{"id":15012579,"url":"https://github.com/microsoft/cookie-doh","last_synced_at":"2025-10-25T22:39:28.543Z","repository":{"id":241809040,"uuid":"797256025","full_name":"microsoft/cookie-doh","owner":"microsoft","description":"Cookie-doh is a repository template for creating single Python package projects.","archived":false,"fork":false,"pushed_at":"2024-12-17T15:05:10.000Z","size":637,"stargazers_count":16,"open_issues_count":0,"forks_count":2,"subscribers_count":5,"default_branch":"main","last_synced_at":"2025-01-31T16:23:32.762Z","etag":null,"topics":["codespaces","cookiecutter","copier-template","devcontainer","poetry","project-template","python","scaffolding"],"latest_commit_sha":null,"homepage":"https://microsoft.github.io/cookie-doh/","language":"Jinja","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/microsoft.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":"SUPPORT.md","governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-05-07T13:45:16.000Z","updated_at":"2024-12-30T22:29:39.000Z","dependencies_parsed_at":"2024-05-30T05:56:26.005Z","dependency_job_id":"0c5c3185-c8a5-4615-b855-5bc5707e9438","html_url":"https://github.com/microsoft/cookie-doh","commit_stats":{"total_commits":86,"total_committers":2,"mean_commits":43.0,"dds":0.05813953488372092,"last_synced_commit":"b028727d526e7ffbf76e6c8af04d9abfdb98265b"},"previous_names":["microsoft/cookie-doh"],"tags_count":13,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microsoft%2Fcookie-doh","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microsoft%2Fcookie-doh/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microsoft%2Fcookie-doh/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microsoft%2Fcookie-doh/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/microsoft","download_url":"https://codeload.github.com/microsoft/cookie-doh/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":237143591,"owners_count":19262232,"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":["codespaces","cookiecutter","copier-template","devcontainer","poetry","project-template","python","scaffolding"],"created_at":"2024-09-24T19:42:52.171Z","updated_at":"2025-10-19T14:30:45.465Z","avatar_url":"https://github.com/microsoft.png","language":"Jinja","readme":"# :cookie: cookie-doh\n\n[![main](https://github.com/microsoft/cookie-doh/actions/workflows/main.yml/badge.svg)](https://github.com/microsoft/cookie-doh/actions/workflows/main.yml)\n[![Checked with pyright](https://microsoft.github.io/pyright/img/pyright_badge.svg)](https://microsoft.github.io/pyright/)\n[![uv](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/uv/main/assets/badge/v0.json)](https://github.com/astral-sh/uv)\n[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\nCookie-doh is a repository template for creating single Python package projects that include pre-configured development tools.\n\n## :woman_shrugging: Why use cookie-doh?\n\n* :seedling: Improve your development workflow (checks, formatting, remote dev, etc.).\n\n* :scroll: Uses [uv](https://docs.astral.sh/uv) for dependency management (configured and fast).\n\n* :tropical_drink: quick and easy to start new projects!\n\n:link: Short-link: [https://aka.ms/cookie-doh]()\n\n:star: Star this repo to show your support!\n\n-----------------------------------------------------------------\n\n## :rocket: Getting started with cookie-doh\n\nThis template uses [uv](https://docs.astral.sh/uv/getting-started/installation/) and\n [_copier_](https://github.com/copier-org/copier) to create new repositories:\n\n```bash\ncurl -LsSf https://astral.sh/uv/install.sh | sh  # Install uv\nuv tool install copier  # Install copier\ncopier copy gh:microsoft/cookie-doh \u003cnew-repo-folder\u003e  # Create new project\n```\n\n## :notebook_with_decorative_cover: Documentation\n\nVisit the documentation:\n\n\u003chttps://microsoft.github.io/cookie-doh/\u003e\n\n:point_right: Go to [new project](https://microsoft.github.io/cookie-doh/getting_started/) for first steps!\n\n## :space_invader: Codespaces\n\nLearn about [GitHub Codespaces](https://docs.github.com/en/codespaces) and [DevPod](https://devpod.sh/).\n\n:point_right: Click below to clone or fork this repository automatically and start developing:\n\n[![Open in GitHub Codespaces](https://github.com/codespaces/badge.svg)](https://codespaces.new/microsoft/cookie-doh)\n\n[![Open in DevPod!](https://devpod.sh/assets/open-in-devpod.svg)](https://devpod.sh/open#https://github.com/microsoft/cookie-doh)\n\n## :gear: Devcontainer\n\nLearn about [Devcontainers](https://containers.dev).\nRequires [Docker](https://www.docker.com/get-started/) installed on your local machine.\n\n:point_right: Follow instructions for [VSCode](https://code.visualstudio.com/docs/devcontainers/tutorial)\nand/or [PyCharm](https://www.jetbrains.com/help/pycharm/connect-to-devcontainer.html).\n\n## :computer: Local development\n\n:point_right: Follow [instructions](https://microsoft.github.io/cookie-doh/dev_setup)\nto set up your local environment.\n\n## :hammer_and_wrench: Development tools\n\nCookie-doh uses and generates projects with the following tools to help the development experience:\n\n* [uv](https://docs.astral.sh/uv/) for dependency management, virtual environments and\npackaging. Configured so that your code is readily importable.\n* [ruff](https://docs.astral.sh/ruff/) for formatting and linting: helps you write clean and uniform code across collaborations.\n* [pytest](https://docs.pytest.org/en/stable/) for testing: ensures your code is working as expected.\n* [pyright](https://github.com/microsoft/pyright) for static annotations: helps identify simple errors and makes your code more readable!\n* [codespell](https://github.com/codespell-project/codespell) for spell checking: pinpoints spelling errors across code and documents.\n* [CI workflows](https://en.wikipedia.org/wiki/Continuous_integration): automates validation when you submit a PR or merge to `main` branch.\n\nOptional tools (configurable when you create a new project):\n\n* [Material for MkDocs](https://squidfunk.github.io/mkdocs-material/) for beautiful markdown documentation builds (like [cookie-doh](https:microsoft.github.io/cookie-doh)'s).\n* [pre-commit](https://pre-commit.com/) for quick validation checks and fixes before committing.\n* [commitizen](https://commitizen-tools.github.io/commitizen/)\nfor writing [conventional commits](https://www.conventionalcommits.org/), to help write better commit messages\nand track changes through [time](https://github.com/microsoft/cookie-doh/blob/main/CHANGELOG.md).\n\n## :mountain: Contributing\n\nThis project welcomes contributions and suggestions. Most contributions require you to agree to a\nContributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us\nthe rights to use your contribution. For details, visit \u003chttps://cla.opensource.microsoft.com\u003e.\n\nWhen you submit a pull request, a CLA bot will automatically determine whether you need to provide\na CLA and decorate the PR appropriately (e.g., status check, comment). Simply follow the instructions\nprovided by the bot. You will only need to do this once across all repos using our CLA.\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or\ncontact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\n## :balance_scale: Trademarks\n\nThis project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft\ntrademarks or logos is subject to and must follow\n[Microsoft's Trademark \u0026 Brand Guidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\nAny use of third-party trademarks or logos are subject to those third-party's policies.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmicrosoft%2Fcookie-doh","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmicrosoft%2Fcookie-doh","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmicrosoft%2Fcookie-doh/lists"}