ILIAS\Setup\CLI Namespace Reference

This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Learning e.V. More...

Data Structures
class	AchieveCommand
	Achieves an objective. More...
class	App
	The ILIAS-setup-console-application. More...
class	BuildArtifactsCommand
	Installation command. More...
class	ConfigReader
	Read a json-formatted config from a file and overwrite some fields. More...
class	InstallCommand
	Installation command. More...
class	IOWrapper
	Wrapper around symfonies input and output facilities to provide just the functionality required for the ILIAS-setup. More...
class	MigrateCommand
	Migration command. More...
class	StatusCommand
	Command to output status information about the installation. More...
class	UpdateCommand
	Update command. More...

Functions
	configureCommandForPlugins ()
	getRelevantAgent (InputInterface $input)
	readAgentConfig (Agent $agent, InputInterface $input)
	addAgentConfigsToEnvironment (Agent $agent, Config $config, Environment $environment)

Variables
trait	HasAgent
	Add this to an Command that has an agent. More...
trait	HasConfigReader
	Add this to an Command that has an config reader. More...

Detailed Description

This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Learning e.V.

ILIAS is licensed with the GPL-3.0, see https://www.gnu.org/licenses/gpl-3.0.en.html You should have received a copy of said license along with the source code, too.

If this is not the case or you just want to try ILIAS, you'll find us at: https://www.ilias.de https://github.com/ILIAS-eLearning

Function Documentation

addAgentConfigsToEnvironment()

ILIAS\Setup\CLI\addAgentConfigsToEnvironment ( Agent  $agent, Config  $config, Environment  $environment  )

protected

Definition at line 49 of file HasConfigReader.php.

      : Environment {
        if ($agent instanceof AgentCollection) {
            foreach ($config->getKeys() as $k) {
                $environment = $environment->withConfigFor($k, $config->getConfig($k));
            }
        }
 
        return $environment;
    }

References $config, and ILIAS\Setup\Environment\withConfigFor().

Referenced by ILIAS\Setup\CLI\AchieveCommand\execute(), ILIAS\Setup\CLI\UpdateCommand\execute(), ILIAS\Setup\CLI\InstallCommand\prepareILIASInstallation(), and ILIAS\Setup\CLI\InstallCommand\preparePluginInstallation().

Here is the call graph for this function:

Here is the caller graph for this function:

configureCommandForPlugins()

ILIAS\Setup\CLI\configureCommandForPlugins ( )

protected

Definition at line 21 of file HasAgent.php.

    {
        $this->addOption("plugin", null, InputOption::VALUE_REQUIRED, "Name of the plugin to run the command for.");
        $this->addOption("no-plugins", null, InputOption::VALUE_NONE, "Ignore all plugins when running the command.");
        $this->addOption("skip", null, InputOption::VALUE_REQUIRED | InputOption::VALUE_IS_ARRAY, "Skip plugin with the supplied <plugin-name> when running the command.");
    }

Referenced by ILIAS\Setup\CLI\BuildArtifactsCommand\configure(), ILIAS\Setup\CLI\InstallCommand\configure(), ILIAS\Setup\CLI\MigrateCommand\configure(), ILIAS\Setup\CLI\StatusCommand\configure(), and ILIAS\Setup\CLI\UpdateCommand\configure().

Here is the caller graph for this function:

getRelevantAgent()

ILIAS\Setup\CLI\getRelevantAgent ( InputInterface  $input )

protected

Definition at line 28 of file HasAgent.php.

                                                               : Agent
    {
        if (!$this->agent_finder) {
            throw new \LogicException(
                "\$this->agent_finder needs to intialized with an AgentFinder."
            );
        }
 
        if ($input->hasOption("no-plugins") && $input->getOption("no-plugins")) {
            // The agents of the core are in all folders but the customizing folder.
            return $this->agent_finder->getCoreAgents();
        }
 
        if ($input->hasOption("plugin")) {
            $plugin_name = $input->getOption("plugin");
            if ($plugin_name) {
                return $this->agent_finder->getPluginAgent($plugin_name);
            }
        }
 
        $agents = $this->agent_finder->getAgents();
        if ($input->hasOption("skip")) {
            foreach (($input->getOption("skip") ?? []) as $plugin_name) {
                $agents = $agents->withRemovedAgent(strtolower($plugin_name));
            }
        }
 
        return $agents;
    }

Referenced by ILIAS\Setup\CLI\AchieveCommand\execute(), ILIAS\Setup\CLI\BuildArtifactsCommand\execute(), ILIAS\Setup\CLI\StatusCommand\execute(), ILIAS\Setup\CLI\UpdateCommand\execute(), ILIAS\Setup\CLI\MigrateCommand\listMigrations(), ILIAS\Setup\CLI\InstallCommand\prepareILIASInstallation(), ILIAS\Setup\CLI\InstallCommand\preparePluginInstallation(), ILIAS\Setup\CLI\MigrateCommand\runMigration(), and ILIAS\Tests\Setup\CLI\HasAgentTest\setUp().

Here is the caller graph for this function:

readAgentConfig()

ILIAS\Setup\CLI\readAgentConfig ( Agent  $agent, InputInterface  $input  )

protected

Definition at line 22 of file HasConfigReader.php.

                                                                            : ?Config
    {
        if (!($this->config_reader instanceof ConfigReader)) {
            throw new \LogicException("\$this->config_reader not properly initialized.");
        }
 
        if (!$agent->hasConfig()) {
            return null;
        }
 
        $config_file = $input->getArgument("config");
        $config_overwrites_raw = $input->getOption("config");
        $config_overwrites = [];
        foreach ($config_overwrites_raw as $o) {
            $vs = explode("=", $o);
            if (count($vs) !== 2) {
                throw new \Exception("Cannot read config-option: '$o'");
            }
            $config_overwrites[$vs[0]] = $vs[1];
        }
 
        $config_content = $this->config_reader->readConfigFile($config_file, $config_overwrites);
 
        $trafo = $agent->getArrayToConfigTransformation();
        return $trafo->transform($config_content);
    }

References ILIAS\Setup\Agent\getArrayToConfigTransformation(), and ILIAS\Setup\Agent\hasConfig().

Referenced by ILIAS\Setup\CLI\AchieveCommand\execute(), ILIAS\Setup\CLI\UpdateCommand\execute(), ILIAS\Setup\CLI\InstallCommand\prepareILIASInstallation(), ILIAS\Setup\CLI\InstallCommand\preparePluginInstallation(), and ILIAS\Tests\Setup\CLI\HasConfigReaderTest\setUp().

Here is the call graph for this function:

Here is the caller graph for this function:

Variable Documentation

HasAgent

trait ILIAS::Setup::CLI\HasAgent

Initial value:

{
    
    protected $agent_finder = null

Add this to an Command that has an agent.

Definition at line 14 of file HasAgent.php.

Referenced by ILIAS\Tests\Setup\CLI\HasAgentTest\setUp().

HasConfigReader

trait ILIAS::Setup::CLI\HasConfigReader

Initial value:

{
    
    protected $config_reader

Add this to an Command that has an config reader.

Definition at line 15 of file HasConfigReader.php.

Referenced by ILIAS\Tests\Setup\CLI\HasConfigReaderTest\setUp().