dtools.circular-array 3.13.0__py3-none-any.whl → 3.14.0__py3-none-any.whl

dtools/{circular_array/ca.py → circular_array.py}

@@ -12,10 +12,19 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-"""### An indexable circular array data structure."""
+"""### An indexable circular array data structure.
+
+An indexable, sliceable, auto-resizing circular array
+data structure with amortized O(1) pushes and pops either end.
+
+"""
 
 from __future__ import annotations
 
+__author__ = 'Geoffrey R. Scheller'
+__copyright__ = 'Copyright (c) 2023-2025 Geoffrey R. Scheller'
+__license__ = 'Apache License 2.0'
+
 from collections.abc import Callable, Iterable, Iterator
 from typing import cast, Never, overload, TypeVar
 
@@ -27,7 +36,7 @@ D = TypeVar('D')
 class CA[D]:
     """Indexable circular array data structure
 
-    - generic, stateful data structure
+    - generic, stateful, invariant data structure
     - amortized O(1) pushing and popping from either end
     - O(1) random access any element
     - will resize itself as needed

{dtools_circular_array-3.13.0.dist-info → dtools_circular_array-3.14.0.dist-info}/METADATA

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: dtools.circular-array
-Version: 3.13.0
-Summary: ### Developer Tools - Circular Array Data Structure
+Version: 3.14.0
+Summary: ### An indexable circular array data structure.
 Keywords: circular array,dequeue,pop,push,indexable,auto resizing
 Author-email: "Geoffrey R. Scheller" <geoffrey@scheller.com>
 Requires-Python: >=3.12
@@ -16,8 +16,8 @@ Classifier: Typing :: Typed
 License-File: LICENSE
 Requires-Dist: pytest >=8.3.5 ; extra == "test"
 Project-URL: Changelog, https://github.com/grscheller/dtools-circular-array/blob/main/CHANGELOG.md
-Project-URL: Documentation, https://grscheller.github.io/dtools-docs/circular-array
-Project-URL: Homepage, https://github.com/grscheller/dtools-docs
+Project-URL: Documentation, https://grscheller.github.io/dtools-namespace-projects/circular-array
+Project-URL: Homepage, https://github.com/grscheller/dtools-namespace-projects/blob/main/README.md
 Project-URL: Source, https://github.com/grscheller/dtools-circular-array
 Provides-Extra: test
 
@@ -32,8 +32,8 @@ structure,
 - **Detailed documentation**
   - [Detailed API documentation][3] on *GH-Pages*
 
-This project is part of the [Developer Tools for Python][4] **dtools.**
-namespace project.
+This project is part of the [Developer Tools for Python][4] **dtools**
+namespace projects.
 
 ## Overview
 
@@ -53,8 +53,11 @@ Useful either if used directly like a Python list, or in a "has-a"
 relationship when implementing other data structures.
 
 - *module* dtools.circular_array
-  - *class* CA: circular array data structure
-  - *function* ca: factory function to produce a CA from data
+  - *class* `CA:` circular array data structure
+    - initializer takes 1 or 0 iterators
+    - like `list` or `set`
+  - *function* `ca`: produces a `CA` from function's arguments
+    - similar use case as syntactic constructs `[]` or `{}`
 
 Above nomenclature modeled after builtin data types like `list`, where
 `CA` and `ca` correspond respectfully to `list` and  `[]` in their use
@@ -63,7 +66,7 @@ cases.
 #### Usage
 
 ```python
-    from dtools.circular_array.ca import CA, ca
+    from dtools.circular_array import CA, ca
     
     ca1 = ca(1, 2, 3)
     assert ca1.popl() == 1
@@ -81,8 +84,8 @@ cases.
     tup4 = ca2.poprt(4)
     assert tup3 == (1, 2, 3)
     assert tup4 == (10, 9, 8, 7)
-    assert ca2 == CA(4, 5, 6)
-    four, *rest = ca.popft(1000)
+    assert ca2 == ca(4, 5, 6)
+    four, *rest = ca2.poplt(1000)
     assert four == 4
     assert rest == [5, 6]
     assert len(ca2) == 0
@@ -96,10 +99,8 @@ cases.
     assert len(ca2) == 0
 ```
 
-______________________________________________________________________
-
 [1]: https://pypi.org/project/dtools.circular-array
 [2]: https://github.com/grscheller/dtools-circular-array
-[3]: https://grscheller.github.io/dtools-docs/circular-array
-[4]: https://github.com/grscheller/dtools-docs
+[3]: https://grscheller.github.io/dtools-namespace-projects/circular-array
+[4]: https://github.com/grscheller/dtools-namespace-projects/blob/main/README.md
 

dtools_circular_array-3.14.0.dist-info/RECORD

@@ -0,0 +1,5 @@
+dtools/circular_array.py,sha256=GJn30Xub6oSd2Ltiy76ccUytiNpVS43RJNU4Oax6EkM,16184
+dtools_circular_array-3.14.0.dist-info/licenses/LICENSE,sha256=csqbZRvA3Nyuav1aszWvswE8CZtaKr-hMjjjcKqms7w,10774
+dtools_circular_array-3.14.0.dist-info/WHEEL,sha256=G2gURzTEtmeR8nrdXUJfNiB3VYVxigPQ-bEQujpNiNs,82
+dtools_circular_array-3.14.0.dist-info/METADATA,sha256=PPfMaC0yPeiMRUp9rsXxFtEmw7mUVkJK-DAtffjKjhI,3597
+dtools_circular_array-3.14.0.dist-info/RECORD,,

dtools/circular_array/__init__.py

@@ -1,32 +0,0 @@
-# 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.
-# You may obtain a copy of the License at
-#
-#     http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-
-"""### Developer Tools - Circular Array Data Structure
-
-Package for an indexable, sliceable, auto-resizing circular array
-data structure with amortized O(1) pushes and pops either end.
-
-Circular array data structure.
-
-- *module* dtools.circular_array.ca
-  - *class* dtools.circular_array.ca.CA
-    - initializer takes up to 1 iterable
-  - *function* dtools.circular_array.ca.ca
-    - constructs a `CA` from a variable number of arguments
-
-"""
-
-__author__ = 'Geoffrey R. Scheller'
-__copyright__ = 'Copyright (c) 2023-2025 Geoffrey R. Scheller'
-__license__ = 'Apache License 2.0'

dtools_circular_array-3.13.0.dist-info/RECORD

@@ -1,7 +0,0 @@
-dtools/circular_array/__init__.py,sha256=T_Jqa8AzDhow6q5O6A_FP5kCHBohEYJYSpo5xcsfTuU,1168
-dtools/circular_array/ca.py,sha256=xSvYBPAFAJU_KbHAjmSIFAt3Pq9YkVVojo0BIoxIZPY,15918
-dtools/circular_array/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-dtools_circular_array-3.13.0.dist-info/licenses/LICENSE,sha256=csqbZRvA3Nyuav1aszWvswE8CZtaKr-hMjjjcKqms7w,10774
-dtools_circular_array-3.13.0.dist-info/WHEEL,sha256=G2gURzTEtmeR8nrdXUJfNiB3VYVxigPQ-bEQujpNiNs,82
-dtools_circular_array-3.13.0.dist-info/METADATA,sha256=NRnV41SCn3OKLWHgud6_WpQg_dr9WGbeXraJ6CkzAZg,3448
-dtools_circular_array-3.13.0.dist-info/RECORD,,