Metadata-Version: 2.4
Name: pioton
Version: 0.3.10
Summary: píotón language is a superset of Python allowing it to be written in Irish. Not for use in any important work
Home-page: https://github.com/LukeRoantree4815162342/pioton
Download-URL: https://github.com/LukeRoantree4815162342/pioton/archive/v_030.tar.gz
Author: Luke Roantree
Author-email: luke@roantree.com
License: GPL
Keywords: IPython,Gaeilge,Irish
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Build Tools
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
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
License-File: LICENCE
Requires-Dist: ipython
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: download-url
Dynamic: home-page
Dynamic: keywords
Dynamic: license
Dynamic: license-file
Dynamic: requires-dist
Dynamic: summary


Píotón - Write Python code in Irish

---

Installation:

pip: 

`pip install pioton`

github: 

clone the repo, run `python -m build`, then `pip install` the `.whl` file produced in the `dist/` folder.

---

USAGE Transpiled:

write your píotón code in one or more scripts with a '.pag' (Python as Gaeilge) extension, and run 

tiomsaitheoir file.pag [file2.pag [...]]

which will transpile the píotón scripts into pure Python '.py' files. Running 

tiomsaitheoir -h

will provide further details and examples, and running 

tiomsaitheoir -s

will show an overview of the syntax for píotón code 

#### USAGE IPython:

There are two modes of operation in IPython/Jupyter Notebooks:

  * 'magic' mode: interpret a single cell as Píotón.
  * 'notebook' mode: interpret all cells as Píotón.

Setup: 

```python
from pioton import píotón_magic, píotón_notebook
píotón_magic() # activate the magic command
píotón_notebook() # activate the notebook command
```

Magic Usage:
```python
%% píotón
scríobh('this cell will be interpreted as píotón code')
```

Syntax:
Call `pioton.show_syntax()` to print a full description of the Píotón syntax.

---
