sliceview 0.1.0__py3-none-any.whl

sliceview-0.1.0.dist-info/METADATA

@@ -0,0 +1,153 @@
+Metadata-Version: 2.4
+Name: sliceview
+Version: 0.1.0
+Summary: Zero-copy, composable slice views for Python sequences
+Project-URL: Homepage, https://github.com/julianofischer/sliceview
+Project-URL: Bug Tracker, https://github.com/julianofischer/sliceview/issues
+Project-URL: Discussions, https://discuss.python.org/t/slice-views-for-python-sequences/103531
+Author-email: Juliano Fischer Naves <julianofischer@gmail.com>
+License: MIT
+License-File: LICENSE
+Keywords: memory,performance,sequence,slice,view,zero-copy
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Utilities
+Requires-Python: >=3.9
+Provides-Extra: dev
+Requires-Dist: pytest-cov; extra == 'dev'
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# sliceview
+
+**Zero-copy, composable slice views for Python sequences.**
+
+`sliceview` lets you work with windows into lists, tuples, strings, or any
+`Sequence` without copying the underlying data.  It is the proof-of-concept
+library accompanying the Python discussion on
+[Slice Views for Python Sequences](https://discuss.python.org/t/slice-views-for-python-sequences/103531).
+
+```python
+from sliceview import sliceview
+
+data = list(range(1_000_000))
+
+# O(1) — no copy
+window = sliceview(data)[50_000:60_000]
+
+# Compose slices — still O(1), still no copy
+every_third = sliceview(data)[::3][100:200]
+
+# In-place windowed update
+sv = sliceview(data)
+sv[0:5] = [10, 20, 30, 40, 50]
+
+# Sliding window without creating new objects
+view = sliceview(data, 0, 1000)
+for _ in range(10):
+    process(view)
+    view.advance(1000)
+```
+
+## Why?
+
+In Python today, `seq[a:b]` copies the data.  For large pipelines — text
+processing, audio, genomics, sorting algorithms — those copies dominate
+both time and memory.  `memoryview` solves this for *bytes-like* objects;
+`sliceview` targets *generic* sequences of Python objects.
+
+Inspired by Go slices, NumPy views, and `memoryview`.
+
+## Installation
+
+```bash
+pip install sliceview
+```
+
+## Features
+
+| Feature | Details |
+|---|---|
+| **Zero-copy slicing** | `sv[a:b:c]` returns a new `sliceview` in O(1) |
+| **Composable** | `sv[2:][::3][5:10]` chains correctly with no intermediate copies |
+| **Live view** | Mutations to the base are immediately visible through the view |
+| **Write-through** | `sv[i] = x` and `sv[a:b] = iterable` forward to the base |
+| **Sliding window** | `sv.advance(n)` shifts the window in-place — no new object |
+| **Any sequence** | Works with `list`, `tuple`, `str`, `array`, or your own type |
+
+## API
+
+### `sliceview(base, start=None, stop=None, step=None)`
+
+Create a view over `base`.  `start` may be a `slice` object.
+
+```python
+sv = sliceview(my_list)           # full view
+sv = sliceview(my_list, 10, 20)   # [10:20]
+sv = sliceview(my_list, slice(10, 20, 2))  # [10:20:2]
+```
+
+### Indexing and slicing
+
+```python
+sv[i]        # element access — maps to base[start + i*step]
+sv[a:b:c]    # returns a new sliceview (O(1))
+sv[i] = x    # write-through to the base
+sv[a:b] = it # slice assignment (delegates to base)
+```
+
+### `sv.advance(n) -> self`
+
+Shift the view's window forward by `n` index positions (negative to retreat).
+Returns `self` for chaining.  Useful for sliding-window algorithms:
+
+```python
+view = sliceview(samples, 0, window_size)
+while True:
+    result = process(view)
+    if view.advance(window_size)._start >= len(samples):
+        break
+```
+
+### `sv.tolist()` / `sv.copy()`
+
+Materialise the view as a new `list` (explicit copy).
+
+### `sv.base`
+
+The underlying sequence the view points into.
+
+## Semantics
+
+- **`len(sv)`** reflects the *current* base length, so appending to the base
+  is immediately visible.
+- **`sv[:]`** returns a new `sliceview` pointing at the same base — O(1).
+- **Hashing**: `sliceview` is intentionally unhashable.
+- **Equality**: compares element-wise to any `Sequence`.
+- **Immutable bases**: `sv[i] = x` raises `TypeError` if the base does not
+  support `__setitem__`.
+
+## Design notes and open questions
+
+This library implements the core proposal from the
+[Python discussion](https://discuss.python.org/t/slice-views-for-python-sequences/103531).
+Deliberately left out to keep the scope focused:
+
+- `view()` builtin shortcut (consensus in the thread was it's unnecessary)
+- `__sliceview__` dunder (motivation unclear until adoption data exists)
+- Multidimensional views (NumPy is the right tool for that)
+- ABC / Protocol additions to `collections.abc`
+
+Feedback welcome — please open an issue or join the discussion thread.
+
+## License
+
+MIT

sliceview-0.1.0.dist-info/RECORD

@@ -0,0 +1,4 @@
+sliceview-0.1.0.dist-info/METADATA,sha256=QjGuRRpfC1O9Jg3ojQMQekWSEDSn2m-Mfo3nDJCbMdE,4981
+sliceview-0.1.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+sliceview-0.1.0.dist-info/licenses/LICENSE,sha256=YLaR9KAHSR8-GGGii9qagbhN44bbozVaa4DQU44Bru0,1078
+sliceview-0.1.0.dist-info/RECORD,,

sliceview-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.29.0
+Root-Is-Purelib: true
+Tag: py3-none-any

sliceview-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Juliano Fischer Naves
+
+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.