Metadata-Version: 2.4
Name: sona-lang
Version: 0.15.0
Summary: Sona Programming Language with Cognitive Accessibility and Neurodivergent-First Features
Author-email: "WayCore Inc." <info@waycore.com>
License-Expression: MIT
Project-URL: Bug Reports, https://github.com/Bryantad/Sona/issues
Project-URL: Source, https://github.com/Bryantad/Sona.git
Project-URL: Documentation, https://github.com/Bryantad/Sona/wiki
Keywords: programming-language,ai-native,cognitive-accessibility,runtime-governance,smod
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Intended Audience :: Developers
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: lark-parser>=0.12.0
Requires-Dist: pygls<2,>=1.3.1
Provides-Extra: ai
Requires-Dist: torch>=2.2; platform_system != "Windows" and extra == "ai"
Requires-Dist: transformers>=4.43; extra == "ai"
Requires-Dist: accelerate>=0.33; extra == "ai"
Provides-Extra: toml
Requires-Dist: tomli-w>=1.0.0; extra == "toml"
Provides-Extra: dev
Requires-Dist: ruff>=0.5; extra == "dev"
Requires-Dist: black>=24.4; extra == "dev"
Requires-Dist: pytest>=8.0; extra == "dev"
Requires-Dist: coverage>=7.5; extra == "dev"
Requires-Dist: pytest-cov>=5.0; extra == "dev"
Requires-Dist: mypy>=1.10; extra == "dev"
Requires-Dist: hypothesis>=6.100; extra == "dev"
Requires-Dist: pytest-randomly>=3.15; extra == "dev"
Dynamic: license-file

# Sona

Sona is an AI-native programming language and developer toolchain focused on
clear execution, readable diagnostics, deterministic examples, and cognitive
accessibility.

[![Source Version](https://img.shields.io/github/v/tag/Bryantad/Sona?label=source&sort=semver)](https://github.com/Bryantad/Sona/tags)
[![CI](https://github.com/Bryantad/Sona/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/Bryantad/Sona/actions/workflows/ci.yml)
[![Python](https://img.shields.io/badge/python-3.11%20%7C%203.12-blue.svg)](https://www.python.org/)
[![License](https://img.shields.io/github/license/Bryantad/Sona)](LICENSE)

Current release: `0.15.0`

## What Sona Provides

- A Python-hosted runtime and CLI for `.sona` programs.
- A stable first-run path for new developers.
- Clear user-facing diagnostics with actionable hints.
- A source-validated official example suite.
- Standard library documentation for the stable user-facing modules.

## Install

Sona requires Python 3.11 or newer.

```bash
python -m pip install sona-lang
```

Confirm the install:

```bash
sona --version
```

Expected output shape:

```text
Sona 0.15.0
```

## First Run

The README does not assume access to repository examples. Create a local file
first, then run it.

Bash or macOS/Linux shell:

```bash
echo 'print("Hello, Sona!")' > hello.sona
sona hello.sona
```

Windows PowerShell:

```powershell
'print("Hello, Sona!")' | Out-File -Encoding utf8 hello.sona
sona hello.sona
```

Expected output:

```text
Hello, Sona!
```

## CLI Basics

```bash
sona --help
sona run hello.sona
sona hello.sona
```

Both `sona run <file.sona>` and `sona <file.sona>` are supported for local
files.

## Documentation

- [Quickstart](docs/QUICKSTART.md)
- [Language Reference](docs/LANGUAGE_REFERENCE.md)
- [Standard Library Reference](docs/STDLIB_REFERENCE.md)
- [Accessibility Reference](docs/ACCESSIBILITY_REFERENCE.md)
- [Guardian Reference](docs/GUARDIAN_REFERENCE.md)
- [Diagnostics Guide](docs/errors/v0.14-diagnostics.md)
- [Package Manifest](docs/packages/manifest.md)
- [Native Independence Roadmap](docs/roadmap/SONA_NATIVE_INDEPENDENCE.md)
- [Release Notes](RELEASE_NOTES_v0.15.0.md)

## Official Examples

Official examples are part of the source repository validation surface. They are
not required to exist in installed Python packages.

From a source checkout:

```bash
python tools/run_examples.py
sona run examples/hello.sona
```

## Repository Layout

```text
sona/                         Core runtime, CLI, parser, and packaged stdlib
stdlib/                       Source .smod modules
docs/                         Current user-facing documentation
examples/                     Official source-checkout examples
tools/run_examples.py         Source-checkout example validator
```

## Package Scope

The Python package is intentionally lean. Docs, examples, tests, extension
sources, local reports, and build artifacts are source-repository materials and
are excluded from release wheels and sdists.

## Contributing

See [CONTRIBUTING.md](CONTRIBUTING.md). Keep pull requests focused, document
runtime-visible behavior, and do not commit local test files, temporary build
output, or planning notes.

## License

Sona is released under the MIT license. See [LICENSE](LICENSE).
