a-ledger 0.1.0__tar.gz

a_ledger-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 realqiyan
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

a_ledger-0.1.0/PKG-INFO

@@ -0,0 +1,100 @@
+Metadata-Version: 2.4
+Name: a-ledger
+Version: 0.1.0
+Summary: Application-neutral double-entry ledger SDK backed by SQLite
+Author: realqiyan
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/realqiyan/a-ledger
+Project-URL: Repository, https://github.com/realqiyan/a-ledger
+Project-URL: Issues, https://github.com/realqiyan/a-ledger/issues
+Keywords: ledger,accounting,double-entry,sqlite,bookkeeping
+Classifier: Development Status :: 4 - Beta
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Office/Business :: Financial :: Accounting
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: dev
+Requires-Dist: build>=1; extra == "dev"
+Requires-Dist: pytest>=8; extra == "dev"
+Requires-Dist: twine>=5; extra == "dev"
+Dynamic: license-file
+
+# a-ledger
+
+`a-ledger` is an application-neutral, SQLite-backed double-entry ledger SDK.
+It owns accounting primitives and persistence; calling applications own business
+commands, broker integration, market calendars, projections, APIs, and pages.
+
+## Accounting convention
+
+- Money is stored as integer minor units; posted amounts never use `float`.
+- A positive posting is a debit and a negative posting is a credit.
+- Every posted transaction balances exactly to zero.
+- Accounts use one of `ASSET`, `LIABILITY`, `EQUITY`, `INCOME`, or `EXPENSE`.
+- Security quantities and cost lots are replayed from immutable lot events. There
+  are no persisted balance or position snapshots.
+- Posted transactions, postings, lots, lot events, and audit events cannot be
+  updated or deleted. Corrections use linked reversal and replacement entries.
+- Reservations are mutable authorization state, not accounting entries.
+
+## Transaction ownership
+
+The caller supplies a `sqlite3.Connection`, enables a short transaction, and
+decides whether to commit or roll back. Write APIs reject calls without an active
+caller-owned transaction. The SDK never calls `commit()` or `rollback()` and
+never runs network or application callbacks.
+
+```python
+import sqlite3
+
+from a_ledger import AccountCategory, Ledger, PostingDraft, TransactionDraft
+
+connection = sqlite3.connect("application.sqlite3")
+ledger = Ledger(connection)  # enables and verifies SQLite foreign keys
+
+connection.execute("BEGIN IMMEDIATE")
+ledger.install_schema()
+ledger.create_portfolio("portfolio-uuid", code="main", currency="CNY")
+ledger.create_account(
+    "cash-account-uuid",
+    portfolio_id="portfolio-uuid",
+    code="ASSET:CASH",
+    category=AccountCategory.ASSET,
+    currency="CNY",
+)
+ledger.create_account(
+    "capital-account-uuid",
+    portfolio_id="portfolio-uuid",
+    code="EQUITY:CONTRIBUTED_CAPITAL",
+    category=AccountCategory.EQUITY,
+    currency="CNY",
+)
+ledger.post(
+    TransactionDraft(
+        portfolio_id="portfolio-uuid",
+        source_namespace="app.capital",
+        idempotency_key="capital-flow-uuid",
+        event_code="CAPITAL_FLOW",
+        business_date="2026-08-03",
+        currency="CNY",
+        postings=(
+            PostingDraft("cash-account-uuid", 100_00),
+            PostingDraft("capital-account-uuid", -100_00),
+        ),
+    )
+)
+connection.commit()
+```
+
+## Non-goals
+
+The package does not define trading strategies, orders, options, QMT behavior,
+HTTP APIs, UI, market prices, settlement calendars, or bank/broker transfers.
+Generic `event_code`, `source_type`, and JSON dimensions let each application
+attach its own domain semantics without coupling those semantics to the SDK.

a_ledger-0.1.0/README.md

@@ -0,0 +1,73 @@
+# a-ledger
+
+`a-ledger` is an application-neutral, SQLite-backed double-entry ledger SDK.
+It owns accounting primitives and persistence; calling applications own business
+commands, broker integration, market calendars, projections, APIs, and pages.
+
+## Accounting convention
+
+- Money is stored as integer minor units; posted amounts never use `float`.
+- A positive posting is a debit and a negative posting is a credit.
+- Every posted transaction balances exactly to zero.
+- Accounts use one of `ASSET`, `LIABILITY`, `EQUITY`, `INCOME`, or `EXPENSE`.
+- Security quantities and cost lots are replayed from immutable lot events. There
+  are no persisted balance or position snapshots.
+- Posted transactions, postings, lots, lot events, and audit events cannot be
+  updated or deleted. Corrections use linked reversal and replacement entries.
+- Reservations are mutable authorization state, not accounting entries.
+
+## Transaction ownership
+
+The caller supplies a `sqlite3.Connection`, enables a short transaction, and
+decides whether to commit or roll back. Write APIs reject calls without an active
+caller-owned transaction. The SDK never calls `commit()` or `rollback()` and
+never runs network or application callbacks.
+
+```python
+import sqlite3
+
+from a_ledger import AccountCategory, Ledger, PostingDraft, TransactionDraft
+
+connection = sqlite3.connect("application.sqlite3")
+ledger = Ledger(connection)  # enables and verifies SQLite foreign keys
+
+connection.execute("BEGIN IMMEDIATE")
+ledger.install_schema()
+ledger.create_portfolio("portfolio-uuid", code="main", currency="CNY")
+ledger.create_account(
+    "cash-account-uuid",
+    portfolio_id="portfolio-uuid",
+    code="ASSET:CASH",
+    category=AccountCategory.ASSET,
+    currency="CNY",
+)
+ledger.create_account(
+    "capital-account-uuid",
+    portfolio_id="portfolio-uuid",
+    code="EQUITY:CONTRIBUTED_CAPITAL",
+    category=AccountCategory.EQUITY,
+    currency="CNY",
+)
+ledger.post(
+    TransactionDraft(
+        portfolio_id="portfolio-uuid",
+        source_namespace="app.capital",
+        idempotency_key="capital-flow-uuid",
+        event_code="CAPITAL_FLOW",
+        business_date="2026-08-03",
+        currency="CNY",
+        postings=(
+            PostingDraft("cash-account-uuid", 100_00),
+            PostingDraft("capital-account-uuid", -100_00),
+        ),
+    )
+)
+connection.commit()
+```
+
+## Non-goals
+
+The package does not define trading strategies, orders, options, QMT behavior,
+HTTP APIs, UI, market prices, settlement calendars, or bank/broker transfers.
+Generic `event_code`, `source_type`, and JSON dimensions let each application
+attach its own domain semantics without coupling those semantics to the SDK.

a_ledger-0.1.0/pyproject.toml

@@ -0,0 +1,42 @@
+[build-system]
+requires = ["setuptools>=77"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "a-ledger"
+version = "0.1.0"
+description = "Application-neutral double-entry ledger SDK backed by SQLite"
+readme = "README.md"
+requires-python = ">=3.11"
+license = "MIT"
+authors = [{ name = "realqiyan" }]
+keywords = ["ledger", "accounting", "double-entry", "sqlite", "bookkeeping"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Office/Business :: Financial :: Accounting",
+]
+
+[project.urls]
+Homepage = "https://github.com/realqiyan/a-ledger"
+Repository = "https://github.com/realqiyan/a-ledger"
+Issues = "https://github.com/realqiyan/a-ledger/issues"
+
+[project.optional-dependencies]
+dev = ["build>=1", "pytest>=8", "twine>=5"]
+
+[tool.setuptools]
+license-files = ["LICENSE"]
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.pytest.ini_options]
+addopts = "-q"
+pythonpath = ["src"]
+testpaths = ["tests"]

a_ledger-0.1.0/setup.cfg

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

a_ledger-0.1.0/src/a_ledger/__init__.py

@@ -0,0 +1,35 @@
+from .errors import LedgerError
+from .ledger import Ledger
+from .models import (
+    AccountCategory,
+    LotAllocation,
+    LotOperation,
+    LotEventKind,
+    Money,
+    OpenLot,
+    PostResult,
+    PostingDraft,
+    Price,
+    Reservation,
+    ReservationKind,
+    ReservationStatus,
+    TransactionDraft,
+)
+
+__all__ = [
+    "AccountCategory",
+    "Ledger",
+    "LedgerError",
+    "LotAllocation",
+    "LotOperation",
+    "LotEventKind",
+    "Money",
+    "OpenLot",
+    "PostResult",
+    "PostingDraft",
+    "Price",
+    "Reservation",
+    "ReservationKind",
+    "ReservationStatus",
+    "TransactionDraft",
+]

a_ledger-0.1.0/src/a_ledger/errors.py

@@ -0,0 +1,2 @@
+class LedgerError(ValueError):
+    """Raised when a ledger invariant would be violated."""