# coco-tools
This is a simple collection of tools to assist with developing software for
the [TRS-80 Color Computer](https://en.wikipedia.org/wiki/TRS-80_Color_Computer).
## Installation
```
# To install via pip
pip install coco-tools
# To install from source
git clone https://github.com/jamieleecho/coco-tools.git
cd coco-tools
python3 setup.py
```
## Tools
### [decb-to-b09](README.decb-to-b09.md)
```
usage: decb-to-b09 [-h] [--version] [-l] [-z] program.bas program.b09
Convert a Color BASIC program to a BASIC09 program
Copyright (c) 2023 by Jamie Cho
Version: 0.7
positional arguments:
program.bas input DECB text program file
program.b09 output BASIC09 text program file
options:
-h, --help show this help message and exit
--version show program's version number and exit
-l, --filter-unused-linenum
Filter out line numbers not referenced by the program
-z, --dont-initialize-vars
Don't pre-initialize all variables
```
### cm3toppm
```
usage: cm3toppm [-h] [--version] [image.cm3] [image.ppm]
Convert RS-DOS CM3 images to PPM
Copyright (c) 2017 by Mathieu Bouchard
Copyright (c) 2018-2020 by Jamie Cho
Version: 0.6
positional arguments:
image.cm3 input CM3 image file
image.ppm output PPM image file
options:
-h, --help show this help message and exit
--version show program's version number and exit
```
### hrstoppm
```
usage: hrstoppm [-h] [-w width] [-r height] [-s bytes] [--version]
[image.hrs] [image.ppm]
Convert RS-DOS HRS images to PPM
Copyright (c) 2018 by Mathieu Bouchard
Copyright (c) 2018-2020 by Jamie Cho
Version: 0.6
positional arguments:
image.hrs input HRS image file
image.ppm output PPM image file
options:
-h, --help show this help message and exit
-w width choose different width (this does not assume bigger pixels)
-r height choose height not computed from header divided by width
-s bytes skip some number of bytes
--version show program's version number and exit
```
### maxtoppm
```
usage: maxtoppm [-h] [--version]
[-br | -rb | -br2 | -rb2 | -br3 | -rb3 | -s10 | -s11] [-i]
[-w width] [-r height] [-s bytes] [-newsroom]
[image] [image.ppm]
Convert RS-DOS MAX and ART images to PPM
Copyright (c) 2018 by Mathieu Bouchard
Copyright (c) 2018-2020 by Mathieu Bouchard, Jamie Cho
Version: 0.6
positional arguments:
image input image file
image.ppm output PPM image file
options:
-h, --help show this help message and exit
--version show program's version number and exit
pixel mode:
Default pixel mode is no artifact (PMODE 4 on monitor). The 6 other modes:
-br PMODE 4 artifacts, cyan-blue first
-rb PMODE 4 artifacts, orange-red first
-br2 PMODE 3 Coco 3 cyan-blue first
-rb2 PMODE 3 Coco 3 orange-red first
-br3 PMODE 3 Coco 3 primary, blue first
-rb3 PMODE 3 Coco 3 primary, red first
-s10 PMODE 3 SCREEN 1,0
-s11 PMODE 3 SCREEN 1,1
Format and size options::
Default file format is CocoMax 1/2's .MAX, which is also Graphicom's
.PIC and SAVEM of 4 or 8 pages of PMODE 3/4.
Also works with any other height of SAVEM (including fractional pages).
-i ignore header errors (but read header anyway)
-w width choose different width (this does not assume bigger pixels)
-r height choose height not computed from header divided by width
-s bytes skip header and assume it has the specified length
-newsroom read Coco Newsroom / The Newspaper .ART header instead
```
### mgetoppm
```
usage: mgetoppm [-h] [--version] [image.mge] [image.ppm]
Convert RS-DOS MGE images to PPM
Copyright (c) 2017 by Mathieu Bouchard
Copyright (c) 2018-2020 by Jamie Cho
Version: 0.6
positional arguments:
image.mge input MGE image file
image.ppm output PPM image file
options:
-h, --help show this help message and exit
--version show program's version number and exit
```
### mge_viewer2
```
usage: mge_viewer2 [-h] [--version] [image.mge]
View ColorMax 3 MGE files
Copyright (c) 2022 by R. Allen Murphey
Version: 0.6
positional arguments:
image.mge input MGE image file
optional arguments:
-h, --help show this help message and exit
--version show program's version number and exit
```
### pixtopgm
```
usage: pixtopgm [-h] [--version] image.pix [image.pgm]
Convert RS-DOS PIX images to PGM
Copyright (c) 2018-2020 by Mathieu Bouchard, Jamie Cho
Version: 0.6
positional arguments:
image.pix input PIX image file
image.pgm output PGM image file
options:
-h, --help show this help message and exit
--version show program's version number and exit
```
### rattoppm
```
usage: rattoppm [-h] [--version] [image.rat] [image.ppm]
Convert RS-DOS RAT images to PPM
Copyright (c) 2018-2020 by Mathieu Bouchard, Jamie Cho
Version: 0.6
positional arguments:
image.rat input RAT image file
image.ppm output PPM image file
options:
-h, --help show this help message and exit
--version show program's version number and exit
```
### veftopng
```
usage: veftopng [-h] [--version] image.vef image.png
Convert OS-9 VEF images to PNG
Copyright (c) 2018-2020 Travis Poppe <tlp@lickwid.net>
Copyright (c) 2020 Jamie Cho
Version: 0.6
positional arguments:
image.vef input VEF image file
image.png output PNG image file
options:
-h, --help show this help message and exit
--version show program's version number and exit
```
## Developing and Testing
```
# Build the docker image
docker-compose build test
# Run tests using the source on the docker image
docker-compose run test
# Run tests using the source on the host computer
docker-compose run testv
```
Raw data
{
"_id": null,
"home_page": "https://github.com/jamieleecho/coco-tools",
"name": "coco-tools",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": "",
"keywords": "coco image conversion trs-80 tandy",
"author": "Jamie Cho",
"author_email": "jamieleecho+coco_tools@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/22/6a/8ea4e5fec12babfb5ee82abc24a0b973a0d3871d05b34d60df13b86c9cb1/coco-tools-0.8.tar.gz",
"platform": null,
"description": "# coco-tools\n\nThis is a simple collection of tools to assist with developing software for\nthe [TRS-80 Color Computer](https://en.wikipedia.org/wiki/TRS-80_Color_Computer).\n\n## Installation\n\n```\n# To install via pip\npip install coco-tools\n\n# To install from source\ngit clone https://github.com/jamieleecho/coco-tools.git\ncd coco-tools\npython3 setup.py\n```\n\n## Tools\n\n### [decb-to-b09](README.decb-to-b09.md)\n\n```\nusage: decb-to-b09 [-h] [--version] [-l] [-z] program.bas program.b09\n\nConvert a Color BASIC program to a BASIC09 program\nCopyright (c) 2023 by Jamie Cho\nVersion: 0.7\n\npositional arguments:\n program.bas input DECB text program file\n program.b09 output BASIC09 text program file\n\noptions:\n -h, --help show this help message and exit\n --version show program's version number and exit\n -l, --filter-unused-linenum\n Filter out line numbers not referenced by the program\n -z, --dont-initialize-vars\n Don't pre-initialize all variables\n```\n\n### cm3toppm\n\n```\nusage: cm3toppm [-h] [--version] [image.cm3] [image.ppm]\n\nConvert RS-DOS CM3 images to PPM\nCopyright (c) 2017 by Mathieu Bouchard\nCopyright (c) 2018-2020 by Jamie Cho\nVersion: 0.6\n\npositional arguments:\n image.cm3 input CM3 image file\n image.ppm output PPM image file\n\noptions:\n -h, --help show this help message and exit\n --version show program's version number and exit\n```\n\n### hrstoppm\n\n```\nusage: hrstoppm [-h] [-w width] [-r height] [-s bytes] [--version]\n [image.hrs] [image.ppm]\n\nConvert RS-DOS HRS images to PPM\nCopyright (c) 2018 by Mathieu Bouchard\nCopyright (c) 2018-2020 by Jamie Cho\nVersion: 0.6\n\npositional arguments:\n image.hrs input HRS image file\n image.ppm output PPM image file\n\noptions:\n -h, --help show this help message and exit\n -w width choose different width (this does not assume bigger pixels)\n -r height choose height not computed from header divided by width\n -s bytes skip some number of bytes\n --version show program's version number and exit\n```\n\n### maxtoppm\n\n```\nusage: maxtoppm [-h] [--version]\n [-br | -rb | -br2 | -rb2 | -br3 | -rb3 | -s10 | -s11] [-i]\n [-w width] [-r height] [-s bytes] [-newsroom]\n [image] [image.ppm]\n\nConvert RS-DOS MAX and ART images to PPM\nCopyright (c) 2018 by Mathieu Bouchard\nCopyright (c) 2018-2020 by Mathieu Bouchard, Jamie Cho\nVersion: 0.6\n\npositional arguments:\n image input image file\n image.ppm output PPM image file\n\noptions:\n -h, --help show this help message and exit\n --version show program's version number and exit\n\npixel mode:\n Default pixel mode is no artifact (PMODE 4 on monitor). The 6 other modes:\n\n -br PMODE 4 artifacts, cyan-blue first\n -rb PMODE 4 artifacts, orange-red first\n -br2 PMODE 3 Coco 3 cyan-blue first\n -rb2 PMODE 3 Coco 3 orange-red first\n -br3 PMODE 3 Coco 3 primary, blue first\n -rb3 PMODE 3 Coco 3 primary, red first\n -s10 PMODE 3 SCREEN 1,0\n -s11 PMODE 3 SCREEN 1,1\n\nFormat and size options::\n Default file format is CocoMax 1/2's .MAX, which is also Graphicom's\n .PIC and SAVEM of 4 or 8 pages of PMODE 3/4.\n Also works with any other height of SAVEM (including fractional pages).\n\n -i ignore header errors (but read header anyway)\n -w width choose different width (this does not assume bigger pixels)\n -r height choose height not computed from header divided by width\n -s bytes skip header and assume it has the specified length\n -newsroom read Coco Newsroom / The Newspaper .ART header instead\n```\n\n### mgetoppm\n\n```\nusage: mgetoppm [-h] [--version] [image.mge] [image.ppm]\n\nConvert RS-DOS MGE images to PPM\nCopyright (c) 2017 by Mathieu Bouchard\nCopyright (c) 2018-2020 by Jamie Cho\nVersion: 0.6\n\npositional arguments:\n image.mge input MGE image file\n image.ppm output PPM image file\n\noptions:\n -h, --help show this help message and exit\n --version show program's version number and exit\n```\n\n### mge_viewer2\n\n```\nusage: mge_viewer2 [-h] [--version] [image.mge]\n\nView ColorMax 3 MGE files\nCopyright (c) 2022 by R. Allen Murphey\nVersion: 0.6\n\npositional arguments:\n image.mge input MGE image file\n\noptional arguments:\n -h, --help show this help message and exit\n --version show program's version number and exit\n```\n\n### pixtopgm\n\n```\nusage: pixtopgm [-h] [--version] image.pix [image.pgm]\n\nConvert RS-DOS PIX images to PGM\nCopyright (c) 2018-2020 by Mathieu Bouchard, Jamie Cho\nVersion: 0.6\n\npositional arguments:\n image.pix input PIX image file\n image.pgm output PGM image file\n\noptions:\n -h, --help show this help message and exit\n --version show program's version number and exit\n```\n\n### rattoppm\n\n```\nusage: rattoppm [-h] [--version] [image.rat] [image.ppm]\n\nConvert RS-DOS RAT images to PPM\nCopyright (c) 2018-2020 by Mathieu Bouchard, Jamie Cho\nVersion: 0.6\n\npositional arguments:\n image.rat input RAT image file\n image.ppm output PPM image file\n\noptions:\n -h, --help show this help message and exit\n --version show program's version number and exit\n```\n\n### veftopng\n\n```\nusage: veftopng [-h] [--version] image.vef image.png\n\nConvert OS-9 VEF images to PNG\nCopyright (c) 2018-2020 Travis Poppe <tlp@lickwid.net>\nCopyright (c) 2020 Jamie Cho\nVersion: 0.6\n\npositional arguments:\n image.vef input VEF image file\n image.png output PNG image file\n\noptions:\n -h, --help show this help message and exit\n --version show program's version number and exit\n```\n\n## Developing and Testing\n\n```\n# Build the docker image\ndocker-compose build test\n\n# Run tests using the source on the docker image\ndocker-compose run test\n\n# Run tests using the source on the host computer\ndocker-compose run testv\n```\n",
"bugtrack_url": null,
"license": "GPLv2",
"summary": "TRS-80 Color Computer Tools",
"version": "0.8",
"project_urls": {
"Homepage": "https://github.com/jamieleecho/coco-tools"
},
"split_keywords": [
"coco",
"image",
"conversion",
"trs-80",
"tandy"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "226a8ea4e5fec12babfb5ee82abc24a0b973a0d3871d05b34d60df13b86c9cb1",
"md5": "8658b49104374b615818d27fc0a745fd",
"sha256": "6ed472bdbe8226ebec778d756c214878c53d8ecf42bcca3acffa26d6c0453585"
},
"downloads": -1,
"filename": "coco-tools-0.8.tar.gz",
"has_sig": false,
"md5_digest": "8658b49104374b615818d27fc0a745fd",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 37163,
"upload_time": "2023-08-13T04:10:52",
"upload_time_iso_8601": "2023-08-13T04:10:52.938939Z",
"url": "https://files.pythonhosted.org/packages/22/6a/8ea4e5fec12babfb5ee82abc24a0b973a0d3871d05b34d60df13b86c9cb1/coco-tools-0.8.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-08-13 04:10:52",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "jamieleecho",
"github_project": "coco-tools",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "Pillow",
"specs": [
[
"==",
"8.4.0"
]
]
},
{
"name": "pypng",
"specs": [
[
"==",
"0.20220715.0"
]
]
},
{
"name": "autopep8",
"specs": [
[
">=",
"1.5.4"
]
]
},
{
"name": "black",
"specs": [
[
">=",
"20.8b1"
]
]
},
{
"name": "pycodestyle",
"specs": [
[
">=",
"2.6.0"
]
]
},
{
"name": "pylint",
"specs": [
[
">=",
"2.6.0"
]
]
},
{
"name": "pytest",
"specs": [
[
">=",
"6.2.1"
]
]
},
{
"name": "pytest-cov",
"specs": [
[
">=",
"2.11.1"
]
]
}
],
"lcname": "coco-tools"
}
JSON
