flexfloat 0.1.0__py3-none-any.whl → 0.1.2__py3-none-any.whl

flexfloat/types.py

@@ -1,5 +1,5 @@
-"""Type definitions for the flexfloat package."""
-
-from typing import TypeAlias
-
-Number: TypeAlias = int | float
+"""Type definitions for the flexfloat package."""
+
+from typing import TypeAlias
+
+Number: TypeAlias = int | float

{flexfloat-0.1.0.dist-info → flexfloat-0.1.2.dist-info}/METADATA

@@ -1,82 +1,147 @@
-Metadata-Version: 2.4
-Name: flexfloat
-Version: 0.1.0
-Summary: A library for arbitrary precision floating point arithmetic
-Author: Ferran Sanchez Llado
-License: MIT
-Classifier: Development Status :: 3 - Alpha
-Classifier: Intended Audience :: Developers
-Classifier: Intended Audience :: Science/Research
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Topic :: Scientific/Engineering :: Mathematics
-Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Requires-Python: >=3.11
-Description-Content-Type: text/markdown
-Provides-Extra: dev
-Requires-Dist: pytest>=7.0; extra == "dev"
-Requires-Dist: pytest-cov>=4.0; extra == "dev"
-Requires-Dist: black>=23.0; extra == "dev"
-Requires-Dist: isort>=5.0; extra == "dev"
-Requires-Dist: mypy>=1.0; extra == "dev"
-Requires-Dist: pylint>=3.0; extra == "dev"
-Requires-Dist: flake8>=6.0; extra == "dev"
-
-# FlexFloat
-
-A Python library for arbitrary precision floating point arithmetic with a flexible exponent and fixed-size fraction.
-
-## Features
-
-- **Growable Exponents**: Handle very large or very small numbers by dynamically adjusting the exponent size
-- **Fixed-Size Fractions**: Maintain precision consistency with IEEE 754-compatible 52-bit fractions  
-- **IEEE 754 Compatibility**: Follows IEEE 754 double-precision format as the baseline
-- **Special Value Support**: Handles NaN, positive/negative infinity, and zero values
-- **Arithmetic Operations**: Addition and subtraction with proper overflow/underflow handling
-
-## Installation
-
-```bash
-pip install flexfloat
-```
-
-## Development Installation
-
-```bash
-pip install -e ".[dev]"
-```
-
-## Usage
-
-```python
-from flexfloat import FlexFloat
-
-# Create FlexFloat instances
-a = FlexFloat.from_float(1.5)
-b = FlexFloat.from_float(2.5)
-
-# Perform arithmetic operations
-result = a + b
-print(result.to_float())  # 4.0
-
-# Handle very large numbers
-large_a = FlexFloat.from_float(1e308)
-large_b = FlexFloat.from_float(1e308)
-large_result = large_a + large_b
-# Result has grown exponent to handle overflow
-print(len(large_result.exponent))  # > 11 (grows beyond IEEE 754 standard)
-```
-
-## Running Tests
-
-```bash
-python -m pytest tests
-```
-
-
-## License
-
-MIT License
+Metadata-Version: 2.4
+Name: flexfloat
+Version: 0.1.2
+Summary: A library for arbitrary precision floating point arithmetic
+Author: Ferran Sanchez Llado
+License: MIT
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Mathematics
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0; extra == "dev"
+Requires-Dist: black>=23.0; extra == "dev"
+Requires-Dist: isort>=5.0; extra == "dev"
+Requires-Dist: mypy>=1.0; extra == "dev"
+Requires-Dist: pylint>=3.0; extra == "dev"
+Requires-Dist: flake8>=6.0; extra == "dev"
+Requires-Dist: bump2version>=1.0; extra == "dev"
+Requires-Dist: build>=0.10; extra == "dev"
+Requires-Dist: twine>=4.0; extra == "dev"
+Requires-Dist: check-manifest>=0.49; extra == "dev"
+Requires-Dist: PyYAML>=6.0; extra == "dev"
+Dynamic: license-file
+
+# FlexFloat
+
+A Python library for arbitrary precision floating point arithmetic with a flexible exponent and fixed-size fraction.
+
+## Features
+
+- **Growable Exponents**: Handle very large or very small numbers by dynamically adjusting the exponent size
+- **Fixed-Size Fractions**: Maintain precision consistency with IEEE 754-compatible 52-bit fractions  
+- **IEEE 754 Compatibility**: Follows IEEE 754 double-precision format as the baseline
+- **Special Value Support**: Handles NaN, positive/negative infinity, and zero values
+- **Arithmetic Operations**: Addition and subtraction with proper overflow/underflow handling
+
+## Installation
+
+```bash
+pip install flexfloat
+```
+
+## Development Installation
+
+```bash
+pip install -e ".[dev]"
+```
+
+## Usage
+
+```python
+from flexfloat import FlexFloat
+
+# Create FlexFloat instances
+a = FlexFloat.from_float(1.5)
+b = FlexFloat.from_float(2.5)
+
+# Perform arithmetic operations
+result = a + b
+print(result.to_float())  # 4.0
+
+# Handle very large numbers
+large_a = FlexFloat.from_float(1e308)
+large_b = FlexFloat.from_float(1e308)
+large_result = large_a + large_b
+# Result has grown exponent to handle overflow
+print(len(large_result.exponent))  # > 11 (grows beyond IEEE 754 standard)
+```
+
+## Running Tests
+
+```bash
+python -m pytest tests
+```
+
+## CI/CD and Release Process
+
+This project uses automated CI/CD workflows for building, testing, and releasing:
+
+### Automatic Releases
+
+When a Pull Request is merged to the `main` branch:
+
+1. **Version Detection**: The system analyzes commit messages and PR labels to determine the version bump type:
+   - `major`: Breaking changes (e.g., commit messages with "BREAKING CHANGE")
+   - `minor`: New features (e.g., commit messages starting with "feat:")
+   - `patch`: Bug fixes and other changes (default)
+
+2. **Version Update**: All version references are automatically updated:
+   - `pyproject.toml`
+   - `flexfloat/__init__.py`
+
+3. **Automated Publishing**:
+   - Package is built and tested
+   - New Git tag is created (e.g., `v0.2.0`)
+   - GitHub Release is created with artifacts
+   - Package is published to PyPI
+
+### Manual Releases
+
+You can also trigger releases manually:
+
+1. Go to the "Actions" tab in GitHub
+2. Select "Manual Release" workflow
+3. Choose the version bump type and add release notes
+4. Run the workflow
+
+### Version Bump Labels
+
+Add these labels to your PRs to control version bumping:
+- `major` - For breaking changes
+- `minor` - For new features  
+- `patch` - For bug fixes (default)
+
+### PyPI Setup
+
+To enable automatic PyPI publishing, configure trusted publishing:
+
+1. Go to [PyPI](https://pypi.org/manage/account/publishing/)
+2. Add a trusted publisher for your GitHub repository
+3. Set the workflow name to `release.yml` or `manual-release.yml`
+
+### Development Workflow
+
+1. Create a feature branch from `main`
+2. Make your changes
+3. Create a Pull Request
+4. The CI will automatically:
+   - Run tests and linting
+   - Check version consistency
+   - Suggest version bump type
+   - Build and validate the package
+5. When merged, automatic release is triggered
+
+## License
+
+MIT License

flexfloat-0.1.2.dist-info/RECORD

@@ -0,0 +1,10 @@
+flexfloat/__init__.py,sha256=OFbzrKWdmpnX85VTA37dOj1pcNdn4IOUx45u-RUg4ls,365
+flexfloat/bitarray.py,sha256=HbManwfCgoAB3YDSeBWq7QnX64L03A4i5g6UU_wOeoo,8939
+flexfloat/core.py,sha256=z1W4Ma4ftAnSTICvrNiMNaGHJVVqv9tf5BmwiXSl1qU,28043
+flexfloat/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+flexfloat/types.py,sha256=_vRC7gQl5ua76QfKco4L3jQ4uPtEPUxPNGy4zWBFbns,113
+flexfloat-0.1.2.dist-info/licenses/LICENSE,sha256=uwwkK--SUYUV3lbrv9kXJ_vDiYfHVb-t732g6c4qg7Q,1077
+flexfloat-0.1.2.dist-info/METADATA,sha256=fJt-FNO9BBmdROleg1zSnsrTaAA1oYPsPyt6LOV4m7o,4441
+flexfloat-0.1.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+flexfloat-0.1.2.dist-info/top_level.txt,sha256=82S8dY2UoNZh-9pwg7tUvbwB3uw2s3mfEoyUW6vCMdU,10
+flexfloat-0.1.2.dist-info/RECORD,,

flexfloat-0.1.2.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Ferran Sanchez Llado
+
+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.

flexfloat-0.1.0.dist-info/RECORD

@@ -1,9 +0,0 @@
-flexfloat/__init__.py,sha256=fvimTZm80CHm8bp11bID5twYoISERcatgx21snQxsz8,378
-flexfloat/bitarray.py,sha256=Ss0bZUUpfsBPJkPaGymXd2O-4e-UCanUva_encnc4MI,9172
-flexfloat/core.py,sha256=KK8LfRlqReZuVgyN-fQwYDsM1TlaJtYjHcafPYSPZeQ,27570
-flexfloat/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-flexfloat/types.py,sha256=SFTYmG3BHLiCJc0LvNwOnByRLRcRXH2erINeqLyHLKs,118
-flexfloat-0.1.0.dist-info/METADATA,sha256=8QUYOP_vFgljckHUm02jixPFfDYkt-XZdW5Wahm8TbQ,2459
-flexfloat-0.1.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-flexfloat-0.1.0.dist-info/top_level.txt,sha256=82S8dY2UoNZh-9pwg7tUvbwB3uw2s3mfEoyUW6vCMdU,10
-flexfloat-0.1.0.dist-info/RECORD,,