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

Improvements for stable ABI definition files #91324

Closed
encukou opened this issue Mar 30, 2022 · 5 comments
Closed

Improvements for stable ABI definition files #91324

encukou opened this issue Mar 30, 2022 · 5 comments

Comments

@encukou
Copy link
Member

encukou commented Mar 30, 2022

BPO 47168
Nosy @encukou, @arhadthedev
PRs
  • bpo-47168: Mark files generated by make regen-limited-abi as generated #32195
  • bpo-47169: Add feature macro PY_HAVE_THREAD_NATIVE_ID to the stable ABI definition #32365
  • bpo-47168: List feature macros in the stable ABI manifest, improve tests #32415
  • Note: these values reflect the state of the issue at the time it was migrated and might not reflect the current state.

    Show more details

    GitHub fields:

    assignee = None
    closed_at = None
    created_at = <Date 2022-03-30.15:39:32.343>
    labels = []
    title = 'Improvements for stable ABI definition files'
    updated_at = <Date 2022-04-08.14:02:39.376>
    user = 'https://github.com/encukou'

    bugs.python.org fields:

    activity = <Date 2022-04-08.14:02:39.376>
    actor = 'petr.viktorin'
    assignee = 'none'
    closed = False
    closed_date = None
    closer = None
    components = []
    creation = <Date 2022-03-30.15:39:32.343>
    creator = 'petr.viktorin'
    dependencies = []
    files = []
    hgrepos = []
    issue_num = 47168
    keywords = ['patch']
    message_count = 4.0
    messages = ['416376', '416388', '416492', '416985']
    nosy_count = 2.0
    nosy_names = ['petr.viktorin', 'arhadthedev']
    pr_nums = ['32195', '32365', '32415']
    priority = 'normal'
    resolution = None
    stage = 'patch review'
    status = 'open'
    superseder = None
    type = None
    url = 'https://bugs.python.org/issue47168'
    versions = []

    @encukou
    Copy link
    Member Author

    encukou commented Mar 30, 2022

    This issue groups together a few changes I'd like to make:

    • Rename Doc/data/stable_abi.dat to *.csv, so it gets syntax highlighting. (The only user of that file should be the Sphinx extension)
    • Mark autogenerated files as such in .gitattributes
    • Convert Misc/stable_abi.txt to TOML, and change the parser to match (this will need a heads-up on python-dev)
      • adjust the devguide to stable_abi.toml

    @arhadthedev
    Copy link
    Mannequin

    arhadthedev mannequin commented Mar 30, 2022

    Probably, regen-limited-abi needs to be called from regen-all so 'Check if generated files are up to date' CI job will become aware of it.

    @encukou
    Copy link
    Member Author

    encukou commented Apr 1, 2022

    New changeset 079143d by Petr Viktorin in branch 'main':
    bpo-47168: Mark files generated by make regen-limited-abi as generated (GH-32195)
    079143d

    @encukou
    Copy link
    Member Author

    encukou commented Apr 8, 2022

    Thinking more about Doc/data/stable_abi.dat, I don't think the rename is worth it. The file is not meant to be used/edited by humans.
    If someone needs the data for something other than running the Sphinx extension, let me know. We should provide a proper data source for their use case.

    @encukou
    Copy link
    Member Author

    encukou commented Apr 29, 2022

    The manifest is now TOML.
    CPython: #92026
    Devguide: python/devguide#847

    @encukou encukou closed this as completed Apr 29, 2022
    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

    No branches or pull requests

    1 participant