-
Notifications
You must be signed in to change notification settings - Fork 10
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Signed-off-by: Matthew Watkins <[email protected]>
- Loading branch information
1 parent
5271f2f
commit f8ac6bd
Showing
10 changed files
with
405 additions
and
101 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
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
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
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
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,14 +1,17 @@ | ||
# Contributing to phsyrisk-api | ||
|
||
## Getting started | ||
|
||
To get set up, clone and enter the repo. | ||
|
||
``` | ||
git clone [email protected]:os-climate/physrisk-api.git | ||
cd physrisk-api | ||
``` | ||
|
||
We recommend using [pipenv](https://pipenv.pypa.io/en/latest/) for a | ||
consistent working environment. | ||
|
||
``` | ||
pip install pipenv | ||
pipenv install | ||
|
@@ -20,8 +23,9 @@ When adding a package for use in new or improved functionality, | |
testing or development, `pipenv install -d <package-name>`. | ||
|
||
## Development | ||
|
||
Patches may be contributed via pull requests to | ||
https://github.com/os-climate/physrisk-api. | ||
<https://github.com/os-climate/physrisk-api>. | ||
|
||
All changes must pass the automated test suite, along with various static | ||
checks. | ||
|
@@ -30,13 +34,15 @@ checks. | |
[isort](https://pycqa.github.io/isort/) import ordering are enforced | ||
and enabling automatic formatting via [pre-commit](https://pre-commit.com/) | ||
is recommended: | ||
|
||
``` | ||
pre-commit install | ||
``` | ||
|
||
To ensure compliance with static check tools, developers may wish to run black and isort against modified files. | ||
|
||
E.g., | ||
|
||
``` | ||
# auto-sort imports | ||
isort . | ||
|
@@ -45,6 +51,7 @@ black . | |
``` | ||
|
||
Code can then be tested using tox. | ||
|
||
``` | ||
# run static checks and unit tests | ||
tox | ||
|
@@ -57,13 +64,16 @@ tox -e cov | |
``` | ||
|
||
To run the application locally, run either of the following commands; | ||
|
||
``` | ||
docker-compose up | ||
# or | ||
podman-compose up | ||
``` | ||
One may then make requests of https://0.0.0.0:8080. | ||
|
||
One may then make requests of <https://0.0.0.0:8080>. | ||
|
||
## Releasing | ||
|
||
Currently, this service is released automatically to quay.io and manually | ||
deployed onto OpenShift. |
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
Oops, something went wrong.