selveri 0.9.0__tar.gz

selveri-0.9.0/PKG-INFO

@@ -0,0 +1,193 @@
+Metadata-Version: 2.4
+Name: selveri
+Version: 0.9.0
+Summary: SelVeri: Self-Verifying Programming Language
+Author-email: Yağız Kaan Aydoğdu <y.kaan.aydogdu@gmail.com>, Yusuf Demir <yusufdemir12610@gmail.com>
+Project-URL: Homepage, https://github.com/Selveri-Corp/selveri
+Project-URL: Issues, https://github.com/Selveri-Corp/selveri/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Operating System :: MacOS :: MacOS X
+Classifier: Operating System :: Microsoft :: Windows
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: lark
+Requires-Dist: ltlf2dfa
+Requires-Dist: z3-solver
+
+# SelVeri : Self-Verifying Programming Language
+
+SelVeri is an **educational, imperative** programming language designed to bridge the gap between sequential programming and formal methods.
+
+Unlike traditional languages that rely on runtime errors or unit tests to catch bugs, SelVeri employs _Dynamic Verification_ by utilizing its **First-Order Logic Runtime Engine**. SelVeri integrates the Z3 SMT Solver directly into its runtime. This allows developers to embed complex mathematical and logical specifications—including quantifiers ($\forall, \exists$) and logical implications—which are verified in real-time as the program executes.
+
+## Source layout
+
+Python package root: `src/selveri/`
+
+```
+src/selveri/
+├── __init__.py
+├── __main__.py              # python -m selveri
+├── cli.py                   # CLI entry (parse → compile → run)
+│
+├── common/                  # shared infrastructure
+│   ├── diagnostics.py       # source spans, rendered errors
+│   ├── errors.py            # SelVeriError hierarchy
+│   ├── runtime.py           # State, Scope, DeclType
+│   └── types.py             # shared scalars (e.g. real = float)
+│
+├── high_level/              # .svi source language
+│   ├── ast.py               # HL AST nodes
+│   ├── parser.py            # Lark parser, parse_selveri
+│   ├── preprocessor.py      # {spec} extraction
+│   └── grammars/
+│       └── grammar.lark
+│
+├── spec/                    # specification / annotation language
+│   ├── models.py            # Spec, RawSpec, domains
+│   ├── parser.py            # parse_spec
+│   └── grammars/
+│       └── spec_grammar.lark
+│
+├── compiler/                # high-level AST → SelVerIR
+│   └── compiler.py
+│
+├── ir/                      # intermediate representation
+│   ├── instr.py             # IRInstr
+│   └── text.py              # IR text parse/serialize helpers
+│
+├── abstract_machine/        # SelVerIR interpreter (VM)
+│   ├── config.py            # RuntimeConfiguration
+│   └── interpreter.py
+│
+└── verifier/                # Z3 / LTL verification engine
+    ├── engine.py            # VerificationEngine
+    ├── z3_mapper.py
+    ├── future_mapper.py
+    ├── future_automaton.py
+    └── models.py            # FutureAutomaton, obligations, …
+```
+
+Pipeline flow: `high_level` → `compiler` → `ir` → `abstract_machine`, with `spec` + `verifier` hooked into compile/run, and `common` used throughout.
+
+## Setup
+
+Create a Virtual Environment (Optional):
+
+```
+python -m venv .venv
+.\.venv\Scripts\activate (for Windows)
+source .\.venv\Scripts\activate (for Linux/MacOS)
+```
+
+Install dependencies:
+
+```
+pip install -r requirements.txt
+```
+
+Or install the project in editable mode to enable the `selveri` command:
+
+```
+pip install -e .
+```
+
+### Future LTL (fLTL) and MONA
+
+Specs using temporal operators such as **Eventually**, **Always**, and **Until** are verified by compiling an automaton through [MONA](https://www.brics.dk/mona/). The `mona` executable must be on your `PATH`; otherwise SelVeri raises a verification error for those specs.
+
+**Linux (Debian/Ubuntu)** — MONA is packaged as `mona` in the universe repository:
+
+```
+sudo apt update
+sudo apt install mona
+```
+
+**macOS / Windows** — Install from the [official MONA page](https://www.brics.dk/mona/), or use a Linux environment (**WSL** on Windows, then follow the Debian/Ubuntu steps).
+
+To confirm:
+
+```
+mona -h
+```
+
+## Run Full Pipeline
+
+Run parser -> compiler -> interpreter from the project root:
+
+```
+python selveri.py examples/example_loop.svi
+```
+
+After editable install, you can use the command directly:
+
+```
+selveri examples/example_loop.svi
+```
+
+By default, IR is **not** written to disk. To generate `.svir` output, pass `--emit-ir`:
+
+```
+selveri examples/example_loop.svi --emit-ir
+```
+
+Or choose a custom path:
+
+```
+selveri examples/example_loop.svi --emit-ir --output-ir out/example_loop.svir
+```
+
+## Error Diagnostics
+
+SelVeri reports parser, preprocessor, compiler, runtime, and verification
+failures as structured diagnostics with source spans, labels, hints, and
+counterexamples when available.
+
+See [docs/errors.md](docs/errors.md) for diagnostic codes, examples, and
+guidance for adding new errors.
+
+# Selveri VsCode Extension
+
+## Prerequisites
+
+The `selveri` Python package and LSP dependencies must be installed in the interpreter used by the extension:
+
+```bash
+pip install -e <path_to_selveri>
+pip install -r vscode-selveri/server/requirements.txt
+```
+
+## Build & Install
+
+```bash
+cd vscode-selveri
+npm install
+npm run compile
+npx vsce package
+code --install-extension selveri-0.9.0.vsix
+```
+
+## Development
+
+1. Open the `vscode-selveri` folder in VS Code.
+2. Open `client/src/extension.ts`.
+3. Press F5 to launch an Extension Development Host.
+
+Example `.vscode/launch.json`:
+
+```json
+{
+  "version": "0.2.0",
+  "configurations": [
+    {
+      "name": "Launch Extension",
+      "type": "extensionHost",
+      "request": "launch",
+      "args": ["--extensionDevelopmentPath=${workspaceFolder}"],
+      "outFiles": ["${workspaceFolder}/client/out/**/*.js"]
+    }
+  ]
+}
+```

selveri-0.9.0/README.md

@@ -0,0 +1,175 @@
+# SelVeri : Self-Verifying Programming Language
+
+SelVeri is an **educational, imperative** programming language designed to bridge the gap between sequential programming and formal methods.
+
+Unlike traditional languages that rely on runtime errors or unit tests to catch bugs, SelVeri employs _Dynamic Verification_ by utilizing its **First-Order Logic Runtime Engine**. SelVeri integrates the Z3 SMT Solver directly into its runtime. This allows developers to embed complex mathematical and logical specifications—including quantifiers ($\forall, \exists$) and logical implications—which are verified in real-time as the program executes.
+
+## Source layout
+
+Python package root: `src/selveri/`
+
+```
+src/selveri/
+├── __init__.py
+├── __main__.py              # python -m selveri
+├── cli.py                   # CLI entry (parse → compile → run)
+│
+├── common/                  # shared infrastructure
+│   ├── diagnostics.py       # source spans, rendered errors
+│   ├── errors.py            # SelVeriError hierarchy
+│   ├── runtime.py           # State, Scope, DeclType
+│   └── types.py             # shared scalars (e.g. real = float)
+│
+├── high_level/              # .svi source language
+│   ├── ast.py               # HL AST nodes
+│   ├── parser.py            # Lark parser, parse_selveri
+│   ├── preprocessor.py      # {spec} extraction
+│   └── grammars/
+│       └── grammar.lark
+│
+├── spec/                    # specification / annotation language
+│   ├── models.py            # Spec, RawSpec, domains
+│   ├── parser.py            # parse_spec
+│   └── grammars/
+│       └── spec_grammar.lark
+│
+├── compiler/                # high-level AST → SelVerIR
+│   └── compiler.py
+│
+├── ir/                      # intermediate representation
+│   ├── instr.py             # IRInstr
+│   └── text.py              # IR text parse/serialize helpers
+│
+├── abstract_machine/        # SelVerIR interpreter (VM)
+│   ├── config.py            # RuntimeConfiguration
+│   └── interpreter.py
+│
+└── verifier/                # Z3 / LTL verification engine
+    ├── engine.py            # VerificationEngine
+    ├── z3_mapper.py
+    ├── future_mapper.py
+    ├── future_automaton.py
+    └── models.py            # FutureAutomaton, obligations, …
+```
+
+Pipeline flow: `high_level` → `compiler` → `ir` → `abstract_machine`, with `spec` + `verifier` hooked into compile/run, and `common` used throughout.
+
+## Setup
+
+Create a Virtual Environment (Optional):
+
+```
+python -m venv .venv
+.\.venv\Scripts\activate (for Windows)
+source .\.venv\Scripts\activate (for Linux/MacOS)
+```
+
+Install dependencies:
+
+```
+pip install -r requirements.txt
+```
+
+Or install the project in editable mode to enable the `selveri` command:
+
+```
+pip install -e .
+```
+
+### Future LTL (fLTL) and MONA
+
+Specs using temporal operators such as **Eventually**, **Always**, and **Until** are verified by compiling an automaton through [MONA](https://www.brics.dk/mona/). The `mona` executable must be on your `PATH`; otherwise SelVeri raises a verification error for those specs.
+
+**Linux (Debian/Ubuntu)** — MONA is packaged as `mona` in the universe repository:
+
+```
+sudo apt update
+sudo apt install mona
+```
+
+**macOS / Windows** — Install from the [official MONA page](https://www.brics.dk/mona/), or use a Linux environment (**WSL** on Windows, then follow the Debian/Ubuntu steps).
+
+To confirm:
+
+```
+mona -h
+```
+
+## Run Full Pipeline
+
+Run parser -> compiler -> interpreter from the project root:
+
+```
+python selveri.py examples/example_loop.svi
+```
+
+After editable install, you can use the command directly:
+
+```
+selveri examples/example_loop.svi
+```
+
+By default, IR is **not** written to disk. To generate `.svir` output, pass `--emit-ir`:
+
+```
+selveri examples/example_loop.svi --emit-ir
+```
+
+Or choose a custom path:
+
+```
+selveri examples/example_loop.svi --emit-ir --output-ir out/example_loop.svir
+```
+
+## Error Diagnostics
+
+SelVeri reports parser, preprocessor, compiler, runtime, and verification
+failures as structured diagnostics with source spans, labels, hints, and
+counterexamples when available.
+
+See [docs/errors.md](docs/errors.md) for diagnostic codes, examples, and
+guidance for adding new errors.
+
+# Selveri VsCode Extension
+
+## Prerequisites
+
+The `selveri` Python package and LSP dependencies must be installed in the interpreter used by the extension:
+
+```bash
+pip install -e <path_to_selveri>
+pip install -r vscode-selveri/server/requirements.txt
+```
+
+## Build & Install
+
+```bash
+cd vscode-selveri
+npm install
+npm run compile
+npx vsce package
+code --install-extension selveri-0.9.0.vsix
+```
+
+## Development
+
+1. Open the `vscode-selveri` folder in VS Code.
+2. Open `client/src/extension.ts`.
+3. Press F5 to launch an Extension Development Host.
+
+Example `.vscode/launch.json`:
+
+```json
+{
+  "version": "0.2.0",
+  "configurations": [
+    {
+      "name": "Launch Extension",
+      "type": "extensionHost",
+      "request": "launch",
+      "args": ["--extensionDevelopmentPath=${workspaceFolder}"],
+      "outFiles": ["${workspaceFolder}/client/out/**/*.js"]
+    }
+  ]
+}
+```

selveri-0.9.0/pyproject.toml

@@ -0,0 +1,39 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "selveri"
+version = "0.9.0"
+authors = [
+    { name = "Yağız Kaan Aydoğdu", email = "y.kaan.aydogdu@gmail.com" },
+    { name = "Yusuf Demir", email = "yusufdemir12610@gmail.com" },
+]
+description = "SelVeri: Self-Verifying Programming Language"
+readme = "README.md"
+requires-python = ">=3.10"
+dependencies = [
+    "lark",
+    "ltlf2dfa",
+    "z3-solver",
+]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: POSIX :: Linux",
+    "Operating System :: MacOS :: MacOS X",
+    "Operating System :: Microsoft :: Windows",
+]
+
+[project.scripts]
+selveri = "selveri.cli:main"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[project.urls]
+Homepage = "https://github.com/Selveri-Corp/selveri"
+Issues = "https://github.com/Selveri-Corp/selveri/issues"

selveri-0.9.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

selveri-0.9.0/src/selveri/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.8.0"

selveri-0.9.0/src/selveri/__main__.py

@@ -0,0 +1,4 @@
+from .cli import main
+
+if __name__ == "__main__":
+    raise SystemExit(main())

selveri-0.9.0/src/selveri/abstract_machine/__init__.py

@@ -0,0 +1,9 @@
+from .config import RuntimeConfiguration
+from .interpreter import ExecutionResult, interpret_ir_code, interpret_ir_text
+
+__all__ = [
+    "ExecutionResult",
+    "RuntimeConfiguration",
+    "interpret_ir_code",
+    "interpret_ir_text",
+]

selveri-0.9.0/src/selveri/abstract_machine/config.py

@@ -0,0 +1,11 @@
+from __future__ import annotations
+
+from dataclasses import dataclass
+
+from selveri.common.runtime import Scope, State
+
+
+@dataclass(frozen=True)
+class RuntimeConfiguration:
+    state: State
+    scope: Scope