Metadata-Version: 2.4
Name: cp437g
Version: 1.0.0
Summary: Code Page 437 memory-mapped graphics codec
Author-email: Jacob Shtabnoy <jshtabb@gmail.com>
License-Expression: Unicode-3.0
Keywords: code page 437,cp437,codec,classic
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Topic :: File Formats
Classifier: Topic :: Text Processing :: Filters
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.14
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.7
Requires-Python: <4,>=3.7
Description-Content-Type: text/markdown
License-File: COPYING
Dynamic: license-file

 CP437 Graphics Codec
======================

Python text codec for Code Page 437 memory-mapped graphics data, which
replaces the control codes with icons and symbol glyphs. Works as a drop-in
replacement for the builtin 'cp437' codec.

Includes a subset of CP437 used in the Minecraft Classic network protocol.

> [!IMPORTANT]
> This work is not affiliated with Microsoft Corporation, Mojang AB, Minecraft,
> ClassiCube, International Business Machines Corporation, or Unicode, Inc.

 Included Codecs
-----------------

 |   Codec   |         Aliases           |          Description           |
 |-----------|---------------------------|--------------------------------|
 | cp437g    | 437g, ibm437g, classicube | All 255 code points            |
 | minecraft |                           | Only the first 127 code points |

 Installation
--------------

To install from the Python Package Index:

    $ python3 -m pip install cp437g

To install from this repository, use the PyPI build module:

    $ python3 -m pip install build
    $ python3 -m build
    $ python3 -m pip install dist/*.whl

 Examples
----------

To encode a string:

    >>> import cp437g
    >>> "••••".encode('cp437g')
    b'\x07\x07\x07\x07'

To decode a string:

    >>> import cp437g
    >>> b'\x0D\x20\x4C\x61\x20\x4C\x61\x20\x0D'.decode('cp437g')
    '♪ La La ♪'    
