Description

YvesDup

opened on Apr 29, 2025

Issue body actions

Feature or enhancement

Proposal:

This improvement is based on @ronaldoussoren's comment at #125829 (comment)

1. This public method should be documented in the synchronization primitives of multiprocessing module.
2. I also suggest to refactor code with this public method, in replacement of calls to the private method semaphore._semlock._get_value in the following locations:

cpython/Lib/multiprocessing/synchronize.py

Line 142 in 0c26dbd

value = self._semlock._get_value()

cpython/Lib/multiprocessing/synchronize.py

Line 158 in 0c26dbd

value = self._semlock._get_value()

cpython/Lib/multiprocessing/synchronize.py

Lines 250 to 251 in 0c26dbd

	num_waiters = (self._sleeping_count._semlock._get_value() -
	self._woken_count._semlock._get_value())

cpython/Lib/multiprocessing/queues.py

Line 124 in 0c26dbd

return self._maxsize - self._sem._semlock._get_value()

Has this already been discussed elsewhere?

This is a minor feature, which does not need previous discussion elsewhere

Links to previous discussion of this feature:

No response

Linked PRs

• gh-133146: Add the old public get_value method to documentation and refactor code. #133301
• [3.14] gh-133146: Add the old public get_value method to documentation and refactor code. (GH-133301) #142110

Activity

1. YvesDup

   added

   type-featureA feature request or enhancementA feature request or enhancement

   on Apr 29, 2025
2. ZeroIntensity

   added

   topic-multiprocessing

   on Apr 29, 2025
3. picnixz

   added

   stdlibStandard Library Python modules in the Lib/ directoryStandard Library Python modules in the Lib/ directory

   on May 1, 2025
4. YvesDup commented on May 2, 2025

   

   YvesDup

   on May 2, 2025

   ContributorAuthor

   More actions

   Perhaps there was a good reason for never documenting this public method.
5. gpshead

   marked multiprocessing.Semaphore has undocumented get_value() method #84974 as a duplicate of this issue on Nov 29, 2025
6. gpshead

   self-assigned this

   on Nov 29, 2025
7. gpshead

   added a commit that references this issue on Nov 29, 2025

   gh-133146: Add the old public `get_value` method to documentation and…

   db098a4
8. gpshead

   closed this as completedin #133301on Nov 29, 2025
9. hugovk

   added a commit that references this issue on Nov 30, 2025

   [3.14] pythongh-133146: Add the old public `get_value` method to docu…

   ecab12a
10. gpshead

    added a commit that references this issue on Nov 30, 2025

    [3.14] gh-133146: Add the old public `get_value` method to documentat…

    b95d16a
11. StanFromIreland

    added a commit that references this issue on Dec 6, 2025

    pythongh-133146: Add the old public `get_value` method to documentati…

    a19fde2

Issue actions