someProgrammingLanguage 0.3.5

SPL — a small custom programming language (interpreter in Python).

someProgrammingLanguage (SPL)

A small custom language implemented in Python. Run .spl files with the run-spl command.

Install from PyPI (after you publish)

pip install someProgrammingLanguage
run-spl yourprogram.spl

Install from a clone / zip (development)

cd SomeProjectFolder
pip install -e .
run-spl yourprogram.spl

Publish to PyPI (make it public for everyone)

1. Create accounts on PyPI and TestPyPI (optional but recommended for a dry run).
2. Install build tools: pip install build twine
3. In the project root: python -m build — creates dist/*.whl and dist/*.tar.gz.
4. Upload to TestPyPI first: twine upload --repository testpypi dist/*
5. Test install: pip install -i https://test.pypi.org/simple/ someProgrammingLanguage
6. Upload to real PyPI: twine upload dist/* (use API token from PyPI → Account settings → API tokens).

After that, anyone in the world can run pip install someProgrammingLanguage with Python 3.10+.

Publish an update (after you change code)

PyPI does not let you overwrite the same version twice. Each release needs a new version number.

1. Edit pyproject.toml — bump version = "0.3.4" to something higher (e.g. 0.3.5 or 0.4.0). Commit your code changes.
2. Clean old builds (optional but avoids confusion):

   rm -rf dist/ build/ *.egg-info
   

   Or only delete the dist/ folder before building.
3. Build fresh artifacts:

   python -m build
   

   This creates new files under dist/ with the new version in the filename.
4. Upload to PyPI:

   twine upload dist/*
   

   Use your PyPI API token (__token__ + token value) when prompted.
5. Tell users to upgrade:

   pip install -U someProgrammingLanguage
   

   Or pin a version: pip install someProgrammingLanguage==0.3.5.

Optional: Tag the release in git (v0.3.5) and push to GitHub so the source matches what’s on PyPI.

Optional: public source on GitHub

Push this repo to GitHub (public). You can set Homepage / Repository in pyproject.toml under [project.urls] to that URL.