PyRepec

PyRepec is a small Python client for the RePEc API. It provides typed result models, basic in-session caching, and helpers for querying authors, publications, bibliographic references, and JEL codes.

Current Version: 0.2.5

Requirements

• Python 3.12 or newer
• A RePEc API token

Installation

Install the package from PyPI:

pip install pyrepec

Quick start

Keep the API token outside your source code, for example in the REPEC_TOKEN environment variable:

export REPEC_TOKEN="your-token"

Create a client and perform a request:

import os

from pyrepec import Repec

repec = Repec(os.environ["REPEC_TOKEN"])
result = repec.get_org_authors("RePEc:edi:bdigvit")

if result.error is not None:
    print(f"RePEc error {result.error.code}: {result.error.message}")
else:
    for author in result.data:
        print(author)

Successful responses expose their payload through result.data. Errors reported by RePEc are available through result.error; in that case, result.data is empty. HTTP errors are raised by requests in the usual way.

Available methods

The exact dictionaries returned in data follow the upstream RePEc API response format.

Development

Clone the repository and install the locked development environment:

git clone https://github.com/andrea-cap/pyrepec.git
cd pyrepec
uv sync --locked

Run the test suite and code-quality checks:

uv run pytest ./tests/
uv run ruff check .
uv run ruff format --check .

Integration tests require REPEC_TOKEN; without it, they are skipped. Unit tests do not make external API calls.

Generate the changelog from the available Git history:

uv run gitchangelog

Reporting issues

Report bugs and request features through the GitHub issue tracker.