Metadata-Version: 2.4
Name: pymcu-pic-toolchain
Version: 1.5.2
Summary: Vendored gputils assembler (gpasm) and device headers for the PyMCU PIC backend
Project-URL: Homepage, https://github.com/PyMCU/pymcu-pic-toolchain
Project-URL: Repository, https://github.com/PyMCU/pymcu-pic-toolchain
Project-URL: Bug Tracker, https://github.com/PyMCU/pymcu-pic-toolchain/issues
Author-email: Iván Montiel Cardona <contact@pymcu.org>
License: MIT AND GPL-2.0-or-later
License-File: LICENSE
Keywords: gpasm,gputils,microchip,pic,pymcu,toolchain
Classifier: License :: OSI Approved :: GNU General Public License v2 or later (GPLv2+)
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: MacOS
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Compilers
Classifier: Topic :: Software Development :: Embedded Systems
Requires-Python: >=3.11
Description-Content-Type: text/markdown

# pymcu-pic-toolchain

Vendored [GNU PIC Utilities (gputils)](https://gputils.sourceforge.io/) for the
[PyMCU](https://github.com/PyMCU/PyMCU) PIC backend.

This package ships the `gpasm` assembler plus the processor header files
(`header/*.inc`) as a platform-specific wheel, so that

```bash
pip install --pre "pymcu-compiler[pic]"
```

is self-contained — no system `brew install gputils` / `apt install gputils`
step required.

It mirrors the role [pymcu-avr-toolchain](https://pypi.org/project/pymcu-avr-toolchain/)
and [pymcu-arm-toolchain](https://pypi.org/project/pymcu-arm-toolchain/) play
for the other backends.

## API

```python
import pymcu_pic_toolchain as t

t.get_tool("gpasm")   # -> Path to a ready-to-run gpasm binary
t.header_dir()        # -> Path to the bundled *.inc headers (or None)
t.GPUTILS_VERSION     # -> "1.5.2"
```

The [pymcu-pic](https://github.com/PyMCU/pymcu-pic) toolchain driver resolves
binaries in this order: this wheel → system `PATH` → the `~/.pymcu/tools`
cache → source build.

## Versioning

The package version tracks the bundled gputils version. Packaging-only fixes
on the same gputils release use a `.postN` suffix.

## License

The packaging code is MIT. The bundled gputils binaries are
GPL-2.0-or-later — they are aggregated, not linked; the driver invokes
`gpasm` as a subprocess. See [LICENSE](LICENSE).
