# personal-man (`pman`)
> **Note**
>
> I am archiving this project in favor of [cheat](https://github.com/cheat/cheat), which provides the same features and more!
Personal Manpages
## Installation
1. [Install `ripgrep`](https://github.com/BurntSushi/ripgrep/tree/000015791742bb1280f1853adb714fdee1ba9f8e#installation)
1. Install the `pman` CLI with pipx
```sh
pipx install personal-man
```
1. Run `pman` to check that installation succeeded and to see the available commands
1. The help output will display the directory for your personal manpages, but you can change the default by exporting an environment variable: `PMAN_DOC_PATH`. I personally have a directory within my main Obsidian vault so that I can edit the files in [Obsidian](https://obsidian.md/) and search with `pman`
## Usage
For more example code, see the [scripts] directory or the [tests].
## Project Status
See the `Open Issues` and/or the [CODE_TAG_SUMMARY]. For release history, see the [CHANGELOG].
## Contributing
We welcome pull requests! For your pull request to be accepted smoothly, we suggest that you first open a GitHub issue to discuss your idea. For resources on getting started with the code base, see the below documentation:
- [DEVELOPER_GUIDE]
- [STYLE_GUIDE]
## Code of Conduct
We follow the [Contributor Covenant Code of Conduct][contributor-covenant].
### Open Source Status
We try to reasonably meet most aspects of the "OpenSSF scorecard" from [Open Source Insights](https://deps.dev/pypi/personal_man)
## Responsible Disclosure
If you have any security issue to report, please contact the project maintainers privately. You can reach us at [dev.act.kyle@gmail.com](mailto:dev.act.kyle@gmail.com).
## License
[LICENSE]
[changelog]: ./docs/CHANGELOG.md
[code_tag_summary]: ./docs/CODE_TAG_SUMMARY.md
[contributor-covenant]: https://www.contributor-covenant.org
[developer_guide]: ./docs/DEVELOPER_GUIDE.md
[license]: https://github.com/kyleking/personal-man/LICENSE
[scripts]: https://github.com/kyleking/personal-man/scripts
[style_guide]: ./docs/STYLE_GUIDE.md
[tests]: https://github.com/kyleking/personal-man/tests
Raw data
{
"_id": null,
"home_page": "https://github.com/kyleking/personal_man",
"name": "personal-man",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.10.5,<4.0.0",
"maintainer_email": "",
"keywords": "",
"author": "Kyle King",
"author_email": "dev.act.kyle@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/ad/12/5583a2860454430a8927a3dbe02fa59d04ddbf9a93c15d764eca875a4a24/personal_man-1.1.1.tar.gz",
"platform": null,
"description": "# personal-man (`pman`)\n\n> **Note**\n>\n> I am archiving this project in favor of [cheat](https://github.com/cheat/cheat), which provides the same features and more!\n\nPersonal Manpages\n\n## Installation\n\n1. [Install `ripgrep`](https://github.com/BurntSushi/ripgrep/tree/000015791742bb1280f1853adb714fdee1ba9f8e#installation)\n\n1. Install the `pman` CLI with pipx\n\n ```sh\n pipx install personal-man\n ```\n\n1. Run `pman` to check that installation succeeded and to see the available commands\n\n1. The help output will display the directory for your personal manpages, but you can change the default by exporting an environment variable: `PMAN_DOC_PATH`. I personally have a directory within my main Obsidian vault so that I can edit the files in [Obsidian](https://obsidian.md/) and search with `pman`\n\n## Usage\n\n\n\nFor more example code, see the [scripts] directory or the [tests].\n\n## Project Status\n\nSee the `Open Issues` and/or the [CODE_TAG_SUMMARY]. For release history, see the [CHANGELOG].\n\n## Contributing\n\nWe welcome pull requests! For your pull request to be accepted smoothly, we suggest that you first open a GitHub issue to discuss your idea. For resources on getting started with the code base, see the below documentation:\n\n- [DEVELOPER_GUIDE]\n- [STYLE_GUIDE]\n\n## Code of Conduct\n\nWe follow the [Contributor Covenant Code of Conduct][contributor-covenant].\n\n### Open Source Status\n\nWe try to reasonably meet most aspects of the \"OpenSSF scorecard\" from [Open Source Insights](https://deps.dev/pypi/personal_man)\n\n## Responsible Disclosure\n\nIf you have any security issue to report, please contact the project maintainers privately. You can reach us at [dev.act.kyle@gmail.com](mailto:dev.act.kyle@gmail.com).\n\n## License\n\n[LICENSE]\n\n[changelog]: ./docs/CHANGELOG.md\n[code_tag_summary]: ./docs/CODE_TAG_SUMMARY.md\n[contributor-covenant]: https://www.contributor-covenant.org\n[developer_guide]: ./docs/DEVELOPER_GUIDE.md\n[license]: https://github.com/kyleking/personal-man/LICENSE\n[scripts]: https://github.com/kyleking/personal-man/scripts\n[style_guide]: ./docs/STYLE_GUIDE.md\n[tests]: https://github.com/kyleking/personal-man/tests\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Personal Manpages (pman)",
"version": "1.1.1",
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "20f857f1b67558107ba0390a5741976b9f301561a3e7a4fac67a2902b6010851",
"md5": "e97a25fae724ddb92092dfe6984bf024",
"sha256": "c02066adeade039565f931c2a42a075072d12d65b3382db362babebff9a460fe"
},
"downloads": -1,
"filename": "personal_man-1.1.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "e97a25fae724ddb92092dfe6984bf024",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10.5,<4.0.0",
"size": 11182,
"upload_time": "2023-01-04T01:01:25",
"upload_time_iso_8601": "2023-01-04T01:01:25.207627Z",
"url": "https://files.pythonhosted.org/packages/20/f8/57f1b67558107ba0390a5741976b9f301561a3e7a4fac67a2902b6010851/personal_man-1.1.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "ad125583a2860454430a8927a3dbe02fa59d04ddbf9a93c15d764eca875a4a24",
"md5": "d76258a728725f6b0c7bc3c314f0b8ec",
"sha256": "7bece605c5a050b042f9ac961b4d15a6060f5e0210777ebfade8c1fea79f62b7"
},
"downloads": -1,
"filename": "personal_man-1.1.1.tar.gz",
"has_sig": false,
"md5_digest": "d76258a728725f6b0c7bc3c314f0b8ec",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10.5,<4.0.0",
"size": 9681,
"upload_time": "2023-01-04T01:01:26",
"upload_time_iso_8601": "2023-01-04T01:01:26.903451Z",
"url": "https://files.pythonhosted.org/packages/ad/12/5583a2860454430a8927a3dbe02fa59d04ddbf9a93c15d764eca875a4a24/personal_man-1.1.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-01-04 01:01:26",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "kyleking",
"github_project": "personal_man",
"lcname": "personal-man"
}
JSON
