Buckets:

download
raw
4.63 kB
"""
jvspatial - Enhanced async object-spatial Python library.
jvspatial is an asynchronous, object-spatial Python library designed for building
robust persistence and business logic application layers. This enhanced version
maintains the original inheritance hierarchy while providing simplified APIs.
Key Features:
- Maintained inheritance hierarchy: Object → Node → Edge/Walker
- Enhanced classes with simplified decorator support
- Simplified decorator system (@attribute, @endpoint)
- Direct instantiation (no complex factories)
- Essential CRUD operations
- Server configuration (:class:`~jvspatial.api.config.ServerConfig`)
- Async/await architecture
Main Exports (Import from top level):
Core Entities (Maintaining Original Hierarchy):
- Object: Base class for all entities
- Node: Graph nodes with spatial data (inherits from Object)
- Edge: Relationships between nodes (inherits from Object)
- Walker: Graph traversal and pathfinding (inherits from Object)
- Root: Singleton root node (inherits from Node)
- GraphContext: Graph database context
Decorators:
- attribute: Unified attribute decorator (@attribute(protected=True))
- endpoint: Unified endpoint decorator (@endpoint("/api/users"))
API:
- Server: FastAPI server for graph operations
- ServerConfig: Server configuration model
Database & Cache:
- Database: Simplified database interface
- create_database: Direct database creation
- create_cache: Direct cache creation
Utilities:
- serialize_datetime: Serialize datetime objects
- deserialize_datetime: Deserialize datetime objects
Example:
# Using enhanced classes with maintained hierarchy
from jvspatial import Node, Walker, Server, ServerConfig, create_database
# Node inherits from Object with all original functionality
node = Node(id="test-node")
# Walker inherits from Object with all original functionality
walker = Walker()
await walker.spawn(node)
"""
# API server
from .api import Server
from .api.config import ServerConfig
from .api.decorators.route import endpoint
from .async_utils import create_task
from .cache import create_cache
# Simplified decorators
from .core.annotations import attribute
from .core.context import GraphContext
# Unified entity system
from .core.entities import Edge, Node, Object, Root, Walker
# Mixins
from .core.mixins import (
DeferredSaveMixin,
deferred_saves_globally_allowed,
flush_deferred_entities,
)
# Simplified database and cache
from .db import Database, create_database
from .db.work_claim import claim_record, delete_claimed_record, release_claim
# Observability primitives
from .observability import MetricsRecorder, NullMetricsRecorder
from .runtime.serverless import detect_serverless_provider, is_serverless_mode
from .serverless.deferred_invoke import (
MalformedDeferredInvokeError,
UnknownDeferredTaskError,
clear_deferred_invoke_handlers,
deferred_invoke_handler,
dispatch_deferred_invoke,
normalize_deferred_envelope,
register_deferred_invoke_handler,
)
from .serverless.factory import dispatch_deferred_task, get_task_scheduler
from .serverless.tasks import RetryConfig, TaskScheduler
# Utilities
from .utils.serialization import deserialize_datetime, serialize_datetime
# Version is managed in version.py
# Update version.py to release a new version
from .version import __version__
__all__ = [
# Version
"__version__",
"ServerConfig",
"is_serverless_mode",
"detect_serverless_provider",
"get_task_scheduler",
"dispatch_deferred_task",
"register_deferred_invoke_handler",
"deferred_invoke_handler",
"dispatch_deferred_invoke",
"normalize_deferred_envelope",
"MalformedDeferredInvokeError",
"UnknownDeferredTaskError",
"clear_deferred_invoke_handlers",
"TaskScheduler",
"RetryConfig",
# Background task API
"create_task",
# Work-claim helpers
"claim_record",
"release_claim",
"delete_claimed_record",
# Core entities
"Object",
"Node",
"Edge",
"Walker",
"Root",
"GraphContext",
# Mixins
"DeferredSaveMixin",
"deferred_saves_globally_allowed",
"flush_deferred_entities",
# Simplified decorators
"attribute",
"endpoint",
# API
"Server",
# Database & Cache
"Database",
"create_database",
"create_cache",
# Observability
"MetricsRecorder",
"NullMetricsRecorder",
# Utilities
"serialize_datetime",
"deserialize_datetime",
]

Xet Storage Details

Size:
4.63 kB
·
Xet hash:
083d860abe9df4c344af979dd35ad1c9f3ed42cdd97f07311f871a61920034c3

Xet efficiently stores files, intelligently splitting them into unique chunks and accelerating uploads and downloads. More info.