monosmith-plugin-sdk 0.4.0__tar.gz → 2.0.0b1__tar.gz
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.
Potentially problematic release.
This version of monosmith-plugin-sdk might be problematic. Click here for more details.
- {monosmith_plugin_sdk-0.4.0/src/monosmith_plugin_sdk.egg-info → monosmith_plugin_sdk-2.0.0b1}/PKG-INFO +1 -1
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/pyproject.toml +1 -1
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk/__init__.py +6 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk/protocol/protocol_schema_contract.py +397 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk/protocol/protocol_types_contract.py +349 -2
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk/serve/__init__.py +6 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk/serve/plugin_contract.py +24 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk/serve/plugin_members_config.py +3 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1/src/monosmith_plugin_sdk.egg-info}/PKG-INFO +1 -1
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/LICENSE +0 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/README.md +0 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/setup.cfg +0 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk/build_dir/__init__.py +0 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk/build_dir/build_dir_algorithm.py +0 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk/cancellation/__init__.py +0 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk/cancellation/cancel_token_model.py +0 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk/cancellation/request_cancelled_error.py +0 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk/ci/__init__.py +0 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk/ci/ci_contribution_algorithm.py +0 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk/codec/__init__.py +0 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk/codec/encode_by_schema_algorithm.py +0 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk/codec/encode_error.py +0 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk/codec/encode_json_value_algorithm.py +0 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk/codec/message_parse_error.py +0 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk/codec/method_codec_algorithm.py +0 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk/codec/normalize_by_schema_algorithm.py +0 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk/codec/params_error.py +0 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk/codec/received_message_contract.py +0 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk/codec/schema_lookup_algorithm.py +0 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk/codec/wire_message_mapper.py +0 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk/concurrency/__init__.py +0 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk/concurrency/concurrency_policy.py +0 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk/conformance/__init__.py +0 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk/conformance/check_generation_use_case.py +0 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk/conformance/check_kind_change_use_case.py +0 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk/conformance/check_plugin_use_case.py +0 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk/conformance/check_scheduling_use_case.py +0 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk/conformance/conformance_report_model.py +0 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk/conformance/find_manifests_algorithm.py +0 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk/conformance/go_list_mapper.py +0 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk/framing/__init__.py +0 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk/framing/frame_message_algorithm.py +0 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk/framing/frame_reader_store.py +0 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk/framing/framing_error.py +0 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk/host/__init__.py +0 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk/host/call_interrupted_error.py +0 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk/host/connect_plugin_use_case.py +0 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk/host/host_options_contract.py +0 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk/host/plugin_client_client.py +0 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk/host/start_plugin_use_case.py +0 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk/jsondoc/__init__.py +0 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk/jsondoc/indent_raw_json_algorithm.py +0 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk/jsondoc/json_document_error.py +0 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk/jsondoc/json_document_model.py +0 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk/jsondoc/scan_json_object_algorithm.py +0 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk/plugin_refs/__init__.py +0 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk/plugin_refs/plugin_ref_policy.py +0 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk/plugin_roles/__init__.py +0 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk/plugin_roles/plugin_role_policy.py +0 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk/projects/__init__.py +0 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk/projects/audit_settings_policy.py +0 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk/projects/manifest_match_algorithm.py +0 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk/projects/project_kind_policy.py +0 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk/projects/publishes_policy.py +0 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk/projects/set_toolchain_algorithm.py +0 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk/projects/stack_plugins_algorithm.py +0 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk/protocol/__init__.py +0 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk/protocol/rpc_error.py +0 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk/py.typed +0 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk/scaffold/__init__.py +0 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk/scaffold/scaffold_data_mapper.py +0 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk/scaffold/scaffold_project_use_case.py +0 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk/serve/capabilities_of_algorithm.py +0 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk/serve/claim_stdio_use_case.py +0 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk/serve/dispatch_request_use_case.py +0 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk/serve/frame_writer_store.py +0 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk/serve/initialize_plugin_use_case.py +0 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk/serve/protocol_streams_contract.py +0 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk/serve/request_outcome_contract.py +0 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk/serve/request_pool_store.py +0 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk/serve/serve_use_case.py +0 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk/tasks/__init__.py +0 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk/tasks/contribute_tasks_algorithm.py +0 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk/tasks/task_algorithm.py +0 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk/templating/__init__.py +0 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk/templating/file_exists_error.py +0 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk/templating/parse_template_algorithm.py +0 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk/templating/render_template_algorithm.py +0 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk/templating/template_error.py +0 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk/templating/template_functions_algorithm.py +0 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk/templating/template_syntax_contract.py +0 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk/templating/tokenize_action_algorithm.py +0 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk/templating/write_templates_use_case.py +0 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk.egg-info/SOURCES.txt +0 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk.egg-info/dependency_links.txt +0 -0
- {monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk.egg-info/top_level.txt +0 -0
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: monosmith-plugin-sdk
|
|
3
|
-
Version: 0.
|
|
3
|
+
Version: 2.0.0b1
|
|
4
4
|
Summary: The Python SDK for writing smith plugins: the protocol's types, the serve loop, a test host, the conformance checks, templating and key-order-keeping JSON editing. No runtime dependencies.
|
|
5
5
|
Author: Eduardo Russo
|
|
6
6
|
License-Expression: MIT
|
|
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
|
|
|
4
4
|
|
|
5
5
|
[project]
|
|
6
6
|
name = "monosmith-plugin-sdk"
|
|
7
|
-
version = "0.
|
|
7
|
+
version = "2.0.0-beta.1"
|
|
8
8
|
description = "The Python SDK for writing smith plugins: the protocol's types, the serve loop, a test host, the conformance checks, templating and key-order-keeping JSON editing. No runtime dependencies."
|
|
9
9
|
readme = "README.md"
|
|
10
10
|
requires-python = ">=3.10"
|
{monosmith_plugin_sdk-0.4.0 → monosmith_plugin_sdk-2.0.0b1}/src/monosmith_plugin_sdk/__init__.py
RENAMED
|
@@ -90,10 +90,13 @@ from .projects import (
|
|
|
90
90
|
from .protocol import * # noqa: F403
|
|
91
91
|
from .scaffold import scaffold_data, scaffold_project
|
|
92
92
|
from .serve import (
|
|
93
|
+
APISurfaceReader,
|
|
93
94
|
CIContributor,
|
|
95
|
+
ComponentLister,
|
|
94
96
|
Contributor,
|
|
95
97
|
DeclarationEditor,
|
|
96
98
|
DependencyManager,
|
|
99
|
+
Deriver,
|
|
97
100
|
Discoverer,
|
|
98
101
|
DoctorContributor,
|
|
99
102
|
Generator,
|
|
@@ -127,6 +130,9 @@ __all__ = [
|
|
|
127
130
|
"Remover",
|
|
128
131
|
"KindChanger",
|
|
129
132
|
"DependencyManager",
|
|
133
|
+
"Deriver",
|
|
134
|
+
"APISurfaceReader",
|
|
135
|
+
"ComponentLister",
|
|
130
136
|
"DeclarationEditor",
|
|
131
137
|
"LatestReader",
|
|
132
138
|
"Contributor",
|
|
@@ -219,6 +219,39 @@ _SCHEMA_JSON = r'''{
|
|
|
219
219
|
},
|
|
220
220
|
"capability": "latest",
|
|
221
221
|
"notification": false
|
|
222
|
+
},
|
|
223
|
+
"sbom/components": {
|
|
224
|
+
"description": "Asks which components a project ships (its locked dependencies, read from a lockfile where the ecosystem has one and from the manifest otherwise), as package URLs, for the SBOM a release attaches.",
|
|
225
|
+
"params": {
|
|
226
|
+
"$ref": "#/$defs/ComponentsParams"
|
|
227
|
+
},
|
|
228
|
+
"result": {
|
|
229
|
+
"$ref": "#/$defs/ComponentsResult"
|
|
230
|
+
},
|
|
231
|
+
"capability": "components",
|
|
232
|
+
"notification": false
|
|
233
|
+
},
|
|
234
|
+
"derive": {
|
|
235
|
+
"description": "Asks which files a plugin derives from facts and the project graph (a tsconfig's references, a test config's display name). The plugin writes nothing: it answers with the content, and the host rewrites a file only when its ownership record allows.",
|
|
236
|
+
"params": {
|
|
237
|
+
"$ref": "#/$defs/DeriveParams"
|
|
238
|
+
},
|
|
239
|
+
"result": {
|
|
240
|
+
"$ref": "#/$defs/DeriveResult"
|
|
241
|
+
},
|
|
242
|
+
"capability": "derive",
|
|
243
|
+
"notification": false
|
|
244
|
+
},
|
|
245
|
+
"api/surface": {
|
|
246
|
+
"description": "Asks for the public API names of a project, at the working tree or at a git revision (its last release tag), so a release can compare them and say what bump the change needs.",
|
|
247
|
+
"params": {
|
|
248
|
+
"$ref": "#/$defs/APISurfaceParams"
|
|
249
|
+
},
|
|
250
|
+
"result": {
|
|
251
|
+
"$ref": "#/$defs/APISurfaceResult"
|
|
252
|
+
},
|
|
253
|
+
"capability": "apiSurface",
|
|
254
|
+
"notification": false
|
|
222
255
|
}
|
|
223
256
|
},
|
|
224
257
|
"x-errorCodes": [
|
|
@@ -299,6 +332,42 @@ _SCHEMA_JSON = r'''{
|
|
|
299
332
|
}
|
|
300
333
|
],
|
|
301
334
|
"$defs": {
|
|
335
|
+
"APISurfaceParams": {
|
|
336
|
+
"description": "APISurfaceParams asks a plugin for the public API names of one project.",
|
|
337
|
+
"type": "object",
|
|
338
|
+
"properties": {
|
|
339
|
+
"project": {
|
|
340
|
+
"$ref": "#/$defs/Project"
|
|
341
|
+
},
|
|
342
|
+
"ref": {
|
|
343
|
+
"type": "string",
|
|
344
|
+
"description": "Ref is the git revision to read the project at (the tag of its last release). Empty means the working tree."
|
|
345
|
+
}
|
|
346
|
+
},
|
|
347
|
+
"required": [
|
|
348
|
+
"project"
|
|
349
|
+
]
|
|
350
|
+
},
|
|
351
|
+
"APISurfaceResult": {
|
|
352
|
+
"description": "APISurfaceResult is the public API of a project: the names its entry points export. A host compares the names of two revisions; it never reads their meaning, so a plugin chooses its own spelling and keeps it stable.",
|
|
353
|
+
"type": "object",
|
|
354
|
+
"properties": {
|
|
355
|
+
"names": {
|
|
356
|
+
"type": "array",
|
|
357
|
+
"items": {
|
|
358
|
+
"type": "string"
|
|
359
|
+
},
|
|
360
|
+
"description": "Names are the exported names, sorted. A name an entry point other than the main one exports is prefixed with that entry point and a colon (\"./cli:run\"). An empty list is an answer: the project exports nothing."
|
|
361
|
+
},
|
|
362
|
+
"unreadable": {
|
|
363
|
+
"type": "string",
|
|
364
|
+
"description": "Unreadable says why the API could not be listed (no entry point, no source at the revision). When set, Names is empty and the host skips the project without a warning."
|
|
365
|
+
}
|
|
366
|
+
},
|
|
367
|
+
"required": [
|
|
368
|
+
"names"
|
|
369
|
+
]
|
|
370
|
+
},
|
|
302
371
|
"ActionStep": {
|
|
303
372
|
"description": "ActionStep is a provider-native step: a GitHub action or an Azure task, with its inputs in the order they are written.",
|
|
304
373
|
"type": "object",
|
|
@@ -543,6 +612,22 @@ _SCHEMA_JSON = r'''{
|
|
|
543
612
|
"cancel": {
|
|
544
613
|
"type": "boolean",
|
|
545
614
|
"description": "Cancel says the plugin stops the work of a request when the host sends a cancel notification with its id, then answers that request with its result (if the work was already done) or the request-cancelled error. A host never sends the notification to a plugin without it."
|
|
615
|
+
},
|
|
616
|
+
"components": {
|
|
617
|
+
"type": "boolean",
|
|
618
|
+
"description": "Components lists a project's dependencies for its SBOM."
|
|
619
|
+
},
|
|
620
|
+
"derive": {
|
|
621
|
+
"type": "boolean",
|
|
622
|
+
"description": "Derive says which files the plugin derives from facts and the project graph (smith derive)."
|
|
623
|
+
},
|
|
624
|
+
"apiSurface": {
|
|
625
|
+
"type": "boolean",
|
|
626
|
+
"description": "APISurface lists the names a project exports, at a git revision, so a release can warn when the commits ask for a smaller bump than the API change needs."
|
|
627
|
+
},
|
|
628
|
+
"channels": {
|
|
629
|
+
"type": "boolean",
|
|
630
|
+
"description": "Channels says a prerelease version the plugin publishes never takes the place of the stable one: the plugin publishes under PublishParams.Tag, a release channel's name, without moving the registry's stable pointer (npm's latest), or its registry orders a prerelease below the release (PyPI, NuGet) and needs no tag. A host does not publish a package of a release channel with a plugin that lacks it."
|
|
546
631
|
}
|
|
547
632
|
}
|
|
548
633
|
},
|
|
@@ -600,6 +685,124 @@ _SCHEMA_JSON = r'''{
|
|
|
600
685
|
}
|
|
601
686
|
}
|
|
602
687
|
},
|
|
688
|
+
"Choice": {
|
|
689
|
+
"description": "Choice is one option on an axis of a project's make-up: a framework, a test runner, a style library. A plugin publishes the choices it owns in InitializeResult.Choices; the host checks a selection of them (smith add --with react,vitest,bootstrap) and turns it into a stack. What a choice writes (dependencies, tasks, files) stays with the plugin: the host never sees it.",
|
|
690
|
+
"type": "object",
|
|
691
|
+
"properties": {
|
|
692
|
+
"axis": {
|
|
693
|
+
"type": "string",
|
|
694
|
+
"description": "Axis is the question the choice answers: \"framework\", \"test\", \"style\", \"lint\". The plugins agree on the name; the host only compares it."
|
|
695
|
+
},
|
|
696
|
+
"name": {
|
|
697
|
+
"type": "string",
|
|
698
|
+
"description": "Name identifies the choice in a selection and is unique among the choices of all loaded plugins."
|
|
699
|
+
},
|
|
700
|
+
"description": {
|
|
701
|
+
"type": "string"
|
|
702
|
+
},
|
|
703
|
+
"language": {
|
|
704
|
+
"type": "string",
|
|
705
|
+
"description": "Language is the language plugin the choice applies to (\"node\")."
|
|
706
|
+
},
|
|
707
|
+
"roles": {
|
|
708
|
+
"type": "array",
|
|
709
|
+
"items": {
|
|
710
|
+
"$ref": "#/$defs/Role"
|
|
711
|
+
},
|
|
712
|
+
"description": "Roles are the roles the choice's plugin plays in a stack built from it: scaffold (it writes the project) and/or toolchain (it joins the toolchain). Empty means it only adds to what a plugin of the selection already writes, as a style does."
|
|
713
|
+
},
|
|
714
|
+
"needs": {
|
|
715
|
+
"type": "array",
|
|
716
|
+
"items": {
|
|
717
|
+
"type": "string"
|
|
718
|
+
},
|
|
719
|
+
"description": "Needs are axes that the selection must have a choice on. An axis the person leaves out is filled with the default of the axis."
|
|
720
|
+
},
|
|
721
|
+
"default": {
|
|
722
|
+
"type": "boolean",
|
|
723
|
+
"description": "Default marks the choice the host adds when a selection needs its axis and has no choice on it."
|
|
724
|
+
},
|
|
725
|
+
"many": {
|
|
726
|
+
"type": "boolean",
|
|
727
|
+
"description": "Many allows the choice next to other choices of its axis that are Many too. By default a selection has one choice per axis."
|
|
728
|
+
},
|
|
729
|
+
"requires": {
|
|
730
|
+
"type": "array",
|
|
731
|
+
"items": {
|
|
732
|
+
"type": "string"
|
|
733
|
+
},
|
|
734
|
+
"description": "Requires are choices that must be in the selection."
|
|
735
|
+
},
|
|
736
|
+
"conflicts": {
|
|
737
|
+
"type": "array",
|
|
738
|
+
"items": {
|
|
739
|
+
"type": "string"
|
|
740
|
+
},
|
|
741
|
+
"description": "Conflicts are choices that must not be in the selection."
|
|
742
|
+
}
|
|
743
|
+
},
|
|
744
|
+
"required": [
|
|
745
|
+
"axis",
|
|
746
|
+
"name",
|
|
747
|
+
"language"
|
|
748
|
+
]
|
|
749
|
+
},
|
|
750
|
+
"Component": {
|
|
751
|
+
"description": "Component is one dependency of a project.",
|
|
752
|
+
"type": "object",
|
|
753
|
+
"properties": {
|
|
754
|
+
"name": {
|
|
755
|
+
"type": "string"
|
|
756
|
+
},
|
|
757
|
+
"version": {
|
|
758
|
+
"type": "string",
|
|
759
|
+
"description": "Version is the locked version, or the declared range when the project has no lockfile."
|
|
760
|
+
},
|
|
761
|
+
"purl": {
|
|
762
|
+
"type": "string",
|
|
763
|
+
"description": "PURL is the package URL (https://github.com/package-url/purl-spec)."
|
|
764
|
+
}
|
|
765
|
+
},
|
|
766
|
+
"required": [
|
|
767
|
+
"name",
|
|
768
|
+
"purl"
|
|
769
|
+
]
|
|
770
|
+
},
|
|
771
|
+
"ComponentsParams": {
|
|
772
|
+
"description": "ComponentsParams asks a plugin for the components one of its projects ships: what a CycloneDX SBOM lists.",
|
|
773
|
+
"type": "object",
|
|
774
|
+
"properties": {
|
|
775
|
+
"project": {
|
|
776
|
+
"$ref": "#/$defs/Project"
|
|
777
|
+
}
|
|
778
|
+
},
|
|
779
|
+
"required": [
|
|
780
|
+
"project"
|
|
781
|
+
]
|
|
782
|
+
},
|
|
783
|
+
"ComponentsResult": {
|
|
784
|
+
"description": "ComponentsResult lists the components, read from a lockfile where the ecosystem has one and from the manifest otherwise. An empty list is an answer: the project declares no dependencies.",
|
|
785
|
+
"type": "object",
|
|
786
|
+
"properties": {
|
|
787
|
+
"components": {
|
|
788
|
+
"type": "array",
|
|
789
|
+
"items": {
|
|
790
|
+
"$ref": "#/$defs/Component"
|
|
791
|
+
}
|
|
792
|
+
},
|
|
793
|
+
"source": {
|
|
794
|
+
"type": "string",
|
|
795
|
+
"description": "Source is the workspace-relative file the list was read from, \"\" when the project has none."
|
|
796
|
+
},
|
|
797
|
+
"purl": {
|
|
798
|
+
"type": "string",
|
|
799
|
+
"description": "PURL is the project's own package URL when it has a registry identity (without a version: the release supplies it); \"\" otherwise."
|
|
800
|
+
}
|
|
801
|
+
},
|
|
802
|
+
"required": [
|
|
803
|
+
"components"
|
|
804
|
+
]
|
|
805
|
+
},
|
|
603
806
|
"ContributeParams": {
|
|
604
807
|
"description": "ContributeParams hands a plugin the projects it applies to: those whose stack includes it, or, for a workspace-wide convention, those of the languages it supports that smith.toml enables it for.",
|
|
605
808
|
"type": "object",
|
|
@@ -658,6 +861,10 @@ _SCHEMA_JSON = r'''{
|
|
|
658
861
|
"release": {
|
|
659
862
|
"$ref": "#/$defs/ReleaseDefaults",
|
|
660
863
|
"description": "Release is how the project's release files are made, for a project that releases through GitHub releases and leaves them out of its smith.toml [projects.<name>.release] table; what the table sets wins."
|
|
864
|
+
},
|
|
865
|
+
"facts": {
|
|
866
|
+
"type": "object",
|
|
867
|
+
"description": "Facts are the plugin's default facts for the project: typed values under namespaced keys ({\"source.roots\": [\"src\"]}) that other settings and plugins read through the merged Project.Facts. They are the lowest scope: a [facts] table in smith.toml wins over them, and two plugins that publish different values for one key are an error that names both."
|
|
661
868
|
}
|
|
662
869
|
}
|
|
663
870
|
},
|
|
@@ -785,6 +992,114 @@ _SCHEMA_JSON = r'''{
|
|
|
785
992
|
}
|
|
786
993
|
}
|
|
787
994
|
},
|
|
995
|
+
"DeriveParams": {
|
|
996
|
+
"description": "DeriveParams asks a plugin for the files it can derive from facts and the project graph. The plugin writes nothing: it answers with the content, and the host decides, from its ownership record, whether to write it.",
|
|
997
|
+
"type": "object",
|
|
998
|
+
"properties": {
|
|
999
|
+
"projects": {
|
|
1000
|
+
"type": "array",
|
|
1001
|
+
"items": {
|
|
1002
|
+
"$ref": "#/$defs/Project"
|
|
1003
|
+
},
|
|
1004
|
+
"description": "Projects are the projects the plugin serves."
|
|
1005
|
+
},
|
|
1006
|
+
"graph": {
|
|
1007
|
+
"type": "object",
|
|
1008
|
+
"additionalProperties": {
|
|
1009
|
+
"type": "array",
|
|
1010
|
+
"items": {
|
|
1011
|
+
"type": "string"
|
|
1012
|
+
}
|
|
1013
|
+
},
|
|
1014
|
+
"description": "Graph maps a project name to the names of the projects it depends on inside the workspace, sorted. The host resolved these edges: a plugin does not repeat that work."
|
|
1015
|
+
},
|
|
1016
|
+
"owned": {
|
|
1017
|
+
"type": "array",
|
|
1018
|
+
"items": {
|
|
1019
|
+
"type": "string"
|
|
1020
|
+
},
|
|
1021
|
+
"description": "Owned are the workspace-relative paths the host's ownership record says smith owns. A plugin proposes such a file again even when it is missing on disk, so deleting a derived file and deriving restores it. A file that is not owned and not on disk is not proposed."
|
|
1022
|
+
}
|
|
1023
|
+
},
|
|
1024
|
+
"required": [
|
|
1025
|
+
"projects"
|
|
1026
|
+
]
|
|
1027
|
+
},
|
|
1028
|
+
"DeriveResult": {
|
|
1029
|
+
"description": "DeriveResult carries the files a plugin derives.",
|
|
1030
|
+
"type": "object",
|
|
1031
|
+
"properties": {
|
|
1032
|
+
"files": {
|
|
1033
|
+
"type": "array",
|
|
1034
|
+
"items": {
|
|
1035
|
+
"$ref": "#/$defs/DerivedFile"
|
|
1036
|
+
}
|
|
1037
|
+
},
|
|
1038
|
+
"diverging": {
|
|
1039
|
+
"type": "array",
|
|
1040
|
+
"items": {
|
|
1041
|
+
"$ref": "#/$defs/DivergentFile"
|
|
1042
|
+
},
|
|
1043
|
+
"description": "Diverging are files a renderer looked at and left alone because they differ from the shape their siblings share. They are not drift: the project owns them. The host shows them in `smith derive --explain` and in the doctor, and never writes them."
|
|
1044
|
+
}
|
|
1045
|
+
},
|
|
1046
|
+
"required": [
|
|
1047
|
+
"files"
|
|
1048
|
+
]
|
|
1049
|
+
},
|
|
1050
|
+
"DerivedFile": {
|
|
1051
|
+
"description": "DerivedFile is the content one renderer derives for one file.",
|
|
1052
|
+
"type": "object",
|
|
1053
|
+
"properties": {
|
|
1054
|
+
"project": {
|
|
1055
|
+
"type": "string",
|
|
1056
|
+
"description": "Project is the project the file belongs to."
|
|
1057
|
+
},
|
|
1058
|
+
"path": {
|
|
1059
|
+
"type": "string",
|
|
1060
|
+
"description": "Path is workspace-relative, with forward slashes."
|
|
1061
|
+
},
|
|
1062
|
+
"mode": {
|
|
1063
|
+
"type": "string",
|
|
1064
|
+
"description": "Mode is DeriveFile, DeriveRegion or DeriveKeys."
|
|
1065
|
+
},
|
|
1066
|
+
"renderer": {
|
|
1067
|
+
"type": "string",
|
|
1068
|
+
"description": "Renderer is the stable id of the renderer, for example \"node.tsconfig.references\". It names the region markers."
|
|
1069
|
+
},
|
|
1070
|
+
"version": {
|
|
1071
|
+
"type": "integer",
|
|
1072
|
+
"description": "Version is the renderer's version. A new version means new output for the same inputs, so the host rewrites an unedited file."
|
|
1073
|
+
},
|
|
1074
|
+
"content": {
|
|
1075
|
+
"type": "string",
|
|
1076
|
+
"description": "Content is the whole file (DeriveFile) or the lines of the region (DeriveRegion), without the markers. Unused for DeriveKeys."
|
|
1077
|
+
},
|
|
1078
|
+
"comment": {
|
|
1079
|
+
"type": "string",
|
|
1080
|
+
"description": "Comment is the line comment leader of the file (\"//\", \"#\"): the host writes a generated header after it in a DeriveFile. Empty for a format without comments, then the file has no header."
|
|
1081
|
+
},
|
|
1082
|
+
"format": {
|
|
1083
|
+
"type": "string",
|
|
1084
|
+
"description": "Format is \"json\" or \"toml\" for DeriveKeys."
|
|
1085
|
+
},
|
|
1086
|
+
"table": {
|
|
1087
|
+
"type": "string",
|
|
1088
|
+
"description": "Table is the TOML table that holds the keys (\"tool.smith\"); required for \"toml\", unused for \"json\", whose keys are the top-level ones."
|
|
1089
|
+
},
|
|
1090
|
+
"keys": {
|
|
1091
|
+
"type": "object",
|
|
1092
|
+
"description": "Keys are the owned keys and their values (DeriveKeys). A TOML value is a string, a number, a boolean or an array of those."
|
|
1093
|
+
}
|
|
1094
|
+
},
|
|
1095
|
+
"required": [
|
|
1096
|
+
"project",
|
|
1097
|
+
"path",
|
|
1098
|
+
"mode",
|
|
1099
|
+
"renderer",
|
|
1100
|
+
"version"
|
|
1101
|
+
]
|
|
1102
|
+
},
|
|
788
1103
|
"DevcontainerFeature": {
|
|
789
1104
|
"description": "DevcontainerFeature is a dev container feature and its options (https://containers.dev/features).",
|
|
790
1105
|
"type": "object",
|
|
@@ -834,6 +1149,34 @@ _SCHEMA_JSON = r'''{
|
|
|
834
1149
|
"projects"
|
|
835
1150
|
]
|
|
836
1151
|
},
|
|
1152
|
+
"DivergentFile": {
|
|
1153
|
+
"description": "DivergentFile is a file a renderer does not derive because the project made it differ from its siblings.",
|
|
1154
|
+
"type": "object",
|
|
1155
|
+
"properties": {
|
|
1156
|
+
"project": {
|
|
1157
|
+
"type": "string",
|
|
1158
|
+
"description": "Project is the project the file belongs to."
|
|
1159
|
+
},
|
|
1160
|
+
"path": {
|
|
1161
|
+
"type": "string",
|
|
1162
|
+
"description": "Path is workspace-relative, with forward slashes."
|
|
1163
|
+
},
|
|
1164
|
+
"renderer": {
|
|
1165
|
+
"type": "string",
|
|
1166
|
+
"description": "Renderer is the stable id of the renderer that compared the file."
|
|
1167
|
+
},
|
|
1168
|
+
"detail": {
|
|
1169
|
+
"type": "string",
|
|
1170
|
+
"description": "Detail says in a sentence how the file differs from its siblings."
|
|
1171
|
+
}
|
|
1172
|
+
},
|
|
1173
|
+
"required": [
|
|
1174
|
+
"project",
|
|
1175
|
+
"path",
|
|
1176
|
+
"renderer",
|
|
1177
|
+
"detail"
|
|
1178
|
+
]
|
|
1179
|
+
},
|
|
837
1180
|
"DoctorParams": {
|
|
838
1181
|
"description": "DoctorParams gives the plugin its projects to check.",
|
|
839
1182
|
"type": "object",
|
|
@@ -1050,6 +1393,24 @@ _SCHEMA_JSON = r'''{
|
|
|
1050
1393
|
"settings": {
|
|
1051
1394
|
"type": "object",
|
|
1052
1395
|
"description": "Settings are this plugin's own settings for the new project, from the recipe the project is created from (its settings.<plugin> table); the same table is later the plugin's entry in Project.Settings. Nil when there are none."
|
|
1396
|
+
},
|
|
1397
|
+
"facts": {
|
|
1398
|
+
"type": "object",
|
|
1399
|
+
"description": "Facts are the shared facts that hold for the new project, from smith.toml: [projects.<name>.facts] over [facts]. A key that is absent was set by no one: the plugin scaffolds its own default. Set by the host; read only."
|
|
1400
|
+
},
|
|
1401
|
+
"shape": {
|
|
1402
|
+
"type": "object",
|
|
1403
|
+
"additionalProperties": {
|
|
1404
|
+
"type": "string"
|
|
1405
|
+
},
|
|
1406
|
+
"description": "Shape is the dialect the new project should have: the facts (see Project.Shape) that most projects of its kind and language agree on, as the host counted them. A plugin applies the keys it follows (see InitializeResult.Follows) and ignores the rest. Nil when there is nothing to follow, or the person asked for a fresh project."
|
|
1407
|
+
},
|
|
1408
|
+
"choices": {
|
|
1409
|
+
"type": "array",
|
|
1410
|
+
"items": {
|
|
1411
|
+
"type": "string"
|
|
1412
|
+
},
|
|
1413
|
+
"description": "Choices are the choices (see Choice) the new project is built from, the stack's Choices, in the order they apply: a choice comes after those it requires. A plugin applies the choices it owns and ignores the rest. Absent when the stack is not a selection. Set by the host; read only."
|
|
1053
1414
|
}
|
|
1054
1415
|
},
|
|
1055
1416
|
"required": [
|
|
@@ -1186,6 +1547,20 @@ _SCHEMA_JSON = r'''{
|
|
|
1186
1547
|
"$ref": "#/$defs/ProjectKind"
|
|
1187
1548
|
},
|
|
1188
1549
|
"description": "Kinds are the project kinds the plugin can scaffold with generate. Absent or empty means all three (app, lib and package): what every plugin that says nothing does. A plugin that scaffolds only some, such as an app, lists them, so the host offers and the conformance suite asks for just those."
|
|
1550
|
+
},
|
|
1551
|
+
"follows": {
|
|
1552
|
+
"type": "array",
|
|
1553
|
+
"items": {
|
|
1554
|
+
"type": "string"
|
|
1555
|
+
},
|
|
1556
|
+
"description": "Follows are the shape keys (see Project.Shape) the plugin applies when it generates a project with GenerateParams.Shape. Where siblings split on a key, the host asks the person only for a key that a plugin of the stack follows. Absent means the plugin follows none."
|
|
1557
|
+
},
|
|
1558
|
+
"choices": {
|
|
1559
|
+
"type": "array",
|
|
1560
|
+
"items": {
|
|
1561
|
+
"$ref": "#/$defs/Choice"
|
|
1562
|
+
},
|
|
1563
|
+
"description": "Choices are the options on an axis (framework, test, style) the plugin owns. The host lists them (smith choices) and checks a selection of them (smith add --with). Absent means the plugin owns none."
|
|
1189
1564
|
}
|
|
1190
1565
|
},
|
|
1191
1566
|
"required": [
|
|
@@ -1430,6 +1805,13 @@ _SCHEMA_JSON = r'''{
|
|
|
1430
1805
|
},
|
|
1431
1806
|
"description": "Settings are plugins' settings for this project from smith.toml, by plugin name: [projects.<project>.settings.<name>] (what a recipe's settings became when it created the project), and for a convention its [conventions.<name>] settings and the project's [projects.<project>.<name>] on top. Set by the host; a plugin reads its own entry."
|
|
1432
1807
|
},
|
|
1808
|
+
"shape": {
|
|
1809
|
+
"type": "object",
|
|
1810
|
+
"additionalProperties": {
|
|
1811
|
+
"type": "string"
|
|
1812
|
+
},
|
|
1813
|
+
"description": "Shape is the dialect of the project: named facts about how it is made (\"build.tool\": \"esbuild\", \"test.runner\": \"@swc/jest\", \"exports.target\": \"dist\"), each a short string, read from the manifest and files the plugin already reads in discovery. The host counts the shapes of the projects of one kind and language to let a new project follow what they do, and knows no key itself. Nil when the plugin does not describe shapes."
|
|
1814
|
+
},
|
|
1433
1815
|
"registries": {
|
|
1434
1816
|
"$ref": "#/$defs/Registries",
|
|
1435
1817
|
"description": "Registries are the private registries the project installs from and publishes to, from smith.toml [registries]; nil means the public ones. Set by the host."
|
|
@@ -1437,6 +1819,10 @@ _SCHEMA_JSON = r'''{
|
|
|
1437
1819
|
"releaseAssets": {
|
|
1438
1820
|
"$ref": "#/$defs/AssetSpec",
|
|
1439
1821
|
"description": "ReleaseAssets is what an app's release builds, from smith.toml [projects.<project>.release]: the platforms and file names, so a plugin can check (doctor) and prepare (CI) for them. Nil for a project that has no release files. Set by the host."
|
|
1822
|
+
},
|
|
1823
|
+
"facts": {
|
|
1824
|
+
"type": "object",
|
|
1825
|
+
"description": "Facts are the shared facts that hold for the project, merged by the host, narrowest scope first: [projects.<name>.facts], then [facts], then the defaults plugins published through Contribution.Facts. A key that is absent was set by no one: the plugin uses its own default. A request made before every plugin has contributed carries the smith.toml facts and the defaults published so far. Set by the host; read only."
|
|
1440
1826
|
}
|
|
1441
1827
|
},
|
|
1442
1828
|
"required": [
|
|
@@ -1486,6 +1872,10 @@ _SCHEMA_JSON = r'''{
|
|
|
1486
1872
|
},
|
|
1487
1873
|
"branch": {
|
|
1488
1874
|
"type": "string"
|
|
1875
|
+
},
|
|
1876
|
+
"tag": {
|
|
1877
|
+
"type": "string",
|
|
1878
|
+
"description": "Tag is the name of the release channel the version belongs to (npm's dist-tag \"beta\"). When set, the plugin publishes under it and leaves the registry's stable pointer where it is, or ignores it when its registry has no such pointer. Only sent to a plugin with the channels capability."
|
|
1489
1879
|
}
|
|
1490
1880
|
},
|
|
1491
1881
|
"required": [
|
|
@@ -1865,6 +2255,13 @@ _SCHEMA_JSON = r'''{
|
|
|
1865
2255
|
"items": {
|
|
1866
2256
|
"type": "string"
|
|
1867
2257
|
}
|
|
2258
|
+
},
|
|
2259
|
+
"choices": {
|
|
2260
|
+
"type": "array",
|
|
2261
|
+
"items": {
|
|
2262
|
+
"type": "string"
|
|
2263
|
+
},
|
|
2264
|
+
"description": "Choices make the stack a saved selection (see Choice). When they are set, the host derives the language, the scaffold and the toolchain from them, and Toolchain lists only the plugins to add after those. The plugins of the stack get the choices in GenerateParams.Choices."
|
|
1868
2265
|
}
|
|
1869
2266
|
},
|
|
1870
2267
|
"required": [
|