Metadata-Version: 2.5
Name: maxgotlost
Version: 0.1.1
Summary: Gothic terminal banners, animated logos, and colored typing utilities
Project-URL: Homepage, https://pypi.org/project/maxgotlost/
Author: MAXGOTLOST
License-Expression: MIT
License-File: LICENSE
Keywords: animation,ansi,cli,gothic,terminal,text
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Terminals
Classifier: Topic :: Utilities
Requires-Python: >=3.8
Requires-Dist: cfonts>=1.5.2
Requires-Dist: colorama>=0.4.6
Description-Content-Type: text/markdown

# maxgotlost

Gothic terminal banners, animated logo reveal, and color-supported typewriter effects.

## Install

```bash
python -m pip install maxgotlost
```

## Quick start

```python
from maxgotlost import logo, typewrite, type, bypass

logo("MAX", "𓆩♱𓆪 MAXGOTLOST • GOTHIC TERMINAL 𓆩♱𓆪").center().print(
    animate=True, delay=0.025, color="magenta"
)

typewrite("WELCOME TO MAXGOTLOST", color="red", speed=0.04, align="center")
type("GOTHIC TERMINAL").center(color="cyan", speed=0.03)

# Optional: replaces normal Python exit functions globally in this process.
# Call only if you intend that behavior:
# bypass()
```

## API

- `logo(text, subtitle="")`: create a banner object. Use `.print(animate=True, delay=0.025, color="red")`.
- Logo alignment: `.left()`, `.right()`, `.center()`, `.centre()`.
- `type(text)`: create an animated text object with `.left()`, `.right()`, `.center()`, `.centre()`, and `color`/`speed` options.
- `typewrite(text, color="red", speed=0.035, align="left")`: animate text directly.
- Supported color names: `red`, `green`, `yellow`, `blue`, `magenta`, `cyan`, `white`, `black`.
- `bypass(module=None)`: replaces `sys.exit`, `builtins.exit`, and `builtins.quit` with a function that prints the MAXGOTLOST message rather than exiting. This changes process-global behavior. Use carefully.

## Dependencies

`cfonts` and `colorama`.

## License

MIT. See `LICENSE`.
