{"id":13587312,"url":"https://github.com/adityaathalye/bash-toolkit","last_synced_at":"2025-03-26T22:30:53.002Z","repository":{"id":148465241,"uuid":"226383173","full_name":"adityaathalye/bash-toolkit","owner":"adityaathalye","description":"Could be my ever-growing, ever-improving, Swiss Army Toolkit of functions-as-cmd-line-tools and useful-to-me patterns.","archived":false,"fork":false,"pushed_at":"2024-09-09T16:44:58.000Z","size":41,"stargazers_count":29,"open_issues_count":0,"forks_count":0,"subscribers_count":4,"default_branch":"master","last_synced_at":"2024-10-30T08:24:02.805Z","etag":null,"topics":["bash","bash-scripting","clojure-development","command-line-tool","functional-programming","git-ops","log-analysis","machine-setup","shell","shell-script"],"latest_commit_sha":null,"homepage":"https://www.evalapply.org/tags/bash/","language":"Shell","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/adityaathalye.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2019-12-06T18:02:19.000Z","updated_at":"2024-10-02T14:57:02.000Z","dependencies_parsed_at":"2023-05-20T06:45:45.180Z","dependency_job_id":null,"html_url":"https://github.com/adityaathalye/bash-toolkit","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adityaathalye%2Fbash-toolkit","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adityaathalye%2Fbash-toolkit/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adityaathalye%2Fbash-toolkit/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adityaathalye%2Fbash-toolkit/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/adityaathalye","download_url":"https://codeload.github.com/adityaathalye/bash-toolkit/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245747499,"owners_count":20665800,"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":["bash","bash-scripting","clojure-development","command-line-tool","functional-programming","git-ops","log-analysis","machine-setup","shell","shell-script"],"created_at":"2024-08-01T15:06:09.085Z","updated_at":"2025-03-26T22:30:52.729Z","avatar_url":"https://github.com/adityaathalye.png","language":"Shell","funding_links":[],"categories":["Shell"],"sub_categories":[],"readme":"[Purpose](#purpose)\n[Caveat emptor](#caveat-emptor)\n[Contributing](#contributing)\n[Credits](#credits)\n[HOPETODOs](#hopetodos)\n\n# Purpose\n\nMaybe this will become my ever-growing, ever-improving, Swiss Army\nToolkit of functions-as-cmd-line-tools and useful-to-me patterns.\n\nIt is unlikely to be useful as-is to you. However, you might find\nsome of the ideas or techniques interesting (almost none of them\nare original).\n\nIn any case, this stuff has emerged from my personal motivations to:\n\n- reinvent the wheel for fun and profit\n- avoid rewriting all of these all over the place, as I end up\n  doing ever so often\n- get better at text processing. That stuff is everywhere!\n- benefit from stable, fast tools, with well-known warts, and\n  Because The Masters Already Solved It Better Decades Ago\n- improve personal/team productivity\n- preserve tool-building autonomy\n- learn about good and successful design\n- learn about bad _and_ successful design\n- go down the winding rabbit pipes of computer history.\n\nSee also:\n- [shite](https://github.com/adityaathalye/shite), my little static site generator that makes [my website](https://evalapply.org) (and it also hot-builds and hot-refreshes).\n- [oxo](https://github.com/adityaathalye/oxo), a game of Noughts and Crosses, written in Bash (and it also speaks in computer voice).\n\n# Usage\n\nI happen to use these tools on Ubuntu 18+ LTS, with Bash 4.4+. Maybe\nthey will also work just fine on other Debian-like distros, with Bash 4+.\n\nEach \"utility\" file would have its own usage guide.\n\n# Caveat emptor\n\nThese utilities are NOT designed to be portable across shells or older\nBash versions or operating systems. Nor should they be presumed secure.\nIf I haven't tried, they certainly aren't. And even if I did, they very\nwell may not be.\n\nI'm still learning from my mistakes, after all. Ergo, by perusing these,\nyou accept all the horrible ramifications of your life choice.\n\n# Contributing\n\nI'll be happy to discuss bugs, design ideas etc. via email or github's\nissues feature. Suppose a discussion leads to a thing I'd like to add\nto this repo, I'll work with you to bring it in with due credit.\n\nHowever, I do not intend this for use by others, and will not heed\nunsolicited pull requests.\n\n# Credits\n\nToo many to name, but some important ones are:\n\n- Several friends and colleagues (especially those who failed to\n  caution me about the perils of Shell scripting)\n- Classic Shell Scripting (Robbins and Beebee)\n- bash manpage authors, tool manpage authors, especially the ones\n  who document EXAMPLES\n- mtxia.com, jpnc.info, catb.org, wiki.bash-hackers.org, tldp.org\n- Various StackOverflows, githubs, subreddits, HackerNewses,\n  ${RANDOM_BLOGGERS}... erm... \"The Internets\"?\n\n# HOPETODOs\n\n- Read \"The Unix Programming Environment\".\n- Peruse [google's shell style guide](https://google.github.io/styleguide/shell.xml). They seem to know a bit or two.\n- Understand plan9. Migrate to plan9. Upgrade to plan10.\n  Wait, no that's not macOS.\n- Many, many other things.\n\n# Copyright and License\n\nCopyright © 2018-2019 [Aditya Athalye](https://adityaathalye.com).\n\nDistributed under the [MIT license](https://github.com/inclojure-org/clojure-by-example/blob/master/LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadityaathalye%2Fbash-toolkit","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fadityaathalye%2Fbash-toolkit","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadityaathalye%2Fbash-toolkit/lists"}