treescript-builder 0.1.7__py3-none-any.whl → 0.1.9__py3-none-any.whl

treescript_builder/data/path_stack.py

@@ -11,7 +11,6 @@ class PathStack:
  - push(str)
  - pop: str?
  - join_stack: Path
- - create_path(str): Path
  - reduce_depth(int): bool
  - get_depth: int
     """
@@ -47,19 +46,6 @@ class PathStack:
             return Path("./")
         return Path(f"./{'/'.join(self._stack)}/")
 
-    def create_path(self, filename: str) -> Path:
-        """ Combines all Elements in the Stack and appends a File name.
-
-**Parameters:**
- - filename (str): The name of the file to append to the end of the path.
-
-**Returns:**
- Path - The Path to the file.
-        """
-        if type(filename) is not str or len(filename) < 1:
-            return self.join_stack()
-        return self.join_stack() / filename
-
     def reduce_depth(self, depth: int) -> bool:
         """ Reduce the Depth of the Path Stack.
 
@@ -84,4 +70,4 @@ class PathStack:
 **Returns:**
  int - The number of elements in the Path Stack.
         """
-        return len(self._stack)
+        return len(self._stack)

treescript_builder/data/tree_state.py

@@ -102,18 +102,19 @@ class TreeState:
 
     def process_stack(self, depth: int) -> Generator[Path, None, None]:
         """ Pop the Stack to the Desired Depth.
+        - Combines all Elements in the Stack into a Directory Path.
 
-        Parameters:
+        **Parameters:**
          - depth (int): The depth to process the stack to.
 
-        Returns:
-         Generator[Path] - Provides a Path for each entry in the Stack.
+        **Yields:**
+         Path - A Path for every Directory in the Stack, from top to bottom.
         """
         if depth < 0:
-            exit('Invalid Depth')
+            raise ValueError('Negative Depth.')
         while depth < self._stack.get_depth():
             if (entry := self._stack.pop()) is not None:
-                yield self._stack.create_path(entry)
+                yield self._stack.join_stack() / entry
 
     def reduce_depth(self, depth: int) -> bool:
         """ Pop an element from the stack.
@@ -135,7 +136,6 @@ class TreeState:
         Raises:
          SystemExit - When the Line Number does not increase.
         """
-        if self._prev_line_number < line_number:
-            self._prev_line_number = line_number
-        else:
-            exit("Invalid Tree Data Sequence")
+        if self._prev_line_number >= line_number:
+            exit("Invalid Tree Data Sequence")
+        self._prev_line_number = line_number

treescript_builder/input/line_reader.py

@@ -1,24 +1,34 @@
-""" Line Reader.
+""" Line Reader Module for Processing TreeScript.
 
 The Default Input Reader.
  - Processes a single line at a time, and determines its key properties.
  - The Depth is the Integer number of directories between the current line and the root.
  - The Directory Boolean indicates whether the line represents a Directory.
  - The Name String is the name of the line.
+ - DataLabel is the first word after the Name, and it has a strict set of validation criteria.
+ - Comments are filtered out by starting a line with the # character. A comment after a file name is also filtered.
  Author: DK96-OS 2024 - 2025
 """
-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
+from treescript_builder.input.string_validation import validate_dir_name, validate_name, validate_data_label
 
 
 SPACE_CHARS = (' ', ' ')
 
 
-def read_input_tree(input_tree_data: str) -> Generator[TreeData, None, None]:
+_INVALID_DEPTH_ERROR_MSG = "Invalid Depth (Number of Spaces) in Line: "
+
+_INVALID_NODE_NAME_ERROR_MSG = "Invalid Name in Line: "
+_INVALID_DATALABEL_ERROR_MSG = "Invalid DataLabel in Line: "
+_MISSING_DATADIR_ERROR_MSG = "Missing DataDirectory for DataLabel in Line: "
+
+
+def read_input_tree(
+    input_tree_data: str,
+) -> Generator[TreeData, None, None]:
     """ Generate structured Tree Data from the Input Data String.
 
 **Parameters:**
@@ -30,15 +40,10 @@ def read_input_tree(input_tree_data: str) -> Generator[TreeData, None, None]:
 **Raises:**
  SystemExit - When any Line cannot be read successfully.
     """
-    line_number = 1
-    for is_newline, group in groupby(input_tree_data, lambda x: x in ["\n", "\r"]):
-        if is_newline:
-            line_number += sum(1 for _ in group) # Line number increase by size of group
-        else:
-            line = ''.join(group)
-            if len(lstr := line.lstrip()) == 0 or lstr.startswith('#'):
-                continue
-            yield _process_line(line_number, line)
+    for line_number, line in enumerate(input_tree_data.splitlines(), start=1):
+        if len(lstr := line.lstrip()) == 0 or lstr.startswith('#'):
+            continue
+        yield _process_line(line_number, line)
 
 
 def _process_line(
@@ -51,44 +56,59 @@ def _process_line(
 **Parameters:**
  - line_number (int): The line-number in the input tree structure, starting from 1.
  - line (str): A line from the input tree structure.
+ - is_data_label_enabled (bool): Whether DataLabels are enabled. If the DataDirectory argument is not provided, DataLabels are disabled.
 
 **Returns:**
- tuple: (int, bool, str, str) where int is the depth, bool is true when is Directory, and str is name, followed by str data.
+ TreeData - A Tree Node Data object.
 
 **Raises:**
  SystemExit - When Line cannot be read successfully.
     """
+    # Depth Depends on Leading Spaces
     if (depth := _calculate_depth(line)) < 0:
-        exit(f"Invalid Space Count in Line: {line_number}")
-    # Remove Space
+        exit(_INVALID_DEPTH_ERROR_MSG + str(line_number))
+    # Now remove Leading Spaces (and trailing)
     args = line.strip()
-    # Try to split line into multiple arguments
+    # Try to split line into multiple arguments, on one of the SpaceChars.
     for space_char in SPACE_CHARS:
         if space_char in args:
             args = args.split(space_char)
             break
     # Check whether line was split or not
     if isinstance(args, str):
-        name = args
-        data_label = ""
+        name = args  # Was Not Split
+        data_label = ''
     elif isinstance(args, list) and len(args) >= 2:
-        name = args[0]
-        data_label = args[1]
+        name = args[0]  # First Word is the Tree Node Name.
+        # Second Word is the DataLabel.
+        data_label = _validate_data_label_argument(line_number, args[1])
+        # Additional Words are ignored. Comments after the DataLabel are possible, for now. 
+        # Alternate LineReader Modules are likely to expand in this area:
     else:
         exit(f"Invalid Line: {line_number}")
-    # Validate the Node Name and Type.
+    # Validate the Node Name and Type (is_dir). The tuple is bool first, then node name.
     if (node_info := _validate_node_name(name)) is None:
-        exit(f'Invalid Node on Line: {line_number}')
-    (is_dir, name) = node_info
+        exit(_INVALID_NODE_NAME_ERROR_MSG + str(line_number))
     return TreeData(
-        line_number,
-        depth,
-        is_dir,
-        name,
-        data_label
+        line_number=line_number,
+        depth=depth,
+        is_dir=node_info[0],
+        name=node_info[1],
+        data_label=data_label,
     )
 
 
+def _validate_data_label_argument(
+    line_number: int,
+    argument: str,
+) -> str:
+    if argument.startswith('#'):  # Comment should be ignored.
+        return ''
+    elif not validate_data_label(argument):
+        exit(_INVALID_DATALABEL_ERROR_MSG + str(line_number))
+    return argument
+
+
 def _validate_node_name(node_name: str) -> tuple[bool, str] | None:
     """ Determine whether this Tree Node is a Directory, and validate the name.
 
@@ -96,7 +116,7 @@ def _validate_node_name(node_name: str) -> tuple[bool, str] | None:
  - node_name (str): The argument received for the node name.
 
 **Returns:**
- tuple[bool, str] - Node information, first whether it is a directory, then the valid name of the node.
+ tuple[bool, str]? - Node information, first whether it is a directory, then the valid name of the node.
     
 **Raises:**
  SystemExit - When the directory name is invalid.
@@ -104,14 +124,14 @@ def _validate_node_name(node_name: str) -> tuple[bool, str] | None:
     try:
         # Check if the line contains any slash characters
         if (dir_name := validate_dir_name(node_name)) is not None:
-            return (True, dir_name)
+            return True, dir_name
         # Fall-Through to File Node
     except ValueError:
         # An error in the dir name, such that it cannot be a file either
         return None
     # Is a File
     if validate_name(node_name):
-        return (False, node_name)
+        return False, node_name
     return None
 
 
@@ -122,11 +142,13 @@ def _calculate_depth(line: str) -> int:
  - line (str): A line from the tree command output.
 
 **Returns:**
- int: The depth of the line in the tree structure, or -1 if space count is invalid.
+ int - The depth of the line in the tree structure, or -1 if space count is invalid.
     """
-    space_count = len(list(
-        takewhile(lambda c: c in SPACE_CHARS, line)
-    ))
+    space_count = 0
+    for char in line:
+        if char not in SPACE_CHARS:
+            break
+        space_count += 1
     # Bit Shift Shuffle Equivalence Validation (space_count is divisible by 2)
     if (depth := space_count >> 1) << 1 == space_count:
         return depth

{treescript_builder-0.1.7.dist-info → treescript_builder-0.1.9.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: treescript-builder
-Version: 0.1.7
+Version: 0.1.9
 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
@@ -16,6 +16,7 @@ Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE

{treescript_builder-0.1.7.dist-info → treescript_builder-0.1.9.dist-info}/RECORD

@@ -3,24 +3,24 @@ treescript_builder/__main__.py,sha256=IWk1m8kZFyd35b3HLGwcxqczqKWskt1keylKQFV7YN
 treescript_builder/data/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 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=L_1u6YVM13EO0YLzbmaA_fYCMJeN3vdTzgJBhEJX-hI,2367
+treescript_builder/data/path_stack.py,sha256=2u7MKv57l_-YB1Cgr81woZGJdJCke7hCNR27T9r4za8,1932
 treescript_builder/data/tree_data.py,sha256=iyo-op0AmM9i_ypGXSROkbdax_YJgGsYLXKIlvmXmQ0,1035
-treescript_builder/data/tree_state.py,sha256=EJYSnioAlh4nD44xfeSTQrIY4WjUjckpAQ9m9MQANOo,4473
+treescript_builder/data/tree_state.py,sha256=luWdxLxMrqaDRuNVLz7BKy_ZW4nYrGUymUdshOHmkI0,4553
 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=_jRwuODxT4frnQE0GkEPV6uJbUMpwKAc7EsR8mgSCEM,4333
+treescript_builder/input/line_reader.py,sha256=RDft2rW2Apkd56rQJ8_ngkVyrp3DOh2KtJT6DamXlqI,5492
 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=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=Q49ufnISQxZDzsnvMWrF5cMxRSZQYAhgpY_2XdIjnzI,3353
-treescript_builder-0.1.7.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-treescript_builder-0.1.7.dist-info/METADATA,sha256=5G-RUeotPkqu4Nk0VSu4nS7a76q0QwBfa17K48D_i5w,5299
-treescript_builder-0.1.7.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-treescript_builder-0.1.7.dist-info/entry_points.txt,sha256=eOmYzJQPcGaH2GGBfwwU6UH_33tGtsK_ogxB4DnVrFI,111
-treescript_builder-0.1.7.dist-info/top_level.txt,sha256=parytS3LU7PXBsMVe_puiTOva14bUCzvFwcIwF_Y3Ks,19
-treescript_builder-0.1.7.dist-info/RECORD,,
+treescript_builder-0.1.9.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+treescript_builder-0.1.9.dist-info/METADATA,sha256=G25tjXNH71GnYyOsMqchowmS1H3z3lw4kD4rrfjC6WE,5350
+treescript_builder-0.1.9.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+treescript_builder-0.1.9.dist-info/entry_points.txt,sha256=eOmYzJQPcGaH2GGBfwwU6UH_33tGtsK_ogxB4DnVrFI,111
+treescript_builder-0.1.9.dist-info/top_level.txt,sha256=parytS3LU7PXBsMVe_puiTOva14bUCzvFwcIwF_Y3Ks,19
+treescript_builder-0.1.9.dist-info/RECORD,,