Skip to content

Commit 10e2b51

Browse files
update README.md
1 parent fb2f900 commit 10e2b51

File tree

1 file changed

+11
-20
lines changed

1 file changed

+11
-20
lines changed

README.md

Lines changed: 11 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,10 @@
11
# Autosubmit API
22

3+
[![codecov](https://codecov.io/gh/BSC-ES/autosubmit-api/graph/badge.svg?token=ECJKA4M6GR)](https://codecov.io/gh/BSC-ES/autosubmit-api)
4+
![PyPI - Downloads](https://img.shields.io/pypi/dm/autosubmit-api)
5+
![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/BSC-ES/autosubmit-api/ci.yml)
6+
7+
38
# Table of Contents
49

510
1. [Overview](#overview)
@@ -13,7 +18,7 @@ Autosubmit API is a package that consumes the information generated by Autosubmi
1318

1419
Distribution: https://pypi.org/project/autosubmit-api/
1520

16-
See the `openapi.json` specification and the repository wiki for more information.
21+
Full documentation: https://autosubmit-api.readthedocs.io/
1722

1823
## Installation
1924

@@ -34,20 +39,12 @@ autosubmit_api start
3439

3540
## Configuration options
3641

37-
The Autosubmit API have some configuration options that can be modified by setting their specific environment variable before starting the server:
42+
The Autosubmit API have some configuration options that can be modified by setting their specific environment variable before starting the server. Here are some options:
3843

39-
- **`PROTECTION_LEVEL`**: Default `ALL`. Possible values `ALL`, `WRITEONLY`, `NONE`.
40-
- If set to `ALL`, all the endpoints will be protected by needing a valid token inside the `Authorization` header of the request.
41-
- If set to `WRITEONLY`, only a subset of the endpoints will be protected.
42-
- If set to `NONE`, none of the endpoints will be protected.
4344
- **`SECRET_KEY`**: The secret key to encode the JWT tokens from the Authorization Module. **Important to be set up on production.**
44-
- **`CAS_SERVER_URL`**: CAS Protocol server base URL to request a ticket and verify it. Used for `/v4` endpoints. `CAS_LOGIN_URL` and `CAS_VERIFY_URL` can be empty if this variable is set (the API will append the protocol URL subpaths).
45-
- **`CAS_LOGIN_URL`**: CAS Protocol URL to request a ticket. Used for `/v3` endpoints.
46-
- **`CAS_VERIFY_URL`**: CAS Protocol URL to verify a given ticket. Used for `/v3` endpoints.
47-
- **`GITHUB_OAUTH_CLIENT_ID`**: Client ID of the Github Oauth app.
48-
- **`GITHUB_OAUTH_CLIENT_SECRET`**: Secret key of the Github Oauth app.
49-
- **`GITHUB_OAUTH_WHITELIST_ORGANIZATION`**: Used to use authorization based on the membership of a Github organization.
50-
- **`GITHUB_OAUTH_WHITELIST_TEAM`**: Used to use authorization based on the membership of a Github team in an organization. `GITHUB_OAUTH_WHITELIST_ORGANIZATION` is required
45+
- **`AS_API_ROOT_PATH`**: The root path of the API. This is useful if you are serving it with a reverse proxy. Default is an empty string.
46+
47+
To see the full list go to: https://autosubmit-api.readthedocs.io/en/latest/configuration/
5148

5249
## How to run tests
5350

@@ -63,10 +60,4 @@ pip install -e .[test]
6360
pytest
6461
```
6562

66-
### Run tests with coverage HTML report:
67-
68-
```bash
69-
pytest --cov=autosubmit_api --cov-config=.coveragerc --cov-report=html tests/
70-
```
71-
72-
You will find the report in `htmlcov/index.html`
63+
You will find the coverage report in `htmlcov/index.html`

0 commit comments

Comments
 (0)