Metadata-Version: 2.4
Name: someProgrammingLanguage
Version: 0.3.5
Summary: SPL — a small custom programming language (interpreter in Python).
Author: confidential
License-Expression: MIT
Project-URL: Homepage, https://pypi.org/project/someProgrammingLanguage/
Requires-Python: >=3.10
Description-Content-Type: text/markdown

# someProgrammingLanguage (SPL)

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

## Install from PyPI (after you publish)

```bash
pip install someProgrammingLanguage
run-spl yourprogram.spl
```

## Install from a clone / zip (development)

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

## Publish to PyPI (make it public for everyone)

1. Create accounts on [PyPI](https://pypi.org/account/register/) and [TestPyPI](https://test.pypi.org/account/register/) (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):
   ```bash
   rm -rf dist/ build/ *.egg-info
   ```
   Or only delete the `dist/` folder before building.
3. **Build fresh artifacts:**
   ```bash
   python -m build
   ```
   This creates new files under `dist/` with the new version in the filename.
4. **Upload to PyPI:**
   ```bash
   twine upload dist/*
   ```
   Use your PyPI API token (`__token__` + token value) when prompted.
5. **Tell users to upgrade:**
   ```bash
   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.
