Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add missing blocking argument documentation to the external source operator #5501

Merged
merged 3 commits into from
Jun 6, 2024

Conversation

JanuszL
Copy link
Contributor

@JanuszL JanuszL commented Jun 5, 2024

  • as the external source operator documentation is written
    in Python, it missed the blocking argument description
    which was defined in the native schema but not copied to
    the python description

Category:

Other (e.g. Documentation, Tests, Configuration)

Description:

Additional information:

Affected modules and functionalities:

  • external source operator

Key points relevant for the review:

  • NA

Tests:

  • Existing tests apply
  • New tests added
    • Python tests
    • GTests
    • Benchmark
    • Other
  • N/A

Checklist

Documentation

  • Existing documentation applies
  • Documentation updated
    • Docstring
    • Doxygen
    • RST
    • Jupyter
    • Other
  • N/A

DALI team only

Requirements

  • Implements new requirements
  • Affects existing requirements
  • N/A

REQ IDs: N/A

JIRA TASK: N/A

…operator

- as the external source operator documentation is written
  in Python, it missed the `blocking` argument description
  which was defined in the native schema but not copied to
  the python description

Signed-off-by: Janusz Lisiecki <[email protected]>
@JanuszL
Copy link
Contributor Author

JanuszL commented Jun 5, 2024

!build

@dali-automaton
Copy link
Collaborator

CI MESSAGE: [15587657]: BUILD STARTED

@jantonguirao jantonguirao self-assigned this Jun 5, 2024
Comment on lines 463 to 466
`blocking`: bool, optional
If True, this operator will block until the data is available
(e.g. by calling ``feed_input``). If False, the operator will raise an error,
if the data is not available.
Copy link
Contributor

Choose a reason for hiding this comment

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

I would add some warning that it's intended for advanced usage.

Suggested change
`blocking`: bool, optional
If True, this operator will block until the data is available
(e.g. by calling ``feed_input``). If False, the operator will raise an error,
if the data is not available.
`blocking`: bool, optional
**Advanced** if True, this operator will block until the data is available
(e.g. by calling ``feed_input``). If False, the operator will raise an error,
if the data is not available.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Fixed here and in the input op.

@mzient mzient self-assigned this Jun 5, 2024
Signed-off-by: Janusz Lisiecki <[email protected]>
@JanuszL
Copy link
Contributor Author

JanuszL commented Jun 5, 2024

!build

@dali-automaton
Copy link
Collaborator

CI MESSAGE: [15590147]: BUILD STARTED

@dali-automaton
Copy link
Collaborator

CI MESSAGE: [15587657]: BUILD PASSED

Signed-off-by: Janusz Lisiecki <[email protected]>
@JanuszL
Copy link
Contributor Author

JanuszL commented Jun 5, 2024

!build

@dali-automaton
Copy link
Collaborator

CI MESSAGE: [15592614]: BUILD STARTED

@dali-automaton
Copy link
Collaborator

CI MESSAGE: [15590147]: BUILD PASSED

@dali-automaton
Copy link
Collaborator

CI MESSAGE: [15592614]: BUILD PASSED

@JanuszL JanuszL merged commit 50715e1 into NVIDIA:main Jun 6, 2024
6 checks passed
@JanuszL JanuszL deleted the blocking_dosc branch June 6, 2024 00:03
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.

None yet

4 participants