Metadata-Version: 2.4
Name: pyrefdev
Version: 2025.7
Summary: The entry point to Python reference docs
Project-URL: Homepage, https://pyref.dev
Project-URL: Source, https://github.com/mangoumbrella/pyref.dev
Project-URL: Changelog, https://github.com/mangoumbrella/pyref.dev/blob/main/CHANGELOG.md
Author-email: Mango Umbrella LLC <hi@mangoumbrella.com>
License-Expression: Apache-2.0
License-File: LICENSE
Keywords: documentation
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Programming Language :: Python :: Free Threading
Classifier: Topic :: Documentation
Requires-Python: >=3.10
Requires-Dist: cyclopts>=3.19.0
Requires-Dist: jinja2>=3.1.6
Requires-Dist: packaging>=25.0
Requires-Dist: yib>=0.3.0
Provides-Extra: indexer
Requires-Dist: beautifulsoup4>=4.13.4; extra == 'indexer'
Requires-Dist: rich>=14.0.0; extra == 'indexer'
Provides-Extra: server
Requires-Dist: fastapi<1,>=0.115.12; extra == 'server'
Requires-Dist: uvicorn[standard]<1,>=0.34.2; extra == 'server'
Description-Content-Type: text/markdown

# pyref.dev

[pyref.dev](https://pyref.dev) is a fast, convenient way to access Python reference docs.

<p>
<a href="https://pypi.org/project/pyrefdev"><img alt="PyPI" src="https://img.shields.io/pypi/v/pyrefdev"></a>
<a href="https://pypi.org/project/pyrefdev"><img alt="Python veresions supported" src="https://img.shields.io/pypi/pyversions/pyrefdev"></a>
<a href="https://github.com/mangoumbrella/pyref.dev/blob/main/LICENSE"><img alt="License" src="https://img.shields.io/pypi/l/pyrefdev.svg"></a>
</p>

It allows you to quickly jump to the official documentation for Python standard library modules and popular packages by using a simple URL pattern:

```
https://pyref.dev/<fully.qualified.symbol.name>
```

You can also search for symbols using:

```
https://pyref.dev/is?symbol=<SYMBOL>
```

And if you are feeling lucky, ask it to redirect to the first result:

```
https://pyref.dev/is?lucky=true&symbol=<SYMBOL>
```

Lastly, you can `pip install pyrefdev` and run the `pyrefdev` CLI tool.

## Examples

* [pyref.dev/json](https://pyref.dev/json)
* [pyref.dev/pathlib.Path](https://pyref.dev/pathlib.Path)
* [pyref.dev/datetime.datetime.strftime](https://pyref.dev/datetime.datetime.strftime)
* [pyref.dev/numpy.array](https://pyref.dev/numpy.array)

## Supported packages

See [pyref.dev](https://pyref.dev/#supported-packages) for the list of supported packages.

# Case sensitivity

For most of the cases, they are case-insensitive. However, for symbols like `typing.final` and `typing.Final`, you need to access them with the correct case.

## Server setup

To set up a new server:

```bash
> git clone https://github.com/mangoumbrella/pyref.dev
> cd pyref.dev
> sudo cp pyrefdev.service /etc/systemd/system/pyrefdev.service
> systemctl start pyrefdev.service
```

To update to a new version:

```bash
> cd pyref.dev
> git pull
> uv sync --all-extras --locked
> systemctl restart pyrefdev.service
```

## Changelog

See [CHANGELOG.md](https://github.com/mangoumbrella/pyref.dev/blob/main/CHANGELOG.md).

## License

[pyref.dev](https://pyref.dev) is licensed under the terms of the Apache license. See [LICENSE](https://github.com/mangoumbrella/pyref.dev/blob/main/LICENSE) for more information.
