You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+29-27Lines changed: 29 additions & 27 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,16 +2,6 @@
2
2
3
3
API service for KnowWhereGraph
4
4
5
-
## Running
6
-
7
-
To run the API in a production setting, deploy with docker
8
-
1.`docker build -t kwg-api .`
9
-
2.`docker run -d --name kwg-api -p 8080:8080 kwg-api`
10
-
11
-
Visit the redoc page at http://127.0.0.1:8080/redoc
12
-
13
-
Visit the swagger page at http://127.0.0.1:8080/docs
14
-
15
5
## Features
16
6
17
7
- Node de-referencing
@@ -29,23 +19,6 @@ poetry run black .
29
19
poetry run isort .
30
20
```
31
21
32
-
### Running Locally
33
-
34
-
The API can be run locally when developing. To run,
35
-
36
-
```bash
37
-
poetry install
38
-
poetry run uvicorn kwg_api.main:app --reload --port 80
39
-
```
40
-
41
-
#### Via Docker
42
-
43
-
The API can also be run using the `docker-compose.dev.yaml` file with
44
-
45
-
```commandline
46
-
docker-compose -f docker-compose.local.yaml up
47
-
```
48
-
49
22
### Testing
50
23
51
24
The unit tests can be run through pytest with
@@ -54,6 +27,7 @@ The unit tests can be run through pytest with
54
27
poetry run pytest
55
28
```
56
29
30
+
57
31
## Building Docs
58
32
59
33
The API uses the sphinx documentation formation. To build the documentation, first [install sphinx](https://www.sphinx-doc.org/en/master/usage/installation.html).
@@ -64,3 +38,31 @@ Then,
64
38
cd docs
65
39
make build
66
40
```
41
+
42
+
## Running
43
+
44
+
When the API is running, the following pages can be used to play with the endpoint
45
+
46
+
Visit the redoc page at http://127.0.0.1:8080/redoc
47
+
48
+
Visit the swagger page at http://127.0.0.1:8080/docs
49
+
50
+
51
+
The API can be run locally when developing. To run,
52
+
53
+
### For local Development
54
+
55
+
#### Non-Docker
56
+
57
+
```bash
58
+
poetry install
59
+
poetry run uvicorn kwg_api.main:app --reload --port 80
60
+
```
61
+
62
+
### With Docker
63
+
64
+
The API can also be run using the `docker-compose.dev.yaml` file with
0 commit comments