From 99a19a3688554fa2cf264c4437d26fd39b17d298 Mon Sep 17 00:00:00 2001 From: profitroll Date: Tue, 12 Mar 2024 13:06:37 +0100 Subject: [PATCH] Update library README --- README.md | 43 +++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 43 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..ec24830 --- /dev/null +++ b/README.md @@ -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