Metadata-Version: 2.4
Name: nullsec
Version: 0.1.0
Summary: Prints the NULLSEC ASCII art with a random tag.
Project-URL: Homepage, https://github.com/filipinescu/nullsec
Project-URL: Source, https://github.com/filipinescu/nullsec
Project-URL: Issues, https://github.com/filipinescu/nullsec/issues
Author-email: filipinescu <fillipgamerx414@gmail.com>
License-Expression: MIT
License-File: LICENSE
Keywords: ascii-art,cli,nullsec,terminal
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: End Users/Desktop
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Artistic Software
Classifier: Topic :: Utilities
Requires-Python: >=3.9
Description-Content-Type: text/markdown

# nullsec

A tiny terminal toy: prints the NULLSEC ASCII art with one of `DNR`, `OPSEC`,
`NULLSEC` or `EBK` picked at random underneath it, in a random color.

```
$ nullsec
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@*+++++==*@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@#:.......+@@@@@@@@@@@
...

                                               NULLSEC
```

## Install

```sh
pip install nullsec          # PyPI
pipx install nullsec         # isolated, recommended for a CLI
yay -S nullsec               # Arch Linux (AUR)
```

## Usage

```sh
nullsec                      # random tag, random color
nullsec --tag EBK            # pin the tag
nullsec --color never        # no ANSI codes
nullsec --seed 42            # reproducible output
nullsec --version
python -m nullsec            # same thing, without the entry point
```

Color is on when stdout is a TTY and off when piped. `NO_COLOR` and
`FORCE_COLOR` are both honored, and `--color always|never` overrides everything.

## Library use

```python
from nullsec import render

print(render("OPSEC", color=False))
```

## Development

```sh
python -m pip install -e .
python -m pytest
```

## License

MIT
