ebk 0.3.1__py3-none-any.whl → 0.3.2__py3-none-any.whl

ebk/vfs/resolver.py

@@ -0,0 +1,228 @@
+"""Path resolution for the Virtual File System.
+
+Handles path parsing and navigation (cd, ls semantics).
+"""
+
+from pathlib import PurePosixPath
+from typing import Optional, List, Tuple
+
+from ebk.vfs.base import Node, DirectoryNode, SymlinkNode
+
+
+class PathResolver:
+    """Resolves paths in the VFS and handles navigation.
+
+    This class provides the core navigation logic for cd, ls, etc.
+    It handles:
+    - Absolute paths: /books/42/title
+    - Relative paths: ../other, ./files
+    - Special paths: ., .., ~
+    - Symlink resolution
+    """
+
+    def __init__(self, root: DirectoryNode):
+        """Initialize path resolver.
+
+        Args:
+            root: Root node of the VFS
+        """
+        self.root = root
+
+    def resolve(
+        self,
+        path: str,
+        current: DirectoryNode,
+        follow_symlinks: bool = True,
+    ) -> Optional[Node]:
+        """Resolve a path to a node.
+
+        Args:
+            path: Path to resolve (absolute or relative)
+            current: Current working directory
+            follow_symlinks: Whether to follow symlinks
+
+        Returns:
+            Resolved node or None if path doesn't exist
+        """
+        # Handle empty path
+        if not path or path == ".":
+            return current
+
+        # Parse path
+        parts = self._parse_path(path)
+
+        # Start from root or current directory
+        if path.startswith("/"):
+            node = self.root
+        else:
+            node = current
+
+        # Navigate through path parts
+        for part in parts:
+            if part == "." or part == "":
+                continue
+            elif part == "..":
+                # Go to parent
+                if node.parent is not None:
+                    node = node.parent
+                # Stay at root if already at root
+            else:
+                # Navigate to child
+                if not isinstance(node, DirectoryNode):
+                    # Can't cd into a file
+                    return None
+
+                child = node.get_child(part)
+                if child is None:
+                    return None
+
+                # Follow symlinks if requested
+                if follow_symlinks and isinstance(child, SymlinkNode):
+                    child = self.resolve(child.target_path, current, follow_symlinks=True)
+                    if child is None:
+                        return None
+
+                node = child
+
+        return node
+
+    def resolve_directory(
+        self,
+        path: str,
+        current: DirectoryNode,
+    ) -> Optional[DirectoryNode]:
+        """Resolve a path to a directory node.
+
+        Args:
+            path: Path to resolve
+            current: Current working directory
+
+        Returns:
+            Directory node or None if path doesn't exist or isn't a directory
+        """
+        node = self.resolve(path, current)
+        if node is None or not isinstance(node, DirectoryNode):
+            return None
+        return node
+
+    def normalize_path(self, path: str, current: DirectoryNode) -> str:
+        """Normalize a path to absolute form.
+
+        Args:
+            path: Path to normalize
+            current: Current working directory
+
+        Returns:
+            Normalized absolute path
+        """
+        # Resolve to node first
+        node = self.resolve(path, current)
+        if node is None:
+            # Path doesn't exist, do best effort normalization
+            return self._normalize_nonexistent(path, current)
+
+        return node.get_path()
+
+    def complete_path(
+        self,
+        partial: str,
+        current: DirectoryNode,
+    ) -> List[str]:
+        """Get completion candidates for a partial path.
+
+        Used for tab completion.
+
+        Args:
+            partial: Partial path to complete
+            current: Current working directory
+
+        Returns:
+            List of completion candidates
+        """
+        # Split into directory part and filename part
+        if "/" in partial:
+            dir_part, file_part = partial.rsplit("/", 1)
+            if partial.startswith("/"):
+                dir_part = "/" + dir_part if dir_part else "/"
+        else:
+            dir_part = ""
+            file_part = partial
+
+        # Resolve directory
+        if dir_part:
+            dir_node = self.resolve_directory(dir_part, current)
+        else:
+            dir_node = current
+
+        if dir_node is None:
+            return []
+
+        # Get children and filter by prefix
+        children = dir_node.list_children()
+        candidates = []
+
+        for child in children:
+            if child.name.startswith(file_part):
+                if dir_part:
+                    candidates.append(f"{dir_part}/{child.name}")
+                else:
+                    candidates.append(child.name)
+
+                # Add trailing slash for directories
+                if isinstance(child, DirectoryNode):
+                    candidates[-1] += "/"
+
+        return candidates
+
+    def _parse_path(self, path: str) -> List[str]:
+        """Parse a path into parts.
+
+        Args:
+            path: Path to parse
+
+        Returns:
+            List of path components
+        """
+        # Use PurePosixPath for Unix-style path handling
+        posix_path = PurePosixPath(path)
+
+        # Get parts (excluding the root /)
+        parts = posix_path.parts
+        if parts and parts[0] == "/":
+            parts = parts[1:]
+
+        return list(parts)
+
+    def _normalize_nonexistent(self, path: str, current: DirectoryNode) -> str:
+        """Normalize a path that doesn't exist.
+
+        Args:
+            path: Path to normalize
+            current: Current working directory
+
+        Returns:
+            Best-effort normalized path
+        """
+        if path.startswith("/"):
+            # Already absolute
+            return str(PurePosixPath(path))
+
+        # Make relative path absolute
+        current_path = current.get_path()
+        combined = PurePosixPath(current_path) / path
+        return str(combined)
+
+
+class PathError(Exception):
+    """Error resolving a path."""
+    pass
+
+
+class NotADirectoryError(PathError):
+    """Attempted to cd into a non-directory."""
+    pass
+
+
+class NotFoundError(PathError):
+    """Path does not exist."""
+    pass

{ebk-0.3.1.dist-info → ebk-0.3.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ebk
-Version: 0.3.1
+Version: 0.3.2
 Summary: A lightweight, extensible tool for managing eBook metadata
 Home-page: https://github.com/queelius/ebk
 Author: Alex Towell

ebk-0.3.2.dist-info/RECORD

@@ -0,0 +1,69 @@
+ebk/__init__.py,sha256=KK5aFY07PvPB8LjfNJ_xAuWft6uyIMsiK6vrvhyyg14,790
+ebk/cli.py,sha256=oAG25LPGJH0QZPQJVGEpiHCcgdaPw4sn5mN0knhRX_M,112835
+ebk/config.py,sha256=P090sNH2YSnNNteXjim2_WYN9j2BC_GU5o0wQIwSbT4,7364
+ebk/decorators.py,sha256=MpAD1Wwy3o4l0sEiq4EIy5YtKMKf_nXtu7jpV64Uvyc,5179
+ebk/extract_metadata.py,sha256=epMn9_4zQYiytBwj25_-rYl0QmPN4cP25DuxMnijNMU,12228
+ebk/ident.py,sha256=yRIKVA0rpyhdPCxl0Vx7iu3YOebE8Yvbv32iCJmKk-Y,3324
+ebk/library_db.py,sha256=BEwqvoR8Ayec53ptmVcRsL2oTTlHj1_w0WP_j1ONfSA,29535
+ebk/search_parser.py,sha256=NRVbGnaOWxbc1WtsoFVINjHqCMBEubrKBxY2b_HQqJY,14848
+ebk/server.py,sha256=x5vpQmZjGAwJVgmUq8l8Z1owfoqg2weuUVBovEWVE-s,59036
+ebk/ai/__init__.py,sha256=-0vfDHdht8ZasYvl33nyGoWCaZxKIn_en0PxZdRQMkw,686
+ebk/ai/knowledge_graph.py,sha256=Xp4Ao1fVwp6oKyBG1hDroAqPTADyyUGG86WczvLRDzg,16504
+ebk/ai/metadata_enrichment.py,sha256=jQrqwjTzZkxzkJdxdwQCN1Cchkwa6jibHd8r5hjYosw,12364
+ebk/ai/question_generator.py,sha256=ev1wEmgIDxnb_kaZdiLh0Z1TW7HUjb_HR1NlsBmdduQ,11363
+ebk/ai/reading_companion.py,sha256=8GHiA9tR-vb28eCS3FmpDmRMX2OMyg5IP8AhPZ7c-Vg,7948
+ebk/ai/semantic_search.py,sha256=i0qY6cEr_89RWxTdJpnMoHu-l4csYIdDi6nh17asyfQ,15218
+ebk/ai/text_extractor.py,sha256=SOi7VgiAupZTfh4GG8XDB5N2AMeEP727o_eVlTdlhiQ,13918
+ebk/ai/llm_providers/__init__.py,sha256=dqXtt2zh2iAHfpBLRQWpyDIOrJ8IggcxwvD0isHplcI,438
+ebk/ai/llm_providers/base.py,sha256=am-TO4LTYLNeyMop9qy4TQdS7LJ2VTNvqy4iri1YvNk,5694
+ebk/ai/llm_providers/ollama.py,sha256=MwXhJSsAc7cYfKyrmiXvk25QzIpvfNOZcugs9TNZta8,10132
+ebk/db/__init__.py,sha256=CN1R77Ut5ai8kGSh1ohprGaS5qvOUMdtMT-y--5DIpw,792
+ebk/db/migrations.py,sha256=H0nAl8I-hUKctV7sPj14iockSL9IL0qHihy3krxZPsc,5513
+ebk/db/models.py,sha256=PGcq9knATE06_MStiCpg7zNvO2nDhU592xDt0vhNCxg,19967
+ebk/db/session.py,sha256=3Oc7Xo1gb7B430JtKRtF4JFyFi8hdIKz1GQq-Bjjz_o,3549
+ebk/exports/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+ebk/exports/base_exporter.py,sha256=OQFmuyP9vxB5SVErTacOGonjD2Kyc1j1_1G9VcpdlDY,6783
+ebk/exports/html_library.py,sha256=L8b__nU_c_4nZYym-W_M90Eb-GRVZfb3OqLm0nE-0Lk,54107
+ebk/exports/html_utils.py,sha256=ft4PLHBKjx6OFD3bxCEI9tpaEUEqWzhLNqwKc196ulo,3899
+ebk/exports/hugo.py,sha256=0rKNCegtm_Xd2g7IU77DmzlNiHZkoHTd2Wyr_y2gLRk,2209
+ebk/exports/jinja_export.py,sha256=wWy_eQIp16yuZ0i-Ssj8PaGHSNiSdjOwjt5OpKuv-q0,10996
+ebk/exports/multi_facet_export.py,sha256=xgy5Vjkow49ESVUXcjmLcTbMa-nSyaAlYW8HH-SeB4U,6364
+ebk/exports/symlink_dag.py,sha256=ChTSp9qA5Ibui4eIFfbWNDeYBfYh--RtOI4RvP54-Vs,20499
+ebk/exports/zip.py,sha256=erteF1NcymUbka5m_pnXWaRZmkUihALXe4A_cYg8hXs,779
+ebk/plugins/__init__.py,sha256=-YhhLSqVI6lZSCoW-8fJfib7qL12AO3h4IGOFGcs_qU,765
+ebk/plugins/base.py,sha256=x523_EFtHiFgBBTJqzgArIF8D8KtmD20jJUTqew29eM,14121
+ebk/plugins/hooks.py,sha256=ym7fkmqqirc17Q5GYtOO6ahfyYMJHUX1QwRUkwaZs20,14442
+ebk/plugins/registry.py,sha256=xCmKMc1ioSpXM8nBPcep5RxUy-BZQMKYCInDp2NqzWY,15497
+ebk/repl/__init__.py,sha256=zSAp76GfAEtxYsXe8W2m-PtDFeHX668y6jnpzz2yeWA,252
+ebk/repl/find.py,sha256=Yl-4qv_uKl8dJefHzCyNpjJxngtB_fxj4MqXbMGEkKc,3799
+ebk/repl/grep.py,sha256=VIFdcMrFqSHBB2rmLllf9PDW4UjBelf60znUPfBh-AA,4802
+ebk/repl/shell.py,sha256=emzjK1aXiGnYdEAwUybntnaXS62tQhtQZkDeQ3sDIGg,60896
+ebk/repl/text_utils.py,sha256=nSCE-qPL3xHyXjt_5ltjYnOCBXpyPqJiyaKztrfAKuQ,8382
+ebk/services/__init__.py,sha256=j6Gqdqp7MRRWIuSjJH_3TxL7JA5nID4kcNGbWXKXcDs,199
+ebk/services/import_service.py,sha256=WThx2sEuooFQwgFmjyuOZPlIo8FQ-08g-CzVr5r6QaQ,16478
+ebk/services/tag_service.py,sha256=KhuYqSUalOmQc1ikfrfEZ1__wf9f-VVEoWPpFSSGMi0,7982
+ebk/services/text_extraction.py,sha256=jUPBolw45w5cKuL0m92K1i2Qo0FrqCwoX8p7GuBxvzU,10525
+ebk/similarity/__init__.py,sha256=ySprbU_qfMuOEFyUqnBHe-4HSyvGyZHjRUZ4y6Z20-A,1942
+ebk/similarity/base.py,sha256=uWY1whl1jdjvntnuOaB9Mal3f3yiLt7HqjHSBZyM324,4473
+ebk/similarity/core.py,sha256=ohXY61L3xUOjcbtIkfqLwRKiiEST_oTRt8TFLdXIReQ,13340
+ebk/similarity/extractors.py,sha256=UqxnIWM2sBdY_d6mse_NYTuOxdT2f7rtPDfe9b8QR0k,4220
+ebk/similarity/metrics.py,sha256=2rbX10xXauebBSH7fKN9fCSMgSOuxRHKwUyJhd_hFfU,10419
+ebk/vfs/__init__.py,sha256=5d2jCVRNboJlD576IrFWKIUeOVVVv3zVdyMbSMZ0zEY,3129
+ebk/vfs/base.py,sha256=NkOBkefa6I4O1_GY0SmBFHMHhQbt7edyNAR8ncZeVWM,8231
+ebk/vfs/library_vfs.py,sha256=Lkrn1Wkx2f5qnegnmLGUKiHUfOOUoqnQOADq80xaJNg,3353
+ebk/vfs/resolver.py,sha256=D_pvOzmeErl8oMxw73g4X4nKBzxc_OgoAmHDDP_fJA4,6228
+ebk/vfs/nodes/__init__.py,sha256=W6MCMNUh8129Uw2xtNoWi00rrMHNreTXb26KS7IrXrA,1360
+ebk/vfs/nodes/authors.py,sha256=Dqr8Leb2NM3W_qKwvEz8r3-C3uNFQVjNGxf56-qhm9c,5731
+ebk/vfs/nodes/books.py,sha256=5YzFXFKrK1aUCzD7uAYPmuGCTVh_j4vj9VNfVFywo9o,15461
+ebk/vfs/nodes/files.py,sha256=49kCsPFe5zBstcUcC44E-KEUHkoHTKT6AzQOXhirnDA,4673
+ebk/vfs/nodes/metadata.py,sha256=wo2TDV2JshuWAzdjGEVOWM5-9S3XwqoRoqRIgSX3o1g,11392
+ebk/vfs/nodes/root.py,sha256=4WkU3GnNcnnqg6dpkjUXI0pnWX4oAR6UJDNpEqIexLs,3030
+ebk/vfs/nodes/similar.py,sha256=LJeFZigiu7dDyduGi9SJrxNJNP_qix661o8pyGsARFs,4866
+ebk/vfs/nodes/subjects.py,sha256=7U9Raj0b2PXb6LfOo3zlHAqTD0lW3IQk7m5u0nU8WPU,5327
+ebk/vfs/nodes/tags.py,sha256=uFJ5lWQYXD0dDmRP6v9NpfQDieTZJfGtSgaz2zzHVZo,11119
+ebk-0.3.2.dist-info/licenses/LICENSE,sha256=1eh_aOAZz71hpva42M9f8Vqj_FtSUqzE-1EimifmM_8,1068
+ebk-0.3.2.dist-info/METADATA,sha256=P7E6L37hRP087ibZqpd4EV4szzlIHLh_cgAGxkYHOk4,21712
+ebk-0.3.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+ebk-0.3.2.dist-info/entry_points.txt,sha256=M24WNtCeBq-nmIDPU-3i0DtM9VP3bM_ul2nQIC1r_RA,36
+ebk-0.3.2.dist-info/top_level.txt,sha256=OLATFvDsJQh-6TqJCili349OH47DoH-6dMih88BWcyg,4
+ebk-0.3.2.dist-info/RECORD,,

ebk-0.3.2.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+ebk = ebk.cli:app

ebk-0.3.2.dist-info/top_level.txt

@@ -0,0 +1 @@
+ebk

ebk-0.3.1.dist-info/RECORD

@@ -1,19 +0,0 @@
-ebk/__init__.py,sha256=KK5aFY07PvPB8LjfNJ_xAuWft6uyIMsiK6vrvhyyg14,790
-ebk/cli.py,sha256=KkqLqenlNdTE3gJqVvlxTt1_yNfW1wqXc4N7222MkYo,73606
-ebk/config.py,sha256=P090sNH2YSnNNteXjim2_WYN9j2BC_GU5o0wQIwSbT4,7364
-ebk/decorators.py,sha256=MpAD1Wwy3o4l0sEiq4EIy5YtKMKf_nXtu7jpV64Uvyc,5179
-ebk/extract_metadata.py,sha256=epMn9_4zQYiytBwj25_-rYl0QmPN4cP25DuxMnijNMU,12228
-ebk/ident.py,sha256=yRIKVA0rpyhdPCxl0Vx7iu3YOebE8Yvbv32iCJmKk-Y,3324
-ebk/library_db.py,sha256=6CE00cLY2Ris-qxdS_sakJh4sI0rDA1kdQnk8hgL8Hg,24676
-ebk/search_parser.py,sha256=NRVbGnaOWxbc1WtsoFVINjHqCMBEubrKBxY2b_HQqJY,14848
-ebk/server.py,sha256=x5vpQmZjGAwJVgmUq8l8Z1owfoqg2weuUVBovEWVE-s,59036
-ebk/plugins/__init__.py,sha256=-YhhLSqVI6lZSCoW-8fJfib7qL12AO3h4IGOFGcs_qU,765
-ebk/plugins/base.py,sha256=x523_EFtHiFgBBTJqzgArIF8D8KtmD20jJUTqew29eM,14121
-ebk/plugins/hooks.py,sha256=ym7fkmqqirc17Q5GYtOO6ahfyYMJHUX1QwRUkwaZs20,14442
-ebk/plugins/registry.py,sha256=xCmKMc1ioSpXM8nBPcep5RxUy-BZQMKYCInDp2NqzWY,15497
-ebk-0.3.1.dist-info/licenses/LICENSE,sha256=1eh_aOAZz71hpva42M9f8Vqj_FtSUqzE-1EimifmM_8,1068
-ebk-0.3.1.dist-info/METADATA,sha256=Rr795fgxinK8mNJ8zLVKXGWNZ_D65xxE1CY5Gl0D58s,21712
-ebk-0.3.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-ebk-0.3.1.dist-info/entry_points.txt,sha256=fFLItKyyaEk7Cmf5MRee7Nxubi3kahS2_CWS6GYNQh0,165
-ebk-0.3.1.dist-info/top_level.txt,sha256=9JCtHO8j1qyHWFBXG2BVMr16gg3rimwkVdt0PRVNIB4,17
-ebk-0.3.1.dist-info/RECORD,,

ebk-0.3.1.dist-info/entry_points.txt

@@ -1,6 +0,0 @@
-[console_scripts]
-ebk = ebk.cli:app
-
-[ebk.plugins]
-google_books = integrations.metadata:GoogleBooksExtractor
-network_analyzer = integrations.network:NetworkAnalyzer

ebk-0.3.1.dist-info/top_level.txt

@@ -1,2 +0,0 @@
-ebk
-integrations