Package and Examples

Package and Examples

Sona 0.14.0 keeps the installed Python package lean and validates examples from the source repository.

Package Scope

Install Sona with:

python -m pip install sona-lang

The Python package contains the runtime, CLI, parser, and packaged stdlib needed to run Sona programs.

The package does not need to include:

• docs/
• examples/
• tests/
• VS Code extension source
• local reports or build artifacts

Examples Validation Rule

• Official examples must exist in the source repository.
• python tools/run_examples.py must pass against the repo copy.
• Examples are not required to exist in installed packages.

Running Examples from a Source Checkout

Clone the source repository:

git clone https://github.com/Bryantad/Sona.git
cd Sona

Run one example:

sona run examples/hello.sona

Validate all official examples:

python tools/run_examples.py

README Constraint

Public README and quickstart paths must use local-file examples for first run. They must not assume that an installed package includes repository examples.