datacurrent 1.0.1__tar.gz → 1.0.2__tar.gz

{datacurrent-1.0.1 → datacurrent-1.0.2}/CHANGELOG.md

@@ -4,6 +4,23 @@ All notable changes to DataCurrent are documented here. The format follows
 [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and the project uses
 [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.0.2] — 2026-11-13
+
+Automation and packaging release. The public API is unchanged.
+
+### Added
+
+- GitHub Actions CI (`.github/workflows/ci.yml`) running `ruff`, `mypy` and the
+  coverage-enforcing test suite on Python 3.11 through 3.14 for every push and
+  pull request.
+
+### Fixed
+
+- The source distribution ships `CONTRIBUTING.md`; the manifest entry was added
+  after the 1.0.1 build.
+- The release workflow now skips the PyPI upload when the version is already
+  published, instead of failing on a duplicate file.
+
 ## [1.0.1] — 2026-11-13
 
 Documentation, metadata and packaging release. The public API is unchanged.

datacurrent-1.0.2/CONTRIBUTING.md

@@ -0,0 +1,137 @@
+# Contributing to DataCurrent
+
+Thanks for helping improve DataCurrent. This guide covers setup, the checks your
+change must pass, and how releases are published.
+
+- Repository: <https://github.com/CoderProandTester/datacurrent>
+- Issues: <https://github.com/CoderProandTester/datacurrent/issues>
+- PyPI: <https://pypi.org/project/datacurrent/>
+
+## Development setup
+
+Python 3.11 or newer is required.
+
+```bash
+git clone https://github.com/CoderProandTester/datacurrent.git
+cd datacurrent
+python -m venv .venv
+```
+
+Activate the environment, then install the package with the development extras:
+
+```bash
+# Windows (Git Bash)
+source .venv/Scripts/activate
+# macOS / Linux
+source .venv/bin/activate
+
+python -m pip install --upgrade pip
+python -m pip install -e ".[dev]"
+```
+
+`dev` pulls in `pytest`, `pytest-asyncio`, `pytest-cov`, `hypothesis`, `build`,
+`twine`, `ruff` and `mypy`.
+
+## Before you change anything
+
+```bash
+python scripts/dev.py check    # ruff + mypy
+python scripts/dev.py test     # full test suite
+```
+
+`scripts/dev.py` runs every command with the interpreter that launched it, so it
+always uses the active virtual environment. `python scripts/dev.py --help`
+lists all tasks.
+
+## Layout
+
+| Path | Contents |
+|---|---|
+| `datacurrent/core/` | `Stream`, operators, pipelines, terminals |
+| `datacurrent/buffering/` | `BoundedQueue`, backpressure policies |
+| `datacurrent/concurrency/` | `ConcurrencyLimiter`, task tracking, `gather_limited` |
+| `datacurrent/reliability/` | retries, timeouts |
+| `datacurrent/transports/` | HTTP, SSE, WebSocket and the transport base |
+| `datacurrent/events/` | `Channel`, `EventBus`, routing |
+| `datacurrent/integrations/` | FastAPI and Starlette helpers |
+| `datacurrent/observability/` | metrics, stats, structured logging |
+| `docs/` | guides and the API reference |
+| `examples/` | sixteen runnable, test-covered scripts |
+| `tests/` | unit, property-based, stress and packaging tests |
+| `benchmarks/` | reproducible micro-benchmarks |
+
+## Making a change
+
+1. Keep the public API in `datacurrent/__init__.py` and `__all__` in sync when
+   you add or remove an export.
+2. Preserve the existing guarantees: laziness, single consumption, bounded
+   buffers that block by default, counted drops, and cancellation-safe cleanup.
+3. New behaviour needs tests. The project enforces **100% line and branch
+   coverage**, so aim for that before you open a pull request.
+4. Add an example when you add a user-facing feature, and list it in the README
+   examples table. Examples must define `async def main()` and run in under 30
+   seconds; `tests/unit/test_examples.py` executes every file that does not start
+   with `_`.
+5. Update `CHANGELOG.md` under an "Unreleased" or new version heading. The format
+   follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and versions
+   follow [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## Checks
+
+```bash
+python scripts/dev.py lint                  # ruff check .
+python scripts/dev.py fmt                   # ruff format .
+python scripts/dev.py typecheck             # mypy
+python scripts/dev.py cov                   # pytest with coverage (must be 100%)
+python scripts/dev.py examples              # just the example scripts
+python scripts/dev.py build                 # sdist + wheel
+python scripts/dev.py check-dist            # twine check dist/*
+```
+
+A change is ready when `lint`, `typecheck` and `cov` all pass. Please do not
+weaken assertions, skip tests or add suppressions to get a green run; fix the
+cause instead.
+
+## Style
+
+- `ruff` with a 100-character line length, targeting Python 3.11 syntax.
+- Full type annotations on public functions; the package ships `py.typed`.
+- Async-first: no blocking I/O on the event loop.
+- Prefer editing existing modules over adding new ones.
+- Comments explain why, not what.
+
+## Reporting a bug
+
+Open an issue at <https://github.com/CoderProandTester/datacurrent/issues> with
+the version (`python -c "import datacurrent; print(datacurrent.__version__)"`),
+your Python version and platform, a minimal reproduction, and what you expected
+instead. Security issues should be reported privately rather than in a public
+issue.
+
+## Release process
+
+Versions are read from `datacurrent/_version.py`; that file is the single source
+of truth. Releases are normally published by GitHub Actions with PyPI trusted
+publishing, so the upload carries a signed provenance attestation.
+
+```bash
+# 1. Bump the version and document it
+#    datacurrent/_version.py -> __version__ = "1.0.2"
+#    CHANGELOG.md -> new heading with the date
+
+# 2. Verify everything
+python scripts/dev.py release      # lint, mypy, tests, build, twine check
+
+# 3. Publish
+#    Preferred: GitHub Release -> the release workflow uploads to PyPI
+#    Fallback: twine upload dist/*
+```
+
+Set `TWINE_USERNAME=__token__` and `TWINE_PASSWORD=<PyPI API token>` (or use
+`~/.pypirc`) for the manual path. PyPI rejects re-uploads of an existing version,
+so a failed upload always needs a new version number.
+
+## License
+
+By contributing you agree that your contributions are licensed under the MIT
+license in `LICENSE`.

{datacurrent-1.0.1 → datacurrent-1.0.2}/MANIFEST.in

@@ -1,6 +1,7 @@
 include README.md
 include LICENSE
 include CHANGELOG.md
+include CONTRIBUTING.md
 include MANIFEST.in
 recursive-include datacurrent *.py py.typed
 prune tests

{datacurrent-1.0.1/datacurrent.egg-info → datacurrent-1.0.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: datacurrent
-Version: 1.0.1
+Version: 1.0.2
 Summary: Python streaming, made simple: async streams, operators, backpressure and real-time transports.
 Author: DataCurrent contributors
 License: MIT
@@ -57,7 +57,7 @@ DataCurrent is a production-ready asynchronous streaming library. It gives you
 one consistent API for lists, async generators, queues, WebSockets, Server-Sent
 Events and streaming HTTP responses.
 
-**Version 1.0.1 · Stable / Production**
+**Version 1.0.2 · Stable / Production**
 
 [![PyPI version](https://img.shields.io/pypi/v/datacurrent.svg)](https://pypi.org/project/datacurrent/)
 [![Python versions](https://img.shields.io/pypi/pyversions/datacurrent.svg)](https://pypi.org/project/datacurrent/)

{datacurrent-1.0.1 → datacurrent-1.0.2}/README.md

@@ -6,7 +6,7 @@ DataCurrent is a production-ready asynchronous streaming library. It gives you
 one consistent API for lists, async generators, queues, WebSockets, Server-Sent
 Events and streaming HTTP responses.
 
-**Version 1.0.1 · Stable / Production**
+**Version 1.0.2 · Stable / Production**
 
 [![PyPI version](https://img.shields.io/pypi/v/datacurrent.svg)](https://pypi.org/project/datacurrent/)
 [![Python versions](https://img.shields.io/pypi/pyversions/datacurrent.svg)](https://pypi.org/project/datacurrent/)

{datacurrent-1.0.1 → datacurrent-1.0.2}/datacurrent/_version.py

@@ -2,5 +2,5 @@
 
 from __future__ import annotations
 
-__version__ = "1.0.1"
+__version__ = "1.0.2"
 VERSION = tuple(int(part) for part in __version__.split("."))

{datacurrent-1.0.1 → datacurrent-1.0.2/datacurrent.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: datacurrent
-Version: 1.0.1
+Version: 1.0.2
 Summary: Python streaming, made simple: async streams, operators, backpressure and real-time transports.
 Author: DataCurrent contributors
 License: MIT
@@ -57,7 +57,7 @@ DataCurrent is a production-ready asynchronous streaming library. It gives you
 one consistent API for lists, async generators, queues, WebSockets, Server-Sent
 Events and streaming HTTP responses.
 
-**Version 1.0.1 · Stable / Production**
+**Version 1.0.2 · Stable / Production**
 
 [![PyPI version](https://img.shields.io/pypi/v/datacurrent.svg)](https://pypi.org/project/datacurrent/)
 [![Python versions](https://img.shields.io/pypi/pyversions/datacurrent.svg)](https://pypi.org/project/datacurrent/)

{datacurrent-1.0.1 → datacurrent-1.0.2}/datacurrent.egg-info/SOURCES.txt

@@ -1,4 +1,5 @@
 CHANGELOG.md
+CONTRIBUTING.md
 LICENSE
 MANIFEST.in
 README.md