phpgt/cli

Command line interface builder.

v1.3.4 2023-09-18 10:06 UTC

Requires

• php: >=8.0
• ext-json: *
• ext-readline: *
• phpgt/daemon: ^v1.1

Requires (Dev)

• phpstan/phpstan: ^v1.8
• phpunit/phpunit: ^v9.5

MIT

• Greg Bowler

• cli
• terminal
• webengine
• phpgt

README

Create multi-command terminal application with parameter requirements that are self-documenting and easy to unit test.

Example usage: Twitter client

CLI interaction:

$ twitter tweet --message "Sending a test Tweet from the terminal."
Sent! View online: https://twitter.com/g105b/status/1038509073346510849
$ twitter dm --to @g105b --message "Hello, Greg!"
Sent!
$ twitter help
Twitter example application

Available commands:
• tweet		Send a Tweet to your timeline.
• view		View your timeline
• follow	Follow an account
• dm		Send a direct message.
• login		Authenticate your username.
• help		Show this help screen.

twitter.php:

$app = new Application(
	"Twitter example application",
	new CliArgumentList(...$argv),
	new TweetCommand(),
	new ViewCommand(),
	new FollowCommand(),
	new DmCommand(),
	new LoginCommand()
);
$app->run();

Command/tweet.php

class TweetCommand extends Command {
	public function __construct() {
		$this->setName("tweet");
		$this->setDescription("Send a Tweet to your timeline.");

		$this->setRequiredParameter(true, "message", "m");
		$this->setOptionalParameter(true, "location", "l");
	}

	public function run(ArgumentValueList $arguments):void {
		if(!TwitterApi::isLoggedIn()) {
			$this->writeLine("You must login first.", Stream::ERROR);
		}
		
		try {
			$uri = TwitterApi::sendTweet($arguments->get("message"));
			$this->writeLine("Sent! View online: $uri");
		}
		catch(TwitterApiException $exception) {
			$this->writeLine(
				"Error sending Tweet: "
				. $exception->getMessage(),
				Stream::ERROR
			);
		}
	}
}