pydara 0.6.0a1__tar.gz

pydara-0.6.0a1/BUNDLE.json

@@ -0,0 +1,18 @@
+{
+  "bundle": "pydara",
+  "bundle_revision": 1,
+  "package_version": "0.6.0a1",
+  "wheel": "dist/pydara-0.6.0a1-py3-none-any.whl",
+  "wheel_sha256": "ab1137ea6f800a4a3e6a550979134c4aea965d47857ed5ff57a9a9a0558f5f14",
+  "extras": [
+    "files",
+    "notebook"
+  ],
+  "minimum_python": [
+    3,
+    12
+  ],
+  "runtime_code_changed": true,
+  "runtime_files_matched": 45,
+  "scope": "Dara with the TSE data module; no analysis or ML modules yet"
+}

pydara-0.6.0a1/CHANGELOG.md

@@ -0,0 +1,12 @@
+# 0.6.0a1 — Dara modular namespace
+
+- Rename the distribution from `tse-dara` to `pydara` (Python import: `dara`).
+- Move the complete TSE API from `tse_dara.data` to `dara.tse`.
+- Expose only `tse` at the package root; remove unused analytics/ML placeholders.
+- Move exceptions and internal TSE models under `dara.tse`.
+- Update installation, build, publishing, examples and documentation.
+- Preserve the existing cache location, SQLite schemas and archive formats.
+- Remove obsolete release artifacts, overlay manifests and historical delivery tools.
+
+The TSE data features of 0.5.0a4 are retained. Analysis, ML and additional
+markets are future modules, not implemented features of this release.

pydara-0.6.0a1/INSTALL_WINDOWS.bat

@@ -0,0 +1,10 @@
+@echo off
+setlocal
+if not defined CONDA_PREFIX if not defined VIRTUAL_ENV (
+ echo Activate your project environment in Anaconda Prompt first.
+ echo Then run: python install.py
+ exit /b 2
+)
+python "%~dp0install.py" %*
+set "RESULT=%ERRORLEVEL%"
+endlocal & exit /b %RESULT%

pydara-0.6.0a1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 tse-dara contributors
+
+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.

pydara-0.6.0a1/MANIFEST.in

@@ -0,0 +1,8 @@
+include LICENSE THIRD_PARTY_NOTICES.md README.md README_FA.md CHANGELOG.md SECURITY.md
+include install.py INSTALL_WINDOWS.bat BUNDLE.json
+recursive-include docs *.md *.json *.html
+recursive-include tests *.py
+recursive-include examples *.ipynb *.py
+recursive-include tools *.py *.ps1
+recursive-include src/dara *.json py.typed
+global-exclude __pycache__ *.py[cod] *.sqlite3 *.sqlite3-wal *.sqlite3-shm

pydara-0.6.0a1/PKG-INFO

@@ -0,0 +1,131 @@
+Metadata-Version: 2.4
+Name: pydara
+Version: 0.6.0a1
+Summary: Dara financial data modules: TSE quotes, history, typed exports and versioned local storage
+Author: Dara contributors
+License-Expression: MIT
+Classifier: Development Status :: 3 - Alpha
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Topic :: Office/Business :: Financial
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: THIRD_PARTY_NOTICES.md
+Requires-Dist: httpx<0.29,>=0.27
+Requires-Dist: pandas<4,>=2.2
+Requires-Dist: platformdirs<5,>=4
+Requires-Dist: tzdata>=2024.1
+Provides-Extra: excel
+Requires-Dist: openpyxl<4,>=3.1.5; extra == "excel"
+Provides-Extra: parquet
+Requires-Dist: pyarrow>=19; extra == "parquet"
+Provides-Extra: files
+Requires-Dist: openpyxl<4,>=3.1.5; extra == "files"
+Requires-Dist: pyarrow>=19; extra == "files"
+Provides-Extra: test
+Requires-Dist: pytest<10,>=8; extra == "test"
+Provides-Extra: notebook
+Requires-Dist: ipykernel>=6; extra == "notebook"
+Requires-Dist: nbformat>=5; extra == "notebook"
+Requires-Dist: nbclient>=0.10; extra == "notebook"
+Dynamic: license-file
+
+# Dara
+
+Release **0.6.0a1**. Dara is a modular Python library for financial data.
+The PyPI distribution is named **`pydara`**; its Python import is **`dara`**.
+The currently implemented public module is **`dara.tse`**, providing TSETMC
+quotes, instrument lookup, history, market data, sync/async workflows, Pandas
+outputs, versioned SQLite storage and typed file exports.
+
+## Install
+
+Requires Python 3.12 or newer. After publication on PyPI:
+
+```console
+python -m pip install --upgrade pydara==0.6.0a1
+```
+
+Optional Excel, Parquet and notebook support:
+
+```console
+python -m pip install --upgrade "pydara[files,notebook]==0.6.0a1"
+```
+
+For a local release bundle, activate your Python environment and run
+`python install.py` (`--core-only` omits optional file/notebook dependencies).
+Restart the Jupyter kernel after installation or upgrade.
+
+## Use
+
+```python
+from dara import tse
+
+# Synthetic teaching data; no external request.
+sample = tse.load_sample()
+reference = tse.api_reference('instrument')
+
+# Real data: network access or an eligible cache entry is required.
+matches = tse.instrument(symbol="فولاد", on_multiple="all")
+history = tse.history("فولاد", start="1403-01-01", end="1403-12-30")
+```
+
+```python
+from dara.tse import Client, AsyncClient
+from dara.tse.exceptions import DaraError
+```
+
+Instrument lookup defaults to all matching rows. `on_multiple="first"` returns
+the first source-ordered match; `"error"` rejects ambiguity.
+`on_conflict="error"` checks supplied constraints. `"ins_code"` explicitly
+prioritizes a supplied instrument code.
+
+## Scope and data contracts
+
+The TSE module includes public quotes/history, market watch, client types,
+indices, reported trades/books/states/thresholds, ownership/share counts,
+adjustment events, source-adjusted chart data, fund/NAV data, messages and
+options. Availability depends on the source endpoint. The separate futures
+exchange gateway is experimental. Current catalog coverage is not a complete
+historical instrument registry. Source-adjusted data does not certify total
+return or point-in-time history.
+
+Analysis, ML, Bitcoin, exchange rates, gold and other countries' markets are
+planned extensions. They are not implemented modules in this release.
+
+Importing `dara` creates no network connection, database or worker thread.
+Explicit offline use is `tse.FetchPolicy.offline(allow_stale=True)`.
+A queued storage receipt is not durable storage. Preserve the JSON sidecar
+when copying a CSV Dara archive.
+
+## Migration from tse-dara
+
+Replace `from tse_dara import data` with `from dara import tse`, and use
+`tse.history(...)`, `tse.instrument(...)`, etc. Alternatively,
+`from dara import tse as data` keeps existing local variable names.
+Exceptions move to `dara.tse.exceptions`. The old Python namespace is not shipped.
+
+The existing default cache path and the legacy `tse_dara` metadata key and
+`tse-dara-frame` storage marker are retained for stored-data compatibility.
+No user database is deleted or migrated by this rename.
+See [migration instructions](docs/MIGRATION_FA.md).
+
+## Documentation and development
+
+- [Persian guide](README_FA.md)
+- [API reference](docs/API_REFERENCE.md)
+- [Roadmap](docs/ROADMAP_FA.md)
+- [Third-party notices](THIRD_PARTY_NOTICES.md)
+
+```console
+python -m pip install -e ".[test,files]" build twine
+python tools/generate_api_reference.py
+python -m build --wheel --outdir dist
+python tools/update_bundle.py
+python -m pytest -q
+```
+
+Offline/synthetic tests verify local contracts and do not certify live source
+accuracy or endpoint availability. The code is MIT licensed; data rights are
+separate from the code license.

pydara-0.6.0a1/README.md

@@ -0,0 +1,98 @@
+# Dara
+
+Release **0.6.0a1**. Dara is a modular Python library for financial data.
+The PyPI distribution is named **`pydara`**; its Python import is **`dara`**.
+The currently implemented public module is **`dara.tse`**, providing TSETMC
+quotes, instrument lookup, history, market data, sync/async workflows, Pandas
+outputs, versioned SQLite storage and typed file exports.
+
+## Install
+
+Requires Python 3.12 or newer. After publication on PyPI:
+
+```console
+python -m pip install --upgrade pydara==0.6.0a1
+```
+
+Optional Excel, Parquet and notebook support:
+
+```console
+python -m pip install --upgrade "pydara[files,notebook]==0.6.0a1"
+```
+
+For a local release bundle, activate your Python environment and run
+`python install.py` (`--core-only` omits optional file/notebook dependencies).
+Restart the Jupyter kernel after installation or upgrade.
+
+## Use
+
+```python
+from dara import tse
+
+# Synthetic teaching data; no external request.
+sample = tse.load_sample()
+reference = tse.api_reference('instrument')
+
+# Real data: network access or an eligible cache entry is required.
+matches = tse.instrument(symbol="فولاد", on_multiple="all")
+history = tse.history("فولاد", start="1403-01-01", end="1403-12-30")
+```
+
+```python
+from dara.tse import Client, AsyncClient
+from dara.tse.exceptions import DaraError
+```
+
+Instrument lookup defaults to all matching rows. `on_multiple="first"` returns
+the first source-ordered match; `"error"` rejects ambiguity.
+`on_conflict="error"` checks supplied constraints. `"ins_code"` explicitly
+prioritizes a supplied instrument code.
+
+## Scope and data contracts
+
+The TSE module includes public quotes/history, market watch, client types,
+indices, reported trades/books/states/thresholds, ownership/share counts,
+adjustment events, source-adjusted chart data, fund/NAV data, messages and
+options. Availability depends on the source endpoint. The separate futures
+exchange gateway is experimental. Current catalog coverage is not a complete
+historical instrument registry. Source-adjusted data does not certify total
+return or point-in-time history.
+
+Analysis, ML, Bitcoin, exchange rates, gold and other countries' markets are
+planned extensions. They are not implemented modules in this release.
+
+Importing `dara` creates no network connection, database or worker thread.
+Explicit offline use is `tse.FetchPolicy.offline(allow_stale=True)`.
+A queued storage receipt is not durable storage. Preserve the JSON sidecar
+when copying a CSV Dara archive.
+
+## Migration from tse-dara
+
+Replace `from tse_dara import data` with `from dara import tse`, and use
+`tse.history(...)`, `tse.instrument(...)`, etc. Alternatively,
+`from dara import tse as data` keeps existing local variable names.
+Exceptions move to `dara.tse.exceptions`. The old Python namespace is not shipped.
+
+The existing default cache path and the legacy `tse_dara` metadata key and
+`tse-dara-frame` storage marker are retained for stored-data compatibility.
+No user database is deleted or migrated by this rename.
+See [migration instructions](docs/MIGRATION_FA.md).
+
+## Documentation and development
+
+- [Persian guide](README_FA.md)
+- [API reference](docs/API_REFERENCE.md)
+- [Roadmap](docs/ROADMAP_FA.md)
+- [Third-party notices](THIRD_PARTY_NOTICES.md)
+
+```console
+python -m pip install -e ".[test,files]" build twine
+python tools/generate_api_reference.py
+python -m build --wheel --outdir dist
+python tools/update_bundle.py
+python -m pytest -q
+```
+
+Offline/synthetic tests verify local contracts and do not certify live source
+accuracy or endpoint availability. The code is MIT licensed; data rights are
+separate from the code license.

pydara-0.6.0a1/README_FA.md

@@ -0,0 +1,65 @@
+# دارا — Dara 0.6.0a1
+
+نام نصب در PyPI برابر `pydara` و نام واردکردن در پایتون `dara` است.
+
+دارا کتابخانه‌ای ماژولار برای داده‌های مالی است. فعلاً فقط زیرماژول عمومی
+`tse` پیاده‌سازی شده و قابلیت‌های نسخهٔ قبلی دادهٔ بورس را حفظ می‌کند.
+
+## نصب
+
+پس از انتشار در PyPI با Python 3.12 یا جدیدتر:
+
+```console
+python -m pip install --upgrade pydara==0.6.0a1
+```
+
+برای Excel، Parquet و Notebook:
+
+```console
+python -m pip install --upgrade "pydara[files,notebook]==0.6.0a1"
+```
+
+نصب محلی بستهٔ آماده: `python install.py` در محیط پایتون فعال.
+پس از نصب یا ارتقا، Kernel ژوپیتر را Restart کنید.
+
+## شروع
+
+```python
+from dara import tse
+
+sample = tse.load_sample()  # دادهٔ مصنوعی، بدون شبکه
+reference = tse.api_reference("instrument")
+
+# نیازمند اتصال شبکه یا کش مجاز
+matches = tse.instrument(symbol="فولاد", on_multiple="all")
+history = tse.history("فولاد", start="1403-01-01", end="1403-12-30")
+```
+
+```python
+from dara.tse import Client, AsyncClient
+from dara.tse.exceptions import DaraError
+```
+
+## سیاست شناسایی ابزار
+
+`on_multiple="all"` پیش‌فرض است و همهٔ نتایج منطبق را می‌دهد.
+`"first"` اولین مورد با ترتیب منبع و `"error"` خطا در صورت ابهام را انتخاب می‌کند.
+`on_conflict="error"` شروط داده‌شده را بررسی می‌کند؛ `"ins_code"` فقط با
+کد صریح اجازهٔ اولویت دادن به کد را می‌دهد.
+
+## مهاجرت و داده‌های قبلی
+
+شرح کامل در [راهنمای مهاجرت](docs/MIGRATION_FA.md) است.
+نام قبلی `tse_dara.data` به `dara.tse` تبدیل شده است.
+برای کمترین تغییر می‌توان `from dara import tse as data` نوشت.
+مسیر کش و قرارداد متادیتای فایل‌های ذخیره‌شده حفظ شده‌اند؛ پایگاه دادهٔ کاربر حذف نمی‌شود.
+
+## دامنه و محدودیت
+
+قیمت، تاریخچه، ابزارها، دیده‌بان، مشتریان، شاخص‌ها، عملیات گروهی، ذخیرهٔ SQLite
+و خروجی فایل در `tse` در دسترس‌اند؛ پوشش هر خروجی به سرویس منبع وابسته است.
+آزمون‌های مصنوعی، صحت یا دسترسی لحظه‌ای سرویس واقعی را تضمین نمی‌کنند.
+ماژول‌های تحلیل و ML و داده‌های بیتکوین، دلار، طلا و بازارهای خارجی فعلاً در نقشهٔ راه هستند.
+
+مرجع امضاها: [API_REFERENCE.md](docs/API_REFERENCE.md).
+برای مشاهدهٔ مرجع بدون شبکه از `tse.api_reference()` استفاده کنید.

pydara-0.6.0a1/SECURITY.md

@@ -0,0 +1,33 @@
+# Security and operational notes
+
+No API credentials are needed or accepted in this release. No telemetry, trading,
+account access, proxy rotation, TLS bypass, or package auto-update is performed.
+Requests target a fixed HTTPS base URL; redirects are not followed. Response
+bytes are capped; malformed JSON and duplicate keys are rejected. Only validated
+responses enter the cache. Never send credentials or tokens in issue reports.
+
+Do not treat a fresh retrieval timestamp as proof of fresh exchange data.
+Unit normalization is deliberately narrow and unverified instruments carry
+unknown units. The fixture suite is not an independent security audit.
+
+No background network polling is started. The optional background writer only
+persists data already obtained by an explicit user operation. Stop/close clients
+when finished, and explicitly flush when durability is required.
+
+The supplied license covers code, not permission to redistribute exchange data.
+A public endpoint does not imply unlimited access or a service-level guarantee.
+
+Daily-history cache versions are response observations, not certified publication history.
+Do not use raw or retroactively adjusted daily data as point-in-time ML evidence.
+
+Part 3 adds inert tagged serialization, not pickle or eval. Structural dtype
+parsing uses an allowlist. Hashes detect accidental corruption, not malicious
+rewriting of data and hashes together. XLSX formulas are not executed;
+metadata is not encrypted. CSV+sidecar are two files, not an atomic pair.
+Readers are eager and file-size limits are not a universal sandbox against
+all compressed-format resource-exhaustion attacks. Only open trusted archives.
+
+Normalized history stores observation versions. `committed_at` is the writer's
+transaction timestamp, not a metrologically precise post-fsync timestamp.
+Local as_of is based on recorded timestamps and does not certify an exchange
+publication time or a sub-second, crash-consistent replay of database visibility.

pydara-0.6.0a1/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,44 @@
+# Third-party attribution
+
+## Calendar arithmetic
+
+The `_nowruz` routine in `src/dara/tse/dates.py` adapts the
+`jalCalCore` calendar-cycle calculation from **jalaali-js**, based on the
+Borkowski Persian-calendar algorithm. Python date arithmetic and validation
+around it are implemented for Dara. Supported Jalali dates are intentionally
+restricted to years 1200..1599, not the full upstream interval.
+
+Source inspected 2026-10-13:
+https://github.com/jalaali/jalaali-js/blob/master/src/index.ts
+Git blob SHA: 14309485f93dd8eff2e30d7ba20ba38115457a74
+License source: https://raw.githubusercontent.com/jalaali/jalaali-js/master/LICENSE
+
+MIT License
+
+Copyright (c) 2020 Behrang Norouzinia
+
+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.
+
+## TSETMC access
+
+TSETMC and its data are not owned by this project. This package does not
+include market data; bundled sample responses are explicitly synthetic.
+The MIT code license does not grant market-data redistribution permissions.
+API paths/schema were reviewed using 5j9/tsetmc's source; its GPL code is not
+bundled or made a runtime dependency. No authenticated API is guessed.