rangeslib documentation

rangeslib is a typed Python library for composing eager, list-backed ranges and iterable adaptors through a small public facade.

Guides

• Usage
  • Installation
  • Public API
  • Range
  • Generators
  • Pipelines
  • Materialization
  • Adaptor Catalog
  • Delimiters
  • Type Checking
  • Performance Checks
• Architecture
  • Goals
  • Package layout
  • Dependency direction
  • Public API boundary
  • Data flow and pipeline dispatch
  • Range invariants
  • Eager execution and iterator consumption
  • Validation and edge-case policy
  • Typing architecture
  • Error philosophy
  • Extending the library
  • Compatibility policy
  • Testing strategy
  • C++ correspondence
• C++ ranges comparison
  • Close conceptual matches
  • Important differences
• Roadmap
  • Near-term polish
  • Good future issues
  • Not immediate priorities
  • Release direction
• Contributing
  • Local setup
  • Formatting and quality workflow
  • CI mapping
  • Releases
  • Documentation deployment
  • Test organization
  • Adding a source
  • Adding an adaptor
  • Documentation changes
  • Pull requests and CI
• Publishing
  • Release flow
  • PyPI setup
  • Publishing an existing release manually
  • What the workflows publish
• Migration guide
  • From 0.6.x to 0.7.0
  • From 0.3.0 to 0.3.1
  • From 0.2.x to 0.3.x
• Changelog
  • 0.8.1 - 2026-09-06
  • 0.8.0 - 2026-09-06
  • 0.7.0 - 2026-09-06
  • 0.6.1 - 2026-09-06
  • 0.6.0 - 2026-09-05
  • 0.5.1 - 2026-09-05
  • 0.5.0 - 2026-09-05
  • 0.4.0 - 2026-09-05
  • 0.3.3 - 2026-09-05
  • 0.3.2 - 2026-09-05
  • 0.3.1
  • 0.3.0
  • 0.2.0

API reference

• API reference
  • Core container
  • Generator facade
  • View facade