|
1 | | -""" |
2 | | -Tree_sort algorithm. |
3 | | -
|
4 | | -Build a Binary Search Tree and then iterate thru it to get a sorted list. |
5 | | -""" |
6 | | - |
7 | 1 | from __future__ import annotations |
8 | | - |
9 | 2 | from collections.abc import Iterator |
10 | 3 | from dataclasses import dataclass |
11 | 4 |
|
12 | | - |
13 | 5 | @dataclass |
14 | 6 | class Node: |
| 7 | + """Node of a Binary Search Tree (BST) for sorting.""" |
15 | 8 | val: int |
16 | 9 | left: Node | None = None |
17 | 10 | right: Node | None = None |
18 | 11 |
|
19 | 12 | def __iter__(self) -> Iterator[int]: |
| 13 | + """In-order traversal generator for BST.""" |
| 14 | + # Traverse left subtree first (smaller values) |
20 | 15 | if self.left: |
21 | 16 | yield from self.left |
| 17 | + |
| 18 | + # Current node value |
22 | 19 | yield self.val |
| 20 | + |
| 21 | + # Traverse right subtree last (larger values) |
23 | 22 | if self.right: |
24 | 23 | yield from self.right |
25 | 24 |
|
26 | | - def __len__(self) -> int: |
27 | | - return sum(1 for _ in self) |
28 | | - |
29 | 25 | def insert(self, val: int) -> None: |
30 | | - if val < self.val: |
| 26 | + """Insert value into BST while maintaining sort order.""" |
| 27 | + # Values <= current go to left subtree |
| 28 | + if val <= self.val: |
31 | 29 | if self.left is None: |
32 | 30 | self.left = Node(val) |
33 | 31 | else: |
34 | 32 | self.left.insert(val) |
35 | | - elif val > self.val: |
| 33 | + # Values > current go to right subtree |
| 34 | + else: |
36 | 35 | if self.right is None: |
37 | 36 | self.right = Node(val) |
38 | 37 | else: |
39 | 38 | self.right.insert(val) |
40 | 39 |
|
41 | 40 |
|
42 | | -def tree_sort(arr: list[int]) -> tuple[int, ...]: |
| 41 | +def tree_sort(arr: list[int] | tuple[int, ...]) -> tuple[int, ...]: |
43 | 42 | """ |
44 | | - >>> tree_sort([]) |
45 | | - () |
46 | | - >>> tree_sort((1,)) |
47 | | - (1,) |
48 | | - >>> tree_sort((1, 2)) |
49 | | - (1, 2) |
50 | | - >>> tree_sort([5, 2, 7]) |
51 | | - (2, 5, 7) |
52 | | - >>> tree_sort((5, -4, 9, 2, 7)) |
53 | | - (-4, 2, 5, 7, 9) |
54 | | - >>> tree_sort([5, 6, 1, -1, 4, 37, 2, 7]) |
55 | | - (-1, 1, 2, 4, 5, 6, 7, 37) |
56 | | -
|
57 | | - # >>> tree_sort(range(10, -10, -1)) == tuple(sorted(range(10, -10, -1))) |
58 | | - # True |
| 43 | + Sort sequence using Binary Search Tree (BST) traversal. |
| 44 | + |
| 45 | + Args: |
| 46 | + arr: Input sequence (list or tuple of integers) |
| 47 | + |
| 48 | + Returns: |
| 49 | + Tuple of sorted integers |
| 50 | + |
| 51 | + Examples: |
| 52 | + >>> tree_sort([]) |
| 53 | + () |
| 54 | + >>> tree_sort((1,)) |
| 55 | + (1,) |
| 56 | + >>> tree_sort((1, 2)) |
| 57 | + (1, 2) |
| 58 | + >>> tree_sort([5, 2, 7]) |
| 59 | + (2, 5, 7) |
| 60 | + >>> tree_sort((5, -4, 9, 2, 7)) |
| 61 | + (-4, 2, 5, 7, 9) |
| 62 | + >>> tree_sort([5, 6, 1, -1, 4, 37, 2, 7]) |
| 63 | + (-1, 1, 2, 4, 5, 6, 7, 37) |
| 64 | + >>> tree_sort([5, 2, 7, 5]) # Test duplicate handling |
| 65 | + (2, 5, 5, 7) |
59 | 66 | """ |
60 | | - if len(arr) == 0: |
61 | | - return tuple(arr) |
62 | | - root = Node(arr[0]) |
63 | | - for item in arr[1:]: |
| 67 | + # Handle empty input immediately |
| 68 | + if not arr: |
| 69 | + return () |
| 70 | + |
| 71 | + # Convert to list for uniform processing |
| 72 | + items = list(arr) |
| 73 | + |
| 74 | + # Initialize BST root with first element |
| 75 | + root = Node(items[0]) |
| 76 | + |
| 77 | + # Insert remaining items into BST |
| 78 | + for item in items[1:]: |
64 | 79 | root.insert(item) |
| 80 | + |
| 81 | + # Convert BST traversal to sorted tuple |
65 | 82 | return tuple(root) |
66 | | - |
67 | | - |
68 | | -if __name__ == "__main__": |
69 | | - import doctest |
70 | | - |
71 | | - doctest.testmod() |
72 | | - print(f"{tree_sort([5, 6, 1, -1, 4, 37, -3, 7]) = }") |
|
0 commit comments