@voxgig/create-sdkgen 0.29.1 → 0.30.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md
CHANGED
|
@@ -33,7 +33,7 @@ generated output and is overwritten on each regenerate.
|
|
|
33
33
|
| Flag | Meaning |
|
|
34
34
|
| --- | --- |
|
|
35
35
|
| `<name>` | SDK name (kebab-case), the package base name |
|
|
36
|
-
| `-d, --def <spec>` | OpenAPI 3 spec file (`.yaml`/`.json`) |
|
|
36
|
+
| `-d, --def <spec>` | OpenAPI 3 spec file (`.yaml`/`.json`), with a `servers` entry naming the base URL of the API |
|
|
37
37
|
| `-o, --folder <dir>` | output directory (default `<name>-sdk`) |
|
|
38
38
|
| `-t, --target <langs>` | targets to add during scaffold (e.g. `ts,py,go`) |
|
|
39
39
|
| `-f, --feature <feats>` | features to add (e.g. `test`) |
|
|
@@ -88,6 +88,16 @@ such a project and re-scaffolds it.
|
|
|
88
88
|
- **[@voxgig/apidef](https://github.com/voxgig/apidef)** — parses your OpenAPI spec into the model.
|
|
89
89
|
- **[@voxgig/sdkgen](https://github.com/voxgig/sdkgen)** — generates the SDKs from the model.
|
|
90
90
|
|
|
91
|
+
The scaffold's `.sdk/package.json` pins each Voxgig toolchain package to the
|
|
92
|
+
patch line this release of create-sdkgen was released with: `~4.31.0` for
|
|
93
|
+
`@voxgig/sdkgen`, and likewise for `@voxgig/apidef`, `@voxgig/model` and
|
|
94
|
+
`@voxgig/docgen`. A release that carries these pins, pinned or not, scaffolds
|
|
95
|
+
a project that installs a toolchain able to drive what the scaffold wrote. A
|
|
96
|
+
release from before them declares open floors instead, so re-scaffold with one
|
|
97
|
+
that has them. Fixes arrive with `npm install`. A newer minor arrives with a
|
|
98
|
+
re-scaffold from the current create-sdkgen, which rewrites the pins, or by
|
|
99
|
+
editing the ranges by hand.
|
|
100
|
+
|
|
91
101
|
## Contributing
|
|
92
102
|
|
|
93
103
|
How to validate a change, and why a pull request from a fork gets no CI, are
|
|
@@ -98,7 +108,15 @@ in [`CONTRIBUTING.md`](./CONTRIBUTING.md). The documentation follows
|
|
|
98
108
|
|
|
99
109
|
New projects include `@voxgig/docgen`. Installing the `.sdk` dependencies adds
|
|
100
110
|
the `summary` and `github-pages` editions. `npm run generate` then produces
|
|
101
|
-
`SUMMARY.md` and
|
|
111
|
+
`SUMMARY.md` and a text QA workflow. The `github-pages` edition is off by
|
|
112
|
+
default. To generate the static HTML site in `docs/` and its GitHub Pages
|
|
113
|
+
deployment, turn it on in `.sdk/model/project.aontu`:
|
|
114
|
+
|
|
115
|
+
```aontu
|
|
116
|
+
main: kit: doc: edition: 'github-pages': active: true
|
|
117
|
+
```
|
|
118
|
+
|
|
119
|
+
With `--no-install`, setup happens when dependencies are installed.
|
|
102
120
|
|
|
103
121
|
Add the optional Slidev presentation from `.sdk`:
|
|
104
122
|
|
|
@@ -15,9 +15,16 @@ const APIDEF_WRITES_RE = /^model\/guide\/[^/]*base-guide\.aontu$/;
|
|
|
15
15
|
// Comments and strings are matched whole, so an include is only ever an `@`
|
|
16
16
|
// outside both: a `.aon` named in a comment or held as data is not rewritten.
|
|
17
17
|
const TOKEN_RE = /#[^\n]*|@([ \t]*)(["'`])([^"'`\n]*)\2|"(?:\\.|[^"\\\n])*"|'(?:\\.|[^'\\\n])*'|`(?:\\.|[^`\\])*`/g;
|
|
18
|
+
// A BARE FILENAME ALSO NEEDS `./`. aontu has required the prefix for a local
|
|
19
|
+
// file since 0.65, so rewriting only the extension left an include still
|
|
20
|
+
// refused, with "local files need a ./ prefix". An include already carrying a
|
|
21
|
+
// directory segment is unambiguous and is left alone.
|
|
22
|
+
function localPrefix(path) {
|
|
23
|
+
return path.includes('/') || path.startsWith('./') ? path : './' + path;
|
|
24
|
+
}
|
|
18
25
|
function rewriteIncludes(src, rename) {
|
|
19
26
|
return src.replace(TOKEN_RE, (token, space, quote, path) => null != quote && path.endsWith(LEGACY) && rename(path) ?
|
|
20
|
-
'@' + space + quote + path.slice(0, -LEGACY.length) + CURRENT + quote : token);
|
|
27
|
+
'@' + space + quote + localPrefix(path.slice(0, -LEGACY.length) + CURRENT) + quote : token);
|
|
21
28
|
}
|
|
22
29
|
function legacyIncludes(src) {
|
|
23
30
|
return [...src.matchAll(TOKEN_RE)]
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"migrate.js","sourceRoot":"","sources":["../../../src/project/standard/migrate.ts"],"names":[],"mappings":";;;;;
|
|
1
|
+
{"version":3,"file":"migrate.js","sourceRoot":"","sources":["../../../src/project/standard/migrate.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@voxgig/create-sdkgen",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.30.0",
|
|
4
4
|
"main": "dist/create-sdkgen.js",
|
|
5
5
|
"type": "commonjs",
|
|
6
6
|
"types": "dist/create-sdkgen.d.ts",
|
|
@@ -27,6 +27,8 @@
|
|
|
27
27
|
"watch": "tsc --build src test -w",
|
|
28
28
|
"build": "tsc --build src test",
|
|
29
29
|
"scan-prose": "python3 tools/check_prose.py",
|
|
30
|
+
"toolchain": "node build/toolchain.js",
|
|
31
|
+
"toolchain-check": "node build/toolchain.js --check",
|
|
30
32
|
"test-model": "voxgig-model project/.sdk/test/test.aontu",
|
|
31
33
|
"test-model-watch": "voxgig-model -w project/.sdk/test/test.aontu",
|
|
32
34
|
"clean": "rm -rf dist dist-test node_modules yarn.lock package-lock.json",
|
|
@@ -29,13 +29,13 @@
|
|
|
29
29
|
"devDependencies": {
|
|
30
30
|
"@types/node": ">=25.6",
|
|
31
31
|
"typescript": ">=6.0",
|
|
32
|
-
"@voxgig/apidef": "
|
|
33
|
-
"@voxgig/model": "
|
|
34
|
-
"@voxgig/sdkgen": "
|
|
32
|
+
"@voxgig/apidef": "~8.18.1",
|
|
33
|
+
"@voxgig/model": "~12.0.0",
|
|
34
|
+
"@voxgig/sdkgen": "~4.31.0",
|
|
35
35
|
"@voxgig/util": ">=0.5",
|
|
36
36
|
"@voxgig/struct": ">=0.2",
|
|
37
37
|
"jostraca": ">=0.39.0",
|
|
38
38
|
"aontu": ">=0.75.0",
|
|
39
|
-
"@voxgig/docgen": "
|
|
39
|
+
"@voxgig/docgen": "~0.30.0"
|
|
40
40
|
}
|
|
41
41
|
}
|
|
@@ -23,10 +23,19 @@ type Scaffold = {
|
|
|
23
23
|
}
|
|
24
24
|
|
|
25
25
|
|
|
26
|
+
// A BARE FILENAME ALSO NEEDS `./`. aontu has required the prefix for a local
|
|
27
|
+
// file since 0.65, so rewriting only the extension left an include still
|
|
28
|
+
// refused, with "local files need a ./ prefix". An include already carrying a
|
|
29
|
+
// directory segment is unambiguous and is left alone.
|
|
30
|
+
function localPrefix(path: string): string {
|
|
31
|
+
return path.includes('/') || path.startsWith('./') ? path : './' + path
|
|
32
|
+
}
|
|
33
|
+
|
|
34
|
+
|
|
26
35
|
function rewriteIncludes(src: string, rename: (path: string) => boolean): string {
|
|
27
36
|
return src.replace(TOKEN_RE, (token: string, space: string, quote: string, path: string) =>
|
|
28
37
|
null != quote && path.endsWith(LEGACY) && rename(path) ?
|
|
29
|
-
'@' + space + quote + path.slice(0, -LEGACY.length) + CURRENT + quote : token)
|
|
38
|
+
'@' + space + quote + localPrefix(path.slice(0, -LEGACY.length) + CURRENT) + quote : token)
|
|
30
39
|
}
|
|
31
40
|
|
|
32
41
|
|