[v2][Python] Make generated implementation modules private

Open

#2,048 opened on Jul 21, 2026 2 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty: 4/5
Estimated time: 3-5 days
Newbie friendliness: 55/100

Issue type: Refactor
Clarity: Mostly clear
Activity status: Active
Tech stack: python
Domain: api

Research direction

Start with python/copilot/generated/init.py, python/copilot/rpc.py, python/copilot/session_events.py, and the generated rpc.py and session_events.py modules. Trace which generated symbols are intended to be public before changing the package name or export lists. Done means implementation modules are private and the public modules expose only the intended API without accidental generated symbols.

Written by the indexing model from the issue text.

Description

bug sdk-v2

https://github.com/github/copilot-sdk/blob/main/python/copilot/generated/__init__.py Makes it clear that the copilot.generated subpackage is not meant to be public:

https://github.com/github/copilot-sdk/blob/cd2b10b07e8f393b09379dfda6b30f658b2963d2/python/copilot/generated/__init__.py#L3

But the subpackage doesn't start with an underscore to signify it's an implementation detail: copilot._generated.

As well, https://github.com/github/copilot-sdk/blob/main/python/copilot/rpc.py and https://github.com/github/copilot-sdk/blob/main/python/copilot/session_events.py which are meant to act as the public API potentially over-expose things. While copilot.rpc does export something explicitly:

https://github.com/github/copilot-sdk/blob/cd2b10b07e8f393b09379dfda6b30f658b2963d2/python/copilot/rpc.py#L10-L11

... both files also do an import * followed by an import of __all__ from the generated code which lists everything contained in the generated code. E.g.:

https://github.com/github/copilot-sdk/blob/cd2b10b07e8f393b09379dfda6b30f658b2963d2/python/copilot/session_events.py#L9-L10

exposes 330 symbols in the module:

https://github.com/github/copilot-sdk/blob/cd2b10b07e8f393b09379dfda6b30f658b2963d2/python/copilot/generated/session_events.py#L9883-L10215

I'm not sure if all 330 symbols are meant to be exposed, but at least copilot.generated should be made private by renaming it to copilot._generated. If all of those symbols are meant to be exposed then that one-liner in copilot.rpc might as well be removed. If they are not meant to be exposed then the import __all__ and import * should go and you can explicitly set __all__ in the exporting modules.

Dominant language: Java
Stars: 10.5k
Forks: 1.5k
Avg merge: 1d 9h
Merged PRs (30d): 130

Contributor guide

Open the contributing guide

First steps

Read the whole issue, then the project's contributing guide.
Comment on the issue to say you are picking it up — it saves two people doing the same work.
Fork the repository and make your change on a branch.
Open a pull request that references the issue number.

Similar issues

[Bug]: JavaScript dialog is complaining about changes when there were none Open

awaiting triage bug Causes friction Hop Gui P1 P2 Transforms

Difficulty 2/5 1-3 hours Newbie friendliness 75/100

apache/hop#8564 · Opened Sep 23, 2026
[Bug][api] MemoryRef equality ignores the memory type Open

Difficulty 2/5 1-3 hours Newbie friendliness 75/100

apache/flink-agents#1152 · Opened Sep 23, 2026
Gauntlet loot not showing up in boss section Open

Difficulty 2/5 1-3 hours Newbie friendliness 75/100

TheStonedTurtle/Loot-Logger#97 · Opened Sep 23, 2026
TryBlueOceanMenu allocates a per-FlowNode URL object trio, retaining ~21 GiB on large pipeline graphs Open

Difficulty 2/5 1-3 hours Newbie friendliness 70/100

jenkinsci/blueocean-plugin#5417 · Opened Sep 23, 2026
Dijkstra entry point crashes with ArrayIndexOutOfBoundsException when a vertex id exceeds the argument count Open

Difficulty 2/5 1-3 hours Newbie friendliness 75/100

objectionary/eo-graphs#75 · Opened Sep 23, 2026

More Java issues