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

Jump to bottom

multiprocessing.set_start_method force argument is not documented #91340

Closed
johnthagen mannequin opened this issue Mar 31, 2022 · 2 comments
Closed

multiprocessing.set_start_method force argument is not documented #91340

johnthagen mannequin opened this issue Mar 31, 2022 · 2 comments
Labels
3.7 3.8 3.9 3.10 3.11 docs Documentation in the Doc dir expert-multiprocessing type-feature A feature request or enhancement

Comments

@johnthagen
Copy link
Mannequin

johnthagen mannequin commented Mar 31, 2022 •
edited by bedevere-bot

BPO 47184
Nosy @johnthagen, @dignissimus
PRs
  • gh-91340: Document multiprocessing.set_start_method force parameter #32339
    		•

    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-31.17:42:20.592>
labels = ['3.7', '3.8', '3.9', '3.10', '3.11', 'type-feature', 'docs']
title = 'multiprocessing.set_start_method force argument is not documented'
updated_at = <Date 2022-04-05.19:12:05.366>
user = 'https://github.com/johnthagen'

    bugs.python.org fields:

    activity = <Date 2022-04-05.19:12:05.366>
actor = 'sam_ezeh'
assignee = 'docs@python'
closed = False
closed_date = None
closer = None
components = ['Documentation']
creation = <Date 2022-03-31.17:42:20.592>
creator = 'John Hagen'
dependencies = []
files = []
hgrepos = []
issue_num = 47184
keywords = ['patch']
message_count = 2.0
messages = ['416451', '416805']
nosy_count = 3.0
nosy_names = ['docs@python', 'John Hagen', 'sam_ezeh']
pr_nums = ['32339']
priority = 'normal'
resolution = None
stage = 'patch review'
status = 'open'
superseder = None
type = 'enhancement'
url = 'https://bugs.python.org/issue47184'
versions = ['Python 3.7', 'Python 3.8', 'Python 3.9', 'Python 3.10', 'Python 3.11']

    Linked PRs
    @johnthagen
    Copy link
    Mannequin Author

    johnthagen mannequin commented Mar 31, 2022

    multiprocessing.set_start_method() has a force argument that is not documented: https://docs.python.org/3.10/library/multiprocessing.html#multiprocessing.set_start_method

    @johnthagen johnthagen mannequin assigned docspython Mar 31, 2022
    @johnthagen johnthagen mannequin added 3.7 docs Documentation in the Doc dir type-feature A feature request or enhancement 3.8 3.9 3.10 3.11 labels Mar 31, 2022
    @johnthagen johnthagen mannequin assigned docspython Mar 31, 2022
    @johnthagen johnthagen mannequin added docs Documentation in the Doc dir type-feature A feature request or enhancement labels Mar 31, 2022
    @dignissimus
    Copy link
    Mannequin

    dignissimus mannequin commented Apr 5, 2022

    It's quite weird, the documentation says set_start_method "should not be used more than once in the program" twice.

    The source code also contains the following line

    # Type of default context -- underlying context can be set at most once

    I'm not too familiar with the multiprocessing library but with the force parameter set to True, I don't understand why that can't happen. If there's a specific reason, maybe that should be documented too.

    @ezio-melotti ezio-melotti transferred this issue from another repository Apr 10, 2022
    @JelleZijlstra JelleZijlstra mentioned this issue Apr 23, 2022
    Merged
    miss-islington pushed a commit that referenced this issue Nov 27, 2022
    @dignissimus
    gh-91340: Document multiprocessing.set_start_method force parameter (G…
    dfc2732 
    …H-32339)

#91340


https://bugs.python.org/issue47184

Automerge-Triggered-By: GH:kumaraditya303
    @miss-islington miss-islington mentioned this issue Nov 27, 2022
    Merged
    miss-islington pushed a commit to miss-islington/cpython that referenced this issue Nov 27, 2022
    @dignissimus @miss-islington
    pythongh-91340: Document multiprocessing.set_start_method force param…
    ba15346 
    …eter (pythonGH-32339)

pythonGH-91340

https://bugs.python.org/issue47184
(cherry picked from commit dfc2732)

Co-authored-by: Sam Ezeh <sam.z.ezeh@gmail.com>
Automerge-Triggered-By: GH:kumaraditya303
    miss-islington added a commit that referenced this issue Nov 27, 2022
    @miss-islington @dignissimus
    gh-91340: Document multiprocessing.set_start_method force parameter (G…
    366adc7 
    …H-32339)

GH-91340

https://bugs.python.org/issue47184
(cherry picked from commit dfc2732)

Co-authored-by: Sam Ezeh <sam.z.ezeh@gmail.com>
Automerge-Triggered-By: GH:kumaraditya303
    Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
    Assignees
    No one assigned
    Labels
    3.7 3.8 3.9 3.10 3.11 docs Documentation in the Doc dir expert-multiprocessing type-feature A feature request or enhancement
    Projects
    Multiprocessing issues
    Status: Done
    Milestone
    No milestone
    Development

    No branches or pull requests
    2 participants
    @vstinner @kumaraditya303