Metadata-Version: 2.4
Name: zxtools
Version: 1.0.24
Summary: Tools to manipulate files from ZX Spectrum
Home-page: http://www.codeatcpp.com
Download-URL: https://github.com/codeatcpp/zxtools
Author: Kirill V. Lyadvinsky
Author-email: mail@codeatcpp.com
License: BSD-3-Clause
Project-URL: Repository, https://github.com/codeatcpp/zxtools
Project-URL: Issues, https://github.com/codeatcpp/zxtools/issues
Keywords: spectrum sinclair 48k z80 zeus zeus-asm
Classifier: Development Status :: 4 - Beta
Classifier: Operating System :: OS Independent
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
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: Programming Language :: Python :: 3.14
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Topic :: Software Development
Classifier: Topic :: Utilities
Requires-Python: >=3.7
Description-Content-Type: text/x-rst
License-File: LICENSE
Provides-Extra: test
Requires-Dist: pytest>=2.8; extra == "test"
Requires-Dist: coverage>=3.7.1; extra == "test"
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: download-url
Dynamic: home-page
Dynamic: keywords
Dynamic: license
Dynamic: license-file
Dynamic: project-url
Dynamic: provides-extra
Dynamic: requires-python
Dynamic: summary

=====================================
Tools to manipulate ZX Spectrum files
=====================================


.. image:: https://github.com/codeatcpp/zxtools/actions/workflows/python-package.yml/badge.svg
   :target: https://github.com/codeatcpp/zxtools/actions

.. image:: https://codecov.io/gh/codeatcpp/zxtools/branch/master/graph/badge.svg
   :target: https://codecov.io/gh/codeatcpp/zxtools

.. image:: https://img.shields.io/github/release/codeatcpp/zxtools.svg?style=flat
   :target: https://github.com/codeatcpp/zxtools/releases

.. image:: https://img.shields.io/pypi/v/zxtools.svg?style=flat
   :target: https://pypi.python.org/pypi/zxtools
   
.. image:: https://img.shields.io/github/issues/codeatcpp/zxtools.svg
   :target: https://github.com/codeatcpp/zxtools/issues

.. image:: https://app.fossa.io/api/projects/git%2Bgithub.com%2Fjia3ep%2Fzxtools.svg?type=shield
   :target: https://app.fossa.io/projects/git%2Bgithub.com%2Fjia3ep%2Fzxtools?ref=badge_shield

Here's a set of utils to manipulate files that were copied from a TR-DOS diskette or from a tape.

Originally the tools were written to simplify the following workflow:

1. Grab diskette image using `Hobeta <http://speccy.info/Hobeta>`_ tool.
2. Strip the file header and save the result to a new file.
3. Convert resulting `Zeus Z80 assembler <https://en.wikipedia.org/wiki/Zeus_Assembler>`_ file to the plain text format.

TODO: I have future plans to implement some more tools I need to restore my old ZX Spectrum projects.

But you can use them in the way you need. And it's very easy to use: download the package, run ``setup.py`` (or install via ``pip install zxtools``), invoke in the following way::

   $ python3 -m zxtools.hobeta strip input.hobeta result.zeus
   $ python3 -m zxtools.zeus2txt result.zeus listing.asm --include-code

.. image:: https://raw.githubusercontent.com/codeatcpp/zxtools/master/zeus2txt.jpg

NOTE: Python 3 is required to use this package, and Python 2 is not supported but you are welcome to fix it.

To view the resulting files with syntax colorization you can use special `Visual Studio Code plugin <https://marketplace.visualstudio.com/items?itemName=jia3ep.zeus-z80-asm>`_:

.. image:: https://raw.githubusercontent.com/codeatcpp/vscode-language-z80-asm/master/vscode.png
   :target: https://marketplace.visualstudio.com/items?itemName=jia3ep.zeus-z80-asm

