kuznets 1.0__tar.gz

kuznets-1.0/.codecov.yml

@@ -0,0 +1,11 @@
+codecov:
+  notify:
+    require_ci_to_pass: no
+coverage:
+  status:
+    project:
+      default:
+        # Require 1% coverage, i.e., always succeed
+        target: 1
+    patch: false
+    changes: false

kuznets-1.0/.github/release.yml

@@ -0,0 +1,26 @@
+# Mostly taken verbatim from https://github.com/pymc-devs/pymc/blob/main/.github/release.yml
+#
+# This file contains configuration for the automatic generation of release notes in GitHub.
+# Also see https://docs.github.com/en/repositories/releasing-projects-on-github/automatically-generated-release-notes
+changelog:
+  exclude:
+    labels:
+      - no releasenotes
+  categories:
+    - title: Major Changes 🛠
+      labels:
+        - major
+    - title: New Features 🎉
+      labels:
+        - enhancement
+        - feature request
+    - title: Bugfixes 🐛
+      labels:
+        - bug
+    - title: Documentation 📖
+      labels:
+        - docs
+        - documentation
+    - title: Maintenance 🔧
+      labels:
+        - "*"

kuznets-1.0/.github/workflows/ci.yml

@@ -0,0 +1,58 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  pre-commit:
+    name: Pre-Commit
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+      - uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1 # v6.3.0
+        with:
+          python-version: "3.12"
+      - uses: prefix-dev/setup-pixi@a09b6247153796b190642a2b53fac4241043cf6f # v0.10.0
+        with:
+          pixi-version: v0.70.2
+          run-install: false
+      - uses: pre-commit/action@2c7b3805fd2a0fd8c1884dcaebf91fc102a13ecd # v3.0.1
+
+  tests:
+    name: Tests (${{ matrix.os }}, ${{ matrix.environment }})
+    needs: pre-commit
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, windows-latest]
+        environment: [default, py313, py314]
+
+    steps:
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+        with:
+          fetch-depth: 0  # needed for hatch-vcs
+
+      - uses: prefix-dev/setup-pixi@a09b6247153796b190642a2b53fac4241043cf6f # v0.10.0
+        with:
+          pixi-version: v0.70.2
+          environments: ${{ matrix.environment }}
+          cache: true
+
+      - name: List installed packages
+        run: pixi list -e ${{ matrix.environment }}
+
+      - name: Run tests
+        run: pixi run -e ${{ matrix.environment }} test-cov
+
+      - name: Upload coverage to Codecov
+        if: always()
+        uses: codecov/codecov-action@fb8b3582c8e4def4969c97caa2f19720cb33a72f # v7.0.0
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}
+          files: coverage.xml
+          flags: ${{ matrix.os }}-${{ matrix.environment }}
+          fail_ci_if_error: false

kuznets-1.0/.github/workflows/refresh-fixtures.yml

@@ -0,0 +1,64 @@
+name: Refresh test fixtures
+
+# Re-records the offline test fixtures from the live services and verifies their shape. Runs weekly
+# (and on demand). Push/PR CI stays fully offline; only this job touches the network.
+on:
+  schedule:
+    - cron: "0 6 * * 1"  # Mondays 06:00 UTC
+  workflow_dispatch:
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  refresh:
+    name: Record fixtures and open PR on drift
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+        with:
+          fetch-depth: 0  # needed for hatch-vcs
+
+      - uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1 # v6.3.0
+        with:
+          python-version: "3.12"
+
+      - name: Install package and dev dependencies
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install -e ".[dev]"
+
+      - name: Record fixtures from live services
+        id: record
+        continue-on-error: true
+        env:
+          RECORD: "1"
+          # Optional: set these as repo secrets to also record the keyed readers.
+          ALPHAVANTAGE_API_KEY: ${{ secrets.ALPHAVANTAGE_API_KEY }}
+          QUANDL_API_KEY: ${{ secrets.QUANDL_API_KEY }}
+          TIINGO_API_KEY: ${{ secrets.TIINGO_API_KEY }}
+        run: pytest -m network -o addopts="" -rs
+
+      - name: Verify offline suite replays the refreshed fixtures
+        run: pytest
+
+      - name: Open PR with refreshed fixtures
+        if: always()
+        uses: peter-evans/create-pull-request@5f6978faf089d4d20b00c7766989d076bb2fc7f1 # v8.1.1
+        with:
+          branch: bot/refresh-fixtures
+          title: "test: refresh recorded fixtures"
+          commit-message: "test: refresh recorded fixtures from live services"
+          body: |
+            Automated weekly refresh of the recorded responses under `tests/data/`.
+
+            If this PR is empty, the live responses still match. If the live-recording step
+            failed, an upstream API shape changed — review the diff and the failed run before merging.
+          add-paths: tests/data
+
+      - name: Fail the run if live recording detected drift
+        if: steps.record.outcome == 'failure'
+        run: |
+          echo "Live recording reported a failure (likely an upstream API shape change)."
+          exit 1

kuznets-1.0/.github/workflows/release.yml

@@ -0,0 +1,36 @@
+name: PyPI
+
+on:
+  pull_request:
+    branches: [main]
+  push:
+    branches: [main]
+  release:
+    types: [published]
+
+jobs:
+  build:
+    name: build and inspect the package
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+        with:
+          fetch-depth: 0
+      - uses: hynek/build-and-inspect-python-package@d44ca7d91762de7a7d5436ddae667c6da6d1c3df # v2.18.0
+
+  publish:
+    name: upload release to PyPI
+    needs: [build]
+    runs-on: ubuntu-latest
+    if: github.repository_owner == 'jessegrabowski' && github.event_name == 'release' && github.event.action == 'published'
+    # The release GitHub environment protects Trusted Publishing (OIDC) behind maintainer signoff.
+    environment: release
+    permissions:
+      # write id-token is necessary for trusted publishing (OIDC)
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
+        with:
+          name: Packages
+          path: dist
+      - uses: pypa/gh-action-pypi-publish@cef221092ed1bacb1cc03d23a2d87d1d172e277b # v1.14.0

kuznets-1.0/.gitignore

@@ -0,0 +1,21 @@
+__pycache__
+*.pyc
+*.egg-info
+.coverage
+build
+dist
+docs/build
+.tox/
+.cache/
+.idea
+*.iml
+*~
+env/
+.pytest_cache/
+.vscode/
+scratch.py
+.pixi/
+coverage.xml
+junit/
+cache.sqlite
+docs/source/_version.txt

kuznets-1.0/.pre-commit-config.yaml

@@ -0,0 +1,36 @@
+repos:
+- repo: https://github.com/pre-commit/pre-commit-hooks
+  rev: v6.0.0
+  hooks:
+    -   id: check-merge-conflict
+    -   id: check-toml
+    -   id: check-yaml
+    -   id: debug-statements
+    -   id: end-of-file-fixer
+        exclude: ^tests/data/
+    -   id: trailing-whitespace
+        exclude: ^tests/data/
+
+- repo: https://github.com/astral-sh/ruff-pre-commit
+  rev: v0.12.8
+  hooks:
+    - id: ruff
+      args: [ --fix, --exit-non-zero-on-fix ]
+      exclude: \.md$
+    - id: ruff-format
+      types_or: [ python, pyi ]
+
+- repo: https://github.com/MarcoGorelli/absolufy-imports
+  rev: v0.3.1
+  hooks:
+    - id: absolufy-imports
+      types: [python]
+
+- repo: local
+  hooks:
+    - id: pixi-lock-check
+      name: pixi.lock is in sync with pyproject.toml
+      entry: pixi lock --check
+      language: system
+      files: ^(pyproject\.toml|pixi\.lock)$
+      pass_filenames: false

kuznets-1.0/LICENSE.md

@@ -0,0 +1,49 @@
+=======
+License
+=======
+
+kuznets license
+===============
+
+Copyright (c) 2026, Jesse Grabowski
+All rights reserved.
+
+kuznets is a fork of pandas-datareader and is distributed under the same 3-clause BSD license,
+reproduced below with its original copyright notices.
+
+pandas-datareader license
+=========================
+
+Copyright (c) 2011-2012, Lambda Foundry, Inc. and PyData Development Team
+All rights reserved.
+
+Copyright (c) 2008-2011 AQR Capital Management, LLC
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are
+met:
+
+    * Redistributions of source code must retain the above copyright
+       notice, this list of conditions and the following disclaimer.
+
+    * Redistributions in binary form must reproduce the above
+       copyright notice, this list of conditions and the following
+       disclaimer in the documentation and/or other materials provided
+       with the distribution.
+
+    * Neither the name of the copyright holder nor the names of any
+       contributors may be used to endorse or promote products derived
+       from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDER AND CONTRIBUTORS
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

kuznets-1.0/PKG-INFO

@@ -0,0 +1,177 @@
+Metadata-Version: 2.4
+Name: kuznets
+Version: 1.0
+Summary: Economic and financial data readers for pandas, polars, pyarrow, and dask.
+Project-URL: Homepage, https://github.com/jessegrabowski/kuznets
+Project-URL: Documentation, https://kuznets.readthedocs.io/en/latest/
+Project-URL: Repository, https://github.com/jessegrabowski/kuznets.git
+Project-URL: Bug Tracker, https://github.com/jessegrabowski/kuznets/issues
+Author-email: Jesse Grabowski <jessegrabowski@gmail.com>
+License-Expression: BSD-3-Clause
+License-File: LICENSE.md
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Science/Research
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Scientific/Engineering
+Requires-Python: >=3.12
+Requires-Dist: lxml
+Requires-Dist: narwhals>=2.0
+Requires-Dist: pandas>=3.0
+Requires-Dist: requests
+Provides-Extra: backends
+Requires-Dist: dask[dataframe]; extra == 'backends'
+Requires-Dist: polars; extra == 'backends'
+Requires-Dist: pyarrow; extra == 'backends'
+Provides-Extra: dask
+Requires-Dist: dask[dataframe]; extra == 'dask'
+Provides-Extra: dev
+Requires-Dist: coverage; extra == 'dev'
+Requires-Dist: dask[dataframe]; extra == 'dev'
+Requires-Dist: polars; extra == 'dev'
+Requires-Dist: pre-commit; extra == 'dev'
+Requires-Dist: pyarrow; extra == 'dev'
+Requires-Dist: pytest-cov; extra == 'dev'
+Requires-Dist: pytest-xdist; extra == 'dev'
+Requires-Dist: pytest>=8; extra == 'dev'
+Requires-Dist: ruff; extra == 'dev'
+Requires-Dist: wrapt; extra == 'dev'
+Provides-Extra: docs
+Requires-Dist: ipython; extra == 'docs'
+Requires-Dist: matplotlib; extra == 'docs'
+Requires-Dist: pickleshare; extra == 'docs'
+Requires-Dist: pydata-sphinx-theme; extra == 'docs'
+Requires-Dist: requests-cache; extra == 'docs'
+Requires-Dist: sphinx; extra == 'docs'
+Provides-Extra: polars
+Requires-Dist: polars; extra == 'polars'
+Requires-Dist: pyarrow; extra == 'polars'
+Provides-Extra: pyarrow
+Requires-Dist: pyarrow; extra == 'pyarrow'
+Description-Content-Type: text/markdown
+
+# kuznets
+
+Remote data access for economic and financial data — FRED, OECD, Eurostat, World Bank,
+Fama-French, Yahoo Finance, and more — returned as pandas, polars, pyarrow, or dask frames.
+
+kuznets is a fork of [pydata/pandas-datareader](https://github.com/pydata/pandas-datareader).
+
+[![PyPI](https://img.shields.io/pypi/v/kuznets.svg)](https://pypi.org/project/kuznets/)
+[![Coverage](https://codecov.io/gh/jessegrabowski/kuznets/branch/main/graph/badge.svg)](https://codecov.io/gh/jessegrabowski/kuznets)
+[![License](https://img.shields.io/pypi/l/kuznets)](https://pypi.org/project/kuznets/)
+
+## Installation
+
+Install using `pip`
+
+``` shell
+pip install kuznets
+```
+
+## Usage
+
+``` python
+import kuznets as kz
+kz.get_data_fred('GS10')
+```
+
+Every reader accepts an `output_type` argument to return polars, pyarrow, or dask frames instead of
+pandas, and multi-symbol daily reads fetch concurrently (tune with `max_workers`):
+
+``` python
+kz.DataReader(["AAPL", "MSFT"], "stooq", output_type="polars", max_workers=8)
+```
+
+## Documentation
+
+[Stable documentation](https://pydata.github.io/kuznets/) is available on
+[github.io](https://pydata.github.io/kuznets/). A second copy of the stable
+documentation is hosted on [read the docs](https://kuznets.readthedocs.io/)
+for more details.
+
+[Development documentation](https://pydata.github.io/kuznets/devel/) is available
+for the latest changes in master.
+
+### Requirements
+
+Using kuznets requires the following packages:
+
+-   pandas>=3.0
+-   narwhals>=2.0
+-   lxml
+-   requests
+
+Non-pandas output backends are optional extras:
+
+``` shell
+pip install kuznets[polars]    # or [pyarrow], [dask], [backends]
+```
+
+Building the documentation additionally requires:
+
+-   matplotlib
+-   ipython
+-   requests_cache
+-   sphinx
+-   pydata_sphinx_theme
+
+Development and testing dependencies are defined in `pyproject.toml`: the `dev` extra for pip
+workflows, and the pixi `test`/`lint` features for the pixi workspace.
+
+### Install latest development version
+
+``` shell
+python -m pip install git+https://github.com/jessegrabowski/kuznets.git
+```
+
+or
+
+``` shell
+git clone https://github.com/jessegrabowski/kuznets.git
+cd kuznets
+python setup.py install
+```
+
+### Development environment
+
+The repo is a [pixi](https://pixi.sh) workspace: `pixi install` creates the dev environment
+(editable install, test and lint tools), `pixi run test` runs the suite, and `pixi run -e py314
+test` runs it on another Python. `pip install -e ".[dev]"` in a virtualenv works too.
+
+### Running the tests
+
+The test suite runs fully offline by default: each reader is replayed against a **recorded real
+response** stored under `tests/data/`, so no third-party service is contacted.
+
+``` shell
+pytest
+```
+
+Tests marked `network` are deselected by default. Each one runs a reader against the live service
+and asserts the *shape* of the result (columns, dtypes, non-empty) — an API-drift detector that
+skips gracefully when a service is unreachable:
+
+``` shell
+pytest -m network
+```
+
+The offline fixtures are recordings, not hand-written mocks. To regenerate them from the live
+services, run the `network` tests in record mode:
+
+``` shell
+RECORD=1 pytest -m network
+```
+
+This rewrites `tests/data/` from the real responses (and a wrong parser fails here, at record time,
+rather than being hidden by a fixture built to match it). A weekly GitHub Actions workflow
+(`refresh-fixtures`) does this automatically and opens a PR when a fixture changes, failing if an
+upstream shape breaks. A few services can't be recorded and are documented in their tests: Stooq
+serves an anti-bot challenge to scripted clients, and the keyed readers (AlphaVantage, Quandl,
+Tiingo) need API keys.

kuznets-1.0/README.md

@@ -0,0 +1,119 @@
+# kuznets
+
+Remote data access for economic and financial data — FRED, OECD, Eurostat, World Bank,
+Fama-French, Yahoo Finance, and more — returned as pandas, polars, pyarrow, or dask frames.
+
+kuznets is a fork of [pydata/pandas-datareader](https://github.com/pydata/pandas-datareader).
+
+[![PyPI](https://img.shields.io/pypi/v/kuznets.svg)](https://pypi.org/project/kuznets/)
+[![Coverage](https://codecov.io/gh/jessegrabowski/kuznets/branch/main/graph/badge.svg)](https://codecov.io/gh/jessegrabowski/kuznets)
+[![License](https://img.shields.io/pypi/l/kuznets)](https://pypi.org/project/kuznets/)
+
+## Installation
+
+Install using `pip`
+
+``` shell
+pip install kuznets
+```
+
+## Usage
+
+``` python
+import kuznets as kz
+kz.get_data_fred('GS10')
+```
+
+Every reader accepts an `output_type` argument to return polars, pyarrow, or dask frames instead of
+pandas, and multi-symbol daily reads fetch concurrently (tune with `max_workers`):
+
+``` python
+kz.DataReader(["AAPL", "MSFT"], "stooq", output_type="polars", max_workers=8)
+```
+
+## Documentation
+
+[Stable documentation](https://pydata.github.io/kuznets/) is available on
+[github.io](https://pydata.github.io/kuznets/). A second copy of the stable
+documentation is hosted on [read the docs](https://kuznets.readthedocs.io/)
+for more details.
+
+[Development documentation](https://pydata.github.io/kuznets/devel/) is available
+for the latest changes in master.
+
+### Requirements
+
+Using kuznets requires the following packages:
+
+-   pandas>=3.0
+-   narwhals>=2.0
+-   lxml
+-   requests
+
+Non-pandas output backends are optional extras:
+
+``` shell
+pip install kuznets[polars]    # or [pyarrow], [dask], [backends]
+```
+
+Building the documentation additionally requires:
+
+-   matplotlib
+-   ipython
+-   requests_cache
+-   sphinx
+-   pydata_sphinx_theme
+
+Development and testing dependencies are defined in `pyproject.toml`: the `dev` extra for pip
+workflows, and the pixi `test`/`lint` features for the pixi workspace.
+
+### Install latest development version
+
+``` shell
+python -m pip install git+https://github.com/jessegrabowski/kuznets.git
+```
+
+or
+
+``` shell
+git clone https://github.com/jessegrabowski/kuznets.git
+cd kuznets
+python setup.py install
+```
+
+### Development environment
+
+The repo is a [pixi](https://pixi.sh) workspace: `pixi install` creates the dev environment
+(editable install, test and lint tools), `pixi run test` runs the suite, and `pixi run -e py314
+test` runs it on another Python. `pip install -e ".[dev]"` in a virtualenv works too.
+
+### Running the tests
+
+The test suite runs fully offline by default: each reader is replayed against a **recorded real
+response** stored under `tests/data/`, so no third-party service is contacted.
+
+``` shell
+pytest
+```
+
+Tests marked `network` are deselected by default. Each one runs a reader against the live service
+and asserts the *shape* of the result (columns, dtypes, non-empty) — an API-drift detector that
+skips gracefully when a service is unreachable:
+
+``` shell
+pytest -m network
+```
+
+The offline fixtures are recordings, not hand-written mocks. To regenerate them from the live
+services, run the `network` tests in record mode:
+
+``` shell
+RECORD=1 pytest -m network
+```
+
+This rewrites `tests/data/` from the real responses (and a wrong parser fails here, at record time,
+rather than being hidden by a fixture built to match it). A weekly GitHub Actions workflow
+(`refresh-fixtures`) does this automatically and opens a PR when a fixture changes, failing if an
+upstream shape breaks. A few services can't be recorded and are documented in their tests: Stooq
+serves an anti-bot challenge to scripted clients, and the keyed readers (AlphaVantage, Quandl,
+Tiingo) need API keys.

kuznets-1.0/codecov.yml

@@ -0,0 +1,12 @@
+coverage:
+  status:
+    project:
+      default:
+        informational: true
+    patch:
+      default:
+        informational: true
+
+comment:
+  layout: "condensed_header, diff, flags"
+  require_changes: true

kuznets-1.0/docs/Makefile

@@ -0,0 +1,20 @@
+# Minimal makefile for Sphinx documentation
+#
+
+# You can set these variables from the command line.
+SPHINXOPTS    =
+SPHINXBUILD   = sphinx-build
+SPHINXPROJ    = kuznets
+SOURCEDIR     = source
+BUILDDIR      = build
+
+# Put it first so that "make" without argument is like "make help".
+help:
+	@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+
+.PHONY: help Makefile
+
+# Catch-all target: route all unknown targets to Sphinx using the new
+# "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).
+%: Makefile
+	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)

kuznets-1.0/docs/contributors.py

@@ -0,0 +1,29 @@
+"""
+Get a list of contributors between now and a start date
+"""
+
+import datetime as dt
+import os
+
+from github import Github
+
+# or using an access token
+g = Github(os.environ.get("GITHUB_API_KEY"))
+
+repo = g.get_repo("jessegrabowski/kuznets")
+
+start = dt.datetime(2019, 9, 26, 0, 0, 0)
+pulls = repo.get_pulls(state="closed", sort="updated", base="master", direction="desc")
+
+users = set()
+for i, p in enumerate(pulls):
+    print(f"{i}: {p.number}")
+    if p.merged and p.merged_at >= start:
+        users.update([p.user.name])
+    if p.updated_at < start:
+        break
+
+contrib = sorted((c for c in users if c), key=lambda s: s.split(" ")[-1])
+
+for c in contrib:
+    print(f"- {c}")