csvpath 0.0.613__tar.gz → 0.0.614__tar.gz

{csvpath-0.0.613 → csvpath-0.0.614}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: csvpath
-Version: 0.0.613
+Version: 0.0.614
 Summary: CsvPath Framework is a data preboarding automation library for receiving, validating, and tracking CSV, Excel, JSONL and other tabular data files before they can corrupt downstream data consumers.
 License-File: LICENSE
 Author: David Kershaw

{csvpath-0.0.613 → csvpath-0.0.614}/csvpath/managers/files/file_manager.py

@@ -1,6 +1,7 @@
 import re
 import json
 import traceback
+from uuid import UUID
 from typing import NewType
 from json import JSONDecodeError
 from csvpath.util.file_readers import DataFileReader
@@ -53,18 +54,6 @@ class FileManager:
     def activator(self) -> NamedFileActivator:
         return NamedFileActivator(self)
 
-    """
-    @property
-    def nos(self) -> Nos:
-        box = Box()
-        if self._nos is None:
-            self._nos = box.get("boto_s3_nos")
-            if self._nos is None:
-                self._nos = Nos(None)
-                box.add("boto_s3_nos", self._nos)
-        return self._nos
-    """
-
     @property
     def csvpaths(self):
         """@private"""
@@ -186,6 +175,13 @@ class FileManager:
                         return _["uuid"]
         raise ValueError(f"No matching UUID found for file {file} in {name}")
 
+    def get_reference_for_uuid(self, name:NamedFileName, uuid:str) -> str|None:
+        mani = self.get_manifest(name)
+        for _ in mani:
+            if uuid == _["uuid"]:
+                return _["reference"]
+        return None
+
     def get_manifest(self, name: NamedFileName) -> json:
         if name is None:
             raise ValueError("Paths name cannot be None")
@@ -602,6 +598,7 @@ class FileManager:
         path: str,
         template: str = None,
         config: Config = None,
+        registration_uuid:str = None
     ) -> str | None:
         #
         # note that we can pass in a Config with a template that is different
@@ -609,6 +606,15 @@ class FileManager:
         # using the arg, not the template from the config.
         #
         self.csvpaths.logger.info("Adding named file %s from %s", name, path)
+        if registration_uuid is not None:
+            #
+            # check that we have a real uuid and if not blow up before registration
+            # blowing up seems right here, rather than checking should_i_raise because
+            # we're looking at a serious development problem, rather than a runtime
+            # issue driven by the 3rd party or business rules.
+            #
+            UUID(registration_uuid)
+            self.csvpaths.logger.info("Registration of %s will be associated with UUID %s", path, registration_uuid)
         if not self.can_load(path):
             #
             # if False, can_load() will have already raised an error and/or, minimally,
@@ -716,7 +722,6 @@ class FileManager:
             #
             if mark is not None:
                 self._validate_xlsx_mark(path, mark)
-
             #
             # exp: moving docs and descriptor to above copy_in()
             #
@@ -729,13 +734,9 @@ class FileManager:
             self._copy_in(name=name, path=path, home=home, template=template)
             self.csvpaths.logger.debug("Done copying in")
             #
-            #
-            #
             # self.assure_docs_and_discriptor(name)
             # self.csvpaths.logger.debug("Assured docs and discriptor")
             #
-            # end exp!
-            #
             # create the reference to the bytes/version added to the named-file.
             # this is the most specific reference possible. we return it when we're
             # done here.
@@ -754,6 +755,15 @@ class FileManager:
             name_home = self.named_file_home(name)
             self.csvpaths.logger.debug("Name home is %s", name_home)
             mdata = FileMetadata(self.csvpaths.config)
+            #
+            # add the ability to pass in a UUID. if received, use it here to
+            # set the FileMetadata's UUID. this will allow the caller to give a
+            # trackable ticket. for e.g. we may want to spin-up a registration in
+            # a thread, create our own UUID, pass it in for the registration, and
+            # return the UUID to the user so they can retrieve the reference later
+            #
+            if registration_uuid is not None:
+                mdata.uuid_string = registration_uuid
             mdata.named_file_name = name
             mdata.named_file_ref = ret
             #
@@ -767,7 +777,6 @@ class FileManager:
             mdata.fingerprint = h
             mdata.file_path = rpath
             mdata.file_home = file_home
-            # nos = self.nos
             nos.path = file_home
             mdata.file_name = file_home[file_home.rfind(nos.sep) + 1 :]
             mdata.name_home = name_home

{csvpath-0.0.613 → csvpath-0.0.614}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "csvpath"
-version = "0.0.613"
+version = "0.0.614"
 description = "CsvPath Framework is a data preboarding automation library for receiving, validating, and tracking CSV, Excel, JSONL and other tabular data files before they can corrupt downstream data consumers."
 authors = ["David Kershaw <info@csvpath.org>"]
 readme = "README.md"