{"id":18459669,"url":"https://github.com/ronanduddy/pragprog","last_synced_at":"2026-04-28T08:01:51.245Z","repository":{"id":90062800,"uuid":"337424370","full_name":"ronanduddy/pragprog","owner":"ronanduddy","description":"A little bash script that can be used to ask for 'Pragmatic Programming' help.","archived":false,"fork":false,"pushed_at":"2021-02-10T10:28:09.000Z","size":17,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-02-16T15:37:12.479Z","etag":null,"topics":["bash","helpful","pragmatic-programming","tool"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":false,"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/ronanduddy.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":"CODE_OF_CONDUCT.md","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":"2021-02-09T14:06:58.000Z","updated_at":"2021-02-10T10:28:12.000Z","dependencies_parsed_at":null,"dependency_job_id":"0bac24ba-dd07-49b1-9f44-759d94b67329","html_url":"https://github.com/ronanduddy/pragprog","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/ronanduddy%2Fpragprog","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ronanduddy%2Fpragprog/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ronanduddy%2Fpragprog/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ronanduddy%2Fpragprog/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ronanduddy","download_url":"https://codeload.github.com/ronanduddy/pragprog/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250482107,"owners_count":21437833,"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","helpful","pragmatic-programming","tool"],"created_at":"2024-11-06T08:23:59.934Z","updated_at":"2026-04-28T08:01:46.184Z","avatar_url":"https://github.com/ronanduddy.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# PragProg\n\nThis is a little bash script that prints out bits of Hugo Matilla's [summary](https://github.com/HugoMatilla/The-Pragmatic-Programmer) of the [The Pragmatic Programmer](https://pragprog.com/titles/tpp20/the-pragmatic-programmer-20th-anniversary-edition/) by Andrew Hunt and David Thomas.\n\n## Motivation\n\nGiven everyday programming and the subsequent tunnel vision that one sometimes gets during their work, the goal of this project is to have a means to 'ask' for help, inspiration or guidance which can be found in The Pragmatic Programmer book.\n\n## Installation\n\nFirst clone the repo including its submodules:\n\n```Shell\ngit clone --recurse-submodules https://github.com/ronanduddy/pragprog.git\n```\n\nTo access the CLI tool from anywhere on your machine, one simple approach is to add the following to your `~/.bashrc`:\n\n```Shell\nalias pp=~/location/to/pragprog/pp\n```\n\nWhere `~/location/to/pragprog/pp` is the location of the bash script.\n\n## Usage\n\nNext, test that you can run the following command:\n\n```Shell\npp help\n```\n\nThe above command will print the following:\n\n```Shell\nUsage:\n\thelp \tHelp\n\tread \tRead The-Pragmatic-Programmer/readme.md\n\ttoc \tPrint the table of contents, used to find chapters and sections.\n\tx \tPrint a chapter. E.g. chapter 1 'A Pragmatic Philosophy'; 1\n\tx.y \tPrint a section of a chapter. E.g. chapter 1, section 2 'Software Entropy'; 1.2\n\ttips \tPrint tips\n\tls    \tPrint checklist\n```\n\nIt is possible to print section 2 'Software Entropy' from chapter 1 'A Pragmatic Philosophy', for example, by using the following command:\n\n```Shell\npp 1.2\n```\n\nWhich would print something like:\n\n```Shell\n## 2.-Software Entropy\nOne broken window ...\n\n**Tip 4: Don't Live with Broken Windows**\n\nDon't mess up the carpet when fixing the broken window.\n\n```\n\n## Contributing\n\nBug reports and pull requests are welcome on GitHub at https://github.com/ronanduddy/pragprog. Please read [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md) for details on our code of conduct.\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE.md](LICENSE.md) file for details\n\n## Acknowledgments\n\n* [Hugo Matilla](https://github.com/HugoMatilla)\n* [Andrew Hunt \u0026 David Thomas](https://pragprog.com/titles/tpp20/the-pragmatic-programmer-20th-anniversary-edition/)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fronanduddy%2Fpragprog","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fronanduddy%2Fpragprog","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fronanduddy%2Fpragprog/lists"}