Metadata-Version: 2.3
Name: atari-8-bit-utils
Version: 0.0.6
Summary: A collection of Python utilities for projects related to Atari 8-bit computers
Project-URL: Documentation, https://github.com/JSJvR/atari-8-bit-utils#readme
Project-URL: Issues, https://github.com/JSJvR/atari-8-bit-utils/issues
Project-URL: Source, https://github.com/JSJvR/atari-8-bit-utils
Author: Johan van Rensburg
Keywords: ATASCII,Atari
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved :: GNU General Public License v2 (GPLv2)
Classifier: Programming Language :: Python
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 :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Requires-Python: >=3.8
Requires-Dist: typer
Description-Content-Type: text/markdown

# Atari 8-bit Python Utilities
![Auto Tag badge](https://github.com/JSJvR/atari-8-bit-utils/actions/workflows/auto_tag.yml/badge.svg) ![Python Package badge](https://github.com/JSJvR/atari-8-bit-utils/actions/workflows/python-package.yml/badge.svg) ![Python Publish badge](https://github.com/JSJvR/atari-8-bit-utils/actions/workflows/python-publish.yml/badge.svg) 
## Prerequisites

- Python 3.8 or later
- Optional: A version of [`mkatr`](https://github.com/dmsc/mkatr) compiled for you platform, in your `PATH`. Needed for `atr2git` command to work. 

## Getting Started

The package can be installed using `pip`

```
pip install atari-8-bit-utils
```

Verify the installation by running `a8utils --help`

The output should look something like this

```
 Usage: a8utils [OPTIONS] COMMAND [ARGS]...

╭─ Options ────────────────────────────────────────────────────────────╮
│ --install-completion          Install completion for the current     │
│                               shell.                                 │
│ --show-completion             Show completion for the current shell, │
│                               to copy it or customize the            │
│                               installation.                          │
│ --help                        Show this message and exit.            │
╰──────────────────────────────────────────────────────────────────────╯
╭─ Commands ───────────────────────────────────────────────────────────╮
│ ata2utf    Converts a single file or all files in a directory from   │
│            ATASCII to UTF-8                                          │
│ utf2ata    Converts a single file or all files in a directory from   │
│            UTF-8 to ATASCII                                          │
│ atr2git    Keeps an ATR image and git repo in sync                   │
╰──────────────────────────────────────────────────────────────────────╯
```

## Commands
