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

Added missing documentation for the inspectVariables request and resp… #649

Merged
merged 2 commits into from
Jun 4, 2021
Merged

Added missing documentation for the inspectVariables request and resp… #649

merged 2 commits into from
Jun 4, 2021

Conversation

JohanMabille
Copy link
Member

…onse

Notice that this is not a new message to the protocol, but missing documentation for a message the has been part of the debugging protocol in Jupyter since the beginning.

@@ -1137,7 +1141,7 @@ In order to support page reloading, or a client connecting at a later stage, Jup
'command' : 'debugInfo'
}

Content of `debugInfo` response::
Content of the `debugInfo` response::
Copy link
Member

Choose a reason for hiding this comment

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

I think we should get rid of the two-space indentation here, and in other places too:

Suggested change
Content of the `debugInfo` response::
Content of the `debugInfo` response::

Copy link
Member Author

Choose a reason for hiding this comment

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

If you look at the generated doc, this allwos to easily identify the different messages added to the spec. I think we should either keep this indentation, or add subsections.

Copy link
Member

Choose a reason for hiding this comment

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

add subsections

Yes maybe as a bullet list?

Copy link
Member Author

Choose a reason for hiding this comment

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

Let's do this reformating part in a dedicated PR since the indentation was here before. We really need to move on and merge this one since we have more fields to add in some messages.

@@ -1160,6 +1164,32 @@ In order to support page reloading, or a client connecting at a later stage, Jup

The `source_breakpoint` schema is specified by the Debug Adapter Protocol.

The `inspectVariables` is meant to retrieve the values of all the variables that have been defined in the notebook. It is a DAP `Request` with no extra argument.

Content of the `inspectVariables` request::
Copy link
Member

Choose a reason for hiding this comment

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

Same here.

'command' : 'inspectVariables'
}

Content of the `inspectVariables` response::
Copy link
Member

Choose a reason for hiding this comment

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

Same here.

docs/messaging.rst Outdated Show resolved Hide resolved
Co-authored-by: Jeremy Tuloup <jeremy.tuloup@gmail.com>
@davidbrochart davidbrochart merged commit b39ac1f into jupyter:master Jun 4, 2021
@JohanMabille JohanMabille deleted the inspectVariables branch June 4, 2021 08:54
@JohanMabille
Copy link
Member Author

Thanks @davidbrochart !

@blink1073 blink1073 added this to the 7.0 milestone Jul 30, 2021
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants