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
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 --helpAlternatively, 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
uvorpipxto avoid dependency conflicts.
$ pip install --user zeal-feedsor
$ pip install zeal-feedsTo 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 attrsIf a docset is already installed then it will be skipped.
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.
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.
zeal-feeds is distributed under the terms of the MIT license.