eplang 7.0.0__tar.gz

eplang-7.0.0/CHANGELOG.md

@@ -0,0 +1,242 @@
+# Changelog
+
+All notable changes to EPL are documented here.
+
+## [7.0.0] — 2026
+
+### Changed
+- Unified production tooling around `epl.toml` while keeping `epl.json` as a legacy fallback.
+- Fixed the module CLI so manifest-based builds, strict type checking, and sandboxed execution work correctly.
+- Hardened pytest collection to exclude legacy script-style runners from structured pytest runs.
+- Updated release metadata and docs to align with EPL v7.0.
+
+### Packaging
+- Renamed the standalone CLI bundler script from `build.py` to `bundle.py` so `python -m build` works with the standard Python packaging frontend.
+- Added wheel/sdist package data for native `.epl` stdlib modules, `registry.json`, `runtime.c`, and the AI `Modelfile`.
+- Expanded PyInstaller bundling assets so packaged EPL binaries include the same runtime files expected by source installs.
+
+## [4.2.0] — 2025
+
+### Added
+
+#### Native EPL Standard Library Modules
+- 9 native `.epl` modules written in EPL itself (not Python):
+  - `math` — factorial, fibonacci, is_prime, gcd, lcm, statistics (mean, median, variance, std_dev)
+  - `string` — capitalize, slug, pad_left/pad_right, truncate, word_count, char_count, repeat_string
+  - `collections` — flatten, chunk, unique, zip_pair, take/drop, stack (push/pop/peek), queue
+  - `functional` — map_list, filter_list, reduce_list, compose, pipe, curry, memoize, once
+  - `datetime` — format_duration, time_ago, is_weekend, days_until, format_date
+  - `crypto` — md5, sha256, base64_enc/base64_dec, hex_enc, uuid, random_string
+  - `http` — http_fetch, http_send, parse_json, to_json, encode_url
+  - `io` — read_whole_file, write_whole_file, file_lines, file_head, file_tail
+  - `testing` — test, expect_equal, expect_true, expect_false, expect_contains, test_summary
+- `epl/stdlib/registry.json` — Module registry with descriptions and file paths
+- `epl modules` CLI command — Lists all available standard library modules
+
+#### Import System Improvements
+- AST caching (`_ast_cache`) — Parsed files are cached by absolute path, eliminating redundant lex/parse on re-import
+- `_parse_file()` method — Centralised file reading, lexing, and parsing with caching
+- Module function recursion — Functions accessed via `Module.method()` or `Module::method()` can call other module functions
+
+#### REPL Enhancements
+- `.vars` command now works correctly (shows variables + defined functions with parameter names)
+- Persistent REPL history across sessions (`~/.epl_history`)
+- Windows readline support via `pyreadline3` fallback
+
+#### CLI
+- `epl modules` command — Discover available standard library modules
+- Python 3.9+ version guard with friendly error message (both `main.py` and `epl/cli.py`)
+
+### Changed
+- `_import_and_exec()` and `_import_as_module()` refactored to use shared `_parse_file()` method
+- REPL `.vars` handler uses `interpreter.global_env` (was incorrectly using `interpreter.env`)
+
+### Fixed
+- **Security: Removed `shell=True`** from `_exec()` and `_exec_output()` in `epl/stdlib.py` — Eliminates command injection vulnerability. Now raises `EPLRuntimeError` on invalid commands.
+- REPL `.vars` crash — was accessing non-existent `interpreter.env` attribute
+- `median()` in native math module — was using float division result as list index (now uses `floor()`)
+- Module constants accessible via both `Module::CONST` and `Module.CONST` syntax
+- F-string syntax compatibility (Python < 3.12) in `_list_modules()`
+
+---
+
+## [4.1.0] — 2025
+
+### Added
+
+#### Pluggable Store & Session Backends
+- `epl/store_backends.py` — Abstract `StoreBackend` and `SessionBackend` interfaces
+- `MemoryStoreBackend` / `MemorySessionBackend` — In-process (default, fast)
+- `SQLiteStoreBackend` / `SQLiteSessionBackend` — File-based, survives restarts
+- `RedisStoreBackend` / `RedisSessionBackend` — Shared across workers + restarts
+- `configure_backends(store='memory', session='memory', **kwargs)` API
+- CLI flags: `--store memory|sqlite|redis`, `--session memory|sqlite|redis`
+
+#### Production Server (`serve` command)
+- `python main.py serve <file.epl>` — Cross-platform production server
+- Waitress on Windows, Gunicorn on Linux/macOS, wsgiref fallback
+- `--port`, `--workers`, `--reload` flags
+- `serve()` function in `epl/deploy.py`
+
+#### Hot Reload
+- `epl/hot_reload.py` — File watcher + auto-restart for development
+- `--reload` flag on `serve` command
+- Polling-based (no external dependencies)
+
+#### ASGI WebSocket Support
+- `ASGIAdapter` now handles `websocket` scope type
+- `_ASGIWebSocket` class with accept/send/receive/close
+- Dict-based and simple handler patterns
+
+#### Python Callable Route Handlers
+- Routes can return `'callable'` type with a Python function
+- Works across `EPLHandler`, `AsyncEPLServer`, `WSGIAdapter`
+
+#### Advanced Template Engine
+- 30 template filters: upper, lower, title, capitalize, strip, length, reverse, first, last, sort, join, truncate, default, replace, date, url_encode, nl2br, json, abs, int, float, round, safe, wordcount, striptags, batch, slice, unique, shuffle, dictsort
+- Filter chaining: `{{ name|upper|truncate:10 }}`
+- `{% set var = expr %}` tag
+- Ternary expressions: `{{ x if condition else y }}`
+
+### Changed
+- Health check now returns dynamic version from `epl/__init__.py`
+- `_data_store` proxy properly delegates `clear()`, `pop()`, `items()` to backends
+- VS Code extension updated to v4.1.0 with EPL web/English keyword highlighting
+- `startWebServer` command now uses `python main.py serve`
+- `requirements.txt` and `pyproject.toml` list `waitress` and `redis` as optional deps
+
+### Fixed
+- `_StoreProxy.clear()` and `pop()` were no-ops (inherited from `dict`)
+- `_StoreProxy.items()` always returned empty list (missing `all_collections()`)
+- Gunicorn multi-worker mode: `_gunicorn_app` was `None` in forked workers
+
+---
+
+## [4.0.0] — 2025
+
+### Added
+
+#### LLVM Native Compiler
+- Compile EPL programs to native executables via `python main.py compile <file.epl>`
+- Support for integers, floats, strings, print, conditionals, loops, functions
+- LLVM IR inspection via `python main.py ir <file.epl>`
+- 26 compiler tests
+
+#### Kotlin/Android Transpiler
+- Transpile EPL to Kotlin via `python main.py kotlin <file.epl>`
+- Full Android project generation via `python main.py android <file.epl>`
+- Jetpack Compose UI mapping for GUI and web nodes
+- Type inference via SymbolTable across scopes
+- Sealed classes for enums, data classes, generics
+- 30 transpiler tests
+
+#### Bytecode Virtual Machine
+- Stack-based bytecode VM with 68 opcodes
+- 10-50x faster than tree-walking interpretation
+- Peephole optimizer with instruction reindexing
+- Dead code elimination
+- Comparison constant folding
+- Dict-based builtin dispatch (O(1) lookup)
+- 43 VM tests
+
+#### Package Manager v3.0
+- SemVer class with full parsing, comparison, caret/tilde compatibility
+- Version range parsing: exact, ^, ~, >=, <=, >, <, !=, compound, wildcard
+- Transitive dependency resolution via BFS
+- Dependency conflict detection with clear error messages
+- Lockfile v2 with integrity hashes and required_by tracking
+- Frozen install from lockfile
+- Package validation (name format, semver, description, entry point)
+- Pack command (zip + SHA256 checksum)
+- Publish workflow (validate → pack → install → register)
+- Update and update-all commands
+- 91 package manager tests
+
+#### Stability Improvements
+- Short-circuit evaluation for `and`/`or` operators
+- Clean error for `max()`/`min()` on empty lists
+- Type checking for `sum()`, `sorted()`, `round()`, `sqrt()`, `log()`
+- Overflow protection for `**` with exponent > 10000
+- Negative repeat count protection
+- `reduce()` on empty list without initial value raises clean error
+- 42 stability tests
+
+#### Documentation
+- `docs/language-reference.md` — Complete syntax and built-in reference
+- `docs/tutorials.md` — 11 step-by-step tutorials
+- `docs/architecture.md` — Technical system overview
+- `docs/package-manager.md` — Package management guide
+
+#### Adoption Infrastructure
+- `CONTRIBUTING.md` — Contributor guide
+- `CHANGELOG.md` — Version history
+- `CODE_OF_CONDUCT.md` — Community guidelines
+- `.github/ISSUE_TEMPLATE/` — Bug report and feature request templates
+
+### Changed
+- Test count: 299 → 547+ (7 test suites)
+- README updated with documentation links and current statistics
+
+---
+
+## [3.0.0] — 2024
+
+### Added
+- Web framework with routing, sessions, WebSocket support
+- GUI toolkit (tkinter-based): windows, widgets, canvas, events, menus
+- Package manager with init, install, uninstall, list
+- Database ORM with Store/Fetch/Delete
+- Debugger with breakpoints, stepping, watch expressions
+- LSP server for editor integration
+- Testing framework (Assert, AssertEqual, AssertThrows)
+- AI assistant for code generation and explanation
+- Static type system with optional annotations
+- WSGI/ASGI server support
+- Profiler with DAP debugging
+- Async I/O support
+- JavaScript transpiler (browser + Node.js targets)
+- Standard library: 311 functions across 20+ modules
+- 36 built-in packages
+
+### Added (Language Features)
+- Augmented assignment (`+=`, `-=`, `*=`, `/=`)
+- Ternary expressions (`x If condition Otherwise y`)
+- Enums and enum access
+- Match/When pattern matching
+- Super calls in class inheritance
+- Try/Catch/Finally
+- Module definitions and exports
+- Interfaces and implements clauses
+- Generics, abstract methods, static methods
+- Yield, destructuring, spread expressions
+- Chained comparisons
+- Lambda expressions and higher-order functions
+
+---
+
+## [2.0.0] — 2024
+
+### Added
+- Classes and inheritance
+- File I/O (read, write, append)
+- Error handling (Try/Catch/Throw)
+- Imports and module system
+- Break/Continue in loops
+- ForRange loops with step
+- Maps/dictionaries
+- Index access and assignment
+- Slice access for lists and strings
+
+---
+
+## [1.0.0] — 2024
+
+### Added
+- Core language: variables, functions, conditionals, loops
+- Data types: integers, decimals, text, booleans, nothing, lists
+- Print/Input (Say/Ask)
+- Repeat/While/ForEach loops
+- User-defined functions with parameters and return values
+- Binary and unary operators
+- String concatenation and interpolation
+- Comments via `Note:`

eplang-7.0.0/CONTRIBUTING.md

@@ -0,0 +1,151 @@
+# Contributing to EPL
+
+Thank you for your interest in contributing to EPL! This guide will help you get started.
+
+## Getting Started
+
+### Prerequisites
+
+- Python 3.11+
+- Git
+
+### Setup
+
+```bash
+git clone https://github.com/your-org/epl.git
+cd epl
+pip install -r requirements.txt
+```
+
+### Running Tests
+
+```bash
+# Core regression tests (271 tests)
+python -m pytest tests/test_epl.py -v
+
+# v4 feature tests (44 tests)
+python tests/run_tests.py
+
+# LLVM compiler tests (26 tests)
+python -m pytest tests/test_llvm.py -v
+
+# Kotlin transpiler tests (30 tests)
+python -m pytest tests/test_kotlin.py -v
+
+# Bytecode VM tests (43 tests)
+python -m pytest tests/test_vm.py -v
+
+# Package manager tests (91 tests)
+python -m pytest tests/test_package_manager.py -v
+
+# Stability tests (42 tests)
+python -m pytest tests/test_stability.py -v
+
+# Run everything
+python -m pytest tests/ -v && python tests/run_tests.py
+```
+
+All 547+ tests must pass before submitting a PR.
+
+## How to Contribute
+
+### Reporting Bugs
+
+1. Check existing issues to avoid duplicates
+2. Include:
+   - EPL version (`python main.py --version`)
+   - Python version
+   - OS
+   - Minimal `.epl` file that reproduces the bug
+   - Expected vs actual behavior
+   - Full error traceback
+
+### Suggesting Features
+
+Open an issue with:
+- A clear description of the feature
+- Example EPL code showing the proposed syntax
+- Rationale — why this improves the language
+
+### Submitting Code
+
+1. Fork the repository
+2. Create a feature branch: `git checkout -b feature/my-feature`
+3. Make your changes
+4. Add tests for any new functionality
+5. Ensure all tests pass
+6. Submit a pull request
+
+## Code Guidelines
+
+### Project Structure
+
+- `epl/` — All EPL modules (lexer, parser, interpreter, compiler, etc.)
+- `tests/` — Test suites (pytest-based)
+- `examples/` — Example EPL programs
+- `docs/` — Documentation
+
+### Style
+
+- Follow existing code style in each file
+- Use type hints for function signatures
+- Keep functions focused — one responsibility per function
+- Use descriptive variable names
+
+### Commit Messages
+
+Use clear, descriptive commit messages:
+
+```
+Add support for pattern matching in VM backend
+
+- Implement MATCH/WHEN opcodes in bytecode compiler
+- Add VM dispatch for match/case evaluation
+- Add 5 tests for pattern matching
+```
+
+### Testing Requirements
+
+- Every new feature must have tests
+- Bug fixes should include a regression test
+- Tests go in the appropriate suite:
+  - Interpreter features → `tests/test_epl.py`
+  - VM features → `tests/test_vm.py`
+  - Compiler features → `tests/test_llvm.py`
+  - Package manager → `tests/test_package_manager.py`
+  - Edge cases / stability → `tests/test_stability.py`
+
+### Adding a New Built-in Function
+
+1. Add the implementation in `epl/interpreter.py` inside `_call_builtin()`
+2. Add VM support in `epl/vm.py` inside `_exec_call_builtin()`
+3. Add compiler support in `epl/compiler.py` if applicable
+4. Add stdlib documentation in `epl/stdlib.py`
+5. Add tests in the appropriate test file
+6. Update `docs/language-reference.md`
+
+### Adding a New AST Node
+
+1. Define the node class in `epl/ast_nodes.py`
+2. Add parsing in `epl/parser.py`
+3. Add interpretation in `epl/interpreter.py`
+4. Add VM compilation in `epl/vm.py` (BytecodeCompiler + VM)
+5. Add Kotlin transpilation in `epl/kotlin_gen.py` if needed
+6. Add LLVM compilation in `epl/compiler.py` if needed
+7. Add tests covering the new syntax
+
+## Architecture Overview
+
+See [docs/architecture.md](docs/architecture.md) for the full technical overview.
+
+The core pipeline: **Source → Lexer → Parser → AST → Backend**
+
+Backends:
+- **Interpreter** — Tree-walking, full feature support
+- **VM** — Bytecode compilation + stack-based execution (10-50x faster)
+- **LLVM Compiler** — Native executables
+- **Kotlin Transpiler** — Android apps via Jetpack Compose
+
+## License
+
+By contributing, you agree that your contributions will be licensed under the same license as the project.

eplang-7.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 EPL Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

eplang-7.0.0/MANIFEST.in

@@ -0,0 +1,50 @@
+# Include essential project files
+include README.md
+include LICENSE
+include CONTRIBUTING.md
+include CHANGELOG.md
+include pyproject.toml
+
+# Include EPL source files
+recursive-include epl *.py *.epl *.json *.c *.md
+
+# Include stdlib modules
+recursive-include epl/stdlib *.epl *.json
+
+# Include official packages
+recursive-include epl/official_packages *.toml *.md *.epl
+
+# Include templates (but NOT the heavy Android gradle wrapper binaries)
+recursive-include epl/templates *.epl *.md *.xml *.gradle *.properties *.kt
+include epl/templates/android/gradlew
+include epl/templates/android/gradlew.bat
+recursive-include epl/templates/android/gradle *.jar *.properties
+
+# Include examples
+recursive-include examples *.epl *.md
+
+# Exclude compiled Python caches
+global-exclude __pycache__
+global-exclude *.pyc
+global-exclude *.pyo
+global-exclude *.pyd
+
+# Exclude PyInstaller/frozen build artifacts (dist/epl/_internal contains PyTorch etc.)
+prune dist
+prune build
+prune .git
+prune .github
+prune docs
+prune tests
+prune vscode-extension
+prune epl/_internal
+
+# Exclude large model/binary files
+global-exclude *.exe
+global-exclude *.dll
+global-exclude *.so
+global-exclude *.dylib
+global-exclude *.whl
+global-exclude *.zip
+global-exclude *.tar.gz
+global-exclude Modelfile