|
1 | 1 | # {{ project_name }} |
2 | 2 |
|
| 3 | +{% if repository_provider == 'github' -%} |
3 | 4 | [](https://img.shields.io/github/v/release/{{ author_github_handle }}/{{ project_name }}) |
4 | 5 | [](https://github.com/{{ author_github_handle }}/{{ project_name }}/actions/workflows/main.yml?query=branch%3Amain) |
5 | 6 | [](https://codecov.io/gh/{{ author_github_handle }}/{{ project_name }}) |
6 | 7 | [](https://img.shields.io/github/commit-activity/m/{{ author_github_handle }}/{{ project_name }}) |
7 | 8 | [](https://img.shields.io/github/license/{{ author_github_handle }}/{{ project_name }}) |
8 | | - |
9 | | -{{ project_description }} |
10 | | - |
11 | | -- **Github repository**: <https://github.com/{{ author_github_handle }}/{{ project_name }}/> |
12 | | -- **Documentation** <https://{{ author_github_handle }}.github.io/{{ project_name }}/> |
13 | | - |
14 | | -## Getting started with your project |
15 | | - |
16 | | -### 1. Create a New Repository |
17 | | - |
18 | | -First, create a repository on GitHub with the same name as this project, and then run the following commands: |
19 | | - |
20 | | -```bash |
21 | | -git init -b main |
22 | | -git add . |
23 | | -git commit -m "init commit" |
24 | | -git remote add origin git@github.com:{{ author_github_handle }}/{{ project_name }}.git |
25 | | -git push -u origin main |
26 | | -``` |
27 | | - |
28 | | -### 2. Set Up Your Development Environment |
29 | | - |
30 | | -Then, install the environment and the pre-commit hooks with |
31 | | - |
32 | | -```bash |
33 | | -make install |
34 | | -``` |
35 | | - |
36 | | -This will also generate your `uv.lock` file |
37 | | - |
38 | | -### 3. Run the pre-commit hooks |
39 | | - |
40 | | -Initially, the CI/CD pipeline might be failing due to formatting issues. To resolve those run: |
41 | | - |
42 | | -```bash |
43 | | -uv run pre-commit run -a |
44 | | -``` |
45 | | - |
46 | | -### 4. Commit the changes |
47 | | - |
48 | | -Lastly, commit the changes made by the two steps above to your repository. |
49 | | - |
50 | | -```bash |
51 | | -git add . |
52 | | -git commit -m 'Fix formatting issues' |
53 | | -git push origin main |
54 | | -``` |
55 | | - |
56 | | -You are now ready to start development on your project! |
57 | | -The CI/CD pipeline will be triggered when you open a pull request, merge to main, or when you create a new release. |
58 | | - |
59 | | -To finalize the set-up for publishing to PyPI, see [here](https://fpgmaas.github.io/cookiecutter-uv/features/publishing/#set-up-for-pypi). |
60 | | -For activating the automatic documentation with MkDocs, see [here](https://fpgmaas.github.io/cookiecutter-uv/features/mkdocs/#enabling-the-documentation-on-github). |
61 | | -To enable the code coverage reports, see [here](https://fpgmaas.github.io/cookiecutter-uv/features/codecov/). |
62 | | - |
63 | | -## Releasing a new version |
64 | | - |
65 | | -{%- if publish_to_pypi %} |
66 | | -- Create an API Token on [PyPI](https://pypi.org/). |
67 | | -- Add the API Token to your projects secrets with the name `PYPI_TOKEN` by visiting [this page](https://github.com/{{ author_github_handle }}/{{ project_name }}/settings/secrets/actions/new). |
68 | | -- Create a [new release](https://github.com/{{ author_github_handle }}/{{ project_name }}/releases/new) on Github. |
69 | | -- Create a new tag in the form `*.*.*`. |
70 | | - |
71 | | -For more details, see [here](https://fpgmaas.github.io/cookiecutter-uv/features/cicd/#how-to-trigger-a-release). |
72 | 9 | {%- endif %} |
73 | | - |
74 | | ---- |
75 | | - |
76 | | -Repository initiated with [fpgmaas/cookiecutter-uv](https://github.com/fpgmaas/cookiecutter-uv). |
0 commit comments