treescript-builder 0.1.4__py3-none-any.whl → 0.1.6__py3-none-any.whl

treescript_builder/__main__.py

@@ -3,10 +3,12 @@
 
 def main():
     # Author: DK96-OS 2024 - 2025
+    from sys import argv
     from treescript_builder.input import validate_input_arguments
+    input_data = validate_input_arguments(argv[1:])
+    #
     from treescript_builder.tree import build_tree
-    from sys import argv
-    build_tree(validate_input_arguments(argv[1:]))
+    build_tree(input_data)
 
 
 if __name__ == "__main__":

treescript_builder/data/data_directory.py

@@ -1,4 +1,4 @@
-"""Data Directory Management.
+""" Data Directory Management.
  Author: DK96-OS 2024 - 2025
 """
 from pathlib import Path
@@ -20,70 +20,71 @@ class DataDirectory:
     def __init__(self, data_dir: Path):
         if not isinstance(data_dir, Path) or not data_dir.exists():
             exit('The Data Directory must be a Path that Exists!')
-        self._data_dir = data_dir
-        # todo: Create a map of used Data Labels
+        self._data_dir: Path = data_dir
+        self._expected_trim_data: list[str] = []
 
     def validate_build(self, node: TreeData) -> Path | None:
         """ Determine if the Data File supporting this Tree node is available.
 
-        Parameters:
-        - node (TreeData): The TreeData to validate.
+**Parameters:**
+ - node (TreeData): The TreeData to validate.
 
-        Returns:
-        Path - The Path to the Data File in the Data Directory.
+**Returns:**
+ Path? - The Path to the Data File in the Data Directory.
 
-        Raises:
-        SystemExit - When the Data label is invalid, or the Data File does not exist.
+**Raises:**
+ SystemExit - When the Data label is invalid, or the Data File does not exist.
         """
-        if node.data_label == '' or node.is_dir:
+        if node.data_label == '': # For compatibility with 0.1.x
             return None
-        if node.data_label == '!':
-            data_path = self._search_label(node.name)
-        else:
-            data_path = self._search_label(node.data_label)
-        if data_path is None:
-            exit(f'Data Label ({node.data_label}) not found in Data Directory on line: {node.line_number}')
+        if not validate_data_label(data_label := node.get_data_label()):
+            exit(f'Invalid Data Label on line: {node.line_number}')
+        # Search in the DataDir for this Data File.
+        if (data_path := self._search_label(data_label)) is None:
+            exit(f'Label ({node.data_label}) not found in DataDirectory on Line: {node.line_number}')
         return data_path
 
     def validate_trim(self, node: TreeData) -> Path | None:
         """ Determine if the File already exists in the Data Directory.
 
-        Parameters:
-        - node (TreeData): The TreeData to validate.
+**Parameters:**
+ - node (TreeData): The TreeData to validate.
 
-        Returns:
-        Path - The Path to a new File in the Data Directory.
+**Returns:**
+ Path? - The Path to a new File in the Data Directory.
 
-        Raises:
-        SystemExit - When the Data label is invalid, or the Data File already exists.
+**Raises:**
+ SystemExit - When the Data label is invalid, or the Data File already exists.
         """
-        # Ensure that the name of the Label is valid
-        if node.data_label == '' or node.is_dir:
+        if node.data_label == '': # For compatibility with 0.1.x
             return None
-        data_label = node.name if node.data_label == '!' else node.data_label
-        if not validate_data_label(data_label):
+        if not validate_data_label(data_label := node.get_data_label()):
             exit(f'Invalid Data Label on line: {node.line_number}')
+        # Check if another TreeData Node has this DataLabel
+        if data_label in self._expected_trim_data:
+            exit(f"Duplicate DataLabels in Trim Operation on Line: {node.line_number}")
         # Check if the Data File already exists
-        data_path = self._search_label(data_label)
-        if data_path is not None:
-            exit(f'Data File already exists!\n({data_label}) on line: {node.line_number}')
-        # Create the Data Label Path in the Directory
+        if self._search_label(data_label) is not None:
+            exit(f'Data File already exists!\n({data_label}) on Line: {node.line_number}')
+        # Add the new DataLabel to the collection
+        self._expected_trim_data.append(data_label)
+        # Return the DataLabel Path
         return self._data_dir / data_label
 
     def _search_label(self, data_label: str) -> Path | None:
         """ Search for a Data Label in this Data Directory.
 
-        Parameters:
-        - data_label (str): The Data Label to search for.
+**Parameters:**
+ - data_label (str): The Data Label to search for.
 
-        Returns:
-        Path (optional) - The Path to the Data File, or None.
+**Returns:**
+ Path? - The Path to the Data File, or None.
         """
-        if not validate_data_label(data_label):
-            return None
         # Find the Data Label File
         data_files = self._data_dir.glob(data_label)
         try:
             return next(data_files)
         except StopIteration:
-            return None
+            return None
+        except OSError:
+            return None

treescript_builder/data/path_stack.py

@@ -17,8 +17,7 @@ class PathStack:
     """
 
     def __init__(self):
-        # The Stack of Directories in the Path.
-        self._stack = []
+        self._stack: list[str] = []
 
     def push(self, directory_name: str):
         """ Push a directory to the Path Stack.
@@ -70,8 +69,7 @@ class PathStack:
 **Returns:**
  boolean - Whether the Reduction was successful, ie 0 or more Stack pops.
         """
-        current_depth = self.get_depth()
-        if current_depth < depth or depth < 0:
+        if depth < 0 or (current_depth := self.get_depth()) < depth:
             return False
         if current_depth == depth:
             return True

treescript_builder/data/tree_data.py

@@ -1,4 +1,4 @@
-"""Tree Node DataClass.
+""" Tree Node DataClass.
  Author: DK96-OS 2024 - 2025
 """
 from dataclasses import dataclass
@@ -15,9 +15,18 @@ Fields:
  - name (str): The Name of the Tree Node.
  - data_label (str): The Data Label, may be empty string.
     """
-
     line_number: int
     depth: int
     is_dir: bool
     name: str
-    data_label: str = ''
+    data_label: str = ''
+    
+    def get_data_label(self) -> str:
+        """ Obtain the string DataLabel for this TreeData Node.
+ - Contains the relation between these two Fields: name, data_label.
+ - If the DataLabel is the exclamation point !, then use the name as DataLabel.
+
+**Returns:**
+ str - The DataLabel string to use for this TreeData Node. It may not have been validated.
+        """
+        return self.name if self.data_label == '!' else self.data_label

treescript_builder/data/tree_state.py

@@ -24,9 +24,9 @@ class TreeState:
     """
 
     def __init__(self):
-        self._stack = PathStack()
-        self._queue = []
-        self._prev_line_number = 0
+        self._stack: PathStack = PathStack()
+        self._queue: list = []
+        self._prev_line_number: int = 0
 
     def validate_tree_data(self, node: TreeData) -> int:
         """ Ensure that the next TreeData is valid, relative to current state.

treescript_builder/input/line_reader.py

@@ -7,14 +7,15 @@ The Default Input Reader.
  - The Name String is the name of the line.
  Author: DK96-OS 2024 - 2025
 """
-from itertools import groupby
+from itertools import groupby, takewhile
 from sys import exit
 from typing import Generator
 
 from treescript_builder.data.tree_data import TreeData
 from treescript_builder.input.string_validation import validate_dir_name, validate_name
 
-SPACE_CHARS = (' ', ' ', ' ', ' ')
+
+SPACE_CHARS = (' ', ' ')
 
 
 def read_input_tree(input_tree_data: str) -> Generator[TreeData, None, None]:
@@ -57,9 +58,7 @@ def _process_line(
 **Raises:**
  SystemExit - When Line cannot be read successfully.
     """
-    # Calculate the Depth
-    depth = _calculate_depth(line)
-    if depth < 0:
+    if (depth := _calculate_depth(line)) < 0:
         exit(f"Invalid Space Count in Line: {line_number}")
     # Remove Space
     args = line.strip()
@@ -78,8 +77,7 @@ def _process_line(
     else:
         exit(f"Invalid Line: {line_number}")
     # Validate the Node Name and Type.
-    node_info = _validate_node_name(name)
-    if node_info is None:
+    if (node_info := _validate_node_name(name)) is None:
         exit(f'Invalid Node on Line: {line_number}')
     (is_dir, name) = node_info
     return TreeData(
@@ -126,11 +124,10 @@ def _calculate_depth(line: str) -> int:
 **Returns:**
  int: The depth of the line in the tree structure, or -1 if space count is invalid.
     """
-    from itertools import takewhile
     space_count = len(list(
         takewhile(lambda c: c in SPACE_CHARS, line)
     ))
     # Bit Shift Shuffle Equivalence Validation (space_count is divisible by 2)
     if (depth := space_count >> 1) << 1 == space_count:
         return depth
-    return -1  # Invalid Space Count! Someone made an off-by-one whitespace mistake!
+    return -1  # Invalid Space Count! Someone made an off-by-one whitespace mistake!

treescript_builder/tree/build_validation.py

@@ -1,4 +1,4 @@
-"""Tree Validation Methods for the Build Operation.
+""" Tree Validation Methods for the Build Operation.
  Author: DK96-OS 2024 - 2025
 """
 from pathlib import Path
@@ -23,11 +23,11 @@ def validate_build(
 **Returns:**
  tuple[InstructionData] - A generator that yields Instructions.
     """
-    if data_dir_path is None:
-        return tuple(iter(_validate_build_generator(tree_data)))
-    else:
-        data = DataDirectory(data_dir_path)
-        return tuple(iter(_validate_build_generator_data(tree_data, data)))
+    return tuple(
+        _validate_build_generator(tree_data)
+        if data_dir_path is None else
+        _validate_build_generator_data(tree_data, DataDirectory(data_dir_path))
+    )
 
 
 def _validate_build_generator(
@@ -37,7 +37,7 @@ def _validate_build_generator(
     for node in tree_data:
         # Error if any Nodes have Data Labels
         if node.data_label != '':
-            exit(f"Found Data Label on Line {node.line_number} with no Data Directory: {node.data_label}")
+            exit(f"No DataDirectory provided, but DataLabel found on Line: {node.line_number}")
         # Calculate Tree Depth Change
         if tree_state.validate_tree_data(node) == 0:
             if node.is_dir:
@@ -104,4 +104,4 @@ def _validate_build_generator_data(
                 )
     # Always Finish Build Sequence with ProcessQueue
     if (dir := tree_state.process_queue()) is not None:
-        yield InstructionData(True, dir)
+        yield InstructionData(True, dir)

treescript_builder/tree/trim_validation.py

@@ -19,16 +19,15 @@ def validate_trim(
 **Parameters:**
  - tree_data (Generator[TreeData]): The Generator that provides TreeData.
  - data_dir_path (Path?): The optional Path to a Data Directory. Default: None.
- - verbose (bool): Whether to print DataDirectory information during validation.
 
 **Returns:**
- tuple[InstructionData] - A generator that yields Instructions.
+ tuple[InstructionData] - A tuple of InstructionData.
     """
-    if data_dir_path is None:
-        return tuple(iter(_validate_trim_generator(tree_data)))
-    else:
-        data = DataDirectory(data_dir_path)
-        return tuple(iter(_validate_trim_generator_data(tree_data, data)))
+    return tuple(
+        _validate_trim_generator(tree_data)
+        if data_dir_path is None else
+        _validate_trim_generator_data(tree_data, DataDirectory(data_dir_path))
+    )
 
 
 def _validate_trim_generator(
@@ -48,7 +47,6 @@ def _validate_trim_generator(
             # Pop Stack to required Depth
             for i in tree_state.process_stack(node.depth):
                 yield InstructionData(True, i)
-            # Dir or File
             if node.is_dir:
                 tree_state.add_to_stack(node.name)
             else:
@@ -80,7 +78,6 @@ def _validate_trim_generator_data(
             # Pop Stack to required Depth
             for i in tree_state.process_stack(node.depth):
                 yield InstructionData(True, i)
-            # Dir or File
             if node.is_dir:
                 tree_state.add_to_stack(node.name)
             else:
@@ -91,4 +88,4 @@ def _validate_trim_generator_data(
                 )
     # Finish Trim Sequence with Pop Stack
     for i in tree_state.process_stack(0):
-        yield InstructionData(True, i)
+        yield InstructionData(True, i)

{treescript_builder-0.1.4.dist-info → treescript_builder-0.1.6.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: treescript-builder
-Version: 0.1.4
+Version: 0.1.6
 Summary: Builds File Trees from TreeScript. If DataLabels are present in TreeScript, a DataDirectory argument is required.
 Home-page: https://github.com/DK96-OS/treescript-builder
 Author: DK96-OS
@@ -13,9 +13,10 @@ Classifier: Operating System :: OS Independent
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
 Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
-Requires-Python: >=3.12
+Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Dynamic: author

{treescript_builder-0.1.4.dist-info → treescript_builder-0.1.6.dist-info}/RECORD

@@ -1,26 +1,26 @@
 treescript_builder/__init__.py,sha256=bPuoIR3cWkK2iW_IW5By4U0d797xVpWE2z4bSVEdQRg,117
-treescript_builder/__main__.py,sha256=axPC8V6yi58rbj8GpzxI9c7tc_5MKMomrkY2EbK5W58,583
+treescript_builder/__main__.py,sha256=IWk1m8kZFyd35b3HLGwcxqczqKWskt1keylKQFV7YNM,617
 treescript_builder/data/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-treescript_builder/data/data_directory.py,sha256=IaoAGRusyT1gPaBmKRP5YMLMKvaQPa7NG7bZJnrykRI,3140
+treescript_builder/data/data_directory.py,sha256=eqLLOyV2YTXHv1rU7xsE_Hn4oViJh4SrokRfbKfEgTA,3267
 treescript_builder/data/instruction_data.py,sha256=VqJ25-1Na0b2KamuKaVDN6qGPn-8Mm89tS1rt7_RzCY,533
-treescript_builder/data/path_stack.py,sha256=QqpbrhWH3VwVqbDGBZW_CU4WGiZ6f4T7eFHzTd5zL5I,2423
-treescript_builder/data/tree_data.py,sha256=zdICXPy48ysthu9PPAse00ZHdL-Lk1PKVhUp4pMgyQU,590
-treescript_builder/data/tree_state.py,sha256=bLTwKKPYIiLMExZzzMydZpGSAotzx3_W7wyrzWfb9PQ,4451
+treescript_builder/data/path_stack.py,sha256=L_1u6YVM13EO0YLzbmaA_fYCMJeN3vdTzgJBhEJX-hI,2367
+treescript_builder/data/tree_data.py,sha256=iyo-op0AmM9i_ypGXSROkbdax_YJgGsYLXKIlvmXmQ0,1035
+treescript_builder/data/tree_state.py,sha256=EJYSnioAlh4nD44xfeSTQrIY4WjUjckpAQ9m9MQANOo,4473
 treescript_builder/input/__init__.py,sha256=JONsaG0Iq_w-b9BUpHPpc89DFG8sM8Dxrswb3tWvzY8,921
 treescript_builder/input/argument_data.py,sha256=PFacb8g-RXh4-RH8foW4eINms6REWpm_knaehYAICfA,806
 treescript_builder/input/argument_parser.py,sha256=ARPI-EFO5MkXSQqLjyiQPkxg-sB2jP14wf6K4y64Tog,2795
 treescript_builder/input/file_validation.py,sha256=m0zxntGDkkzWLb3PQKKsxfRSSDgd0dhK35IbaUmN_gw,2404
 treescript_builder/input/input_data.py,sha256=mP8FAI26UDRwfuEFWXsJJnw77Qxv_yjkuy4NFiTZVOg,479
-treescript_builder/input/line_reader.py,sha256=_-mWwr9bfROFP34l9d787Qr7nNSqqMnzXMRKjlIwBQA,4410
+treescript_builder/input/line_reader.py,sha256=_jRwuODxT4frnQE0GkEPV6uJbUMpwKAc7EsR8mgSCEM,4333
 treescript_builder/input/string_validation.py,sha256=6H17UWamTPp2aBC-EVX1P58E0a-F6eD1--HH8CWrmIQ,5020
 treescript_builder/tree/__init__.py,sha256=3YgyrVcplTYEtFL9PuEM2k08LM8N8xsdRmNJR0rbA4s,1884
-treescript_builder/tree/build_validation.py,sha256=fQwNX_fovjvpq63HZ4NCYQxPrPYlmC_0gFK_LomF45I,4214
+treescript_builder/tree/build_validation.py,sha256=huO_FRnq_anqGTaQaDfcmc_zU9pIuVaa0orglNDgQIc,4167
 treescript_builder/tree/tree_builder.py,sha256=0OiJ_Rjpm9Ux1DXvP4d6lHw9CoUCpu6lTfxTmLVOTfQ,1862
 treescript_builder/tree/tree_trimmer.py,sha256=4cYrnAPX4WQi9JW60K20KPWb9aAtkPYTZWeZ4scEjps,1581
-treescript_builder/tree/trim_validation.py,sha256=W5FCLBLurHSQYUanU8VmJeprL11OVa7-Z2pCZ39IchQ,3357
-treescript_builder-0.1.4.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-treescript_builder-0.1.4.dist-info/METADATA,sha256=DvoJzrO4QRna-nUg5aHHvVJ29xNoSKzj1xsT-km8nCY,5248
-treescript_builder-0.1.4.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-treescript_builder-0.1.4.dist-info/entry_points.txt,sha256=eOmYzJQPcGaH2GGBfwwU6UH_33tGtsK_ogxB4DnVrFI,111
-treescript_builder-0.1.4.dist-info/top_level.txt,sha256=parytS3LU7PXBsMVe_puiTOva14bUCzvFwcIwF_Y3Ks,19
-treescript_builder-0.1.4.dist-info/RECORD,,
+treescript_builder/tree/trim_validation.py,sha256=1MJjVz2JMNTDIvgJD3BMDwpzOvrKw53XXB2LIRFIWkg,3177
+treescript_builder-0.1.6.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+treescript_builder-0.1.6.dist-info/METADATA,sha256=vV6W26xZ6NeaDy7sPiyXUXdePqOEXKebE6GqEHbCwzk,5299
+treescript_builder-0.1.6.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+treescript_builder-0.1.6.dist-info/entry_points.txt,sha256=eOmYzJQPcGaH2GGBfwwU6UH_33tGtsK_ogxB4DnVrFI,111
+treescript_builder-0.1.6.dist-info/top_level.txt,sha256=parytS3LU7PXBsMVe_puiTOva14bUCzvFwcIwF_Y3Ks,19
+treescript_builder-0.1.6.dist-info/RECORD,,