fincore-py 0.1.0.dev4__tar.gz → 0.1.0.dev6__tar.gz

{fincore_py-0.1.0.dev4 → fincore_py-0.1.0.dev6}/.github/workflows/ci.yml

@@ -9,6 +9,7 @@ on:
 
 permissions:
   contents: read
+  id-token: write
 
 jobs:
   test:
@@ -35,9 +36,12 @@ jobs:
           PYO3_USE_ABI3_FORWARD_COMPATIBILITY: "1"
 
       - name: Upload coverage to Codecov
-        uses: codecov/codecov-action@v5
+        uses: codecov/codecov-action@v7
         with:
           files: coverage.xml
+          flags: python
+          name: fincore-python
+          token: ${{ secrets.CODECOV_TOKEN }}
           fail_ci_if_error: false
 
       - name: Check Rust formatting

{fincore_py-0.1.0.dev4 → fincore_py-0.1.0.dev6}/MANIFEST.in

@@ -3,3 +3,4 @@ include LICENSE
 include README.md
 recursive-include src *.rs
 recursive-include python *.py
+recursive-include examples *.md *.py

{fincore_py-0.1.0.dev4 → fincore_py-0.1.0.dev6}/PKG-INFO

@@ -1,38 +1,22 @@
 Metadata-Version: 2.4
 Name: fincore-py
-Version: 0.1.0.dev4
-Summary: Python-facing financial market data access library powered by Rust.
-Author: fincore contributors
-License: MIT License
-        
-        Copyright (c) 2026 Avinash
-        
-        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.
-        
+Version: 0.1.0.dev6
+Summary: Event-driven financial data and analytics framework for real-time market infrastructure.
+Author: Avinash Chandra
+License-Expression: MIT
 Project-URL: Documentation, https://avi2413.github.io/fincore/
 Project-URL: Repository, https://github.com/avi2413/fincore
-Keywords: finance,market-data,rust,python
-Classifier: Development Status :: 3 - Alpha
-Classifier: Programming Language :: Python :: 3
+Project-URL: Issues, https://github.com/avi2413/fincore/issues
+Keywords: analytics,event-driven,finance,financial-data,kafka,market-data,metrics,python,quant,real-time,rust,streaming
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Financial and Insurance Industry
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Programming Language :: Rust
+Classifier: Topic :: Database
+Classifier: Topic :: Scientific/Engineering :: Information Analysis
 Classifier: Topic :: Office/Business :: Financial
-Requires-Python: >=3.10
+Requires-Python: <3.15,>=3.14
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Provides-Extra: kafka
@@ -47,33 +31,38 @@ Requires-Dist: tox>=4; extra == "test"
 Dynamic: license-file
 
 <p align="center">
-  <img src="https://raw.githubusercontent.com/avi2413/fincore/main/docs/_static/fincore-wordmark.svg" alt="fincore wordmark" width="520">
+  <img src="https://raw.githubusercontent.com/avi2413/fincore/main/docs/_static/fincore-wordmark.svg" alt="fincore wordmark" width="100%">
 </p>
 
 <p align="center">
-  <a href="https://pypi.org/project/fincore-py/"><img src="https://img.shields.io/pypi/v/fincore-py.svg?color=111111&label=PyPI" alt="PyPI version"></a>
-  <a href="https://pypi.org/project/fincore-py/#history"><img src="https://img.shields.io/badge/PyPI-dev%20builds-7A1E1E" alt="PyPI dev builds"></a>
+  <a href="https://pypi.org/project/fincore-py/"><img src="https://img.shields.io/pypi/v/fincore-py.svg?color=111111&label=PyPI&logo=pypi&logoColor=white" alt="PyPI version"></a>
+  <a href="https://pypi.org/project/fincore-py/"><img src="https://img.shields.io/pypi/dm/fincore-py.svg?color=7A1E1E&label=downloads&logo=pypi&logoColor=white" alt="PyPI downloads"></a>
+  <a href="https://pypi.org/project/fincore-py/#history"><img src="https://img.shields.io/badge/PyPI-dev%20builds-7A1E1E?logo=pypi&logoColor=white" alt="PyPI dev builds"></a>
+  <a href="https://www.python.org/"><img src="https://img.shields.io/badge/python-3.14-111111?logo=python&logoColor=white" alt="Python 3.14"></a>
+  <a href="https://www.rust-lang.org/"><img src="https://img.shields.io/badge/rust-core-7A1E1E?logo=rust&logoColor=white" alt="Rust core"></a>
+  <a href="https://kafka.apache.org/"><img src="https://img.shields.io/badge/kafka-optional-111111?logo=apachekafka&logoColor=white" alt="Optional Kafka support"></a>
+  <a href="https://pypi.org/project/fincore-py/"><img src="https://img.shields.io/badge/status-beta-111111?logo=semanticrelease&logoColor=white" alt="Beta status"></a>
   <a href="https://github.com/avi2413/fincore/actions/workflows/ci.yml"><img src="https://github.com/avi2413/fincore/actions/workflows/ci.yml/badge.svg" alt="CI workflow"></a>
   <a href="https://codecov.io/gh/avi2413/fincore"><img src="https://codecov.io/gh/avi2413/fincore/branch/main/graph/badge.svg" alt="Codecov coverage"></a>
-  <a href="https://github.com/avi2413/fincore/actions/workflows/publish.yml"><img src="https://github.com/avi2413/fincore/actions/workflows/publish.yml/badge.svg" alt="Publish workflow"></a>
   <a href="https://github.com/avi2413/fincore/actions/workflows/docs.yml"><img src="https://github.com/avi2413/fincore/actions/workflows/docs.yml/badge.svg" alt="Docs workflow"></a>
-  <a href="https://avi2413.github.io/fincore/"><img src="https://img.shields.io/badge/docs-GitHub%20Pages-111111" alt="Documentation"></a>
-  <a href="https://github.com/avi2413/fincore/blob/main/LICENSE"><img src="https://img.shields.io/github/license/avi2413/fincore.svg?color=7A1E1E" alt="License"></a>
+  <a href="https://avi2413.github.io/fincore/"><img src="https://img.shields.io/badge/docs-GitHub%20Pages-111111?logo=githubpages&logoColor=white" alt="Documentation"></a>
+  <a href="https://github.com/avi2413/fincore/issues"><img src="https://img.shields.io/github/issues/avi2413/fincore.svg?color=7A1E1E&logo=github&logoColor=white" alt="GitHub issues"></a>
+  <a href="https://github.com/avi2413/fincore/blob/main/LICENSE"><img src="https://img.shields.io/github/license/avi2413/fincore.svg?color=111111&logo=opensourceinitiative&logoColor=white" alt="License"></a>
 </p>
 
 # fincore
 
-`fincore` is a developer-first financial data library.
+`fincore` is an event-driven financial data and analytics framework for building real-time market infrastructure.
 
-The package is designed for software and data engineers who understand systems, streams, schemas, and downstream storage, but may not yet know finance. The motive is to create a financial data product with a very low barrier of use and understanding: ask for `"Apple"`, get `AAPL`; ask for `"10 year treasury"`, get a usable yield series; ask for a recent minute range, get normalized market events that can flow into Kafka, TimescaleDB, notebooks, or future analytics.
+The package is designed for software and data engineers who think in streams, schemas, event envelopes, metrics, and downstream storage. It provides a low-barrier way to build market-data pipelines: resolve `"Apple"` to `AAPL`, fetch or replay bars, emit Kafka-ready events, derive normalized analytics events, and feed those events into notebooks, databases, stream processors, or future inference systems.
 
-This is a personal research project and an early alpha package. It is not a production-grade market data client, trading system, investment tool, or source of financial advice. Free public data sources can be delayed, incomplete, rate limited, schema-changing, or unavailable.
+This is a personal research project by Avinash Chandra and a beta-stage package. It is not a production-grade market data client, trading system, investment tool, or source of financial advice. Free public data sources can be delayed, incomplete, rate limited, schema-changing, or unavailable.
 
 The Python import name is `fincore`. The PyPI distribution name is `fincore-py`.
 
 ## Current Scope
 
-`fincore-py` currently focuses on data access, not trading or portfolio analytics.
+`fincore-py` currently focuses on data access, event streams, and metrics. It does not do trading, order execution, portfolio construction, or investment recommendations.
 
 Implemented today:
 
@@ -117,20 +106,35 @@ Rust extension
   Yahoo Finance bar fetching
   Nasdaq Trader, ASX, and NSE directory parsing
   FRED yield fetching
+  metric calculations
   normalized Python dict conversion
 ```
 
 ## Installation
 
-Create and activate a Python environment, then install build dependencies:
+Install from PyPI:
 
 ```bash
+python --version  # requires Python 3.14
+python -m pip install fincore-py
+```
+
+Kafka support:
+
+```bash
+python -m pip install "fincore-py[kafka]"
+```
+
+For local development, create and activate a Python environment, then install build dependencies:
+
+```bash
+python --version  # requires Python 3.14
 python -m pip install --upgrade pip
 python -m pip install -r requirements.txt
 python -m pip install -e .
 ```
 
-Kafka support:
+Local Kafka development:
 
 ```bash
 python -m pip install -r requirements-kafka.txt
@@ -176,6 +180,8 @@ client.search_instruments("apple", limit=5)
 client.resolve_symbol("Apple")
 ```
 
+More complete examples live in [`examples/`](examples/).
+
 Choose a market context:
 
 ```python
@@ -497,7 +503,7 @@ The docs explain:
 - market data concepts for non-finance developers
 - streaming and Kafka concepts
 - the current API surface
-- future analytics direction
+- analytics calculations and metric events
 
 Docs are deployed to GitHub Pages from `.github/workflows/docs.yml` on pushes to `main`, version tags, and manual dispatch.
 
@@ -582,31 +588,12 @@ async for metric_event in engine.run(client.stream_bars(["Apple"], interval="1m"
     ...
 ```
 
-## Versioning And Publishing
-
-Python package versions are derived from git tags through `setuptools-scm`.
-
-For a beta pre-release:
-
-```bash
-git tag v0.1.0b0
-git push origin v0.1.0b0
-```
-
-The publish workflow at `.github/workflows/publish.yml` builds distributions for both main pushes and version tags.
-
-- Pushes to `main` publish source-distribution development builds to PyPI, using versions like `0.1.0.dev123`.
-- Tags like `v0.1.0b0` build beta wheels plus a source distribution and publish them to PyPI.
-- Later stable tags like `v0.1.0` can use the same tagged release path.
+## Contributions And Issues
 
-Configure PyPI trusted publishing with:
+Issues, bug reports, documentation fixes, and focused feature suggestions are welcome through [GitHub Issues](https://github.com/avi2413/fincore/issues).
 
-```text
-Repository: <owner>/fincore
-Workflow: publish.yml
-Environment: pypi
-```
+This is still a personal research project, so contributions should stay aligned with the current scope: event-driven market data access, normalized schemas, streaming events, Kafka integration, and analytics metrics. Production trading, order execution, and investment advice are intentionally out of scope.
 
 ## Status
 
-Early alpha implementation stage. The data client is usable for discovery, historical bars, yield series, replay streams, polling streams, and Kafka publishing for personal research and prototyping. The analytics layer now emits normalized metric events for batch and streaming workflows.
+Beta implementation stage. The data client is usable for discovery, historical bars, yield series, replay streams, polling streams, and Kafka publishing for personal research and prototyping. The analytics layer emits normalized metric events for batch and streaming workflows.

{fincore_py-0.1.0.dev4 → fincore_py-0.1.0.dev6}/README.md

@@ -1,31 +1,36 @@
 <p align="center">
-  <img src="https://raw.githubusercontent.com/avi2413/fincore/main/docs/_static/fincore-wordmark.svg" alt="fincore wordmark" width="520">
+  <img src="https://raw.githubusercontent.com/avi2413/fincore/main/docs/_static/fincore-wordmark.svg" alt="fincore wordmark" width="100%">
 </p>
 
 <p align="center">
-  <a href="https://pypi.org/project/fincore-py/"><img src="https://img.shields.io/pypi/v/fincore-py.svg?color=111111&label=PyPI" alt="PyPI version"></a>
-  <a href="https://pypi.org/project/fincore-py/#history"><img src="https://img.shields.io/badge/PyPI-dev%20builds-7A1E1E" alt="PyPI dev builds"></a>
+  <a href="https://pypi.org/project/fincore-py/"><img src="https://img.shields.io/pypi/v/fincore-py.svg?color=111111&label=PyPI&logo=pypi&logoColor=white" alt="PyPI version"></a>
+  <a href="https://pypi.org/project/fincore-py/"><img src="https://img.shields.io/pypi/dm/fincore-py.svg?color=7A1E1E&label=downloads&logo=pypi&logoColor=white" alt="PyPI downloads"></a>
+  <a href="https://pypi.org/project/fincore-py/#history"><img src="https://img.shields.io/badge/PyPI-dev%20builds-7A1E1E?logo=pypi&logoColor=white" alt="PyPI dev builds"></a>
+  <a href="https://www.python.org/"><img src="https://img.shields.io/badge/python-3.14-111111?logo=python&logoColor=white" alt="Python 3.14"></a>
+  <a href="https://www.rust-lang.org/"><img src="https://img.shields.io/badge/rust-core-7A1E1E?logo=rust&logoColor=white" alt="Rust core"></a>
+  <a href="https://kafka.apache.org/"><img src="https://img.shields.io/badge/kafka-optional-111111?logo=apachekafka&logoColor=white" alt="Optional Kafka support"></a>
+  <a href="https://pypi.org/project/fincore-py/"><img src="https://img.shields.io/badge/status-beta-111111?logo=semanticrelease&logoColor=white" alt="Beta status"></a>
   <a href="https://github.com/avi2413/fincore/actions/workflows/ci.yml"><img src="https://github.com/avi2413/fincore/actions/workflows/ci.yml/badge.svg" alt="CI workflow"></a>
   <a href="https://codecov.io/gh/avi2413/fincore"><img src="https://codecov.io/gh/avi2413/fincore/branch/main/graph/badge.svg" alt="Codecov coverage"></a>
-  <a href="https://github.com/avi2413/fincore/actions/workflows/publish.yml"><img src="https://github.com/avi2413/fincore/actions/workflows/publish.yml/badge.svg" alt="Publish workflow"></a>
   <a href="https://github.com/avi2413/fincore/actions/workflows/docs.yml"><img src="https://github.com/avi2413/fincore/actions/workflows/docs.yml/badge.svg" alt="Docs workflow"></a>
-  <a href="https://avi2413.github.io/fincore/"><img src="https://img.shields.io/badge/docs-GitHub%20Pages-111111" alt="Documentation"></a>
-  <a href="https://github.com/avi2413/fincore/blob/main/LICENSE"><img src="https://img.shields.io/github/license/avi2413/fincore.svg?color=7A1E1E" alt="License"></a>
+  <a href="https://avi2413.github.io/fincore/"><img src="https://img.shields.io/badge/docs-GitHub%20Pages-111111?logo=githubpages&logoColor=white" alt="Documentation"></a>
+  <a href="https://github.com/avi2413/fincore/issues"><img src="https://img.shields.io/github/issues/avi2413/fincore.svg?color=7A1E1E&logo=github&logoColor=white" alt="GitHub issues"></a>
+  <a href="https://github.com/avi2413/fincore/blob/main/LICENSE"><img src="https://img.shields.io/github/license/avi2413/fincore.svg?color=111111&logo=opensourceinitiative&logoColor=white" alt="License"></a>
 </p>
 
 # fincore
 
-`fincore` is a developer-first financial data library.
+`fincore` is an event-driven financial data and analytics framework for building real-time market infrastructure.
 
-The package is designed for software and data engineers who understand systems, streams, schemas, and downstream storage, but may not yet know finance. The motive is to create a financial data product with a very low barrier of use and understanding: ask for `"Apple"`, get `AAPL`; ask for `"10 year treasury"`, get a usable yield series; ask for a recent minute range, get normalized market events that can flow into Kafka, TimescaleDB, notebooks, or future analytics.
+The package is designed for software and data engineers who think in streams, schemas, event envelopes, metrics, and downstream storage. It provides a low-barrier way to build market-data pipelines: resolve `"Apple"` to `AAPL`, fetch or replay bars, emit Kafka-ready events, derive normalized analytics events, and feed those events into notebooks, databases, stream processors, or future inference systems.
 
-This is a personal research project and an early alpha package. It is not a production-grade market data client, trading system, investment tool, or source of financial advice. Free public data sources can be delayed, incomplete, rate limited, schema-changing, or unavailable.
+This is a personal research project by Avinash Chandra and a beta-stage package. It is not a production-grade market data client, trading system, investment tool, or source of financial advice. Free public data sources can be delayed, incomplete, rate limited, schema-changing, or unavailable.
 
 The Python import name is `fincore`. The PyPI distribution name is `fincore-py`.
 
 ## Current Scope
 
-`fincore-py` currently focuses on data access, not trading or portfolio analytics.
+`fincore-py` currently focuses on data access, event streams, and metrics. It does not do trading, order execution, portfolio construction, or investment recommendations.
 
 Implemented today:
 
@@ -69,20 +74,35 @@ Rust extension
   Yahoo Finance bar fetching
   Nasdaq Trader, ASX, and NSE directory parsing
   FRED yield fetching
+  metric calculations
   normalized Python dict conversion
 ```
 
 ## Installation
 
-Create and activate a Python environment, then install build dependencies:
+Install from PyPI:
 
 ```bash
+python --version  # requires Python 3.14
+python -m pip install fincore-py
+```
+
+Kafka support:
+
+```bash
+python -m pip install "fincore-py[kafka]"
+```
+
+For local development, create and activate a Python environment, then install build dependencies:
+
+```bash
+python --version  # requires Python 3.14
 python -m pip install --upgrade pip
 python -m pip install -r requirements.txt
 python -m pip install -e .
 ```
 
-Kafka support:
+Local Kafka development:
 
 ```bash
 python -m pip install -r requirements-kafka.txt
@@ -128,6 +148,8 @@ client.search_instruments("apple", limit=5)
 client.resolve_symbol("Apple")
 ```
 
+More complete examples live in [`examples/`](examples/).
+
 Choose a market context:
 
 ```python
@@ -449,7 +471,7 @@ The docs explain:
 - market data concepts for non-finance developers
 - streaming and Kafka concepts
 - the current API surface
-- future analytics direction
+- analytics calculations and metric events
 
 Docs are deployed to GitHub Pages from `.github/workflows/docs.yml` on pushes to `main`, version tags, and manual dispatch.
 
@@ -534,31 +556,12 @@ async for metric_event in engine.run(client.stream_bars(["Apple"], interval="1m"
     ...
 ```
 
-## Versioning And Publishing
-
-Python package versions are derived from git tags through `setuptools-scm`.
-
-For a beta pre-release:
-
-```bash
-git tag v0.1.0b0
-git push origin v0.1.0b0
-```
-
-The publish workflow at `.github/workflows/publish.yml` builds distributions for both main pushes and version tags.
-
-- Pushes to `main` publish source-distribution development builds to PyPI, using versions like `0.1.0.dev123`.
-- Tags like `v0.1.0b0` build beta wheels plus a source distribution and publish them to PyPI.
-- Later stable tags like `v0.1.0` can use the same tagged release path.
+## Contributions And Issues
 
-Configure PyPI trusted publishing with:
+Issues, bug reports, documentation fixes, and focused feature suggestions are welcome through [GitHub Issues](https://github.com/avi2413/fincore/issues).
 
-```text
-Repository: <owner>/fincore
-Workflow: publish.yml
-Environment: pypi
-```
+This is still a personal research project, so contributions should stay aligned with the current scope: event-driven market data access, normalized schemas, streaming events, Kafka integration, and analytics metrics. Production trading, order execution, and investment advice are intentionally out of scope.
 
 ## Status
 
-Early alpha implementation stage. The data client is usable for discovery, historical bars, yield series, replay streams, polling streams, and Kafka publishing for personal research and prototyping. The analytics layer now emits normalized metric events for batch and streaming workflows.
+Beta implementation stage. The data client is usable for discovery, historical bars, yield series, replay streams, polling streams, and Kafka publishing for personal research and prototyping. The analytics layer emits normalized metric events for batch and streaming workflows.

fincore_py-0.1.0.dev6/docs/_static/fincore-wordmark.svg

@@ -0,0 +1,29 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1440" height="300" viewBox="0 0 1440 300" role="img" aria-labelledby="title desc">
+  <title id="title">fincore wordmark</title>
+  <desc id="desc">Noir brutalist fincore wordmark showing event streams, normalized data, and analytics signals.</desc>
+  <rect width="1440" height="300" fill="#0B0B0B"/>
+  <path d="M0 246H1440" stroke="#191919" stroke-width="2"/>
+  <path d="M0 68H1440" stroke="#151515" stroke-width="2"/>
+  <g transform="translate(82 70)">
+    <rect x="0" y="0" width="160" height="160" fill="none" stroke="#D9D2C3" stroke-width="3"/>
+    <path d="M24 40H66M94 40H136M24 80H52M80 80H136M24 120H70M98 120H136" stroke="#6F6A61" stroke-width="5" stroke-linecap="square"/>
+    <circle cx="76" cy="40" r="8" fill="#8F1D1D"/>
+    <circle cx="66" cy="80" r="8" fill="#D9D2C3"/>
+    <circle cx="84" cy="120" r="8" fill="#8F1D1D"/>
+    <path d="M32 136L58 108L82 116L112 72L132 88" fill="none" stroke="#D9D2C3" stroke-width="4" stroke-linecap="square" stroke-linejoin="miter"/>
+    <path d="M32 136L58 108L82 116L112 72L132 88" fill="none" stroke="#8F1D1D" stroke-width="2" stroke-linecap="square" stroke-linejoin="miter"/>
+  </g>
+  <text x="282" y="144" fill="#EFE8D8" font-family="'Arial Narrow', 'Helvetica Neue Condensed Bold', 'Roboto Condensed', Arial, sans-serif" font-size="102" font-weight="800" letter-spacing="10">FINCORE</text>
+  <path d="M286 166H934" stroke="#8F1D1D" stroke-width="5"/>
+  <text x="288" y="212" fill="#A8A096" font-family="'Arial Narrow', 'Roboto Condensed', Arial, sans-serif" font-size="28" font-weight="700" letter-spacing="5">EVENT-DRIVEN DATA + ANALYTICS INFRASTRUCTURE</text>
+  <g transform="translate(1058 86)" stroke-linecap="square">
+    <path d="M0 32H245" stroke="#2A2A2A" stroke-width="3"/>
+    <path d="M0 76H245" stroke="#2A2A2A" stroke-width="3"/>
+    <path d="M0 120H245" stroke="#2A2A2A" stroke-width="3"/>
+    <path d="M22 32H66L94 76H146L174 120H226" stroke="#8F1D1D" stroke-width="5" fill="none"/>
+    <path d="M22 120H70L102 76H150L182 32H226" stroke="#D9D2C3" stroke-width="4" fill="none"/>
+    <circle cx="94" cy="76" r="7" fill="#D9D2C3"/>
+    <circle cx="174" cy="120" r="7" fill="#8F1D1D"/>
+    <circle cx="182" cy="32" r="7" fill="#D9D2C3"/>
+  </g>
+</svg>

{fincore_py-0.1.0.dev4 → fincore_py-0.1.0.dev6}/docs/conf.py

@@ -1,6 +1,6 @@
 project = "fincore-py"
-author = "fincore contributors"
-copyright = "2026, fincore contributors"
+author = "Avinash Chandra"
+copyright = "2026, Avinash Chandra"
 extensions = [
     "sphinx.ext.autodoc",
     "sphinx.ext.napoleon",

{fincore_py-0.1.0.dev4 → fincore_py-0.1.0.dev6}/docs/index.rst

@@ -1,9 +1,10 @@
 fincore-py documentation
 ========================
 
-``fincore-py`` is a developer-first financial data library. It is designed for
-engineers who understand data systems, streams, schemas, and downstream storage,
-but may not yet know market conventions or financial terminology.
+``fincore-py`` is an event-driven financial data and analytics framework for
+building real-time market infrastructure. It is designed for engineers who
+understand data systems, streams, schemas, and downstream storage, but may not
+yet know market conventions or financial terminology.
 
 The package imports as ``fincore`` and currently focuses on:
 
@@ -14,6 +15,7 @@ The package imports as ``fincore`` and currently focuses on:
 * historical replay streams
 * delayed polling streams for latest bars
 * Kafka-ready event envelopes
+* normalized analytics metric events
 
 .. toctree::
    :maxdepth: 2

{fincore_py-0.1.0.dev4 → fincore_py-0.1.0.dev6}/docs/schemas.rst

@@ -2,7 +2,7 @@ Output schemas
 ==============
 
 ``fincore-py`` returns plain Python dictionaries. The shapes below are the
-public contract for the current alpha data layer.
+public contract for the current beta data and analytics layers.
 
 Instrument
 ----------

fincore_py-0.1.0.dev6/examples/01_data_discovery.py

@@ -0,0 +1,31 @@
+"""Discover instruments and fetch normalized data."""
+
+from __future__ import annotations
+
+from fincore.data import DataClient
+
+
+def main() -> None:
+    client = DataClient(market="US")
+    print("US matches for Apple:")
+    print(client.search_instruments("apple", limit=3))
+
+    au = DataClient(market="AU")
+    print("Australia matches for BHP:")
+    print(au.search_instruments("bhp", limit=3))
+
+    india = DataClient(market="IN")
+    print("India matches for Reliance:")
+    print(india.search_instruments("reliance", limit=3))
+
+    print("Daily Apple bars:")
+    bars = client.fetch_bars("Apple", "2024-01-01", "2024-01-10", interval="1d")
+    print(bars[:2])
+
+    print("US 10Y Treasury yield observations:")
+    yields = client.fetch_bond_yields("10 year treasury", start="2024-01-01", end="2024-01-10")
+    print(yields[:2])
+
+
+if __name__ == "__main__":
+    main()

fincore_py-0.1.0.dev6/examples/02_batch_analytics.py

@@ -0,0 +1,31 @@
+"""Compute batch analytics from historical bars."""
+
+from __future__ import annotations
+
+from fincore.analytics import MetricEngine, MetricSpec
+from fincore.data import DataClient
+
+
+def main() -> None:
+    client = DataClient()
+    bars = client.fetch_bars("Apple", "2024-01-01", "2024-02-15", interval="1d")
+
+    engine = MetricEngine()
+    metric_events = engine.compute(
+        bars,
+        metrics=[
+            "return.simple",
+            "return.log",
+            MetricSpec("momentum.roc", window=3),
+            MetricSpec("volatility.rolling", window=5),
+            MetricSpec("drawdown.current"),
+            MetricSpec("auc.window", window=5),
+        ],
+    )
+
+    for event in metric_events[:10]:
+        print(event)
+
+
+if __name__ == "__main__":
+    main()

fincore_py-0.1.0.dev6/examples/03_streaming_metrics.py

@@ -0,0 +1,27 @@
+"""Replay historical bars and derive metrics on the fly."""
+
+from __future__ import annotations
+
+import asyncio
+
+from fincore.analytics import MetricEngine, MetricSpec
+from fincore.data import DataClient
+
+
+async def main() -> None:
+    client = DataClient()
+    engine = MetricEngine(
+        metrics=[
+            "return.simple",
+            MetricSpec("momentum.roc", window=3),
+            MetricSpec("volatility.rolling", window=5),
+        ]
+    )
+
+    async for event in client.replay_bars("Apple", "2024-01-01", "2024-01-31", interval="1d"):
+        for metric_event in engine.update(event):
+            print(metric_event)
+
+
+if __name__ == "__main__":
+    asyncio.run(main())

fincore_py-0.1.0.dev6/examples/04_external_rows.py

@@ -0,0 +1,37 @@
+"""Compute metrics from external database-style rows."""
+
+from __future__ import annotations
+
+from fincore.analytics import MetricEngine, MetricSpec
+
+
+def main() -> None:
+    db_rows = [
+        {"ticker": "aapl", "ts": "2024-01-01T00:00:00+00:00", "close_price": 100.0, "share_volume": 1000},
+        {"ticker": "aapl", "ts": "2024-01-02T00:00:00+00:00", "close_price": 104.0, "share_volume": 1100},
+        {"ticker": "aapl", "ts": "2024-01-03T00:00:00+00:00", "close_price": 102.0, "share_volume": 1200},
+        {"ticker": "aapl", "ts": "2024-01-04T00:00:00+00:00", "close_price": 108.0, "share_volume": 1300},
+    ]
+
+    engine = MetricEngine()
+    events = engine.compute(
+        db_rows,
+        metrics=[
+            "return.simple",
+            MetricSpec("momentum.acceleration"),
+            MetricSpec("auc.window", window=3),
+        ],
+        field_map={
+            "symbol": "ticker",
+            "event_time": "ts",
+            "close": "close_price",
+            "volume": "share_volume",
+        },
+    )
+
+    for event in events:
+        print(event)
+
+
+if __name__ == "__main__":
+    main()

fincore_py-0.1.0.dev6/examples/05_kafka_publish.py

@@ -0,0 +1,25 @@
+"""Publish fincore stream events to Kafka."""
+
+from __future__ import annotations
+
+import asyncio
+
+from fincore.data import DataClient
+from fincore.data.kafka import KafkaSink
+
+
+async def main() -> None:
+    client = DataClient()
+    sink = KafkaSink(
+        bootstrap_servers="localhost:9092",
+        topic="fincore.market.bars",
+    )
+
+    count = await sink.publish_stream(
+        client.replay_bars("Apple", "2024-01-01", "2024-01-05", interval="1d")
+    )
+    print(f"published {count} events")
+
+
+if __name__ == "__main__":
+    asyncio.run(main())

fincore_py-0.1.0.dev6/examples/README.md

@@ -0,0 +1,31 @@
+# fincore examples
+
+These examples are small scripts showing the current beta surface.
+
+Run them after installing the package:
+
+```bash
+python -m pip install fincore-py
+```
+
+For local development:
+
+```bash
+python -m pip install -e .
+```
+
+Kafka examples require the optional extra:
+
+```bash
+python -m pip install "fincore-py[kafka]"
+```
+
+Examples:
+
+- `01_data_discovery.py`: market contexts, fuzzy symbol resolution, bars, and bond yields
+- `02_batch_analytics.py`: batch metric events from historical bars
+- `03_streaming_metrics.py`: historical replay plus on-the-fly metrics
+- `04_external_rows.py`: analytics from database-style rows with a field map
+- `05_kafka_publish.py`: publishing replay events to Kafka
+
+The examples use free public sources, so live fetches can fail or return empty results when an upstream source is unavailable, rate-limited, or outside its retention window.

{fincore_py-0.1.0.dev4 → fincore_py-0.1.0.dev6}/pyproject.toml

@@ -10,18 +10,36 @@ build-backend = "setuptools.build_meta"
 [project]
 name = "fincore-py"
 dynamic = ["version"]
-description = "Python-facing financial market data access library powered by Rust."
+description = "Event-driven financial data and analytics framework for real-time market infrastructure."
 readme = "README.md"
-requires-python = ">=3.10"
-license = { file = "LICENSE" }
+requires-python = ">=3.14,<3.15"
+license = "MIT"
+license-files = ["LICENSE"]
 authors = [
-  { name = "fincore contributors" }
+  { name = "Avinash Chandra" }
+]
+keywords = [
+  "analytics",
+  "event-driven",
+  "finance",
+  "financial-data",
+  "kafka",
+  "market-data",
+  "metrics",
+  "python",
+  "quant",
+  "real-time",
+  "rust",
+  "streaming",
 ]
-keywords = ["finance", "market-data", "rust", "python"]
 classifiers = [
-  "Development Status :: 3 - Alpha",
-  "Programming Language :: Python :: 3",
+  "Development Status :: 4 - Beta",
+  "Intended Audience :: Developers",
+  "Intended Audience :: Financial and Insurance Industry",
+  "Programming Language :: Python :: 3.14",
   "Programming Language :: Rust",
+  "Topic :: Database",
+  "Topic :: Scientific/Engineering :: Information Analysis",
   "Topic :: Office/Business :: Financial",
 ]
 
@@ -42,6 +60,7 @@ test = [
 [project.urls]
 Documentation = "https://avi2413.github.io/fincore/"
 Repository = "https://github.com/avi2413/fincore"
+Issues = "https://github.com/avi2413/fincore/issues"
 
 [tool.setuptools]
 package-dir = { "" = "python" }

{fincore_py-0.1.0.dev4 → fincore_py-0.1.0.dev6}/python/fincore/_version.py

@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
 commit_id: str | None
 __commit_id__: str | None
 
-__version__ = version = '0.1.0.dev4'
-__version_tuple__ = version_tuple = (0, 1, 0, 'dev4')
+__version__ = version = '0.1.0.dev6'
+__version_tuple__ = version_tuple = (0, 1, 0, 'dev6')
 
 __commit_id__ = commit_id = None

{fincore_py-0.1.0.dev4 → fincore_py-0.1.0.dev6}/python/fincore_py.egg-info/PKG-INFO

@@ -1,38 +1,22 @@
 Metadata-Version: 2.4
 Name: fincore-py
-Version: 0.1.0.dev4
-Summary: Python-facing financial market data access library powered by Rust.
-Author: fincore contributors
-License: MIT License
-        
-        Copyright (c) 2026 Avinash
-        
-        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.
-        
+Version: 0.1.0.dev6
+Summary: Event-driven financial data and analytics framework for real-time market infrastructure.
+Author: Avinash Chandra
+License-Expression: MIT
 Project-URL: Documentation, https://avi2413.github.io/fincore/
 Project-URL: Repository, https://github.com/avi2413/fincore
-Keywords: finance,market-data,rust,python
-Classifier: Development Status :: 3 - Alpha
-Classifier: Programming Language :: Python :: 3
+Project-URL: Issues, https://github.com/avi2413/fincore/issues
+Keywords: analytics,event-driven,finance,financial-data,kafka,market-data,metrics,python,quant,real-time,rust,streaming
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Financial and Insurance Industry
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Programming Language :: Rust
+Classifier: Topic :: Database
+Classifier: Topic :: Scientific/Engineering :: Information Analysis
 Classifier: Topic :: Office/Business :: Financial
-Requires-Python: >=3.10
+Requires-Python: <3.15,>=3.14
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Provides-Extra: kafka
@@ -47,33 +31,38 @@ Requires-Dist: tox>=4; extra == "test"
 Dynamic: license-file
 
 <p align="center">
-  <img src="https://raw.githubusercontent.com/avi2413/fincore/main/docs/_static/fincore-wordmark.svg" alt="fincore wordmark" width="520">
+  <img src="https://raw.githubusercontent.com/avi2413/fincore/main/docs/_static/fincore-wordmark.svg" alt="fincore wordmark" width="100%">
 </p>
 
 <p align="center">
-  <a href="https://pypi.org/project/fincore-py/"><img src="https://img.shields.io/pypi/v/fincore-py.svg?color=111111&label=PyPI" alt="PyPI version"></a>
-  <a href="https://pypi.org/project/fincore-py/#history"><img src="https://img.shields.io/badge/PyPI-dev%20builds-7A1E1E" alt="PyPI dev builds"></a>
+  <a href="https://pypi.org/project/fincore-py/"><img src="https://img.shields.io/pypi/v/fincore-py.svg?color=111111&label=PyPI&logo=pypi&logoColor=white" alt="PyPI version"></a>
+  <a href="https://pypi.org/project/fincore-py/"><img src="https://img.shields.io/pypi/dm/fincore-py.svg?color=7A1E1E&label=downloads&logo=pypi&logoColor=white" alt="PyPI downloads"></a>
+  <a href="https://pypi.org/project/fincore-py/#history"><img src="https://img.shields.io/badge/PyPI-dev%20builds-7A1E1E?logo=pypi&logoColor=white" alt="PyPI dev builds"></a>
+  <a href="https://www.python.org/"><img src="https://img.shields.io/badge/python-3.14-111111?logo=python&logoColor=white" alt="Python 3.14"></a>
+  <a href="https://www.rust-lang.org/"><img src="https://img.shields.io/badge/rust-core-7A1E1E?logo=rust&logoColor=white" alt="Rust core"></a>
+  <a href="https://kafka.apache.org/"><img src="https://img.shields.io/badge/kafka-optional-111111?logo=apachekafka&logoColor=white" alt="Optional Kafka support"></a>
+  <a href="https://pypi.org/project/fincore-py/"><img src="https://img.shields.io/badge/status-beta-111111?logo=semanticrelease&logoColor=white" alt="Beta status"></a>
   <a href="https://github.com/avi2413/fincore/actions/workflows/ci.yml"><img src="https://github.com/avi2413/fincore/actions/workflows/ci.yml/badge.svg" alt="CI workflow"></a>
   <a href="https://codecov.io/gh/avi2413/fincore"><img src="https://codecov.io/gh/avi2413/fincore/branch/main/graph/badge.svg" alt="Codecov coverage"></a>
-  <a href="https://github.com/avi2413/fincore/actions/workflows/publish.yml"><img src="https://github.com/avi2413/fincore/actions/workflows/publish.yml/badge.svg" alt="Publish workflow"></a>
   <a href="https://github.com/avi2413/fincore/actions/workflows/docs.yml"><img src="https://github.com/avi2413/fincore/actions/workflows/docs.yml/badge.svg" alt="Docs workflow"></a>
-  <a href="https://avi2413.github.io/fincore/"><img src="https://img.shields.io/badge/docs-GitHub%20Pages-111111" alt="Documentation"></a>
-  <a href="https://github.com/avi2413/fincore/blob/main/LICENSE"><img src="https://img.shields.io/github/license/avi2413/fincore.svg?color=7A1E1E" alt="License"></a>
+  <a href="https://avi2413.github.io/fincore/"><img src="https://img.shields.io/badge/docs-GitHub%20Pages-111111?logo=githubpages&logoColor=white" alt="Documentation"></a>
+  <a href="https://github.com/avi2413/fincore/issues"><img src="https://img.shields.io/github/issues/avi2413/fincore.svg?color=7A1E1E&logo=github&logoColor=white" alt="GitHub issues"></a>
+  <a href="https://github.com/avi2413/fincore/blob/main/LICENSE"><img src="https://img.shields.io/github/license/avi2413/fincore.svg?color=111111&logo=opensourceinitiative&logoColor=white" alt="License"></a>
 </p>
 
 # fincore
 
-`fincore` is a developer-first financial data library.
+`fincore` is an event-driven financial data and analytics framework for building real-time market infrastructure.
 
-The package is designed for software and data engineers who understand systems, streams, schemas, and downstream storage, but may not yet know finance. The motive is to create a financial data product with a very low barrier of use and understanding: ask for `"Apple"`, get `AAPL`; ask for `"10 year treasury"`, get a usable yield series; ask for a recent minute range, get normalized market events that can flow into Kafka, TimescaleDB, notebooks, or future analytics.
+The package is designed for software and data engineers who think in streams, schemas, event envelopes, metrics, and downstream storage. It provides a low-barrier way to build market-data pipelines: resolve `"Apple"` to `AAPL`, fetch or replay bars, emit Kafka-ready events, derive normalized analytics events, and feed those events into notebooks, databases, stream processors, or future inference systems.
 
-This is a personal research project and an early alpha package. It is not a production-grade market data client, trading system, investment tool, or source of financial advice. Free public data sources can be delayed, incomplete, rate limited, schema-changing, or unavailable.
+This is a personal research project by Avinash Chandra and a beta-stage package. It is not a production-grade market data client, trading system, investment tool, or source of financial advice. Free public data sources can be delayed, incomplete, rate limited, schema-changing, or unavailable.
 
 The Python import name is `fincore`. The PyPI distribution name is `fincore-py`.
 
 ## Current Scope
 
-`fincore-py` currently focuses on data access, not trading or portfolio analytics.
+`fincore-py` currently focuses on data access, event streams, and metrics. It does not do trading, order execution, portfolio construction, or investment recommendations.
 
 Implemented today:
 
@@ -117,20 +106,35 @@ Rust extension
   Yahoo Finance bar fetching
   Nasdaq Trader, ASX, and NSE directory parsing
   FRED yield fetching
+  metric calculations
   normalized Python dict conversion
 ```
 
 ## Installation
 
-Create and activate a Python environment, then install build dependencies:
+Install from PyPI:
 
 ```bash
+python --version  # requires Python 3.14
+python -m pip install fincore-py
+```
+
+Kafka support:
+
+```bash
+python -m pip install "fincore-py[kafka]"
+```
+
+For local development, create and activate a Python environment, then install build dependencies:
+
+```bash
+python --version  # requires Python 3.14
 python -m pip install --upgrade pip
 python -m pip install -r requirements.txt
 python -m pip install -e .
 ```
 
-Kafka support:
+Local Kafka development:
 
 ```bash
 python -m pip install -r requirements-kafka.txt
@@ -176,6 +180,8 @@ client.search_instruments("apple", limit=5)
 client.resolve_symbol("Apple")
 ```
 
+More complete examples live in [`examples/`](examples/).
+
 Choose a market context:
 
 ```python
@@ -497,7 +503,7 @@ The docs explain:
 - market data concepts for non-finance developers
 - streaming and Kafka concepts
 - the current API surface
-- future analytics direction
+- analytics calculations and metric events
 
 Docs are deployed to GitHub Pages from `.github/workflows/docs.yml` on pushes to `main`, version tags, and manual dispatch.
 
@@ -582,31 +588,12 @@ async for metric_event in engine.run(client.stream_bars(["Apple"], interval="1m"
     ...
 ```
 
-## Versioning And Publishing
-
-Python package versions are derived from git tags through `setuptools-scm`.
-
-For a beta pre-release:
-
-```bash
-git tag v0.1.0b0
-git push origin v0.1.0b0
-```
-
-The publish workflow at `.github/workflows/publish.yml` builds distributions for both main pushes and version tags.
-
-- Pushes to `main` publish source-distribution development builds to PyPI, using versions like `0.1.0.dev123`.
-- Tags like `v0.1.0b0` build beta wheels plus a source distribution and publish them to PyPI.
-- Later stable tags like `v0.1.0` can use the same tagged release path.
+## Contributions And Issues
 
-Configure PyPI trusted publishing with:
+Issues, bug reports, documentation fixes, and focused feature suggestions are welcome through [GitHub Issues](https://github.com/avi2413/fincore/issues).
 
-```text
-Repository: <owner>/fincore
-Workflow: publish.yml
-Environment: pypi
-```
+This is still a personal research project, so contributions should stay aligned with the current scope: event-driven market data access, normalized schemas, streaming events, Kafka integration, and analytics metrics. Production trading, order execution, and investment advice are intentionally out of scope.
 
 ## Status
 
-Early alpha implementation stage. The data client is usable for discovery, historical bars, yield series, replay streams, polling streams, and Kafka publishing for personal research and prototyping. The analytics layer now emits normalized metric events for batch and streaming workflows.
+Beta implementation stage. The data client is usable for discovery, historical bars, yield series, replay streams, polling streams, and Kafka publishing for personal research and prototyping. The analytics layer emits normalized metric events for batch and streaming workflows.

{fincore_py-0.1.0.dev4 → fincore_py-0.1.0.dev6}/python/fincore_py.egg-info/SOURCES.txt

@@ -24,6 +24,12 @@ docs/schemas.rst
 docs/streaming.rst
 docs/_static/brand.css
 docs/_static/fincore-wordmark.svg
+examples/01_data_discovery.py
+examples/02_batch_analytics.py
+examples/03_streaming_metrics.py
+examples/04_external_rows.py
+examples/05_kafka_publish.py
+examples/README.md
 python/fincore/__init__.py
 python/fincore/_version.py
 python/fincore/analytics/__init__.py

{fincore_py-0.1.0.dev4 → fincore_py-0.1.0.dev6}/tox.ini

@@ -1,8 +1,8 @@
 [tox]
-env_list = py
+env_list = py314
 isolated_build = true
 
-[testenv]
+[testenv:py314]
 description = Run the Python unit tests.
 extras = test
 setenv =

fincore_py-0.1.0.dev4/docs/_static/fincore-wordmark.svg

@@ -1,14 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" width="820" height="180" viewBox="0 0 820 180" role="img" aria-labelledby="title desc">
-  <title id="title">fincore wordmark</title>
-  <desc id="desc">Lean noir brutalist fincore wordmark with a restrained market signal mark.</desc>
-  <rect width="820" height="180" fill="#0D0D0D"/>
-  <g transform="translate(52 48)">
-    <rect x="0" y="0" width="84" height="84" fill="none" stroke="#B8B2A4" stroke-width="2"/>
-    <path d="M16 56 H31 L42 42 L53 48 L68 25" fill="none" stroke="#7A1E1E" stroke-width="4" stroke-linecap="square" stroke-linejoin="miter"/>
-    <path d="M16 68 H68" stroke="#2A2A2A" stroke-width="2"/>
-    <path d="M16 16 V68" stroke="#2A2A2A" stroke-width="2"/>
-  </g>
-  <text x="164" y="96" fill="#E7E0D0" font-family="'Arial Narrow', 'Helvetica Neue Condensed Bold', 'Roboto Condensed', Arial, sans-serif" font-size="58" font-weight="700" letter-spacing="6">FINCORE</text>
-  <path d="M166 111 H474" stroke="#7A1E1E" stroke-width="3"/>
-  <text x="166" y="139" fill="#8F8A80" font-family="'Arial Narrow', 'Roboto Condensed', Arial, sans-serif" font-size="17" letter-spacing="4">MARKET DATA INFRASTRUCTURE</text>
-</svg>