zeal-feeds

zeal-feeds is a command line application for adding user contributed docsets to Zeal, as an alternative to looking up the URL of the XML feed and pasting in the Add Feed option.

Table of Contents

• Installation
• Usage
• Acknowledgements
• License

Installation

The recommended way to install zeal-feeds is via uv or pipx, to provide an isolated installation.

# install with uv
$ uv tool install zeal-feeds
$ zeal-feeds --help

# run without "installing"
$ uvx zeal-feeds

# install with pipx
$ pipx install zeal-feeds
$ zeal-feeds --help

Alternatively, zeal-feeds can be installed via pip, either for the current user or into the current Python virtual environment.

Warning

This package will install several dependencies into the current environment. Consider using uv or pipx to avoid dependency conflicts.

$ pip install --user zeal-feeds

or

$ pip install zeal-feeds

Usage

To search available feeds, use zeal-feeds search:

$ zeal-feeds search alpine
⠴ Loading index of user contributed docsets
Matching docsets:
Alpinejs (3.7.x/5_2021-12-14)

To install feeds, use zeal-feeds install. The docset name needs to match the name from the search results:

$ zeal-feeds install alpinejs attrs
Using cached index of user contributed docsets
Downloading Alpinejs ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 100% 0:00:00
.   Installing Alpinejs
Downloading attrs ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 100% 0:00:00
.   Installing attrs

If a docset is already installed then it will be skipped.

Acknowledgements

This project was inspired by zeal-user-contrib, but the apparent lack of an npm equivalent of pipx for isolated installations prompted writing a Python version (I didn't know about npx at the time).

This article by Hynek Schlawack for introducing Dash/Zeal.

https://zealusercontributions.vercel.app/ for providing the docset API with XML feeds for Zeal.

Contributing

Please open an issue or pull request on GitHub if you have questions, ideas, or issues.

zeal-feeds uses hatch. Run hatch run lint to run checks (Black, Ruff, and mypy) and hatch run test:pytest to run unit tests.

License

zeal-feeds is distributed under the terms of the MIT license.