https://github.com/cspray/annotated-console

A small library for creating Symfony Console apps using Annotated Container!
https://github.com/cspray/annotated-console

annotated-container symfony-console

Last synced: about 2 months ago
JSON representation

A small library for creating Symfony Console apps using Annotated Container!

• Host: GitHub
• URL: https://github.com/cspray/annotated-console
• Owner: cspray
• License: mit
• Created: 2022-08-19T22:48:04.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2022-09-08T10:17:11.000Z (over 2 years ago)
• Last Synced: 2024-04-13T20:21:37.443Z (9 months ago)
• Topics: annotated-container, symfony-console
• Language: PHP
• Homepage:
• Size: 32.2 KB
• Stars: 0
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Annotated Console

Annotated Console is a way to autowire and configure [symfony/console](https://github.com/symfony/console) applications using [Annotated Container](https://github.com/cspray/annotated-container). Out of the box, Annotated Console is intended to provide the following features:

- Automatically add Command instances to a Symfony Application.

- Allow configuring a Command using PHP 8 Attributes.

- Depend on services in Command constructors and take advantage of other functionality provided by [Annotated Container](https://github.com/cspray/annotated-container).

## Installation

I recommend installing Annotated Console using [Composer](https://getcomposer.org).

```shell

composer require cspray/annotated-console:dev-main cspray/annotated-container:v2.x-dev

```

> Annotated Console currently requires Annotated Container v2.x-dev. When Annotated Container releases 2.0 this library 

> will release a 1.0 package.

## Quick Start

Annotated Console is designed to get going in a few straightforward steps.

## Step 1 - Initiate your Container

The functionality for this library is primarily provided by [Annotated Container](https://github.com/cspray/annotated-container). Which means you need to make sure that your configuration is setup to boostrap your app. As long as you have a PSR-4 or PSR-0 autoload configuration setup in your `composer.json` you can run the following command from the root of your project:

```shell

./vendor/bin/annotated-container init

```

By default, the init command will create a directory to cache your Container so static analysis doesn't have to run on every Command. Early in development it is advised to disable the cache by removing the `` element from the configuration file. It is important that if new Services or Commands are added the Container cache is busted appropriately.

## Step 2 - Create your App's Binary

Next, you'll need to create the file that you'll use to run your app. You can name and store this file anywhere you'd like, but we'll put our example in `./bin/acme`.

```php

#!/usr/bin/env php

run(new ArgvInput());

exit($exitCode);

```

After you've added this script ensure you run `chmod +x ./bin/acme` so that you can execute it!

## Step 3 - Add your Commands

At this point you're ready to start adding Commands! Anywhere in a directory scanned by Annotated Container, this will be defined in the `annotated-container.xml` file created in Step 1, implement an object that extends Command and is controlled by the Container.

```php

writeln('Hello, world!');

    }

}

```

Now, if you run `./bin/acme hello-world` your Command will be executed!

You can configure the bulk of your Command through the ConsoleCommand Attribute. Check out the `demo` directory for 

more examples, including configuring arguments and options.