Skip to main content

10x Platform Core

Project description

py10x-core

Unified, identity-driven, dependency-aware object model for Python
—with lazy dependency graph, persistence, automatic UI editors, and more

Python 3.11+ License: MIT

Jerboa Logo

🚀 Why py10x?

Standard Python objects have no shared identity layer and no automatic dependency tracking.
py10x-core turns them into a coherent, dependency-aware graph of connected identifiable objects — a single shared layer that feels unified across modules, files and processes.

Key superpowers:

  • Global Identity & Sharing
    Objects with identical ID Traits are automatically the same logical entity.
    Change a value in one place → every reference sees the update instantly (global cache).

  • Lazy Dependency Graph
    Computed traits (derived values) are calculated only when accessed.
    Dependencies are tracked automatically — no manual invalidation, no recompute storms.

  • Deep Persistence
    Complex nested object graphs saved to Traitable Store (MongoDB or in-memory).
    Built-in versioning, history tracking, transparent lazy loading.

  • Automatic UI Editors
    Define your data model once → get native two-way editors for Rio (web) or Qt (desktop).
    No manual UI code for viewing/editing traitables.

This approach dramatically reduces boilerplate while giving you fine-grained control over computation timing and persistence behavior.


🏁 Hello World

By default, the Traitable constructor accepts only ID traits. For how the framework uses identity and storage to resolve or create instances, see How Traitables Are Created in the Getting Started guide.

from core_10x.traitable import Traitable, T, RT
from core_10x.exec_control import GRAPH_ON, CACHE_ONLY

class Developer(Traitable):
    handle: str      = T(T.ID)           # ← identity trait → global sharing
    coffee_cups: int = T(default=0)      # persistent
    energy: int      = RT()              # lazy-computed

    def energy_get(self) -> int:
        return self.coffee_cups * 20

# In-memory mode (no storage), dependency graph on.
with CACHE_ONLY(), GRAPH_ON():
    dev = Developer(handle="ghost")
    dev.coffee_cups = 5
    print(dev.energy)           # 100 ← computed lazily on first access

    dev.coffee_cups = 6
    print(dev.energy)           # 120  ← recomputed due to dependency change

    # Same identity → same object
    dev2 = Developer(handle="ghost")
    print(dev2.energy)          # 120  ← shared via global cache

Want automatic persistence, per-class stores, store unions, querying, nested objects, UI generation, verifiers, and more? → Dive into GETTING_STARTED.md for the full technical manual.


🧠 When Should You Use py10x?

py10x-core is a good fit when:

  • Your application has rich domain models with derived fields
  • You need deterministic object identity
  • You want automatic dependency tracking
  • You want persistence and UI derived from the same model

It may be overkill for simple scripts, stateless APIs, or lightweight validation-only use cases.

If your system has evolving state and relationships, py10x-core removes a large amount of manual synchronization code.


🔍 How Is This Different?

Unlike dataclasses or Pydantic:

  • Objects have deterministic identity based on ID traits
  • Identical identity traits resolve to the same logical entity
  • Derived fields are lazily computed and dependency-tracked

Unlike traditional ORMs:

  • Identity is not tied to a database row
  • Persistence is optional and pluggable

Unlike reactive frameworks:

  • Dependencies are tracked automatically
  • Computation is lazy by default

🤝 Contact & Support

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

py10x_core-0.1.15.tar.gz (969.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

py10x_core-0.1.15-py3-none-any.whl (322.7 kB view details)

Uploaded Python 3

File details

Details for the file py10x_core-0.1.15.tar.gz.

File metadata

  • Download URL: py10x_core-0.1.15.tar.gz
  • Upload date:
  • Size: 969.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.11.1 {"installer":{"name":"uv","version":"0.11.1","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for py10x_core-0.1.15.tar.gz
Algorithm Hash digest
SHA256 926ede8542065d5144de1a316e0d42273a36af642a881929f548536a359c5427
MD5 404198bcfca1fb4a0b83662d7e3a7d75
BLAKE2b-256 bc8e39636998f87484efd76304844fc1b92f7f7f5b06d311d8f6ccafe09905a8

See more details on using hashes here.

File details

Details for the file py10x_core-0.1.15-py3-none-any.whl.

File metadata

  • Download URL: py10x_core-0.1.15-py3-none-any.whl
  • Upload date:
  • Size: 322.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.11.1 {"installer":{"name":"uv","version":"0.11.1","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for py10x_core-0.1.15-py3-none-any.whl
Algorithm Hash digest
SHA256 0497deff316337903efbcec4dea43107da3b852add166d72b36586ae2fa80546
MD5 e4104585f620fef5c0a93537f7f0acc4
BLAKE2b-256 4d667b3e8a33b05fa26d6a90dad78d25a9596ea339c8bbbd2da1c5af8fe1c3d1

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page