Name | zeal-feeds JSON |
Version |
0.2.1
JSON |
| download |
home_page | |
Summary | A command line application for adding user contributed docset feeds to Zeal. |
upload_time | 2023-02-10 21:01:44 |
maintainer | |
docs_url | None |
author | |
requires_python | >=3.9 |
license | |
keywords |
docsets
zeal
|
VCS |
|
bugtrack_url |
|
requirements |
No requirements were recorded.
|
Travis-CI |
No Travis.
|
coveralls test coverage |
No coveralls.
|
# zeal-feeds
[![PyPI - Version](https://img.shields.io/pypi/v/zeal-feeds.svg)](https://pypi.org/project/zeal-feeds)
[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/zeal-feeds.svg)](https://pypi.org/project/zeal-feeds)
[![GitHub CI](https://github.com/smsearcy/zeal-feeds/actions/workflows/ci.yml/badge.svg)](https://github.com/smsearcy/zeal-feeds/actions)
[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/charliermarsh/ruff/main/assets/badge/v1.json)](https://github.com/charliermarsh/ruff)
-----
*zeal-feeds* is a command line application for adding user contributed docsets to [Zeal](https://zealdocs.org/),
as an alternative to looking up the URL of the XML feed and pasting in the *Add Feed* option.
**Table of Contents**
- [Installation](#installation)
- [Usage](#usage)
- [Acknowledgements](#acknowledgements)
- [License](#license)
## Installation
The recommended way to install *zeal-feeds* is via [pipx](https://pypi.org/project/pipx/),
to provide an isolated installation.
```console
$ pipx install zeal-feeds
```
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 `pipx` to avoid dependency conflicts.
```console
$ pip install --user zeal-feeds
```
or
```console
$ pip install zeal-feeds
```
## Usage
To search available feeds, use `zeal-feeds search`:
```console
$ 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:
```console
$ 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](https://github.com/jmerle/zeal-user-contrib),
but the apparent lack of an `npm` equivalent of `pipx` for isolated installations prompted writing a Python version.
This [article](https://hynek.me/articles/productive-fruit-fly-programmer/) 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](https://hatch.pypa.io/).
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](https://spdx.org/licenses/MIT.html) license.
Raw data
{
"_id": null,
"home_page": "",
"name": "zeal-feeds",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": "",
"keywords": "docsets,zeal",
"author": "",
"author_email": "Scott Searcy <smsearcy14@outlook.com>",
"download_url": "https://files.pythonhosted.org/packages/75/bd/0283faf1d8f6ea5658963004d35d854929eba14fb1b61188e9ff72182613/zeal_feeds-0.2.1.tar.gz",
"platform": null,
"description": "# zeal-feeds\n\n[![PyPI - Version](https://img.shields.io/pypi/v/zeal-feeds.svg)](https://pypi.org/project/zeal-feeds)\n[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/zeal-feeds.svg)](https://pypi.org/project/zeal-feeds)\n[![GitHub CI](https://github.com/smsearcy/zeal-feeds/actions/workflows/ci.yml/badge.svg)](https://github.com/smsearcy/zeal-feeds/actions)\n[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)\n[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/charliermarsh/ruff/main/assets/badge/v1.json)](https://github.com/charliermarsh/ruff)\n\n-----\n\n*zeal-feeds* is a command line application for adding user contributed docsets to [Zeal](https://zealdocs.org/),\nas an alternative to looking up the URL of the XML feed and pasting in the *Add Feed* option.\n\n**Table of Contents**\n\n- [Installation](#installation)\n- [Usage](#usage)\n- [Acknowledgements](#acknowledgements)\n- [License](#license)\n\n## Installation\n\nThe recommended way to install *zeal-feeds* is via [pipx](https://pypi.org/project/pipx/),\nto provide an isolated installation.\n\n```console\n$ pipx install zeal-feeds\n```\n\nAlternatively, *zeal-feeds* can be installed via `pip`,\neither for the current user or into the current Python virtual environment.\n\n> **Warning**\n>\n> This package will install several dependencies into the current environment.\n> Consider using `pipx` to avoid dependency conflicts.\n\n```console\n$ pip install --user zeal-feeds\n```\n\nor\n\n```console\n$ pip install zeal-feeds\n```\n\n## Usage\n\nTo search available feeds, use `zeal-feeds search`:\n\n```console\n$ zeal-feeds search alpine\n\u2834 Loading index of user contributed docsets\nMatching docsets:\nAlpinejs (3.7.x/5_2021-12-14)\n```\n\nTo install feeds, use `zeal-feeds install`.\nThe docset name needs to match the name from the `search` results:\n\n```console\n$ zeal-feeds install alpinejs attrs\nUsing cached index of user contributed docsets\nDownloading Alpinejs \u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501 100% 0:00:00\n. Installing Alpinejs\nDownloading attrs \u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501 100% 0:00:00\n. Installing attrs\n```\n\nIf a docset is already installed then it will be skipped.\n\n## Acknowledgements\n\nThis project was inspired by [zeal-user-contrib](https://github.com/jmerle/zeal-user-contrib),\nbut the apparent lack of an `npm` equivalent of `pipx` for isolated installations prompted writing a Python version.\n\nThis [article](https://hynek.me/articles/productive-fruit-fly-programmer/) by Hynek Schlawack for introducing Dash/Zeal.\n\nhttps://zealusercontributions.vercel.app/ for providing the docset API with XML feeds for Zeal.\n\n## Contributing\n\nPlease open an issue or pull request on GitHub if you have questions, ideas, or issues.\n\n*zeal-feeds* uses [hatch](https://hatch.pypa.io/).\nRun `hatch run lint` to run checks (Black, Ruff, and mypy) and `hatch run test:pytest` to run unit tests.\n\n## License\n\n`zeal-feeds` is distributed under the terms of the [MIT](https://spdx.org/licenses/MIT.html) license.\n",
"bugtrack_url": null,
"license": "",
"summary": "A command line application for adding user contributed docset feeds to Zeal.",
"version": "0.2.1",
"split_keywords": [
"docsets",
"zeal"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "bf5810ce70497d9c47967e153abe0a692eb5c14cc40f442213937fee23771c25",
"md5": "78dd14a504f9a39e127de6fc18a9616c",
"sha256": "d00dd27c14ff29891ff677f2149891d6595aa93efc8a8f679a113923a9989740"
},
"downloads": -1,
"filename": "zeal_feeds-0.2.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "78dd14a504f9a39e127de6fc18a9616c",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 9970,
"upload_time": "2023-02-10T21:01:42",
"upload_time_iso_8601": "2023-02-10T21:01:42.927353Z",
"url": "https://files.pythonhosted.org/packages/bf/58/10ce70497d9c47967e153abe0a692eb5c14cc40f442213937fee23771c25/zeal_feeds-0.2.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "75bd0283faf1d8f6ea5658963004d35d854929eba14fb1b61188e9ff72182613",
"md5": "cc6a15b8b434b5c83366914713de58c1",
"sha256": "d5a3db8b491ef68efbf97d84d7a03f011b4cf10f46c9be423b82e67e8752a81c"
},
"downloads": -1,
"filename": "zeal_feeds-0.2.1.tar.gz",
"has_sig": false,
"md5_digest": "cc6a15b8b434b5c83366914713de58c1",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 1229951,
"upload_time": "2023-02-10T21:01:44",
"upload_time_iso_8601": "2023-02-10T21:01:44.880073Z",
"url": "https://files.pythonhosted.org/packages/75/bd/0283faf1d8f6ea5658963004d35d854929eba14fb1b61188e9ff72182613/zeal_feeds-0.2.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-02-10 21:01:44",
"github": false,
"gitlab": false,
"bitbucket": false,
"lcname": "zeal-feeds"
}