biblibre/omeka-cli

Omeka CLI

Friday, May 4, 2018
by jajm
Repository
7 Watchers
10 Stars
21 Installations

PHP
0 Dependents
0 Suggesters
1 Forks
0 Open issues
34 Versions
5 % Grown

The README.md

Omeka CLI

Command line tool for Omeka, _(*1)

This tool allows to interact with Omeka by using a command line interface. It also provides everything needed for Omeka plugins to create custom commands., _(*2)

![Build status][Build status], _(*3)

Usage

omeka-cli [-h | --help]
omeka-cli [-V | --version]
omeka-cli <command> [options] [arguments]

Available commands

check-updates     check for updates
help              print help for a specific command
status            print status of current Omeka installation
install           install Omeka
list              list available commands
options           list, get and set Omeka options
plugin-disable    disable a plugin
plugin-download   downloads a plugin
plugin-enable     enable a plugin (install & activate)
plugin-list       list all plugins
plugin-search     search a plugin
plugin-uninstall  uninstall a plugin
plugin-update     update a plugin
snapshot          create a snapshot
snapshot-restore  restore a snapshot
upgrade           upgrade Omeka

Requirements

PHP (>= 7.2) with the following extensions:
- Zip
- PDO and the PDO_MYSQL driver
git

Installation

Using composer

# For the latest released version
composer global require biblibre/omeka-cli

# For the latest dev version
composer global require biblibre/omeka-cli:@dev

Then add ~/.config/composer/vendor/bin to your PATH, _(*4)

export PATH=~/.config/composer/vendor/bin:$PATH

Using the phar

Download the latest ̀omeka-cli.phar from Releases page., _(*5)

wget https://github.com/biblibre/omeka-cli/releases/download/$VERSION/omeka-cli.phar
chmod +x omeka-cli.phar
sudo mv omeka-cli.phar /usr/local/bin/omeka-cli

Using the sources

git clone https://github.com/biblibre/omeka-cli.git
cd omeka-cli
composer install --no-dev
bin/omeka-cli --version

Creating custom commands

To create a custom command named foo:bar with the Foo plugin, put the following code in the initialize hook of your plugin's main class:, _(*6)

$events = Zend_EventManager_StaticEventManager::getInstance();
$events->attach('OmekaCli', 'commands', function() {
    return array(
        'Foo_Bar',
    );
});

and define a class Foo_Bar which extends OmekaCli\Command\AbstractCommand, _(*7)

You will have to implements at least configure and execute methods., _(*8)

For instance:, _(*9)

use OmekaCli\Command\AbstractCommand;
use Symfony\Component\Console\Input\InputInterface;
use Symfony\Component\Console\Output\OutputInterface;

class Foo_Bar extends AbstractCommand
{
    protected function configure()
    {
        $this->setName('foo:bar');
        $this->setDescription('print something to stdout');
        $this->setAliases(array('bar'));
    }

    protected function execute(InputInterface $input, OutputInterface $output)
    {
        $output->writeln('Hello, omeka-cli!');

        return 0;
    }
}

Then you will be able to run the command either this way:, _(*10)

omeka-cli foo:bar [OPTION...] [ARG...]

or using the alias:, _(*11)

omeka-cli bar [OPTION...] [ARG...]

To see how to create a custom command from a plugin in practice, see plugin Foo., _(*12)

Running tests

If you want to test omeka-cli, copy phpunit.xml.dist into phpunit.xml and change environment variables OMEKA_DB_* as needed. If you want to avoid downloading Omeka before every run, you can download the ZIP file manually, and put its local path in OMEKA_ZIP_PATH., _(*13)

After you've done that, run, _(*14)

composer install
vendor/bin/phpunit

License

GPL 3.0+, _(*15)

The Versions

04/05 2018

dev-master

9999999-dev https://github.com/biblibre/omeka-cli

Omeka CLI

project omeka-cli

Omeka CLI

biblibre/omeka-cli

The README.md

Omeka CLI

Usage

Available commands

Requirements

Installation

Using composer

Using the phar

Using the sources

Creating custom commands

Running tests

License

The Versions

dev-master

The Requires

The Development Requires

by Julian Maurice

dev-user-create-command

The Requires

The Development Requires

by Julian Maurice

v1.0.0

The Requires

The Development Requires

by Julian Maurice

v1.0.0-beta.1

The Requires

The Development Requires

by Julian Maurice

v1.0.0-alpha.6

The Requires

The Development Requires

by Julian Maurice

v1.0.0-alpha.5

The Requires

The Development Requires

by Julian Maurice

v1.0.0-alpha.4

The Requires

The Development Requires

by Julian Maurice

v1.0.0-alpha.3

The Requires

The Development Requires

by Julian Maurice

v1.0.0-alpha.2

The Requires

The Development Requires

by Julian Maurice

dev-travis

The Requires

The Development Requires

by Julian Maurice

v1.0.0-alpha.1

The Requires

by Julian Maurice

v0.18.0

The Requires

by Julian Maurice

v0.17.0

The Requires

by Julian Maurice

v0.16.1

The Requires

by Julian Maurice

v0.16.0

The Requires

by Julian Maurice

v0.15.0

The Requires

by Julian Maurice

v0.14.0

The Requires

by Julian Maurice

v0.13.0

The Requires

by Julian Maurice