{"id":13566031,"url":"https://github.com/patdaburu/cookiecutter-click","last_synced_at":"2026-02-03T18:39:34.178Z","repository":{"id":49283549,"uuid":"131530433","full_name":"patdaburu/cookiecutter-click","owner":"patdaburu","description":"A Python cookiecutter template to help you start a Click project.","archived":false,"fork":false,"pushed_at":"2022-11-13T19:45:12.000Z","size":478,"stargazers_count":56,"open_issues_count":4,"forks_count":21,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-12-26T16:32:12.413Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/patdaburu.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}},"created_at":"2018-04-29T21:10:19.000Z","updated_at":"2025-08-28T01:28:24.000Z","dependencies_parsed_at":"2023-01-21T15:16:47.779Z","dependency_job_id":null,"html_url":"https://github.com/patdaburu/cookiecutter-click","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/patdaburu/cookiecutter-click","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/patdaburu%2Fcookiecutter-click","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/patdaburu%2Fcookiecutter-click/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/patdaburu%2Fcookiecutter-click/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/patdaburu%2Fcookiecutter-click/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/patdaburu","download_url":"https://codeload.github.com/patdaburu/cookiecutter-click/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/patdaburu%2Fcookiecutter-click/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29052760,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-03T15:43:47.601Z","status":"ssl_error","status_checked_at":"2026-02-03T15:43:46.709Z","response_time":96,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":[],"created_at":"2024-08-01T13:02:00.455Z","updated_at":"2026-02-03T18:39:34.160Z","avatar_url":"https://github.com/patdaburu.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"# Cookiecutter Click\n\n![](https://github.com/patdaburu/cookiecutter-click/workflows/Build/badge.svg)\n[![Code style:\nblack](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/ambv/black)\n\n## Powered by [Cookiecutter](https://cookiecutter.readthedocs.io/en/latest/), Cookiecutter Click generates boilerplate for production-ready [command-line interface (CLI)](http://click.pocoo.org/5/) applications.\n\n## Features\n\nThe project you create from this template has a few features to be aware of\nincluding:\n\n* A [Click](http://click.pocoo.org/5/) application to get you going\n* [Pytest](https://docs.pytest.org/en/latest/) unit tests\n* A documentation project based on\n  [Sphinx](http://www.sphinx-doc.org/en/master/usage/quickstart.html).\n\n## Usage\n\nLet's pretend you want to create a CLI tool called \"redditcli\". Rather than\nusing standard lib argparse and then editing mundane details to include your\nbasic cli tool configuration that always get forgotten until the worst possible\nmoment, get cookiecutter to do all the work.\n\nFirst, get Cookiecutter. Trust me, it's awesome:\n\n``` bash\npip install \"cookiecutter\u003e=1.4.0\"`\n```\n\nNow run it against this repo:\n\n``` bash\ncookiecutter https://github.com/patdaburu/cookiecutter-click\n```\n\nYou'll be prompted for some values. Provide them, then a cli tool will be\ncreated for you.\n\nWarning: After this point, change 'Vlad Doster', 'vladdoster', etc to your own\ninformation.\n\nAnswer the prompts with your own desired options. For example:\n\n``` bash\nCloning into 'cookiecutter-click'...\nremote: Counting objects: 550, done.\nremote: Compressing objects: 100% (310/310), done.\nremote: Total 550 (delta 283), reused 479 (delta 222)\nReceiving objects: 100% (550/550), 127.66 KiB | 58 KiB/s, done.\nResolving deltas: 100% (283/283), done.\nproject_name [my-click-project]: Reddit CLI\npackage_name [my-click-project]: reddit_cli\ncli_name [my_click_project]: reddit-cli\nproject_version [0.0.1]: 0.0.1\nproject_description [This is my click command-line app]: Browse Reddit from a cli tool!\nSelect python_version:\n1 - 3.6\n2 - 3.7\n3 - 3.8\nChoose from 1, 2, 3 (1, 2, 3) [1]: 1\nSelect virtualenv:\n1 - virtualenv\n2 - python3\nChoose from 1, 2 (1, 2) [1]: 1\nSelect linter:\n1 - flake8\n2 - pylint\nChoose from 1, 2 (1, 2) [1]:\nSelect sphinx_theme:\n1 - alabaster\n2 - readthedocs\nChoose from 1, 2 (1, 2) [1]: 1\nSelect auto_readme:\n1 - None\n2 - pandoc\nChoose from 1, 2 (1, 2) [1]: 1\nauthor_name [my_name]: Vlad Doster\nauthor_email [my_email]: mvdoster@gmail.com\nSelect license:\n1 - MIT\n2 - BSD\n3 - GPLv3\n4 - Apache Software License 2.0\n5 - None\nChoose from 1, 2, 3, 4, 5 (1, 2, 3, 4, 5) [1]: 1\ngithub_user [my_github_user]: vladdoster\n```\n\nEnter the project and take a look around:\n\n``` bash\ncd reddit_cli/\nsource venv/bin/activate\nreddit_cli --help\nls -a\n```\n\nCreate a git repo and push it there:\n\n``` bash\ngit init\ngit add .\ngit commit -m \"first awesome commit\"\ngit remote add origin git@github.com:vladdoster/reddit_cli.git\ngit push -u origin master\n```\n\n## `make` Targets\n\nThe template contains a cookiecutter [post-generate\nhook](http://cookiecutter.readthedocs.io/en/latest/advanced/hooks.html) that\nwill attempt to do the following using targets in the project's\n[Makefile](https://www.gnu.org/software/make/):\n\nYou may want to go about this differently according to your processes, but if\nyou want to create a virtual environment for the project, install the\ndependencies, and set up the comman-line application, you can use the `make`\ntargets defined in the project like so.\n\nThere are several other `make` targets so have a look at the `Makefile` if\nyou're interested.\n\n``` bash\ncd \u003cproject-name\u003e\nmake venv\nmake install\nmake build\n```\n\n## Run the Command-Line App\n\nIf you have performed the steps above, you should now be able to run the\napplication by the project name.\n\n``` bash\n\u003cproject-name\u003e --help\n```\n\nIf you get the template help message, you're ready to start building.\n\n## Resources\n\nWould you like to learn more?  Check out the links below!\n\n* [Cookiecutter Project\n  Documentation](https://cookiecutter.readthedocs.io/en/latest/)\n* [Cookiecutter: Project Templates Made\n  Easy](https://www.pydanny.com/cookie-project-templates-made-easy.html)\n* [Click](http://click.pocoo.org/5/)\n* [Pytest](https://docs.pytest.org/en/latest/)\n* [Sphinx](http://www.sphinx-doc.org/en/master/usage/quickstart.html)\n\n## Author\n\nThis program was created by [Pat Daburu](https://github.com/patdaburu). \n\nThis project is [hosted on GitHub](https://github.com/patdaburu/cookiecutter-click). Please feel free to submit pull requests.\n\n## Contributors\n\n| name        | github link                   |\n|-------------|-------------------------------|\n| Vlad Doster | https://github.com/vladdoster |\n\n## License\n\nCopyright © 2018–2020 Pat Daburu. This program is released under the GPLv3 license, which you can find in the file [LICENSE](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpatdaburu%2Fcookiecutter-click","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpatdaburu%2Fcookiecutter-click","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpatdaburu%2Fcookiecutter-click/lists"}