<?php

namespace WP_CLI\Bootstrap;

use WP_CLI;
use WP_CLI\Utils;

/**
 * Class RegisterDeferredCommands.
 *
 * Registers the deferred commands that for which no parent was registered yet.
 * This is necessary, because we can have sub-commands that have no direct
 * parent, like `wp network meta`.
 *
 * @package WP_CLI\Bootstrap
 */
final class RegisterDeferredCommands implements BootstrapStep {

    /**
     * Process this single bootstrapping step.
     *
     * @param BootstrapState $state Contextual state to pass into the step.
     *
     * @return BootstrapState Modified state to pass to the next step.
     */
    public function process( BootstrapState $state ) {

        // Process deferred command additions for external packages.
        $this->add_deferred_commands();

        // Process deferred command additions for commands added through
        // plugins.
        WP_CLI::add_hook(
            'before_run_command',
            [ $this, 'add_deferred_commands' ]
        );

        return $state;
    }

    /**
     * Add deferred commands that are still waiting to be processed.
     */
    public function add_deferred_commands() {
        $deferred_additions = WP_CLI::get_deferred_additions();

        foreach ( $deferred_additions as $name => $addition ) {
            $addition_data = [];
            foreach ( $addition as $addition_key => $addition_value ) {
                // Describe the callable as a string instead of directly printing it
                // for better debug info.
                if ( 'callable' === $addition_key ) {
                    $addition_value = Utils\describe_callable( $addition_value );

                } elseif ( is_array( $addition_value ) ) {
                    $addition_value = json_encode( $addition_value );
                }

                $addition_data[] = sprintf(
                    '%s: %s',
                    $addition_key,
                    $addition_value
                );
            }

            WP_CLI::debug(
                sprintf(
                    'Adding deferred command: %s (%s)',
                    $name,
                    implode( ', ', $addition_data )
                ),
                'bootstrap'
            );

            WP_CLI::add_command(
                $name,
                $addition['callable'],
                $addition['args']
            );
        }
    }
}