gh-151427: add 'not macOS' restriction on availabitity state of 7 functions in os module.

[YvesDup]

These functions are not available on macOS.

• getresgid, setresgid
• getresuid, setresuid
• pipe2
• posix_fallocate
• posix_fadvise

These updates should be backport to 3.13, 3.14 and 3.15 versions. The functions were added in 3.2 and 3.3 versions.

• Issue: os.getresuid() and os.getresgid() are not present in MacOS/Python 3.14.5, but are documented #151427

[read-the-docs-community]

Documentation build overview

📚 cpython-previews | 🛠️ Build #33213348 | 📁 Comparing 3570843 against main (8646385)

  🔍 Preview build  

26 files changed · ± 26 modified

± Modified

• py-modindex.html
• c-api/bytes.html
• c-api/init_config.html
• c-api/stable.html
• c-api/type.html
• c-api/typeobj.html
• faq/gui.html
• library/curses.ascii.html
• library/curses.html
• library/curses.panel.html
• and 16 more...

[vstinner]

LGTM, but I don't have access to macOS to double check.

[YvesDup]

Helper to validate on macOS

import os
import sys

funcs = ('getresgid', 'setresgid',
        'getresuid', 'setresuid',
        'pipe2',
        'posix_fallocate',
        'posix_fadvise',
        'getpid' # this function exists
        )

def test_missing_os_functions_from_macos():
    n = 0
    for f in funcs:
        try:
            os.__dict__[f]
        except KeyError:
            n += 1

    if sys.platform == 'darwin':
        assert n == len(funcs[:-1])
        print(f"Okay on {sys.platform}")
    elif sys.platform == 'linux':
        assert n == 0
        print(f"Okay on {sys.platform}")

if __name__ == '__main__':
    test_missing_os_functions_from_macos()

[ned-deily]

Thanks for the PR. It looks OK as far as it goes. But, since we now document iOS availabilities as well as macOS, we should include not iOS on these. At the os module level, iOS is very similar to macOS with some more restrictions. But with a quick check in the iOS simulator, it appears that these seven are also not available on iOS. @freakboy3742, do you agree?

[freakboy3742]

Correct - these methods aren't available on iOS, so flagging them as "not iOS" as well would make sense to me.

[YvesDup]

While checking all not iOS and not macOS avalaibilities in os module functions, the os.plock seems to be not available in macOS ... neither in Linux.
What are OS where os.plock is really available ? Should I open a new issue ?

[vstinner]

You can update plock() availability documentation in the same PR.

[YvesDup]

I did not add not linux entry on plock availability because I can only check with Ubuntu. This is not represensative enough of all linux distribs.

[miss-islington-app]

Thanks @YvesDup for the PR, and @ned-deily for merging it 🌮🎉.. I'm working now to backport this PR to: 3.13.
🐍🍒⛏🤖

[miss-islington-app]

Thanks @YvesDup for the PR, and @ned-deily for merging it 🌮🎉.. I'm working now to backport this PR to: 3.14.
🐍🍒⛏🤖

[miss-islington-app]

Thanks @YvesDup for the PR, and @ned-deily for merging it 🌮🎉.. I'm working now to backport this PR to: 3.15.
🐍🍒⛏🤖

[bedevere-app]

GH-151697 is a backport of this pull request to the 3.13 branch.

[bedevere-app]

GH-151698 is a backport of this pull request to the 3.14 branch.

[bedevere-app]

GH-151699 is a backport of this pull request to the 3.15 branch.