Skip to content

Params Doc for Rules & OrbiterMeta#103

Merged
fritz-astronomer merged 5 commits intomainfrom
params_doc
Nov 6, 2025
Merged

Params Doc for Rules & OrbiterMeta#103
fritz-astronomer merged 5 commits intomainfrom
params_doc

Conversation

@fritz-astronomer
Copy link
Contributor

@fritz-astronomer fritz-astronomer commented Nov 6, 2025

  • feat: add params_doc to rules & OrbiterMeta

Allows for

@rule(params_doc={"foo": "bar"})

to document what is consumed and emitted in a more easily readable/parsable fashion

@fritz-astronomer fritz-astronomer self-assigned this Nov 6, 2025
@fritz-astronomer fritz-astronomer changed the title @rule(params_doc={"foo": "bar"}) Params Doc for Rules & OrbiterMeta Nov 6, 2025
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull Request Overview

This PR adds a params_doc parameter to rules and the OrbiterMeta class, allowing rules to include documentation for parameters they consume and emit. This enhances the metadata tracking capabilities of the rule system.

  • Adds params_doc parameter to the @rule decorator and Rule class
  • Updates OrbiterMeta to include matched_rule_params_doc field
  • Updates doctest examples to reflect the new field in OrbiterMeta output

Reviewed Changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 1 comment.

File Description
orbiter/rules/init.py Adds params_doc parameter to rule decorator and Rule class; updates doctest to show new OrbiterMeta field
orbiter/meta.py Adds matched_rule_params_doc field to OrbiterMeta class with appropriate description

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@codecov-commenter
Copy link

codecov-commenter commented Nov 6, 2025

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 82.26%. Comparing base (b3ee237) to head (920bd62).
⚠️ Report is 63 commits behind head on main.

Additional details and impacted files
@@            Coverage Diff             @@
##             main     #103      +/-   ##
==========================================
+ Coverage   78.92%   82.26%   +3.34%     
==========================================
  Files          35       51      +16     
  Lines        1362     1878     +516     
==========================================
+ Hits         1075     1545     +470     
- Misses        287      333      +46     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

@fritz-astronomer fritz-astronomer merged commit 762203c into main Nov 6, 2025
8 checks passed
@fritz-astronomer fritz-astronomer deleted the params_doc branch November 6, 2025 00:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants