Update library README
This commit is contained in:
parent
35aa61a83a
commit
99a19a3688
43
README.md
Normal file
43
README.md
Normal file
@ -0,0 +1,43 @@
|
|||||||
|
# PhotosAPI_Client
|
||||||
|
|
||||||
|
Generated using [openapi-python-client](https://github.com/openapi-generators/openapi-python-client) client library for [PhotosAPI](https://git.end-play.xyz/profitroll/PhotosAPI)
|
||||||
|
|
||||||
|
## Usage
|
||||||
|
|
||||||
|
Please, refer to [library README](PhotosAPI_Client/README.md)
|
||||||
|
|
||||||
|
## Building / generating this Client
|
||||||
|
|
||||||
|
This project is separated into to parts:
|
||||||
|
|
||||||
|
1. The generator (located where this README is)
|
||||||
|
2. The generated library (located under `PhotosAPI_Client/`)
|
||||||
|
|
||||||
|
### Generating
|
||||||
|
|
||||||
|
1. Create a virtual environment `.venv` in the repository root:
|
||||||
|
`python -m venv .venv` / `virtualenv .venv`
|
||||||
|
2. Use this virtual environment:
|
||||||
|
`source .venv/bin/activate` / `.venv\Scripts\activate.ps1`
|
||||||
|
3. Install the dependencies:
|
||||||
|
`pip install -r requirements.txt`
|
||||||
|
4. Generate/update the client:
|
||||||
|
* Generate: `.openapi-python-client generate --config config.yaml --url "OPENAPI_SPEC_URL"` (replace `OPENAPI_SPEC_URL` with your URL)
|
||||||
|
* Update: `openapi-python-client update --config config.yaml --url "OPENAPI_SPEC_URL"` (replace `OPENAPI_SPEC_URL` with your URL)
|
||||||
|
|
||||||
|
### Building
|
||||||
|
|
||||||
|
1. Create a virtual environment `.venv` in the repository root:
|
||||||
|
`python -m venv .venv` / `virtualenv .venv`
|
||||||
|
2. Use this virtual environment:
|
||||||
|
`source .venv/bin/activate` / `.venv\Scripts\activate.ps1`
|
||||||
|
3. Install the dependencies:
|
||||||
|
`pip install -r requirements.txt`
|
||||||
|
4. Build the client:
|
||||||
|
`python -m build ./PhotosAPI_Client`
|
||||||
|
5. Artifacts can be found under `PhotosAPI_Client/dist`
|
||||||
|
|
||||||
|
### Generating and building with VSCode
|
||||||
|
|
||||||
|
1. Steps about virtual environments **MUST** be completed first
|
||||||
|
2. Use `Terminal > Run Task` to select the task you want to start
|
Loading…
Reference in New Issue
Block a user