bashe 0.1.1__tar.gz

bashe-0.1.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ssrtw
+
+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.

bashe-0.1.1/PKG-INFO

@@ -0,0 +1,105 @@
+Metadata-Version: 2.4
+Name: bashe
+Version: 0.1.1
+Summary: A Tree-sitter based PHP parser for Python, featuring compatibility with phply.
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: tree-sitter>=0.25.2
+Requires-Dist: tree-sitter-php>=0.24.1
+Provides-Extra: phply
+Requires-Dist: phply>=1.2.6; extra == "phply"
+Dynamic: license-file
+
+# Bashe
+
+<p align="center">
+  <img src="assets/logo.png" alt="Bashe logo" width="256">
+</p>
+
+[![GitHub release](https://img.shields.io/github/release/ssrtw/bashe/all.svg)](https://github.com/ssrtw/bashe/releases)
+[![license](https://img.shields.io/github/license/ssrtw/bashe.svg)](./LICENSE)
+![python version badge](https://img.shields.io/badge/language-python3.10-orange.svg)
+
+Bashe (巴蛇, pronounced like "parser") is a fast, tree-sitter based PHP
+parser for Python, with optional phply-compatible AST output. The name
+comes from the legendary giant snake in Chinese mythology.
+
+## Features
+
+- Parses PHP source into a structured AST using tree-sitter
+- Supports PHP 7 features: scalar types, return type declarations,
+  null coalescing (`??`), spaceship operator (`<=>`)
+- Supports PHP 8 features: constructor property promotion, named
+  arguments, nullsafe operator (`?->`), match expressions, union types
+- Optional `phply.phpparse`-compatible output — just `pip install bashe[phply]`
+- Minimal dependencies when phply is not needed
+
+## Installation
+
+Python 3.10+ is supported; 3.13+ (with [uv](https://docs.astral.sh/uv/)) is
+recommended for the best experience.
+
+```bash
+# Core parser only (tree-sitter + tree-sitter-php)
+uv pip install bashe
+
+# With phply compatibility layer
+uv pip install bashe[phply]
+```
+
+## Quick Start
+
+```python
+from bashe import Bashe
+
+parser = Bashe()
+ast = parser.parse('<?php echo "hello, world!"; ?>')
+print(ast)
+```
+
+For phply-compatible AST nodes (`phpast.Variable`, `phpast.FunctionCall`, etc.):
+
+```bash
+uv pip install bashe[phply]
+```
+
+```python
+from bashe import Bashe
+
+parser = Bashe()
+nodes = parser.parse(
+    '<?php namespace Foo; class Bar { function baz() { echo __METHOD__; } } ?>',
+    filename="/path/to/file.php",
+)
+# All magic constants (__FILE__, __DIR__, __NAMESPACE__, __CLASS__,
+# __FUNCTION__, __METHOD__, __TRAIT__) are resolved at parse time —
+# no need for resolve_magic_constants().
+```
+
+## Performance
+
+Bashe is approximately **2× faster** than phply's lexer-based parser on
+equivalent inputs.
+
+| Parser | 3.10 (10k) | Ratio (3.10) | 3.13 (10k) | Ratio (3.13) |
+| ------ | ---------- | ------------ | ---------- | ------------ |
+| bashe  | 2.46s      | 1.00×        | 1.73s      | 1.00×        |
+| phply  | 5.76s      | 2.34×        | 3.66s      | 2.12×        |
+
+\_Benchmark: parsing `bench.php` (multi-line PHP with includes, evals,
+function definitions) 10,000 times on CPython 3.10 and 3.13
+
+## Development
+
+```bash
+# Install dev dependencies (pytest, ipykernel, phply)
+uv pip install -e ".[dev]"
+
+# Run tests
+uv run pytest
+```
+
+## License
+
+MIT — see [LICENSE](./LICENSE).

bashe-0.1.1/README.md

@@ -0,0 +1,92 @@
+# Bashe
+
+<p align="center">
+  <img src="assets/logo.png" alt="Bashe logo" width="256">
+</p>
+
+[![GitHub release](https://img.shields.io/github/release/ssrtw/bashe/all.svg)](https://github.com/ssrtw/bashe/releases)
+[![license](https://img.shields.io/github/license/ssrtw/bashe.svg)](./LICENSE)
+![python version badge](https://img.shields.io/badge/language-python3.10-orange.svg)
+
+Bashe (巴蛇, pronounced like "parser") is a fast, tree-sitter based PHP
+parser for Python, with optional phply-compatible AST output. The name
+comes from the legendary giant snake in Chinese mythology.
+
+## Features
+
+- Parses PHP source into a structured AST using tree-sitter
+- Supports PHP 7 features: scalar types, return type declarations,
+  null coalescing (`??`), spaceship operator (`<=>`)
+- Supports PHP 8 features: constructor property promotion, named
+  arguments, nullsafe operator (`?->`), match expressions, union types
+- Optional `phply.phpparse`-compatible output — just `pip install bashe[phply]`
+- Minimal dependencies when phply is not needed
+
+## Installation
+
+Python 3.10+ is supported; 3.13+ (with [uv](https://docs.astral.sh/uv/)) is
+recommended for the best experience.
+
+```bash
+# Core parser only (tree-sitter + tree-sitter-php)
+uv pip install bashe
+
+# With phply compatibility layer
+uv pip install bashe[phply]
+```
+
+## Quick Start
+
+```python
+from bashe import Bashe
+
+parser = Bashe()
+ast = parser.parse('<?php echo "hello, world!"; ?>')
+print(ast)
+```
+
+For phply-compatible AST nodes (`phpast.Variable`, `phpast.FunctionCall`, etc.):
+
+```bash
+uv pip install bashe[phply]
+```
+
+```python
+from bashe import Bashe
+
+parser = Bashe()
+nodes = parser.parse(
+    '<?php namespace Foo; class Bar { function baz() { echo __METHOD__; } } ?>',
+    filename="/path/to/file.php",
+)
+# All magic constants (__FILE__, __DIR__, __NAMESPACE__, __CLASS__,
+# __FUNCTION__, __METHOD__, __TRAIT__) are resolved at parse time —
+# no need for resolve_magic_constants().
+```
+
+## Performance
+
+Bashe is approximately **2× faster** than phply's lexer-based parser on
+equivalent inputs.
+
+| Parser | 3.10 (10k) | Ratio (3.10) | 3.13 (10k) | Ratio (3.13) |
+| ------ | ---------- | ------------ | ---------- | ------------ |
+| bashe  | 2.46s      | 1.00×        | 1.73s      | 1.00×        |
+| phply  | 5.76s      | 2.34×        | 3.66s      | 2.12×        |
+
+\_Benchmark: parsing `bench.php` (multi-line PHP with includes, evals,
+function definitions) 10,000 times on CPython 3.10 and 3.13
+
+## Development
+
+```bash
+# Install dev dependencies (pytest, ipykernel, phply)
+uv pip install -e ".[dev]"
+
+# Run tests
+uv run pytest
+```
+
+## License
+
+MIT — see [LICENSE](./LICENSE).

bashe-0.1.1/bashe/__init__.py

@@ -0,0 +1,3 @@
+from .parser import Bashe, php
+
+__all__ = ["Bashe", "php"]