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

JEP for specifying the connectionfile #106

Open
wants to merge 4 commits into
base: master
Choose a base branch
from

Conversation

JohanMabille
Copy link
Member

@JohanMabille JohanMabille commented Apr 22, 2023

Connection file JSON schema

This proposes to specify the connection file through a JSON schema, and have the specification and documentation live in a dedicated repo.

The JSON schema is joined as a standalone file.


I(s been a while since we proposed to move to the voting phase, let's fix it now ;) Ntice that further JSON specs should not been JEPs, but PRs to https://github.com/jupyter/schema

Voting from @jupyter/software-steering-council

@JohanMabille JohanMabille mentioned this pull request Apr 22, 2023
30 tasks
connectionfile-spec/connectionfile.schema.json Outdated Show resolved Hide resolved
connectionfile-spec/connectionfile-spec.md Outdated Show resolved Hide resolved
connectionfile-spec/connectionfile-spec.md Outdated Show resolved Hide resolved
@JohanMabille
Copy link
Member Author

@jupyter/software-steering-council kind ping on this one, similar to #105

@Zsailer
Copy link
Member

Zsailer commented Feb 28, 2024

I propose we move this to a voting phase. This has been open for nearly a year, so I think we can safely close the comment period. Now that the jupyter/schema repo is moving forward, this seems like a good time to proceed.

"description": "ip of the machine where the kernel runs"
},
"shell_port": {
"type": ["integer","string"],
Copy link
Member

Choose a reason for hiding this comment

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

Is it worth using oneOf to distinguish tcp with integer ports from ipc/inproc where it's really a string suffix (that I believe implementation-wise accepts integers)? Essentially, signal that tcp doesn't accept strings for ports.

Fine if that's more schema complexity that folks want.

},
"kernel_network": {
"type": "object",
"required": ["transport", "ip", "shell_port", "control_port", "stdin_port", "hb_port", "iopub_port"],
Copy link

Choose a reason for hiding this comment

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

I realize I'm late to this discussion, but I just want to understand it fully before voting: Is the spec as proposed now consistent with https://github.com/jupyter/enhancement-proposals/pull/66/files ? If not, how would the schema evolve to support that? Would these fields no longer be required?

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.

None yet

5 participants