formatparse 0.5.1__cp310-cp310-manylinux_2_28_x86_64.whl

_formatparse/__init__.py

@@ -0,0 +1,5 @@
+from ._formatparse import *
+
+__doc__ = _formatparse.__doc__
+if hasattr(_formatparse, "__all__"):
+    __all__ = _formatparse.__all__

formatparse-0.5.1.dist-info/METADATA

@@ -0,0 +1,156 @@
+Metadata-Version: 2.4
+Name: formatparse
+Version: 0.5.1
+Classifier: Programming Language :: Rust
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Requires-Dist: hypothesis>=6.0 ; extra == 'test'
+Requires-Dist: pytest-cov>=4.0 ; extra == 'test'
+Requires-Dist: pytest-benchmark>=4.0 ; extra == 'test'
+Requires-Dist: pympler>=0.9 ; extra == 'test'
+Requires-Dist: memory-profiler>=0.60 ; extra == 'test'
+Requires-Dist: mutmut>=2.0 ; extra == 'dev'
+Provides-Extra: test
+Provides-Extra: dev
+License-File: LICENSE
+Summary: Parse strings using a specification based on the Python format() syntax (Rust implementation)
+Keywords: parse,format,string,parsing
+Author-email: Odos Matthews <odosmatthews@gmail.com>
+License: MIT
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
+Project-URL: Homepage, https://github.com/eddiethedean/formatparse
+Project-URL: Repository, https://github.com/eddiethedean/formatparse
+
+# formatparse
+
+[![PyPI version](https://badge.fury.io/py/formatparse.svg)](https://badge.fury.io/py/formatparse)
+[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Rust](https://img.shields.io/badge/rust-1.70+-orange.svg)](https://www.rust-lang.org/)
+[![Documentation](https://readthedocs.org/projects/formatparse/badge/?version=latest)](https://formatparse.readthedocs.io/)
+
+A high-performance, Rust-backed implementation of the [parse](https://github.com/r1chardj0n3s/parse) library for Python. `formatparse` provides the same API as the original `parse` library but with **significant performance improvements** (up to **80x faster**) thanks to Rust's zero-cost abstractions and optimized regex engine.
+
+## 📖 Documentation
+
+**Full documentation is available at [https://formatparse.readthedocs.io/](https://formatparse.readthedocs.io/)**
+
+The documentation includes:
+- **Getting Started Guide** - Quick introduction and basic usage
+- **User Guides** - Comprehensive guides on patterns, datetime parsing, custom types, and bidirectional patterns
+- **API Reference** - Complete API documentation for all functions and classes
+- **Examples & Cookbook** - Practical examples and common use cases
+
+## Features
+
+- 🚀 **Blazing Fast**: Up to 80x faster than the original Python implementation
+- 🔄 **Drop-in Replacement**: Compatible API with the original `parse` library
+- 🎯 **Type-Safe**: Rust backend ensures reliability and correctness
+- 🔍 **Advanced Pattern Matching**: Support for named fields, positional fields, and custom types
+- 📅 **DateTime Parsing**: Built-in support for various datetime formats (ISO 8601, RFC 2822, HTTP dates, etc.)
+- 🎨 **Flexible**: Case-sensitive and case-insensitive matching options
+- 💾 **Optimized**: Pattern caching, lazy evaluation, and batch operations for maximum performance
+
+## Installation
+
+### From PyPI
+
+```bash
+pip install formatparse
+```
+
+### From Source
+
+```bash
+# Clone the repository
+git clone https://github.com/eddiethedean/formatparse.git
+cd formatparse
+
+# Install maturin (build tool)
+pip install maturin
+
+# Build and install in development mode
+maturin develop --manifest-path formatparse-pyo3/Cargo.toml --release
+```
+
+## Quick Start
+
+```python
+from formatparse import parse, search, findall
+
+# Basic parsing with named fields
+result = parse("{name}: {age:d}", "Alice: 30")
+print(result.named['name'])  # 'Alice'
+print(result.named['age'])   # 30
+
+# Search for patterns in text
+result = search("age: {age:d}", "Name: Alice, age: 30, City: NYC")
+if result:
+    print(result.named['age'])  # 30
+
+# Find all matches
+results = findall("ID:{id:d}", "ID:1 ID:2 ID:3")
+for result in results:
+    print(result.named['id'])
+# Output: 1, 2, 3
+```
+
+For more examples and detailed usage, see the [documentation](https://formatparse.readthedocs.io/).
+
+## Performance
+
+formatparse is significantly faster than the original Python `parse` library, with speedups ranging from **3x to 80x** depending on the use case. The Rust backend provides:
+
+- Pattern caching to eliminate regex compilation overhead
+- Optimized type conversion paths for common types
+- Efficient memory management with pre-allocated data structures
+- Reduced Python GIL overhead through batched operations
+
+For detailed benchmark results and performance analysis, see the [documentation](https://formatparse.readthedocs.io/).
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+1. Fork the repository
+2. Create your feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit your changes (`git commit -m 'Add some amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing-feature`)
+5. Open a Pull Request
+
+For detailed contribution guidelines, including testing requirements and development setup, see [CONTRIBUTING.md](CONTRIBUTING.md).
+
+## Testing
+
+The project includes comprehensive test coverage:
+
+- **Unit Tests**: ~436 Python tests + 50 Rust tests
+- **Property-Based Tests**: 32 Hypothesis-based tests
+- **Performance Benchmarks**: Automated regression testing
+- **Stress Tests**: Large input and scalability testing
+- **Fuzz Tests**: Crash-free input testing
+- **Coverage**: >90% code coverage target
+
+Run tests with:
+```bash
+# All tests
+pytest tests/
+
+# With coverage
+pytest tests/ --cov=formatparse --cov-report=html
+
+# Benchmarks
+pytest tests/test_performance.py --benchmark-only
+```
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for more testing information.
+
+## License
+
+MIT License - see [LICENSE](LICENSE) file for details
+
+## Credits
+
+Based on the [parse](https://github.com/r1chardj0n3s/parse) library by Richard Jones.
+

formatparse-0.5.1.dist-info/RECORD

@@ -0,0 +1,6 @@
+_formatparse/__init__.py,sha256=zd2laF10JI9oyBQyTHX10eP4AFaRbhKYr2o_d2yRlAA,131
+_formatparse/_formatparse.cpython-310-x86_64-linux-gnu.so,sha256=pr3iQoJgSfV9-vDu6IN1E0bFHahZrZViCA2KJXmH874,2853360
+formatparse-0.5.1.dist-info/METADATA,sha256=UlSW1qo2Wg0A0EmC1MVl9OxZd7Bi5wcWrwe4b19C5hI,5820
+formatparse-0.5.1.dist-info/WHEEL,sha256=ic5tDgU_G5rT7StWm6RiS5Up5wV4RhurQV82NllAXnE,109
+formatparse-0.5.1.dist-info/licenses/LICENSE,sha256=7d2e2UstJQ5UphPnHa3djO30rYc3Q92LascNZuSM4J0,1071
+formatparse-0.5.1.dist-info/RECORD,,

formatparse-0.5.1.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: maturin (1.10.2)
+Root-Is-Purelib: false
+Tag: cp310-cp310-manylinux_2_28_x86_64

formatparse-0.5.1.dist-info/licenses/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2024 Odos Matthews
+
+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.
+