datacurrent 1.0.0__py3-none-any.whl

datacurrent-1.0.0.dist-info/METADATA

@@ -0,0 +1,250 @@
+Metadata-Version: 2.4
+Name: datacurrent
+Version: 1.0.0
+Summary: Python streaming, made simple: async streams, operators, backpressure and real-time transports.
+Author: DataCurrent contributors
+License: MIT
+Keywords: streaming,async,asyncio,real-time,data pipeline,stream processing,backpressure,reactive,event bus,pubsub,websocket,server-sent events,http streaming,concurrency,observability,http,https
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Framework :: AsyncIO
+Classifier: Intended Audience :: Developers
+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: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Topic :: Internet
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx>=0.27
+Requires-Dist: websockets>=12
+Provides-Extra: starlette
+Requires-Dist: starlette>=0.36; extra == "starlette"
+Provides-Extra: fastapi
+Requires-Dist: fastapi>=0.110; extra == "fastapi"
+Provides-Extra: all
+Requires-Dist: starlette>=0.36; extra == "all"
+Requires-Dist: fastapi>=0.110; extra == "all"
+Provides-Extra: dev
+Requires-Dist: pytest>=8; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
+Requires-Dist: pytest-cov>=5; extra == "dev"
+Requires-Dist: hypothesis>=6; extra == "dev"
+Requires-Dist: build>=1.2; extra == "dev"
+Requires-Dist: twine>=5; extra == "dev"
+Requires-Dist: ruff>=0.6; extra == "dev"
+Requires-Dist: mypy>=1.11; extra == "dev"
+Requires-Dist: fastapi>=0.110; extra == "dev"
+Dynamic: license-file
+
+# DataCurrent
+
+### Python streaming, made simple.
+
+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.0 · Stable / Production**
+
+- 279 tests passing, with 100% line and branch coverage.
+- Required networking dependencies install automatically.
+- No broker, database, API key or hosted service.
+
+## Install
+
+```bash
+pip install datacurrent
+```
+
+Python 3.11 or newer is required. `httpx` and `websockets` are installed with the
+package, so HTTP streaming, SSE and WebSocket clients work immediately.
+
+Framework helpers are optional:
+
+```bash
+pip install "datacurrent[fastapi]"
+pip install "datacurrent[starlette]"
+pip install "datacurrent[all]"
+```
+
+## Quick start
+
+```python
+import asyncio
+from datacurrent import Stream
+
+
+async def main() -> None:
+    result = await (
+        Stream.from_iterable(range(10))
+        .filter(lambda number: number % 2 == 0)
+        .map(lambda number: number * number)
+        .take(4)
+        .collect()
+    )
+    print(result)  # [0, 4, 16, 36]
+
+
+asyncio.run(main())
+```
+
+Streams are lazy and single-consumer:
+
+```python
+stream = Stream.from_iterable([1, 2, 3])
+
+async for item in stream:
+    print(item)
+
+# A second iteration raises StreamConsumedError.
+```
+
+Common terminals:
+
+```python
+await Stream.from_iterable([1, 2, 3]).collect()  # [1, 2, 3]
+await Stream.from_iterable([1, 2, 3]).count()  # 3
+await Stream.from_iterable([3, 1, 2]).reduce(max)  # 3
+await Stream.empty().first("fallback")  # "fallback"
+```
+
+Async callbacks work everywhere a callback is accepted:
+
+```python
+users = await Stream.from_iterable(user_ids).map(fetch_user, concurrency=8).collect()
+```
+
+## Operators
+
+`map`, `filter`, `flat_map`, `take`, `skip`, `batch`, `buffer`, `distinct`,
+`enumerate`, `window`, `debounce`, `throttle`, `timeout`, `retry`, `recover`,
+`tap`, `zip`, `merge` and `concat`.
+
+```python
+batches = Stream.from_iterable(range(1_000)).filter(lambda number: number % 3 == 0).batch(100)
+
+async for batch in batches:
+    print(len(batch))
+```
+
+## Backpressure
+
+Buffers are bounded and block the producer by default. Data is not silently
+dropped.
+
+```python
+stream = Stream.from_iterable(range(100_000)).buffer(size=64)
+```
+
+Lossy behaviour must be explicit and is counted:
+
+```python
+stream = Stream.from_iterable(range(10_000)).buffer(
+    size=16,
+    overflow="drop_oldest",
+)
+items = await stream.collect()
+print(len(items), stream.stats["dropped"])
+```
+
+Policies: `block`, `drop_newest`, `drop_oldest`, `error`.
+
+## Real-time data
+
+### WebSocket
+
+```python
+from datacurrent import WebSocketStream
+
+async with WebSocketStream.connect("wss://example.com/events") as stream:
+    await stream.send_json({"subscribe": "trades"})
+    async for message in stream:
+        print(message)
+```
+
+### Server-Sent Events
+
+```python
+from datacurrent import SSEStream
+
+async with SSEStream.connect("https://example.com/events") as stream:
+    async for event in stream:
+        print(event.event, event.json())
+```
+
+### Streaming HTTP
+
+```python
+from datacurrent import HTTPStream
+
+async with HTTPStream("https://example.com/feed.ndjson") as response:
+    async for line in response.iter_lines():
+        handle(line)
+```
+
+### Fan-out and events
+
+```python
+from datacurrent import Channel, EventBus
+
+channel = Channel(buffer_size=64)
+first = channel.subscribe()
+second = channel.subscribe()
+await channel.publish("deploy finished")
+
+bus = EventBus()
+
+
+@bus.subscribe("user.*")
+async def on_user(event):
+    print(event.topic, event.data)
+
+
+await bus.publish("user.created", {"user_id": 123})
+```
+
+## Retries
+
+```python
+from datacurrent import RetryPolicy
+
+stream = Stream.from_factory(connect_and_read).retry(
+    RetryPolicy(max_attempts=3, base_delay=0.2, jitter=0.1)
+)
+```
+
+Retries require a replayable source, such as a factory or a list. A consumed
+generator raises `NonReplayableStreamError` instead of silently restarting.
+
+## Why DataCurrent
+
+- One model for iterables, queues, HTTP, SSE and WebSockets.
+- Backpressure by default, with explicit and counted drop policies.
+- Bounded concurrency and cancellation-safe cleanup.
+- No infrastructure: no broker, database or external account.
+- Explicit delivery semantics; no false durability claims.
+- Typed API and sync or async callbacks throughout.
+
+HTTP clients such as `httpx` and `aiohttp` handle requests; DataCurrent adds the
+stream engine around them. Reactive libraries provide operator algebra, while
+broker frameworks require Kafka, Redis or RabbitMQ. DataCurrent is the
+in-process streaming layer that works without any of them.
+
+## Compatibility and limits
+
+- Python 3.11+ on asyncio; no Trio or AnyIO backend.
+- In-memory `Channel` and `EventBus` delivery is at most once.
+- No durable broker adapters or OpenTelemetry exporter in 1.0.0.
+- Not published to PyPI; the project name is provisional.
+
+## License
+
+MIT.

datacurrent-1.0.0.dist-info/RECORD

@@ -0,0 +1,43 @@
+datacurrent/__init__.py,sha256=-LVJm3Qd2yjbLOYt2NO9mdViiwPnWuzLoEtValxiDKg,3387
+datacurrent/_version.py,sha256=FZ-fDfPIlmCOb96GbhTHdze7YhOilXVqbGvUOdNv1SM,179
+datacurrent/config.py,sha256=AQvYeNdQvkePSY-EbE0Q0JhEswVKExXzLnJ9Lg_1ESM,2963
+datacurrent/exceptions.py,sha256=Nra8RGSm-bwx7iKt6CK_VeRhvINwjVHgEXdRToHZ5jI,6124
+datacurrent/py.typed,sha256=MEVxnsuDFCH3jsQWkwO_BItWvy5RNDh3BRxEDX8yV4M,70
+datacurrent/buffering/__init__.py,sha256=RUIxcxAHF8LumK1ijgvnbWuW6mDE3GJVXRYcJwavfN4,249
+datacurrent/buffering/backpressure.py,sha256=DwxQg7CVQ8tZyYcyYrgeEW9e5EDokeLRHXV0Ew5wti8,1732
+datacurrent/buffering/queue.py,sha256=YSv_wA-kvMEllSTgmCnZqWQiqXGoDfDqYf1DRPYk470,9786
+datacurrent/concurrency/__init__.py,sha256=9b91jurrbN9ImZpzJ9TEBXmOXYFGISdGKid7JzF4m30,257
+datacurrent/concurrency/limits.py,sha256=FNCbe6tKbL2IbfhoZ8-l0ycH9sYXk_d2_jxLGXFBdAk,2933
+datacurrent/concurrency/tasks.py,sha256=8ptFva17eu42rfKeiCLmbjlNY-yjae1OrG1tPZOzIMw,2743
+datacurrent/core/__init__.py,sha256=eHvFAkOuodDQav1C2BcLIXQeXxP7ek_rtNIREg-Ieek,394
+datacurrent/core/_util.py,sha256=kXtOe--SgQ5tigGBeG0_TiakmM5dSYywD3s5TdpD43E,1272
+datacurrent/core/lifecycle.py,sha256=TgYtrMbvByR3401jSigEItLXi_M_x841JCW0mf-tTkI,2432
+datacurrent/core/operators.py,sha256=jDqYoWOAMUNGiaBrY4fgisehPuL4K8j7Ag8EoH62xDs,25430
+datacurrent/core/pipeline.py,sha256=CIbcP3_l3t7SKajgplg9zycoyIpv9nb24ssvfKkZcWQ,1848
+datacurrent/core/sink.py,sha256=NOy6fpc4y_vWDEU3m9AXyCj_2EDcUTxxjAqsgif_nYk,2078
+datacurrent/core/stream.py,sha256=vN3pjR39RHMI2wVMmDpZQydcboTI3mCJZO-k7qOUBXM,20270
+datacurrent/events/__init__.py,sha256=2QGcVd5f7XX7m1tuVokL4ioICgs_IsFu_w1rS_ypqNA,279
+datacurrent/events/bus.py,sha256=1c_-q4SU4dGl9THdTGJ7umoTc2iNyVBudukgcio3pRw,13722
+datacurrent/events/routing.py,sha256=am9L59dcnmeBVEmuuyfT6H0amiGuAWoSA8W42OxlSH0,1890
+datacurrent/events/subscriptions.py,sha256=Ye4Y0lNkZuL8xbrRrvUQuLdblKoolb7VZ0DiMSo5b8w,2271
+datacurrent/integrations/__init__.py,sha256=E44jhwY2DQDO3yYjw5IF61IyO4l5E6z-sIun7Cr_m_s,479
+datacurrent/integrations/fastapi.py,sha256=236CnlNOdXUFA-OZnSGxfZaUhc2NHw7y2hSHXKAgyQo,2419
+datacurrent/integrations/starlette.py,sha256=VMMOWt8WKmoRWulY_q622Jfib16C2o6Co9oVs3SJiuQ,2156
+datacurrent/observability/__init__.py,sha256=98V3UcsXK9v1CM81kTiT6JbSr2Kc0v43ypuHSeYs9so,403
+datacurrent/observability/logging.py,sha256=yGsZfrTK0qBArsbdVc-ouZVor49XucIDGCbITCXmqv0,3464
+datacurrent/observability/metrics.py,sha256=A5YWDo8lkSfCIygkzJwtceFJXLsteEFb6FDaTpayOgo,3646
+datacurrent/reliability/__init__.py,sha256=jyfZU6cT_i-Fhn4O6y3RKZfn4D4EcJXiOoLPLM24oak,314
+datacurrent/reliability/retry.py,sha256=VVlnvKdZ9RQJo4Ptb98V-644A9_sNqXbORhHirhuOFg,4965
+datacurrent/reliability/timeout.py,sha256=XTYHTlen4IO72452M8KvjJT3w1QJdrhIkQRM9a_kb1w,1135
+datacurrent/transports/__init__.py,sha256=mU6RnvlCtYHyfJ_vCF7hZCFAj9bG306tr2MVZYs4yBM,610
+datacurrent/transports/_deps.py,sha256=vbUjFWdFLG3SxGMyGF8Ncu7uMcRloERHOZlA87ueRbw,623
+datacurrent/transports/base.py,sha256=GQx-eiAkP9sSUaMsY-oG_3qOS1EGHS6SpZ-1_PMAr5s,2397
+datacurrent/transports/http.py,sha256=HXz1H4D-6JhejcQsZp9H0tcDqu2dxd-abxWOcuD-mL4,7497
+datacurrent/transports/memory.py,sha256=BGAZyUbu_-7l8KDFATxBctHb8rQz9_Dkyn-c0ChbZn4,5495
+datacurrent/transports/sse.py,sha256=bUeH2N7DA0aJGlDN7irJ_yVo5eLtS104Ek9o6mBV4iY,13147
+datacurrent/transports/websocket.py,sha256=RNBqzQv6rXZarXJywgfoIO0VBN6c1rX94Y5Zzpr9dGg,10589
+datacurrent-1.0.0.dist-info/licenses/LICENSE,sha256=8uPxhvCmrJv91ttoxbEdtoh7xoifHgKLacwpMmjLYKU,1073
+datacurrent-1.0.0.dist-info/METADATA,sha256=-G30SZO8MCyA67E6-OD5wx1rymB6cny20vXc9aoWtLc,7186
+datacurrent-1.0.0.dist-info/WHEEL,sha256=mOdXR9C3wMVov7cSY8PY-XCzo3SmmWCHvGQr5csJoao,91
+datacurrent-1.0.0.dist-info/top_level.txt,sha256=CUBOKcU2k3gV2eRDU5JYl49MClij1kYAjK8TN19Ws9s,12
+datacurrent-1.0.0.dist-info/RECORD,,

datacurrent-1.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.2.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

datacurrent-1.0.0.dist-info/licenses/LICENSE

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

datacurrent-1.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+datacurrent