algokit-py 0.1.0__tar.gz → 0.2.0__tar.gz

{algokit_py-0.1.0 → algokit_py-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: algokit-py
-Version: 0.1.0
+Version: 0.2.0
 Summary: A minimal Python algorithms library with clean implementations of search algorithms
 Author: Chanaka Prasanna
 License: MIT
@@ -12,14 +12,27 @@ Description-Content-Type: text/markdown
 
 # algokit-py
 
-A lightweight Python algorithms library with clean, well-documented implementations.
+A lightweight Python algorithms library with clean, well-documented, and tested implementations.
+Designed for learning, interviews, and real-world algorithm reasoning.
 
 ## Features
+
+### Search Algorithms
 - Linear Search
-- Binary Search
+- Binary Search (iterative, invariant-based)
+
+### Sorting Algorithms
+- Insertion Sort (in-place, stable)
 
 ## Usage
 
+### Install
+
+```python
+pip install algokit-py
+```
+
+### Search
 ```python
 from algokit_py.search import linear_search, binary_search
 
@@ -27,26 +40,11 @@ print(linear_search([1, 2, 3], 2))
 print(binary_search([1, 2, 3], 2))
 ```
 
-
-We will improve this later.
-
----
-
-## STEP 6: Local Install Test (Very Important)
-
-From **project root**:
-
-```powershell
-pip install -e .
-```
-
-Then test:
-
-```powershell
-python -c "from algokit_py.search import binary_search; print(binary_search([1,2,3], 2))"
-```
-
-You must see:
+### Sorting
 ```python
-1
+from algokit_py.sort import insertion_sort
+
+data = [3, 1, 2]
+insertion_sort(data)
+print(data)   # [1, 2, 3]
 ```

algokit_py-0.2.0/README.md

@@ -0,0 +1,38 @@
+# algokit-py
+
+A lightweight Python algorithms library with clean, well-documented, and tested implementations.
+Designed for learning, interviews, and real-world algorithm reasoning.
+
+## Features
+
+### Search Algorithms
+- Linear Search
+- Binary Search (iterative, invariant-based)
+
+### Sorting Algorithms
+- Insertion Sort (in-place, stable)
+
+## Usage
+
+### Install
+
+```python
+pip install algokit-py
+```
+
+### Search
+```python
+from algokit_py.search import linear_search, binary_search
+
+print(linear_search([1, 2, 3], 2))
+print(binary_search([1, 2, 3], 2))
+```
+
+### Sorting
+```python
+from algokit_py.sort import insertion_sort
+
+data = [3, 1, 2]
+insertion_sort(data)
+print(data)   # [1, 2, 3]
+```

{algokit_py-0.1.0 → algokit_py-0.2.0}/algokit_py/__init__.py

@@ -3,6 +3,7 @@ algokit_py - A minimal Python algorithms library
 """
 
 from algokit_py.search import binary_search, linear_search
+from algokit_py.sort import insertion_sort
 
 __version__ = "0.1.0"
-__all__ = ["binary_search", "linear_search"]
+__all__ = ["binary_search", "linear_search","insertion_sort"]

{algokit_py-0.1.0 → algokit_py-0.2.0}/algokit_py/search/binary.py

@@ -16,10 +16,11 @@ At every step, the algorithm maintains a range that is guaranteed to contain the
 from typing import Sequence, TypeVar
 
 T = TypeVar('T')
-# here we use Sequence because binary seach does not support for unindexed iterables
+# here we use Sequence because binary search does not support for not indexed iterables.
+# Binary search requires a sorted sequence.
 def binary_search(sequence: Sequence[T], target: T)-> int:
     """
-    This function will perform the binary search
+    This function will perform the binary search. Sequence must be a sorted sequence
 
     :param sequence: sorted and indexed sequence
     :param target: value that you want to find

algokit_py-0.2.0/algokit_py/sort/__init__.py

@@ -0,0 +1 @@
+from .insertion import insertion_sort

algokit_py-0.2.0/algokit_py/sort/insertion.py

@@ -0,0 +1,26 @@
+from typing import MutableSequence, TypeVar
+
+T = TypeVar('T')
+def insertion_sort(sequence: MutableSequence[T])-> None:
+    """
+    At the start of iteration i, the subarray sequence[0:i] is sorted.
+
+    :param sequence
+    :return None
+
+    Worst Case Time Complexity: O(n²)
+    Space Complexity: O(1)
+    """
+    length = len(sequence)
+    for i in range(1, length):
+        key = sequence[i]
+        j = i-1
+        while sequence[j] > key and j >= 0:
+            sequence[j+1]= sequence[j]
+            j -= 1
+        sequence[j + 1] = key
+
+
+
+
+

{algokit_py-0.1.0 → algokit_py-0.2.0}/algokit_py.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: algokit-py
-Version: 0.1.0
+Version: 0.2.0
 Summary: A minimal Python algorithms library with clean implementations of search algorithms
 Author: Chanaka Prasanna
 License: MIT
@@ -12,14 +12,27 @@ Description-Content-Type: text/markdown
 
 # algokit-py
 
-A lightweight Python algorithms library with clean, well-documented implementations.
+A lightweight Python algorithms library with clean, well-documented, and tested implementations.
+Designed for learning, interviews, and real-world algorithm reasoning.
 
 ## Features
+
+### Search Algorithms
 - Linear Search
-- Binary Search
+- Binary Search (iterative, invariant-based)
+
+### Sorting Algorithms
+- Insertion Sort (in-place, stable)
 
 ## Usage
 
+### Install
+
+```python
+pip install algokit-py
+```
+
+### Search
 ```python
 from algokit_py.search import linear_search, binary_search
 
@@ -27,26 +40,11 @@ print(linear_search([1, 2, 3], 2))
 print(binary_search([1, 2, 3], 2))
 ```
 
-
-We will improve this later.
-
----
-
-## STEP 6: Local Install Test (Very Important)
-
-From **project root**:
-
-```powershell
-pip install -e .
-```
-
-Then test:
-
-```powershell
-python -c "from algokit_py.search import binary_search; print(binary_search([1,2,3], 2))"
-```
-
-You must see:
+### Sorting
 ```python
-1
+from algokit_py.sort import insertion_sort
+
+data = [3, 1, 2]
+insertion_sort(data)
+print(data)   # [1, 2, 3]
 ```

{algokit_py-0.1.0 → algokit_py-0.2.0}/algokit_py.egg-info/SOURCES.txt

@@ -8,5 +8,8 @@ algokit_py.egg-info/top_level.txt
 algokit_py/search/__init__.py
 algokit_py/search/binary.py
 algokit_py/search/linear.py
+algokit_py/sort/__init__.py
+algokit_py/sort/insertion.py
 tests/test_binary.py
+tests/test_insertion.py
 tests/test_linear.py

{algokit_py-0.1.0 → algokit_py-0.2.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "algokit-py"
-version = "0.1.0"
+version = "0.2.0"
 description = "A minimal Python algorithms library with clean implementations of search algorithms"
 readme = "README.md"
 requires-python = ">=3.9"

algokit_py-0.2.0/tests/test_insertion.py

@@ -0,0 +1,32 @@
+
+from algokit_py.sort import insertion_sort
+
+
+def test_insertion_sort_basic():
+    data = [3, 1, 2]
+    insertion_sort(data)
+    assert data == [1, 2, 3]
+
+
+def test_insertion_sort_already_sorted():
+    data = [1, 2, 3, 4]
+    insertion_sort(data)
+    assert data == [1, 2, 3, 4]
+
+
+def test_insertion_sort_reverse():
+    data = [4, 3, 2, 1]
+    insertion_sort(data)
+    assert data == [1, 2, 3, 4]
+
+
+def test_insertion_sort_single_element():
+    data = [5]
+    insertion_sort(data)
+    assert data == [5]
+
+
+def test_insertion_sort_empty():
+    data = []
+    insertion_sort(data)
+    assert data == []

algokit_py-0.1.0/README.md

@@ -1,40 +0,0 @@
-# algokit-py
-
-A lightweight Python algorithms library with clean, well-documented implementations.
-
-## Features
-- Linear Search
-- Binary Search
-
-## Usage
-
-```python
-from algokit_py.search import linear_search, binary_search
-
-print(linear_search([1, 2, 3], 2))
-print(binary_search([1, 2, 3], 2))
-```
-
-
-We will improve this later.
-
----
-
-## STEP 6: Local Install Test (Very Important)
-
-From **project root**:
-
-```powershell
-pip install -e .
-```
-
-Then test:
-
-```powershell
-python -c "from algokit_py.search import binary_search; print(binary_search([1,2,3], 2))"
-```
-
-You must see:
-```python
-1
-```