Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
21 changes: 21 additions & 0 deletions LICENSE
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
MIT License

Copyright (c) 2026 Runtime Conditions

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
28 changes: 19 additions & 9 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -76,15 +76,25 @@ where the profiler or binding packages were built:
--out "$PROJECT_DIR/runtimeconditions.profile.yaml"
```

`verify-bindings` lists the distributions and extension IDs found through
workload imports; add `--json` for machine-readable output. `profile generate`
uses the installed profiler's approved core schema and the verified extension
definitions from the binding distributions. It validates the complete profile,
including schemas from transitive dependencies, before atomically writing the
YAML file. The profile lists extensions that directly contribute declarations;
validation-only dependencies remain in the checked closure. An error exits
nonzero and leaves an existing output file untouched. Omit `--out` to print
the profile to standard output.
`verify-bindings` lists the distributions found through workload imports, with
the ones only a dependency of those marked `(dependency)`; add `--json` for
machine-readable output, where each package has a `direct` flag. `profile
generate` uses the installed profiler's approved core schema and the verified
extension definitions from the binding distributions. It validates the complete
profile, including schemas from transitive dependencies, before atomically
writing the YAML file. The profile lists extensions that directly contribute
declarations; validation-only dependencies remain in the checked closure. An
error exits nonzero and leaves an existing output file untouched. Omit `--out`
to print the profile to standard output.

`--workload-version` is optional; without it the profile's `workload` has only
its `uri`. The `profile` word is optional too, so `runtimeconditions-python-profiler
generate ...` works, which lets the `rc` command pass its arguments straight
through. `--version --json` prints the profiler's name, version, and the core
profile schemas it emits, which `rc` checks before it runs the profiler.

The profile is written the way the Go, TypeScript, and Java profilers write it,
so the same declarations give the same YAML in every language.

## Extension IDs and remote resolution

Expand Down
Loading