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 a section about how to regenerate the ABI file #903

Merged
merged 2 commits into from
Jun 22, 2022

Conversation

pablogsal
Copy link
Member

No description provided.

Signed-off-by: Pablo Galindo <pablogsal@gmail.com>
Copy link
Member

@AlexWaygood AlexWaygood left a comment

Choose a reason for hiding this comment

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

Some typos :)

Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
@pablogsal pablogsal merged commit 3f73e7d into python:main Jun 22, 2022
@pablogsal pablogsal deleted the regen branch June 22, 2022 15:38
@pablogsal
Copy link
Member Author

Thanks for the review @AlexWaygood :)

Comment on lines +505 to +518
.. code-block:: bash
# In the CPython root:
$ docker run -v`pwd`:/src -it ubuntu:20.04 bash
$ cd /src
# Install dependencies to compile CPython
$ .github/workflows/posix-deps-apt.sh
# Install dependencies to run the ABI regeneration
$ apt-get install -yq abigail-tools python3
# Ensure CPython is built with all the debugging information
$ export CFLAGS="-g3 -O0"
# Build Python
$ ./configure --enable-shared && make
# Regenerate the ABI file
$ make regen-abidump
Copy link
Member

@encukou encukou Jun 22, 2022

Choose a reason for hiding this comment

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

That's a long script. Would you object to adding it to the source, and reducing the instructions to just e.g. docker run -v$(pwd):/src -w/src --rm ubuntu:20.04 bash /src/.github/workflows/regen-abidump.sh?

Copy link
Member Author

Choose a reason for hiding this comment

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

No, I think is a good idea. Will prepare a PR

Copy link
Member Author

Choose a reason for hiding this comment

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

with native extensions and other tools that interact with the Python interpreter.
See the documentation about the :ref:`release candidate <rc>` phase.

You can regenerate the ABI file by yourself by invoking the ``regen abidump``
Copy link
Member

Choose a reason for hiding this comment

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

regen-abidump, right?

Copy link
Member Author

Choose a reason for hiding this comment

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

Yup

Copy link
Member Author

Choose a reason for hiding this comment

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

Will fix this when I update the code block after we merge python/cpython#94135

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.

3 participants