Metadata-Version: 2.4
Name: banger-lib
Version: 1.2.0
Summary: Classic Unix banner command on steroids with TTF support as shared library.
Author-email: Marcin Orlowski <mail@marcinOrlowski.com>
License: MIT
Project-URL: Homepage, https://github.com/MarcinOrlowski/banger
Project-URL: Repository, https://github.com/MarcinOrlowski/banger
Project-URL: Issues, https://github.com/MarcinOrlowski/banger/issues
Keywords: banner,ascii,text,console
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Text Processing
Classifier: Topic :: Utilities
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE.md
Requires-Dist: PyYAML>=6.0
Requires-Dist: Pillow>=8.0.0
Requires-Dist: platformdirs>=3.0.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0; extra == "dev"
Requires-Dist: pytest-cov>=4.0; extra == "dev"
Requires-Dist: black>=23.0; extra == "dev"
Requires-Dist: ruff>=0.1.0; extra == "dev"
Requires-Dist: mypy>=1.0; extra == "dev"
Requires-Dist: wemake-python-styleguide; extra == "dev"
Requires-Dist: wheel; extra == "dev"
Requires-Dist: build; extra == "dev"
Requires-Dist: twine; extra == "dev"
Requires-Dist: faker; extra == "dev"
Requires-Dist: flake8; extra == "dev"
Requires-Dist: flake8-noqa; extra == "dev"
Requires-Dist: flake8-docstrings; extra == "dev"
Requires-Dist: types-Markdown; extra == "dev"
Requires-Dist: types-PyYAML; extra == "dev"
Requires-Dist: python-dateutil; extra == "dev"
Dynamic: license-file

```ascii
▙▄▄                ▗▟█▙  ▟█▙    ▐▄▄              ▄▄▄▄▄▄▄▄▄█             ▗█    ▙▄▖
▜██████████▄▖        ▀    ▀ ▗█  ▝█████████▙▄ ▗▟██████████▀▚▖   ▗▄█████████▛   ▜█████████▙▄
█▙▄▀▀▀▀▀▀█████▖  ▗▄███████████  █▄▄▀▀▀▀▜█████ ████▀     ▗███▌ ▟██████▀▀▀▀▄▄█▌ █▙▄▛▀▀▀▀▜████▌
████      ▟███▌ ▟████▀   ▀▀▀▀▄▌ ████     ████ ████▖     ▐███▌ ████▀    ▄████▌ ████     ▐███▌
██████████████  ████      ▐███▌ ████     ████ ▝█████████████▌ ██████████████▌ ████▄▄▄▄▄▟███▌
████     ▝▜███▌ ████      ▐███▌ ████     ████    ▀▀▘    ▀███▌ ████▙▖     ▄▄▄  ████████████▀
████      ▟███▌ ████▖     ▟███▌ ████     ████  ▄▄        ███▘ ▝▜████████████  ████  ▝███▙
██████████████  ▝█████████████▌ ▄▄▄▄     ▄▄▄▄   ▜▄▄▄▟███████    ▝▀▀▀▀▀▀▀▀▀▀▘  ████    ▜███▖
▀▀▀▀▀▀▀▀▀▀▀▀▀     ▀▀▀▀▀▀▀▀▝▀▀▀▘ ▝▘▝▘     ▝▘▝▘  ▐█▀▀▀▀▀▀▀▀▀▀                   ▀▀▀▀     ▝▀▀▀▘
                                               ▝              *** LUBRARY ***
```

# What it is?

`Bänger` (pronounced just `banger`) is a modern tribute to the classic Unix `banner` command line
utility that produces text banners, with additional features added a top:  multiple built-in ASCII
character set and support for rendering any TTF/OTF font with Unicode! This package contains
the main functionality of the tool in form of a Python library, which can be used to create banners
in your own Python code.

# Command line tool (`banger`)

If you are looking for the command line tool instead, see
the [banger](https://github.com/MarcinOrlowski/banger) project.

# Examples

```python
from banger_lib import Banger

banger = Banger(font="fire")
banger.add_text("Hello World")
output = banger.render()
```

## License

- Written and copyrighted &copy;2025-2026 by Marcin Orlowski <https://marcinOrlowski.com>
- Bänger is the open-sourced software licensed under
  the [MIT license](http://opensource.org/licenses/MIT)
