Skip to content

Conversation

@PDGGK
Copy link
Contributor

@PDGGK PDGGK commented Jan 14, 2026

What changes are being proposed in this pull request?

This PR addresses issue #37279 by documenting the Python version availability issues on Ubuntu 24.04.

Ubuntu 24.04 ships with Python 3.12 by default but lacks python3.10, python3.11, and python3.13 commands in the default repositories. This causes build failures when developers try to run Python SDK test suites that require multiple Python versions.

Why are these changes needed?

New contributors using Ubuntu 24.04 frequently encounter confusing build errors like:

  • python3.10: command not found
  • Cannot run program "python3.10": No such file or directory

This documentation update helps developers:

  1. Understand why the error occurs
  2. Know which Python versions are affected
  3. Apply appropriate workarounds

Changes made:

  • Simplified "For more information" line to match Beam documentation style
  • Added Ubuntu 24.04-specific guidance explaining missing Python versions
  • Provided two workarounds:
    • Using pyenv to install and make multiple versions available
    • Creating symlinks in /usr/local/bin/

Testing

  • Documentation-only change, no code tests required
  • Verified formatting and links

Fixes #37279

Ubuntu 24.04 defaults to Python 3.12 and lacks python3.10, python3.11,
and python3.13 commands in default repositories. This causes build
failures when running Python SDK test suites.

Added documentation explaining:
- Which Python versions are missing on Ubuntu 24.04
- Common error messages developers will encounter
- Workarounds using pyenv or symlinks

Fixes apache#37279

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
@gemini-code-assist
Copy link
Contributor

Summary of Changes

Hello @PDGGK, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request enhances the developer onboarding experience by documenting critical Python version compatibility issues specific to Ubuntu 24.04. It aims to prevent common build failures for new contributors by explaining why certain Python versions are missing and offering clear, actionable solutions, thereby streamlining the setup process for running Python SDK test suites.

Highlights

  • Ubuntu 24.04 Python Version Documentation: Added documentation to CONTRIBUTING.md addressing Python version availability issues on Ubuntu 24.04, specifically the absence of python3.10, python3.11, and python3.13 commands by default.
  • Error Explanation: Clarified the common build errors encountered by developers, such as "python3.10: command not found", explaining their root cause on Ubuntu 24.04.
  • Workaround Provision: Provided two practical workarounds for developers: using pyenv to manage and install multiple Python versions, and creating symlinks in /usr/local/bin/ for existing Python binaries.

🧠 New Feature in Public Preview: You can now enable Memory to help Gemini Code Assist learn from your team's feedback. This makes future code reviews more consistent and personalized to your project's style. Click here to enable Memory in your admin console.

Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

  1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution.

@github-actions
Copy link
Contributor

Assigning reviewers:

R: @Abacn added as fallback since no labels match configuration

Note: If you would like to opt out of this review, comment assign to next reviewer.

Available commands:

  • stop reviewer notifications - opt out of the automated review tooling
  • remind me after tests pass - tag the comment author after tests pass
  • waiting on author - shift the attention set back to the author (any comment or push by the author will return the attention set to the reviewers)

The PR bot will only process comments in the main thread (not review comments).

@github-actions
Copy link
Contributor

Reminder, please take a look at this pr: @Abacn

@github-actions
Copy link
Contributor

Assigning new set of reviewers because Pr has gone too long without review. If you would like to opt out of this review, comment assign to next reviewer:

R: @Abacn added as fallback since no labels match configuration

Available commands:

  • stop reviewer notifications - opt out of the automated review tooling
  • remind me after tests pass - tag the comment author after tests pass
  • waiting on author - shift the attention set back to the author (any comment or push by the author will return the attention set to the reviewers)

For more information, see:
Python installation tips in [Developer Wiki](https://cwiki.apache.org/confluence/display/BEAM/Python+Tips#PythonTips-InstallingPythoninterpreters).
See Python installation tips in [Developer Wiki](https://cwiki.apache.org/confluence/display/BEAM/Python+Tips#PythonTips-InstallingPythoninterpreters).
- Ubuntu 24.04 includes Python 3.12 by default but lacks `python3.10`, `python3.11`, and `python3.13` commands. Builds can fail with errors like `python3.10: command not found` or `Cannot run program "python3.10": No such file or directory`.
Copy link
Contributor

Choose a reason for hiding this comment

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

Is there a reason to specifically call out Ubuntu 24.04? I think the existing text is pretty clear here

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.

[Task]:Docs: clarify Python 3.10 requirement on Ubuntu 24.04 and Codespaces

2 participants