dtools.circular-array 3.9.0__py3-none-any.whl → 3.9.1__py3-none-any.whl

dtools/circular_array/__init__.py

@@ -1,4 +1,4 @@
-# Copyright 2016-2025 Geoffrey R. Scheller
+# Copyright 2023-2025 Geoffrey R. Scheller
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -14,14 +14,15 @@
 
 """### Circular Array
 
-Package for an indexable circular array data structure.
+Package for an indexable, sliceable circular array data structure.
 
 #### Modules
 
-* module dtools.circular_array.ca: circular array Python data structure
+* module dtools.circular_array.ca: circular array data structure
 
 """
-__version__ = "3.9.0"
+__version__ = "3.9.1"
 __author__ = "Geoffrey R. Scheller"
 __copyright__ = "Copyright (c) 2023-2025 Geoffrey R. Scheller"
 __license__ = "Apache License 2.0"
+

dtools/circular_array/ca.py

@@ -15,10 +15,15 @@
 """### Indexable circular array data structure module."""
 from __future__ import annotations
 from collections.abc import Callable, Iterable, Iterator, Sequence
-from typing import Any, cast, Never, overload
+from typing import Any, cast, Never, overload, TypeVar
 
 __all__ = [ 'ca', 'CA' ]
 
+D = TypeVar('D')
+L = TypeVar('L')
+R = TypeVar('R')
+U = TypeVar('U')
+
 class ca[D](Sequence[D]):
     """
     #### Indexable circular array data structure
@@ -34,7 +39,7 @@ class ca[D](Sequence[D]):
     * lowercase class name choosen to match built-ins like `list` and `tuple`
     * raises `IndexError` for out-of-bounds indexing
     * raises `ValueError` for popping from or folding an empty `ca`
-    * raises `TypeError` if more than 2 arguments are passed to constructor
+    * raises `TypeError` if 2 or more arguments are passed to constructor
 
     """
     __slots__ = '_data', '_cnt', '_cap', '_front', '_rear'

{dtools_circular_array-3.9.0.dist-info → dtools_circular_array-3.9.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: dtools.circular-array
-Version: 3.9.0
+Version: 3.9.1
 Summary: ### Circular Array
 Keywords: circular array,circle array,CA,double ended queue,dequeue,dqueue,pop,push,popL,popR,pushL,pushR,indexable,auto-resizing,auto resizing,resizing
 Author-email: "Geoffrey R. Scheller" <geoffrey@scheller.com>
@@ -19,10 +19,10 @@ Project-URL: Documentation, https://grscheller.github.io/dtools-docs/circular-ar
 Project-URL: Source, https://github.com/grscheller/dtools-circular-array
 Provides-Extra: test
 
-# Python Circular Array Implementation
+# Developer Tools - Circular Array Implementation
 
-Python module implementing an indexable, double sided,
-auto-resizing queue data structure.
+Python module implementing a full featured, indexable,
+double sided, auto-resizing queue data structure.
 
 * **Repositories**
   * [dtools.circular-array][1] project on *PyPI*
@@ -30,6 +30,9 @@ auto-resizing queue data structure.
 * **Detailed documentation**
   * [Detailed API documentation][3] on *GH-Pages*
 
+This project is part of the
+[Developer Tools for Python][4] **dtools.** namespace project.
+
 ### Overview
 
 Useful if used directly as an improved version of a Python List or in
@@ -37,7 +40,8 @@ a "has-a" relationship when implementing other data structures.
 
 * O(1) pushes and pops either end.
 * O(1) indexing
-* now fully supports slicing!
+* fully supports slicing
+* iterates over copies of the data allowing ca to mutate
 
 ### Usage
 
@@ -80,6 +84,7 @@ assert len(ca) == 0
 
 [1]: https://pypi.org/project/dtools.circular-array
 [2]: https://github.com/grscheller/dtools-circular-array
-[3]: https://grscheller.github.io/dtools-namespace-docs/circular-array/
+[3]: https://grscheller.github.io/dtools-docs/circular-array
+[4]: https://github.com/grscheller/dtools-docs
 
 

dtools_circular_array-3.9.1.dist-info/RECORD

@@ -0,0 +1,7 @@
+dtools/circular_array/__init__.py,sha256=HdCpPnMesO8z3CGuoNfqMjYLRmiedHYdcQTGE6e6qf8,922
+dtools/circular_array/ca.py,sha256=a-hcJ4hQhLexqX2fqsOogEIPjpzR8PQ5zAE49-Xi8tc,15722
+dtools/circular_array/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+dtools_circular_array-3.9.1.dist-info/LICENSE,sha256=csqbZRvA3Nyuav1aszWvswE8CZtaKr-hMjjjcKqms7w,10774
+dtools_circular_array-3.9.1.dist-info/WHEEL,sha256=CpUCUxeHQbRN5UGRQHYRJorO5Af-Qy_fHMctcQ8DSGI,82
+dtools_circular_array-3.9.1.dist-info/METADATA,sha256=r80WBcYr2g_k-1uH27NICHx3be6BuKivHiI5tGyMtBY,2717
+dtools_circular_array-3.9.1.dist-info/RECORD,,

dtools_circular_array-3.9.0.dist-info/RECORD

@@ -1,7 +0,0 @@
-dtools/circular_array/__init__.py,sha256=yHBn_zsWPfiTPmcdYe4XyO6I6tbx9RTMDBukau6zXWg,917
-dtools/circular_array/ca.py,sha256=qoOjG-m_Z2XlYqRAA4w0HxSUaqz_U3E-7bpzqK-vtQY,15646
-dtools/circular_array/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-dtools_circular_array-3.9.0.dist-info/LICENSE,sha256=csqbZRvA3Nyuav1aszWvswE8CZtaKr-hMjjjcKqms7w,10774
-dtools_circular_array-3.9.0.dist-info/WHEEL,sha256=CpUCUxeHQbRN5UGRQHYRJorO5Af-Qy_fHMctcQ8DSGI,82
-dtools_circular_array-3.9.0.dist-info/METADATA,sha256=UgiPcUtbURZgznj3dUJjcOB5LDfEQeisr5vpN2PoAa4,2512
-dtools_circular_array-3.9.0.dist-info/RECORD,,