Metadata-Version: 2.4
Name: dblpcli
Version: 0.2.0
Summary: CLI for DBLP, for humans and agents alike
Project-URL: Homepage, https://github.com/mrshu/dblpcli
Project-URL: Repository, https://github.com/mrshu/dblpcli
Author: mrshu
License-Expression: MIT
License-File: LICENSE
Keywords: academic,bibliography,bibtex,cli,dblp
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering
Requires-Python: >=3.10
Requires-Dist: httpx>=0.25.0
Requires-Dist: rich>=13.0.0
Requires-Dist: typer>=0.9.0
Provides-Extra: dev
Requires-Dist: pytest-httpx>=0.21.0; extra == 'dev'
Requires-Dist: pytest>=7.0.0; extra == 'dev'
Requires-Dist: ruff>=0.1.0; extra == 'dev'
Description-Content-Type: text/markdown

# dblpcli

CLI for DBLP, for humans and agents alike.

## Installation

```bash
pip install dblpcli
```

Or with [uv](https://github.com/astral-sh/uv):

```bash
uv pip install dblpcli
```

## Quick Start

Run directly without installing using [uvx](https://docs.astral.sh/uv/guides/tools/):

```bash
uvx dblpcli search "transformer attention"
```

Or after installing:

## Usage

### Search publications

```bash
dblpcli search "transformer attention"
dblpcli search "deep learning" --year 2020-2024 --limit 10
dblpcli search "author:Vaswani" --format json
```

### Get publication details

```bash
dblpcli pub conf/nips/VaswaniSPUJGKP17
dblpcli pub conf/nips/VaswaniSPUJGKP17 --format json
```

### Export BibTeX

```bash
dblpcli bibtex conf/nips/VaswaniSPUJGKP17
dblpcli bibtex conf/nips/VaswaniSPUJGKP17 --key vaswani2017attention
dblpcli bibtex conf/nips/VaswaniSPUJGKP17 journals/jmlr/KingmaB14 --output refs.bib
```

### Author commands

```bash
dblpcli author search "Geoffrey Hinton"
dblpcli author get h/GeoffreyEHinton
dblpcli author pubs h/GeoffreyEHinton --year 2020-2024
dblpcli author bibtex h/GeoffreyEHinton
```

### Venue commands

```bash
dblpcli venue search "NeurIPS"
dblpcli venue get conf/nips
dblpcli venue pubs conf/nips --year 2023
```

## Output Formats

All commands support the `--format` / `-f` flag:

- `table` (default) - Human-readable Rich table
- `json` - Structured JSON for agents/scripts
- `bibtex` - BibTeX entries

```bash
dblpcli search "transformers" --format json
dblpcli search "transformers" -f json
```

## License

MIT
