<commit_before># Nether Console

Redux.
<commit_msg>thusfar<commit_after># **Nether Console (netherphp/console)**

[![Packagist](https://img.shields.io/packagist/v/netherphp/console.svg?style=for-the-badge)](https://packagist.org/packages/netherphp/console) [![Packagist](https://img.shields.io/packagist/dt/netherphp/console.svg?style=for-the-badge)](https://packagist.org/packages/netherphp/console) [![Build Status](https://img.shields.io/github/workflow/status/netherphp/console/Unit%20Tests?style=for-the-badge)](https://github.com/netherphp/console/actions) [![codecov](https://img.shields.io/codecov/c/gh/netherphp/console?style=for-the-badge&token=VQC48XNBS2)](https://codecov.io/gh/netherphp/console)

This package provides some basic functionality for creating command line
interfaces via PHP 8 attributes.




# Quickstart

```php
require('vendor/autoloader.php');

use Nether\Console\Meta\Command;
use Nether\Console\Meta\Info;
use Nether\Console\Meta\Arg;
use Nether\Console\Meta\Toggle;

class App
extends Nether\Console\Client {

	#[Command]
	#[Info('A whatever command.')]
	public function
	Whatever():
	int {

		echo 'Whatever', PHP_EOL;
		return 0;
	}

	#[Command]
	#[Info('A whenever command.')]
	#[Arg('date', 'A date input.')]
	#[Toggle('-u', 'Output as unix time.')]
	public function
	Whenever():
	int {

		$Date = $this->GetInput(1);
		$Unixise = $this->GetOption('u');

		if($Unixise)
		echo date('U', strtotime($Date));
		else
		echo date('Y-m-d', strtotime($Date));

		echo PHP_EOL;

		return 0;
	}

}

exit((new App)->Run());
```

```
$ php ./test.php

USAGE: test.php <command> <args>

  whatever

    A whatever command.

  whenever <date>

    A whenever command.

    -u
      Output as unix time.

```

{'fraction_non_alphanumeric': 0.1782006920415225, 'fraction_numerical': 0.005190311418685121, 'mean_word_length': 4.525477707006369, 'pattern_counts': {'":': 0, '<': 6, '<?xml version=': 0, '>': 9, 'https://': 8, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '2157493', 'n_tokens_mistral': 674, 'n_tokens_neox': 628, 'n_words': 111}