particle-os/debian-image-builder-frontend
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

README: update api generation

Browse source 
Since our codegen tool supports pulling in OpenAPI schemas from a url,
we no longer download the OpenAPI schema files. Update the README to
reflect the changes.
This commit is contained in:
Gianluca Zuccarelli 2025-07-23 10:32:33 +01:00 • committed by Klara Simickova
parent f86f81d6d5
commit 3d39065ad0
1 changed files with 11 additions and 22 deletions
Download patch file Download diff file Expand all files Collapse all files

33
README.md
View file

@ -128,19 +128,15 @@ see the [osbuild-getting-started project](https://github.com/osbuild/osbuild-get
API slice definitions are programmatically generated using the [@rtk-query/codegen-openapi](https://redux-toolkit.js.org/rtk-query/usage/code-generation) package. API slice definitions are programmatically generated using the [@rtk-query/codegen-openapi](https://redux-toolkit.js.org/rtk-query/usage/code-generation) package.
OpenAPI schema for the endpoints are stored in `/api/schema`. Their The OpenAPI schema are imported during code generation. OpenAPI configuration files are
corresponding configuration files are stored in `/api/config`. Each endpoint stored in `/api/config`. Each endpoint has a corresponding empty API slice and generated API
has a corresponding empty API slice and generated API slice which are stored in slice which are stored in `/src/store`.
`/src/store`.
### Add a new API schema ### Add a new API schema
For a hypothetical API called foobar For a hypothetical API called foobar
1. Download the foobar API OpenAPI json or yaml representation under 1. Create a new "empty" API file under `src/store/emptyFoobarApi.ts` that has following
`api/schema/foobar.json`
2. Create a new "empty" API file under `src/store/emptyFoobarApi.ts` that has following
content: content:
```typescript ```typescript
@ -156,19 +152,19 @@ export const emptyFoobarApi = createApi({
}); });
``` ```
3. Declare new constant `FOOBAR_API` with the API url in `src/constants.ts` 2. Declare new constant `FOOBAR_API` with the API url in `src/constants.ts`
```typescript ```typescript
export const FOOBAR_API = 'api/foobar/v1' export const FOOBAR_API = 'api/foobar/v1'
``` ```
4. Create the config file for code generation in `api/config/foobar.ts` containing: 3. Create the config file for code generation in `api/config/foobar.ts` containing:
```typescript ```typescript
import type { ConfigFile } from '@rtk-query/codegen-openapi'; import type { ConfigFile } from '@rtk-query/codegen-openapi';
const config: ConfigFile = { const config: ConfigFile = {
schemaFile: '../schema/foobar.json', schemaFile: 'URL_TO_THE_OPENAPI_SCHEMA',
apiFile: '../../src/store/emptyFoobarApi.ts', apiFile: '../../src/store/emptyFoobarApi.ts',
apiImport: 'emptyEdgeApi', apiImport: 'emptyEdgeApi',
outputFile: '../../src/store/foobarApi.ts', outputFile: '../../src/store/foobarApi.ts',
@ -178,14 +174,7 @@ const config: ConfigFile = {
}; };
``` ```
5. Update the `api.sh` script by adding a new line for npx to generate the code: 4. Update the `eslint.config.js` file by adding the generated code path to the ignores array:
```bash
npx @rtk-query/codegen-openapi ./api/config/foobar.ts &
```
6. Update the `eslint.config.js` file by adding the generated code path to the ignores array:
``` ```
ignores: [ ignores: [
@ -194,7 +183,7 @@ ignores: [
] ]
``` ```
7. run api generation 5. run api generation
```bash ```bash
npm run api npm run api
@ -355,12 +344,12 @@ Follow these steps to find and paste the certification file into the 'Keychain A
npm ci npm ci
``` ```
3. Download the Playwright browsers with 3. Download the Playwright browsers with
```bash ```bash
npx playwright install npx playwright install
``` ```
4. Start the local development stage server by running 4. Start the local development stage server by running
```bash ```bash
npm run start:stage npm run start:stage
``` ```