agentfs-sdk 0.3.1__tar.gz → 0.4.0__tar.gz

{agentfs_sdk-0.3.1 → agentfs_sdk-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentfs-sdk
-Version: 0.3.1
+Version: 0.4.0
 Summary: AgentFS Python SDK - A filesystem and key-value store for AI agents
 Author: Turso
 License: MIT
@@ -16,9 +16,11 @@ Classifier: Operating System :: POSIX :: Linux
 Classifier: Operating System :: Microsoft :: Windows
 Classifier: Operating System :: MacOS
 Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Requires-Python: >=3.12
+Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 Requires-Dist: pyturso==0.4.0rc17
 

{agentfs_sdk-0.3.1 → agentfs_sdk-0.4.0}/agentfs_sdk/__init__.py

@@ -4,11 +4,12 @@ A filesystem and key-value store for AI agents, powered by SQLite.
 """
 
 from .agentfs import AgentFS, AgentFSOptions
-from .filesystem import Filesystem, Stats
+from .errors import ErrnoException, FsErrorCode, FsSyscall
+from .filesystem import S_IFDIR, S_IFLNK, S_IFMT, S_IFREG, Filesystem, Stats
 from .kvstore import KvStore
 from .toolcalls import ToolCall, ToolCalls, ToolCallStats
 
-__version__ = "0.3.1"
+__version__ = "0.4.0"
 
 __all__ = [
     "AgentFS",
@@ -16,7 +17,14 @@ __all__ = [
     "KvStore",
     "Filesystem",
     "Stats",
+    "S_IFDIR",
+    "S_IFLNK",
+    "S_IFMT",
+    "S_IFREG",
     "ToolCalls",
     "ToolCall",
     "ToolCallStats",
+    "ErrnoException",
+    "FsErrorCode",
+    "FsSyscall",
 ]

agentfs_sdk-0.4.0/agentfs_sdk/constants.py

@@ -0,0 +1,13 @@
+"""Filesystem constants"""
+
+# File types for mode field
+S_IFMT = 0o170000  # File type mask
+S_IFREG = 0o100000  # Regular file
+S_IFDIR = 0o040000  # Directory
+S_IFLNK = 0o120000  # Symbolic link
+
+# Default permissions
+DEFAULT_FILE_MODE = S_IFREG | 0o644  # Regular file, rw-r--r--
+DEFAULT_DIR_MODE = S_IFDIR | 0o755  # Directory, rwxr-xr-x
+
+DEFAULT_CHUNK_SIZE = 4096

agentfs_sdk-0.4.0/agentfs_sdk/errors.py

@@ -0,0 +1,60 @@
+"""Error types for filesystem operations"""
+
+from typing import Literal, Optional
+
+# POSIX-style error codes for filesystem operations
+FsErrorCode = Literal[
+    "ENOENT",  # No such file or directory
+    "EEXIST",  # File already exists
+    "EISDIR",  # Is a directory (when file expected)
+    "ENOTDIR",  # Not a directory (when directory expected)
+    "ENOTEMPTY",  # Directory not empty
+    "EPERM",  # Operation not permitted
+    "EINVAL",  # Invalid argument
+    "ENOSYS",  # Function not implemented (use for symlinks)
+]
+
+# Filesystem syscall names for error reporting
+# rm, scandir and copyfile are not actual syscalls but used for convenience
+FsSyscall = Literal[
+    "open",
+    "stat",
+    "mkdir",
+    "rmdir",
+    "rm",
+    "unlink",
+    "rename",
+    "scandir",
+    "copyfile",
+    "access",
+]
+
+
+class ErrnoException(Exception):
+    """Exception with errno-style attributes
+
+    Args:
+        code: POSIX error code (e.g., 'ENOENT')
+        syscall: System call name (e.g., 'open')
+        path: Optional path involved in the error
+        message: Optional custom message (defaults to code)
+
+    Example:
+        >>> raise ErrnoException('ENOENT', 'open', '/missing.txt')
+        ErrnoException: ENOENT: no such file or directory, open '/missing.txt'
+    """
+
+    def __init__(
+        self,
+        code: FsErrorCode,
+        syscall: FsSyscall,
+        path: Optional[str] = None,
+        message: Optional[str] = None,
+    ):
+        base = message if message else code
+        suffix = f" '{path}'" if path is not None else ""
+        error_message = f"{code}: {base}, {syscall}{suffix}"
+        super().__init__(error_message)
+        self.code = code
+        self.syscall = syscall
+        self.path = path