---
id: nr-stream
version: "1.1.5"
license: MIT
license_treatment: permissive
maintenance: abandoned
---

# nr-stream

License: permissive · Maintenance: abandoned · Downloads: 259.1K/mo

## What it is and what it does

nr-stream provides four main functional-style abstractions for Python: Stream wraps iterables and chains transformations; Optional represents values that may be None and chains operations conditionally; Refreshable holds a value that can update and propagate changes to derived values; and Supplier lazily evaluates value retrieval with optional chaining. The package aims to simplify code by enabling fluent, chainable operations rather than nested loops or conditional checks.

All classes support method chaining to build readable transformation pipelines. Stream immediately converts its input to an iterator, meaning you cannot branch streams. Refreshable uses eager evaluation so `.get()` calls are performant. Supplier always evaluates lazily and raises `Supplier.Empty` when no value exists, treating None as a valid value. The package supports Python 3.6 through 3.11 and has no external runtime dependencies.

Use it for:

- Transform and filter sequences with readable chained operations instead of nested loops or list comprehensions
- Handle optional configuration values that may be None and propagate transformations conditionally
- Pass reactive configuration objects through an application that automatically propagate updates to derived values
- Lazily compute expensive values on demand with Supplier and cache results using `.once()`
- Process iterables in chunks or apply multiple sequential transformations in a single fluent chain

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides functional-style utilities for Python including Optional, Stream, Refreshable, and Supplier classes to simplify chaining operations on iterables and managing optional or lazy-evaluated values.

No. The package is abandoned (1277 days since last release) with no maintenance activity. While it has no known vulnerabilities and low install friction, the lack of active maintenance makes it risky for new projects. Consider using modern functional libraries or Python's built-in itertools and functools instead, which receive ongoing support.

## Install

pip install nr-stream
uv add nr-stream
poetry add nr-stream

## Installing nr-stream

Before you install: Low install friction with no runtime dependencies. Package is abandoned as of 1277 days since last release, with no recent maintenance activity.

License in practice: MIT license permits commercial and private use with minimal restrictions; you must include the license text in distributions.

Quickstart:

pip install nr-stream

from nr.stream import Stream, Optional, Supplier

values = [3, 6, 4, 7, 1, 2, 5]
result = list(Stream(values).chunks(values, 3, fill=0).map(sum))

opt = Optional(None)
opt_mapped = opt.map(lambda v: v + 1)

sup = Supplier.of(42)
value = sup.map(lambda v: v * 2).get()

Verify before relying:

- Whether the abandoned status affects real-world reliability or if the package is stable enough for production use
- Performance characteristics when chaining many operations on large iterables
- Whether Stream's immediate iterator conversion causes issues in practice for typical use cases

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: abandoned
- Downloads: 259.1K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

functional programming utilities python, stream processing chains, optional value handling, lazy evaluation supplier, refreshable reactive values, iterable transformation, functional style chaining, functional-programming, lazy-evaluation, stream-processing

[View on SkillFed](https://skillfed.io/packages/nr-stream) · [View on PyPI](https://pypi.org/project/nr-stream/)