{"id":13713344,"url":"https://github.com/fennifith/AAH","last_synced_at":"2025-05-06T23:31:50.729Z","repository":{"id":97398188,"uuid":"146597380","full_name":"fennifith/AAH","owner":"fennifith","description":"A basic cmdline program for Linux to help me do basic things I should already know. Ex: \"AAH drive mount\"","archived":false,"fork":false,"pushed_at":"2019-01-09T16:23:19.000Z","size":20,"stargazers_count":6,"open_issues_count":0,"forks_count":3,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-05T04:11:19.053Z","etag":null,"topics":["cli","go","golang","linux"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fennifith.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-08-29T12:35:11.000Z","updated_at":"2020-12-23T16:01:37.000Z","dependencies_parsed_at":"2023-03-13T16:14:29.122Z","dependency_job_id":null,"html_url":"https://github.com/fennifith/AAH","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fennifith%2FAAH","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fennifith%2FAAH/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fennifith%2FAAH/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fennifith%2FAAH/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fennifith","download_url":"https://codeload.github.com/fennifith/AAH/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252787531,"owners_count":21804278,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","go","golang","linux"],"created_at":"2024-08-02T23:01:33.325Z","updated_at":"2025-05-06T23:31:45.720Z","avatar_url":"https://github.com/fennifith.png","language":"Go","funding_links":[],"categories":["Repositories"],"sub_categories":[],"readme":"AAH, or the Annoyingly Advanced Helper, is a basic command-line program to help me do basic things I should already know.\n\n[![Discord](https://img.shields.io/discord/514625116706177035.svg)](https://discord.gg/u5pUkFV)\n\nFor example:\n\n```\n~$ AAH drive mount\nmount: \t\tmkdir /mnt/disk \u0026\u0026 mount \u003cdevice\u003e /mnt/disk\n~$\n```\n\n## Installation\n\nInstallation is fairly simple. You can either install from source or use the prebuilt binary. Both are fairly simple.\n\n### Prebuilt Binary\n\nDownloading a prebuilt binary is fairly simple. Simply choose a file from the [releases](../../releases) page and run the commands below, replacing the information in brackets with their respective values.\n\n```shell\nwget https://github.com/fennifith/AAH/releases/download/{version}/AAH-{platform}\nmv AAH-{platform} AAH\nchmod +x AAH\n```\n\nYou can now run `./AAH` to check that the it works. If you would like to run the program without having to remember the directory that it is stored in, you can either add its directory to the `$PATH` environment variable or move the file to somewhere that is in your `$PATH`.\n\n#### Moving to Somewhere in `$PATH`\n\n```shell\nsudo su\nmv AAH /bin/AAH\n```\n\nYep.\n\n#### Adding Directory to `$PATH`\n\nThis assumes that you have downloaded the binary to a folder titled `~/bin`. Feel free to change the directory as you wish.\n\nAdd the following line to the bottom of `~/.bashrc`:\n\n```shell\nexport PATH=\"$PATH:~/bin\"\n```\n\nThen run `source ~/.bashrc`. Finally, run `AAH` to check that it works.\n\n### Source\n\n#### Prerequisites\n\n- [git](https://git-scm.org/downloads)\n- [go](https://golang.org/dl/)\n\n#### Setup\n\nIf you have `go` set up already, you can skip this. It is basically just a simplified version of the instructions on golang's website.\n\nFollow the link above for instructions to download and install the go binary. After installing go, you can either keep following these instructions or follow the installation instructions linked on the download page. Either way, you will end up with a similar result.\n\nNext, you will want to create a \"workspace\" for your go projects. In this instructions, I will be creating the workspace at `~/go`, but feel free to change this directory to your liking.\n\n```shell\nmkdir go \u0026\u0026 cd go\nmkdir {bin,src,pkg}\n```\n\nNow that go's fancy \"workspace\" directory has been created, it needs to be added as an environment variable. Go ahead and add the following to the end of `~/.bashrc`...\n\n```shell\nexport GOPATH=\"/home/\u003cyou sir\u003e/go\"\nexport PATH=\"$PATH:$GOPATH/bin\"\n```\n\nAfter saving the file, run `source ~/.bashrc` and you're good to go.\n\n#### Installing\n\nThis bit is fairly simple.\n\n```shell\ngo get github.com/fennifith/AAH\ncd ~/go/src/github.com/fennifith/AAH\ngo get \u0026\u0026 go build \u0026\u0026 go install\n```\n\nAfter this, you can try running `AAH` to check that it has installed properly.\n\n## Configuration\n\nConfiguration is fairly basic. The program will use the [`aahelp.yaml`](./aahelp.yaml) file in the repository by default. You can override the values in this file or add your own by creating another located at `~/.aahelp.yaml`.\n\nThe file uses basic YAML syntax (which can be easily learnt by just taking a glance at the default file in the repository), though it should be noted that there is no support for arrays as they do not make much sense in this context.\n\nThe program takes any number of arguments, allowing you to create as many nested maps as you would like and type either some or all of the keys as arguments when running the command to access their values.\n\nFor example, with the following file:\n\n```yaml\nthing:\n    something:\n        yes:\n            stuff: this is a thing\n```\n\nYou could type `AAH thing something yes stuff` to get the value `this is a thing`. Alternatively, you could just type `AAH thing something yes` to get a list of everything below the key `yes` in the YAML hierarchy. And if you are very lazy, you can even shorten some of the names provided they are still differentiable from the other keys, ex: `AAH th some y`.\n\n## Contributing\n\nSee this project's [CONTRIBUTING.md](./.github/CONTRIBUTING.md) for instructions on how to contribute to this project.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffennifith%2FAAH","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffennifith%2FAAH","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffennifith%2FAAH/lists"}