<!--
MIT License
Copyright (c) 2023 Dishant B. (@dishb) <code.dishb@gmail.com>
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
-->
<div align = 'center'>
<img alt = 'banner image' src = './assets/banner.png' width = 300/>
</div>
# monstera
A cross-platform CLI to quickly retrieve system information to make issue management easier.
## Features:
A list of all the information collected:
- Version of Python
- Python's location (where it was installed)
- Python's release type (alpha, beta, candidate, final)
- Version of `pip`
- `pip`'s location (where it was installed)
- Operating system (support for Linux distros)
- OS version
- Version and installation location of packages
A lot of this information depends on the environment that Python is being run in.
## Documentation:
To get more information on how to use `monstera`, you can read the documentation in the [`./docs`](https://github.com/dishb/monstera/tree/main/docs) directory.
## Installation:
`monstera` requires Python 3.9 or higher.
You can install the package with `pip`.
| macOS/Linux | Windows |
| --- | --- |
| `pip3 install monstera` | `pip install monstera` |
## Usage:
There are 2 options for how you can use `monstera`.
1. Use the CLI:
| macOS/Linux | Windows |
| --- | --- |
| `python3 -m monstera` | `python -m monstera` |
You can also just call `monstera` directly.
2. Use `monstera` in your code:
```python
import monstera
monstera.run()
```
## Contributing:
To get started with contributing to `monstera`, follow this guide.
It is recommended to read the [`./CONTRIBUTING.md`](https://github.com/dishb/monstera/blob/main/CONTRIBUTING.md) file.
1. Clone the repository:
| OS Independent |
| --- |
| `git clone https://github.com/dishb/monstera.git` |
Change to the directory:
| macOS/Linux | Windows |
| --- | --- |
| `cd ./monstera/` | `cd .\monstera\` |
2. Create a virtual environment (optional, but recommended):
| macOS/Linux | Windows |
| --- | --- |
| `python3 -m venv ./.venv/` | `python -m venv .\.venv\` |
| `source ./.venv/bin/activate` | `.\.venv\Scripts\activate.bat` |
3. Install the dependencies:
| macOS/Linux | Windows |
| --- | --- |
| `pip3 install -r requirements.txt` | `pip install -r requirements.txt` |
| `pip3 install -r dev-requirements.txt` | `pip install -r dev-requirements.txt` |
4. Install `monstera` in edit mode:
| macOS/Linux | Windows |
| --- | --- |
| `pip3 install -e .` | `pip install -e .` |
## Code of Conduct
This project is goverened by the Contributor Covenant Code of Conduct.
We ask that you read the full Code of Conduct in the [`./CODE_OF_CONDUCT.md`](https://github.com/dishb/monstera/blob/main/CODE_OF_CONDUCT.md) file.
## License:
This project is licensed under the `MIT License`. The full copyright can be found in the [`./LICENSE.md`](https://github.com/dishb/monstera/blob/main/LICENSE.md) file.
## Attribution
The background photo in [`./assets/banner.png`](https://github.com/dishb/monstera/blob/main/assets/banner.png) is by [Gilles Lambert](https://unsplash.com/@gilleslambert?utm_source=unsplash&utm_medium=referral&utm_content=creditCopyText) on [Unsplash](https://unsplash.com/photos/mSK5nNsAsLY?utm_source=unsplash&utm_medium=referral&utm_content=creditCopyText)
The font used is [Victor Mono](https://github.com/rubjo/victor-mono) (bold).
Raw data
{
"_id": null,
"home_page": "https://github.com/dishb/monstera",
"name": "monstera",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": "",
"keywords": "monstera,bug tracker,bug tracking,issue tracker,issue tracking,tool,developers,developing,monstera tool,dependencies,versions,file locations,python,cross-platform,python3",
"author": "Dishant B. (@dishb)",
"author_email": "code.dishb@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/b1/de/501bd4445e79bb4ff018696353e1afaf1187cb847223f241b7208be09422/monstera-0.0.5.tar.gz",
"platform": null,
"description": "<!--\nMIT License\n\nCopyright (c) 2023 Dishant B. (@dishb) <code.dishb@gmail.com>\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n-->\n\n<div align = 'center'>\n <img alt = 'banner image' src = './assets/banner.png' width = 300/>\n</div>\n\n# monstera\n\nA cross-platform CLI to quickly retrieve system information to make issue management easier.\n\n## Features:\nA list of all the information collected:\n\n- Version of Python\n- Python's location (where it was installed)\n- Python's release type (alpha, beta, candidate, final)\n- Version of `pip`\n- `pip`'s location (where it was installed)\n- Operating system (support for Linux distros)\n- OS version\n- Version and installation location of packages\n\nA lot of this information depends on the environment that Python is being run in.\n\n## Documentation:\nTo get more information on how to use `monstera`, you can read the documentation in the [`./docs`](https://github.com/dishb/monstera/tree/main/docs) directory.\n\n## Installation:\n`monstera` requires Python 3.9 or higher.\n\nYou can install the package with `pip`.\n\n| macOS/Linux | Windows |\n| --- | --- |\n| `pip3 install monstera` | `pip install monstera` |\n\n## Usage:\nThere are 2 options for how you can use `monstera`.\n\n1. Use the CLI:\n\n | macOS/Linux | Windows |\n | --- | --- |\n | `python3 -m monstera` | `python -m monstera` |\n\n You can also just call `monstera` directly.\n\n2. Use `monstera` in your code:\n\n ```python\n import monstera\n\n monstera.run()\n ```\n\n## Contributing:\nTo get started with contributing to `monstera`, follow this guide.\nIt is recommended to read the [`./CONTRIBUTING.md`](https://github.com/dishb/monstera/blob/main/CONTRIBUTING.md) file.\n\n1. Clone the repository:\n\n | OS Independent |\n | --- |\n | `git clone https://github.com/dishb/monstera.git` |\n\n Change to the directory:\n\n | macOS/Linux | Windows |\n | --- | --- |\n | `cd ./monstera/` | `cd .\\monstera\\` |\n\n2. Create a virtual environment (optional, but recommended):\n\n | macOS/Linux | Windows |\n | --- | --- |\n | `python3 -m venv ./.venv/` | `python -m venv .\\.venv\\` |\n | `source ./.venv/bin/activate` | `.\\.venv\\Scripts\\activate.bat` |\n\n3. Install the dependencies:\n\n | macOS/Linux | Windows |\n | --- | --- |\n | `pip3 install -r requirements.txt` | `pip install -r requirements.txt` |\n | `pip3 install -r dev-requirements.txt` | `pip install -r dev-requirements.txt` |\n\n4. Install `monstera` in edit mode:\n\n | macOS/Linux | Windows |\n | --- | --- |\n | `pip3 install -e .` | `pip install -e .` |\n\n## Code of Conduct\nThis project is goverened by the Contributor Covenant Code of Conduct.\nWe ask that you read the full Code of Conduct in the [`./CODE_OF_CONDUCT.md`](https://github.com/dishb/monstera/blob/main/CODE_OF_CONDUCT.md) file.\n\n## License:\nThis project is licensed under the `MIT License`. The full copyright can be found in the [`./LICENSE.md`](https://github.com/dishb/monstera/blob/main/LICENSE.md) file.\n\n## Attribution\n\nThe background photo in [`./assets/banner.png`](https://github.com/dishb/monstera/blob/main/assets/banner.png) is by [Gilles Lambert](https://unsplash.com/@gilleslambert?utm_source=unsplash&utm_medium=referral&utm_content=creditCopyText) on [Unsplash](https://unsplash.com/photos/mSK5nNsAsLY?utm_source=unsplash&utm_medium=referral&utm_content=creditCopyText)\n\nThe font used is [Victor Mono](https://github.com/rubjo/victor-mono) (bold).\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A cross-platform CLI to quickly retrieve system information to make issue management easier.",
"version": "0.0.5",
"project_urls": {
"Documentation": "https://github.com/dishb/monstera/tree/main/docs",
"Homepage": "https://github.com/dishb/monstera",
"Issue Tracker": "https://github.com/dishb/monstera/issues",
"Source": "https://github.com/dishb/monstera/"
},
"split_keywords": [
"monstera",
"bug tracker",
"bug tracking",
"issue tracker",
"issue tracking",
"tool",
"developers",
"developing",
"monstera tool",
"dependencies",
"versions",
"file locations",
"python",
"cross-platform",
"python3"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "b41b7204b55855c135a572ae22f6f15046e050fde08b38c20ba95d4f92bc5784",
"md5": "2eea0ab74194edb5e82ef26e23329215",
"sha256": "e49c2e625711dce10b25375553662b5d8da9349303dc6d6cbd9b3e8d05f9731d"
},
"downloads": -1,
"filename": "monstera-0.0.5-py3-none-any.whl",
"has_sig": false,
"md5_digest": "2eea0ab74194edb5e82ef26e23329215",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 12153,
"upload_time": "2023-08-07T01:41:02",
"upload_time_iso_8601": "2023-08-07T01:41:02.562464Z",
"url": "https://files.pythonhosted.org/packages/b4/1b/7204b55855c135a572ae22f6f15046e050fde08b38c20ba95d4f92bc5784/monstera-0.0.5-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "b1de501bd4445e79bb4ff018696353e1afaf1187cb847223f241b7208be09422",
"md5": "268a748b7a359805ff8452a1bf405584",
"sha256": "5b31e6e6e131f75347dc5d574f25e11e25dcafbb185388f186331670ffecee03"
},
"downloads": -1,
"filename": "monstera-0.0.5.tar.gz",
"has_sig": false,
"md5_digest": "268a748b7a359805ff8452a1bf405584",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 8478,
"upload_time": "2023-08-07T01:41:04",
"upload_time_iso_8601": "2023-08-07T01:41:04.155237Z",
"url": "https://files.pythonhosted.org/packages/b1/de/501bd4445e79bb4ff018696353e1afaf1187cb847223f241b7208be09422/monstera-0.0.5.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-08-07 01:41:04",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "dishb",
"github_project": "monstera",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "monstera"
}
JSON
