metapath 0.1.0__tar.gz

metapath-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Lockhart Lab
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

metapath-0.1.0/PKG-INFO

@@ -0,0 +1,20 @@
+Metadata-Version: 2.4
+Name: metapath
+Version: 0.1.0
+Summary: A package to combine paths with metadata
+Author-email: "C. Lockhart" <clockha2@gmu.edu>
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: numpy
+Requires-Dist: parse
+Requires-Dist: polars
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: black; extra == "dev"
+Dynamic: license-file
+
+metapath
+========
+
+A Python package for adding metadata to file paths.

metapath-0.1.0/README.md

@@ -0,0 +1,4 @@
+metapath
+========
+
+A Python package for adding metadata to file paths.

metapath-0.1.0/pyproject.toml

@@ -0,0 +1,27 @@
+[build-system]
+requires = ["setuptools>=68", "wheel", "setuptools_scm"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools_scm]
+write_to = "src/metapath/_version.py"
+version_scheme = "post-release"
+local_scheme = "no-local-version"
+
+[project]
+name = "metapath"
+dynamic = ["version"]
+description = "A package to combine paths with metadata"
+authors = [{ name="C. Lockhart", email="clockha2@gmu.edu" }]
+readme = "README.md"
+requires-python = ">=3.9"
+dependencies = [
+    "numpy",
+    "parse",
+    "polars",
+]
+
+[project.optional-dependencies]
+dev = ["pytest", "black"]
+
+[tool.setuptools.packages.find]
+where = ["src"]

metapath-0.1.0/scripts/pypi.sh

@@ -0,0 +1,3 @@
+python -m build
+twine upload dist/*
+rm -r dist

metapath-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

metapath-0.1.0/src/metapath/__init__.py

@@ -0,0 +1,8 @@
+
+from metapath.path import MetaPath, MetaPaths, find_meta_paths
+
+__all__ = [
+	"MetaPath",
+	"MetaPaths",
+	"find_meta_paths",
+]

metapath-0.1.0/src/metapath/_version.py

@@ -0,0 +1,24 @@
+# file generated by vcs-versioning
+# don't change, don't track in version control
+from __future__ import annotations
+
+__all__ = [
+    "__version__",
+    "__version_tuple__",
+    "version",
+    "version_tuple",
+    "__commit_id__",
+    "commit_id",
+]
+
+version: str
+__version__: str
+__version_tuple__: tuple[int | str, ...]
+version_tuple: tuple[int | str, ...]
+commit_id: str | None
+__commit_id__: str | None
+
+__version__ = version = '0.1.0'
+__version_tuple__ = version_tuple = (0, 1, 0)
+
+__commit_id__ = commit_id = 'g9be45d043'

metapath-0.1.0/src/metapath/path.py

@@ -0,0 +1,74 @@
+from collections.abc import Sequence
+from glob import glob
+import numpy as np
+import parse
+import pathlib
+import polars as pl
+import re
+
+
+class Path(pathlib.Path):
+    def __init__(self, path, metadata=None):
+        super().__init__(path)
+        self.metadata = metadata
+
+    def match(self, path_pattern):
+        for path_pattern in np.hstack([path_pattern]):
+            if super().match(path_pattern):
+                return True
+        return False
+
+# TODO does scan_csv belong here?
+class Paths(Sequence):
+    def __init__(self, paths):
+        if len(paths) != len(set(paths)):
+            raise AttributeError("paths are not unique")
+        self.paths = paths
+
+    def __getitem__(self, item):
+        return self.paths[item]
+
+    def __len__(self):
+        return len(self.paths)
+
+    @property
+    def metadata(self):
+        metadata = {path: path.metadata for path in self.paths}
+        return metadata
+
+    def to_frame(self):
+        data = [{"fname": str(key), **value} for key, value in self.metadata.items()]
+        return pl.DataFrame(data)
+
+    def to_polars(self, lazy=False):
+        df = self.to_frame()
+        if lazy:
+            df = df.lazy()
+        return df
+
+
+def var_paths(fstring, exclude=None, require_metadata=True):
+    """
+    Use an f-string to extract out a collection of paths, where the f-string variables are captured and stored along the path name.
+
+    Parameters
+    ----------
+    fstring : :obj:`str`
+    exclude : :obj:`bool`
+    require_metadata : :obj:`bool`
+    """
+
+    parser = parse.compile(fstring)
+
+    paths = []
+    for fname in glob(re.sub(r"\{.*?\}", "*", fstring)):
+        path = Path(fname)
+        if exclude and path.match(exclude):
+            continue
+        path.metadata = getattr(parser.parse(fname), "named", None)
+        if require_metadata and path.metadata is None:
+            msg = f"metadata not found for '{fname}' with fstring '{fstring}'"
+            raise AttributeError(msg)
+        paths.append(path)
+
+    return Paths(paths)

metapath-0.1.0/src/metapath.egg-info/PKG-INFO

@@ -0,0 +1,20 @@
+Metadata-Version: 2.4
+Name: metapath
+Version: 0.1.0
+Summary: A package to combine paths with metadata
+Author-email: "C. Lockhart" <clockha2@gmu.edu>
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: numpy
+Requires-Dist: parse
+Requires-Dist: polars
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: black; extra == "dev"
+Dynamic: license-file
+
+metapath
+========
+
+A Python package for adding metadata to file paths.

metapath-0.1.0/src/metapath.egg-info/SOURCES.txt

@@ -0,0 +1,12 @@
+LICENSE
+README.md
+pyproject.toml
+scripts/pypi.sh
+src/metapath/__init__.py
+src/metapath/_version.py
+src/metapath/path.py
+src/metapath.egg-info/PKG-INFO
+src/metapath.egg-info/SOURCES.txt
+src/metapath.egg-info/dependency_links.txt
+src/metapath.egg-info/requires.txt
+src/metapath.egg-info/top_level.txt

metapath-0.1.0/src/metapath.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

metapath-0.1.0/src/metapath.egg-info/requires.txt

@@ -0,0 +1,7 @@
+numpy
+parse
+polars
+
+[dev]
+pytest
+black

metapath-0.1.0/src/metapath.egg-info/top_level.txt

@@ -0,0 +1 @@
+metapath