## OVERVIEW
`go-util` is a cross-platform CLI bookmark manager. It allows users to create aliases for URLs, which can be accessed quickly from the terminal using the `go` command. The utility also supports adding new links, removing links, and managing stored bookmarks through various commands.
## INSTALLATION
### Prerequisites
1. **Python:** This software is built in Python and thus requires Python 3.9 or greater to run. To install Python on your system, please refer to the official downloads page: https://www.python.org/downloads/
2. **pipx:** As `go-util` is a standalone CLI app, it is best to install via pipx to isolate it from the rest of your system. To install pipx, first ensure Python is installed then refer to the official documentation: https://github.com/pypa/pipx
### Installing on your system
To install `go-util`, follow these steps:
1. **Install via pipx (RECOMMENDED)**:
Installing via pipx ensures that the application is both available globally and contained within its own isolated environment.
To install, open your terminal and run the following command:
```bash
pipx install go-util
```
This will install the `go-util` utility, making it available globally on your system.
2. **Install via pip (ADVANCED)**:
If you would prefer to install `go-util` in a virtual environment (or, at your own risk, in your Python distribution's global environment), go-util is also available via pip:
```bash
pip install go-util
```
Note that while this option exists, it is generally advisable to not install CLI applications globally, thus installing via pipx is **highly** recommended.
## USAGE
The `go-util` CLI has the following commands and options:
### General Usage:
```bash
go [OPTIONS] COMMAND [ARGS]...
```
- `--help`: Show the help message for any command.
### Available Commands:
#### 1. `go add`
**Adds a new alias with a corresponding URL.**
Usage:
```bash
go add [ALIAS] [LINK]
```
Example:
```bash
go add wiki https://en.wikipedia.org/wiki/Main_Page
```
#### 2. `go to`
**Opens a saved alias in the default web browser.**
Usage:
```bash
go to [ALIAS]
```
Example:
```bash
go to wiki
```
#### 3. `go list`
**Lists all saved aliases and their corresponding URLs.**
Usage:
```bash
go list
```
#### 4. `go remove`
**Removes an existing alias.**
Usage:
```bash
go remove [ALIAS]
```
Example:
```bash
go remove wiki
```
#### 5. `go clean`
**Deletes all saved bookmarks.**
Usage:
```bash
go clean
```
#### 6. `go reset`
**Removes all program-generated data (e.g., on uninstall).**
Usage:
```bash
go reset
```
### Example Workflow:
1. **Adding a bookmark**:
```bash
go add google https://www.google.com
```
2. **Opening a saved bookmark**:
```bash
go to google
```
3. **Listing all saved bookmarks**:
```bash
go list
```
4. **Removing a bookmark**:
```bash
go remove google
```
5. **Resetting the program**:
```bash
go reset
```
## Attributions
The development of `go-util` relies on several open-source libraries and tools, which have been essential in building and testing the project.
For a full list of runtime and development dependencies, including their licenses, please refer to the [DEPENDENCIES.md](DEPENDENCIES.md) file. You can also find the full text of each license in the [licenses/](licenses/) directory.
I extend my thanks to the authors and contributors of these projects for their work.
## License
This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.
You can find the full text of the license in the [LICENSE.txt](LICENSE.txt) file or at the [GNU AGPL v3](https://www.gnu.org/licenses/agpl-3.0.html).
### Contributions
By contributing to this project, you agree that your contributions will be licensed under the AGPL v3, in line with the project's license.
### Third-Party Licenses
This project includes dependencies that are released under their respective open-source licenses (e.g., MIT, BSD). You can find more details in the [DEPENDENCIES.md](DEPENDENCIES.md) file or the `licenses/` directory.
### Disclaimer
This software is provided "as is", without any warranty of any kind, express or implied, including but not limited to the warranties of merchantability, fitness for a particular purpose, and non-infringement. In no event shall the authors 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.
### Copyright Notice
Copyright (c) Aiden McCormack, 2024. All Rights Reserved.
Raw data
{
"_id": null,
"home_page": "https://github.com/aidenm2244/go-util",
"name": "go_util",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.9",
"maintainer_email": null,
"keywords": "CLI, bookmark, manager",
"author": "Aiden McCormack",
"author_email": "aidenm2244@proton.me",
"download_url": "https://files.pythonhosted.org/packages/cc/f0/d12d695d74cdcd93d2a18f9c9cec4a7eabfe24771afd117137c00988596a/go_util-1.0.0.tar.gz",
"platform": null,
"description": "## OVERVIEW\n\n`go-util` is a cross-platform CLI bookmark manager. It allows users to create aliases for URLs, which can be accessed quickly from the terminal using the `go` command. The utility also supports adding new links, removing links, and managing stored bookmarks through various commands.\n\n## INSTALLATION\n\n### Prerequisites\n1. **Python:** This software is built in Python and thus requires Python 3.9 or greater to run. To install Python on your system, please refer to the official downloads page: https://www.python.org/downloads/\n\n2. **pipx:** As `go-util` is a standalone CLI app, it is best to install via pipx to isolate it from the rest of your system. To install pipx, first ensure Python is installed then refer to the official documentation: https://github.com/pypa/pipx\n\n### Installing on your system\nTo install `go-util`, follow these steps:\n\n1. **Install via pipx (RECOMMENDED)**:\n Installing via pipx ensures that the application is both available globally and contained within its own isolated environment. \n \n To install, open your terminal and run the following command:\n\n ```bash\n pipx install go-util\n ```\n This will install the `go-util` utility, making it available globally on your system.\n\n\n2. **Install via pip (ADVANCED)**:\n If you would prefer to install `go-util` in a virtual environment (or, at your own risk, in your Python distribution's global environment), go-util is also available via pip:\n\n ```bash\n pip install go-util\n ```\n\n Note that while this option exists, it is generally advisable to not install CLI applications globally, thus installing via pipx is **highly** recommended.\n\n## USAGE\n\nThe `go-util` CLI has the following commands and options:\n\n### General Usage:\n\n```bash\ngo [OPTIONS] COMMAND [ARGS]...\n```\n\n- `--help`: Show the help message for any command.\n\n### Available Commands:\n\n#### 1. `go add`\n **Adds a new alias with a corresponding URL.**\n\n Usage:\n\n ```bash\n go add [ALIAS] [LINK]\n ```\n\n Example:\n\n ```bash\n go add wiki https://en.wikipedia.org/wiki/Main_Page\n ```\n\n#### 2. `go to`\n **Opens a saved alias in the default web browser.**\n\n Usage:\n\n ```bash\n go to [ALIAS]\n ```\n\n Example:\n\n ```bash\n go to wiki\n ```\n\n#### 3. `go list`\n **Lists all saved aliases and their corresponding URLs.**\n\n Usage:\n\n ```bash\n go list\n ```\n\n#### 4. `go remove`\n **Removes an existing alias.**\n\n Usage:\n\n ```bash\n go remove [ALIAS]\n ```\n\n Example:\n\n ```bash\n go remove wiki\n ```\n\n#### 5. `go clean`\n **Deletes all saved bookmarks.**\n\n Usage:\n\n ```bash\n go clean\n ```\n\n#### 6. `go reset`\n **Removes all program-generated data (e.g., on uninstall).**\n\n Usage:\n\n ```bash\n go reset\n ```\n\n### Example Workflow:\n\n1. **Adding a bookmark**:\n ```bash\n go add google https://www.google.com\n ```\n\n2. **Opening a saved bookmark**:\n ```bash\n go to google\n ```\n\n3. **Listing all saved bookmarks**:\n ```bash\n go list\n ```\n\n4. **Removing a bookmark**:\n ```bash\n go remove google\n ```\n\n5. **Resetting the program**:\n ```bash\n go reset\n ```\n\n## Attributions\n\nThe development of `go-util` relies on several open-source libraries and tools, which have been essential in building and testing the project.\n\nFor a full list of runtime and development dependencies, including their licenses, please refer to the [DEPENDENCIES.md](DEPENDENCIES.md) file. You can also find the full text of each license in the [licenses/](licenses/) directory.\n\nI extend my thanks to the authors and contributors of these projects for their work.\n\n## License\n\nThis program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.\n\nThis program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.\n\nYou can find the full text of the license in the [LICENSE.txt](LICENSE.txt) file or at the [GNU AGPL v3](https://www.gnu.org/licenses/agpl-3.0.html).\n\n### Contributions\n\nBy contributing to this project, you agree that your contributions will be licensed under the AGPL v3, in line with the project's license.\n\n### Third-Party Licenses\n\nThis project includes dependencies that are released under their respective open-source licenses (e.g., MIT, BSD). You can find more details in the [DEPENDENCIES.md](DEPENDENCIES.md) file or the `licenses/` directory.\n\n### Disclaimer\n\nThis software is provided \"as is\", without any warranty of any kind, express or implied, including but not limited to the warranties of merchantability, fitness for a particular purpose, and non-infringement. In no event shall the authors 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.\n\n### Copyright Notice\n\nCopyright (c) Aiden McCormack, 2024. All Rights Reserved.\n\n\n",
"bugtrack_url": null,
"license": "End User License Agreement (EULA)",
"summary": "A CLI bookmark manager",
"version": "1.0.0",
"project_urls": {
"Homepage": "https://github.com/aidenm2244/go-util"
},
"split_keywords": [
"cli",
" bookmark",
" manager"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "3ae2719391506e3318eb3692fca3c43048ba44d67541f5383132783616f94773",
"md5": "acf606f1fca93c46f8b5e5832e7845b3",
"sha256": "0a920ed48f6cbcc15f7dd7d984173e9d15ae0c8be3d63310bc62bfc63da59007"
},
"downloads": -1,
"filename": "go_util-1.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "acf606f1fca93c46f8b5e5832e7845b3",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.9",
"size": 65210,
"upload_time": "2024-10-08T01:00:38",
"upload_time_iso_8601": "2024-10-08T01:00:38.636103Z",
"url": "https://files.pythonhosted.org/packages/3a/e2/719391506e3318eb3692fca3c43048ba44d67541f5383132783616f94773/go_util-1.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "ccf0d12d695d74cdcd93d2a18f9c9cec4a7eabfe24771afd117137c00988596a",
"md5": "13d6b1d0acaa7d8f1bc3979e01aee6c7",
"sha256": "9de966e3b89b56a878e56f65868ed9d2b402af804441bf1c295c354e89ab8440"
},
"downloads": -1,
"filename": "go_util-1.0.0.tar.gz",
"has_sig": false,
"md5_digest": "13d6b1d0acaa7d8f1bc3979e01aee6c7",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.9",
"size": 67489,
"upload_time": "2024-10-08T01:00:40",
"upload_time_iso_8601": "2024-10-08T01:00:40.338348Z",
"url": "https://files.pythonhosted.org/packages/cc/f0/d12d695d74cdcd93d2a18f9c9cec4a7eabfe24771afd117137c00988596a/go_util-1.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-10-08 01:00:40",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "aidenm2244",
"github_project": "go-util",
"github_not_found": true,
"lcname": "go_util"
}