shardorm 1.0.0__tar.gz

shardorm-1.0.0/PKG-INFO

@@ -0,0 +1,66 @@
+Metadata-Version: 2.4
+Name: shardorm
+Version: 1.0.0
+Summary: Eigenbau Sharding-, Replikations- und Failover-Schicht fuer PostgreSQL
+License: MIT
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: psycopg[binary]>=3.0.0
+Requires-Dist: psycopg_pool>=3.0.0
+
+\# ShardORM
+
+
+
+A lightweight, standalone Python layer for PostgreSQL sharding, replication, read/write failover, and two-phase commits (2PC) – completely \*\*without SQLAlchemy\*\* and \*\*without Alembic\*\*.
+
+
+
+\---
+
+
+
+\## 🚀 Key Features
+
+
+
+\* \*\*Consistent Hashing Ring:\*\* Uses virtual nodes (`vnodes`) to distribute records deterministically. Adding or removing a shard only shifts a fraction of the keys instead of remapping the entire cluster.
+
+\* \*\*Flexible Table Policies:\*\*
+
+  \* `"sharded"`: Records are distributed across a configurable `replication\_factor` of shards using consistent hashing.
+
+  \* `"full\_sync"`: Records are mirrored globally across \*\*all\*\* PostgreSQL instances in parallel (ideal for small lookup/global tables like categories or settings).
+
+\* \*\*Automatic Failover \& Quorum / 2PC:\*\*
+
+  \* \*\*Read Failover:\*\* If a primary shard is unreachable, queries automatically fall back to redundant replicas.
+
+  \* \*\*Write Quorum:\*\* Writes are validated against a configured `min\_write\_quorum`.
+
+  \* \*\*Two-Phase Commit (2PC):\*\* Optional strict all-or-nothing writes (`write\_mode: "2pc"`) using PostgreSQL's native `PREPARE TRANSACTION`.
+
+\* \*\*Built-in Migration System ("Mini-Alembic"):\*\* Keeps schemas synchronized across all shards. Supports ad-hoc CLI commands or timestamped `.sql` migration files stored in a local directory.
+
+\* \*\*Online Rebalancing (`rescale`):\*\* Scans the cluster for misplaced data after shard topology changes and safely migrates records to their correct nodes (includes a `--apply` dry-run mode).
+
+\* \*\*Connection Pooling:\*\* Built-in connection management powered by `psycopg\_pool`.
+
+
+
+\---
+
+
+
+\## 📦 Installation
+
+
+
+Install the package locally in editable development mode along with its dependencies:
+
+
+
+```bash
+
+pip install -e .
+

shardorm-1.0.0/README.md

@@ -0,0 +1,56 @@
+\# ShardORM
+
+
+
+A lightweight, standalone Python layer for PostgreSQL sharding, replication, read/write failover, and two-phase commits (2PC) – completely \*\*without SQLAlchemy\*\* and \*\*without Alembic\*\*.
+
+
+
+\---
+
+
+
+\## 🚀 Key Features
+
+
+
+\* \*\*Consistent Hashing Ring:\*\* Uses virtual nodes (`vnodes`) to distribute records deterministically. Adding or removing a shard only shifts a fraction of the keys instead of remapping the entire cluster.
+
+\* \*\*Flexible Table Policies:\*\*
+
+  \* `"sharded"`: Records are distributed across a configurable `replication\_factor` of shards using consistent hashing.
+
+  \* `"full\_sync"`: Records are mirrored globally across \*\*all\*\* PostgreSQL instances in parallel (ideal for small lookup/global tables like categories or settings).
+
+\* \*\*Automatic Failover \& Quorum / 2PC:\*\*
+
+  \* \*\*Read Failover:\*\* If a primary shard is unreachable, queries automatically fall back to redundant replicas.
+
+  \* \*\*Write Quorum:\*\* Writes are validated against a configured `min\_write\_quorum`.
+
+  \* \*\*Two-Phase Commit (2PC):\*\* Optional strict all-or-nothing writes (`write\_mode: "2pc"`) using PostgreSQL's native `PREPARE TRANSACTION`.
+
+\* \*\*Built-in Migration System ("Mini-Alembic"):\*\* Keeps schemas synchronized across all shards. Supports ad-hoc CLI commands or timestamped `.sql` migration files stored in a local directory.
+
+\* \*\*Online Rebalancing (`rescale`):\*\* Scans the cluster for misplaced data after shard topology changes and safely migrates records to their correct nodes (includes a `--apply` dry-run mode).
+
+\* \*\*Connection Pooling:\*\* Built-in connection management powered by `psycopg\_pool`.
+
+
+
+\---
+
+
+
+\## 📦 Installation
+
+
+
+Install the package locally in editable development mode along with its dependencies:
+
+
+
+```bash
+
+pip install -e .
+

shardorm-1.0.0/pyproject.toml

@@ -0,0 +1,18 @@
+[build-system]
+requires = ["setuptools>=61.0.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "shardorm"
+version = "1.0.0"
+description = "Eigenbau Sharding-, Replikations- und Failover-Schicht fuer PostgreSQL"
+readme = "README.md"
+requires-python = ">=3.8"
+license = { text = "MIT" }
+dependencies = [
+    "psycopg[binary]>=3.0.0",
+    "psycopg_pool>=3.0.0",
+]
+
+[project.scripts]
+shardorm = "shardorm:main"

shardorm-1.0.0/setup.cfg

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

shardorm-1.0.0/shardorm.egg-info/PKG-INFO

@@ -0,0 +1,66 @@
+Metadata-Version: 2.4
+Name: shardorm
+Version: 1.0.0
+Summary: Eigenbau Sharding-, Replikations- und Failover-Schicht fuer PostgreSQL
+License: MIT
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: psycopg[binary]>=3.0.0
+Requires-Dist: psycopg_pool>=3.0.0
+
+\# ShardORM
+
+
+
+A lightweight, standalone Python layer for PostgreSQL sharding, replication, read/write failover, and two-phase commits (2PC) – completely \*\*without SQLAlchemy\*\* and \*\*without Alembic\*\*.
+
+
+
+\---
+
+
+
+\## 🚀 Key Features
+
+
+
+\* \*\*Consistent Hashing Ring:\*\* Uses virtual nodes (`vnodes`) to distribute records deterministically. Adding or removing a shard only shifts a fraction of the keys instead of remapping the entire cluster.
+
+\* \*\*Flexible Table Policies:\*\*
+
+  \* `"sharded"`: Records are distributed across a configurable `replication\_factor` of shards using consistent hashing.
+
+  \* `"full\_sync"`: Records are mirrored globally across \*\*all\*\* PostgreSQL instances in parallel (ideal for small lookup/global tables like categories or settings).
+
+\* \*\*Automatic Failover \& Quorum / 2PC:\*\*
+
+  \* \*\*Read Failover:\*\* If a primary shard is unreachable, queries automatically fall back to redundant replicas.
+
+  \* \*\*Write Quorum:\*\* Writes are validated against a configured `min\_write\_quorum`.
+
+  \* \*\*Two-Phase Commit (2PC):\*\* Optional strict all-or-nothing writes (`write\_mode: "2pc"`) using PostgreSQL's native `PREPARE TRANSACTION`.
+
+\* \*\*Built-in Migration System ("Mini-Alembic"):\*\* Keeps schemas synchronized across all shards. Supports ad-hoc CLI commands or timestamped `.sql` migration files stored in a local directory.
+
+\* \*\*Online Rebalancing (`rescale`):\*\* Scans the cluster for misplaced data after shard topology changes and safely migrates records to their correct nodes (includes a `--apply` dry-run mode).
+
+\* \*\*Connection Pooling:\*\* Built-in connection management powered by `psycopg\_pool`.
+
+
+
+\---
+
+
+
+\## 📦 Installation
+
+
+
+Install the package locally in editable development mode along with its dependencies:
+
+
+
+```bash
+
+pip install -e .
+

shardorm-1.0.0/shardorm.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+README.md
+pyproject.toml
+shardorm.py
+shardorm.egg-info/PKG-INFO
+shardorm.egg-info/SOURCES.txt
+shardorm.egg-info/dependency_links.txt
+shardorm.egg-info/entry_points.txt
+shardorm.egg-info/requires.txt
+shardorm.egg-info/top_level.txt

shardorm-1.0.0/shardorm.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

shardorm-1.0.0/shardorm.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+shardorm = shardorm:main

shardorm-1.0.0/shardorm.egg-info/requires.txt

@@ -0,0 +1,2 @@
+psycopg[binary]>=3.0.0
+psycopg_pool>=3.0.0

shardorm-1.0.0/shardorm.egg-info/top_level.txt

@@ -0,0 +1 @@
+shardorm