-
Notifications
You must be signed in to change notification settings - Fork 2
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
3 changed files
with
63 additions
and
67 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,74 +1,10 @@ | ||
# eo-tides | ||
# eo-tides: Tide modelling tools for Earth Observation | ||
|
||
[![Release](https://img.shields.io/github/v/release/GeoscienceAustralia/eo-tides)](https://img.shields.io/github/v/release/GeoscienceAustralia/eo-tides) | ||
[![Build status](https://img.shields.io/github/actions/workflow/status/GeoscienceAustralia/eo-tides/main.yml?branch=main)](https://github.com/GeoscienceAustralia/eo-tides/actions/workflows/main.yml?query=branch%3Amain) | ||
[![codecov](https://codecov.io/gh/GeoscienceAustralia/eo-tides/branch/main/graph/badge.svg)](https://codecov.io/gh/GeoscienceAustralia/eo-tides) | ||
[![Commit activity](https://img.shields.io/github/commit-activity/m/GeoscienceAustralia/eo-tides)](https://img.shields.io/github/commit-activity/m/GeoscienceAustralia/eo-tides) | ||
[![License](https://img.shields.io/github/license/GeoscienceAustralia/eo-tides)](https://img.shields.io/github/license/GeoscienceAustralia/eo-tides) | ||
|
||
This is placeholder text. | ||
|
||
- **Github repository**: <https://github.com/GeoscienceAustralia/eo-tides/> | ||
- **Documentation** <https://GeoscienceAustralia.github.io/eo-tides/> | ||
|
||
## Getting started with your project | ||
|
||
### 1. Create a New Repository | ||
|
||
First, create a repository on GitHub with the same name as this project, and then run the following commands: | ||
|
||
```bash | ||
git init -b main | ||
git add . | ||
git commit -m "init commit" | ||
git remote add origin [email protected]:GeoscienceAustralia/eo-tides.git | ||
git push -u origin main | ||
``` | ||
|
||
### 2. Set Up Your Development Environment | ||
|
||
Then, install the environment and the pre-commit hooks with | ||
|
||
```bash | ||
make install | ||
``` | ||
|
||
This will also generate your `uv.lock` file | ||
|
||
### 3. Run the pre-commit hooks | ||
|
||
Initially, the CI/CD pipeline might be failing due to formatting issues. To resolve those run: | ||
|
||
```bash | ||
uv run pre-commit run -a | ||
``` | ||
|
||
### 4. Commit the changes | ||
|
||
Lastly, commit the changes made by the two steps above to your repository. | ||
|
||
```bash | ||
git add . | ||
git commit -m 'Fix formatting issues' | ||
git push origin main | ||
``` | ||
|
||
You are now ready to start development on your project! | ||
The CI/CD pipeline will be triggered when you open a pull request, merge to main, or when you create a new release. | ||
|
||
To finalize the set-up for publishing to PyPI, see [here](https://fpgmaas.github.io/cookiecutter-uv/features/publishing/#set-up-for-pypi). | ||
For activating the automatic documentation with MkDocs, see [here](https://fpgmaas.github.io/cookiecutter-uv/features/mkdocs/#enabling-the-documentation-on-github). | ||
To enable the code coverage reports, see [here](https://fpgmaas.github.io/cookiecutter-uv/features/codecov/). | ||
|
||
## Releasing a new version | ||
|
||
- Create an API Token on [PyPI](https://pypi.org/). | ||
- Add the API Token to your projects secrets with the name `PYPI_TOKEN` by visiting [this page](https://github.com/GeoscienceAustralia/eo-tides/settings/secrets/actions/new). | ||
- Create a [new release](https://github.com/GeoscienceAustralia/eo-tides/releases/new) on Github. | ||
- Create a new tag in the form `*.*.*`. | ||
|
||
For more details, see [here](https://fpgmaas.github.io/cookiecutter-uv/features/cicd/#how-to-trigger-a-release). | ||
|
||
--- | ||
|
||
Repository initiated with [fpgmaas/cookiecutter-uv](https://github.com/fpgmaas/cookiecutter-uv). |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,61 @@ | ||
## Getting started | ||
|
||
### 1. Create a New Repository | ||
|
||
First, create a repository on GitHub with the same name as this project, and then run the following commands: | ||
|
||
```bash | ||
git init -b main | ||
git add . | ||
git commit -m "init commit" | ||
git remote add origin [email protected]:GeoscienceAustralia/eo-tides.git | ||
git push -u origin main | ||
``` | ||
|
||
### 2. Set Up Your Development Environment | ||
|
||
Then, install the environment and the pre-commit hooks with | ||
|
||
```bash | ||
make install | ||
``` | ||
|
||
This will also generate your `uv.lock` file | ||
|
||
### 3. Run the pre-commit hooks | ||
|
||
Initially, the CI/CD pipeline might be failing due to formatting issues. To resolve those run: | ||
|
||
```bash | ||
uv run pre-commit run -a | ||
``` | ||
|
||
### 4. Commit the changes | ||
|
||
Lastly, commit the changes made by the two steps above to your repository. | ||
|
||
```bash | ||
git add . | ||
git commit -m 'Fix formatting issues' | ||
git push origin main | ||
``` | ||
|
||
You are now ready to start development on your project! | ||
The CI/CD pipeline will be triggered when you open a pull request, merge to main, or when you create a new release. | ||
|
||
To finalize the set-up for publishing to PyPI, see [here](https://fpgmaas.github.io/cookiecutter-uv/features/publishing/#set-up-for-pypi). | ||
For activating the automatic documentation with MkDocs, see [here](https://fpgmaas.github.io/cookiecutter-uv/features/mkdocs/#enabling-the-documentation-on-github). | ||
To enable the code coverage reports, see [here](https://fpgmaas.github.io/cookiecutter-uv/features/codecov/). | ||
|
||
## Releasing a new version | ||
|
||
- Create an API Token on [PyPI](https://pypi.org/). | ||
- Add the API Token to your projects secrets with the name `PYPI_TOKEN` by visiting [this page](https://github.com/GeoscienceAustralia/eo-tides/settings/secrets/actions/new). | ||
- Create a [new release](https://github.com/GeoscienceAustralia/eo-tides/releases/new) on Github. | ||
- Create a new tag in the form `*.*.*`. | ||
|
||
For more details, see [here](https://fpgmaas.github.io/cookiecutter-uv/features/cicd/#how-to-trigger-a-release). | ||
|
||
--- | ||
|
||
Repository initiated with [fpgmaas/cookiecutter-uv](https://github.com/fpgmaas/cookiecutter-uv). |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters