并发执行 ¶

此章描述的模块为代码的并发执行提供支持。合适工具的抉择取决于要执行的任务 (CPU 绑定 vs IO 绑定) 和首选的开发风格 (事件驱动的协作多任务 vs 抢占式多任务)。这里是概述：

• threading — 基于线程的并行
  • active_count()
  • current_thread()
  • excepthook()
  • __excepthook__
  • get_ident()
  • get_native_id()
  • enumerate()
  • main_thread()
  • settrace()
  • settrace_all_threads()
  • gettrace()
  • setprofile()
  • setprofile_all_threads()
  • getprofile()
  • stack_size()
  • TIMEOUT_MAX
  • 线程局部数据
    • local
  • 线程对象
    • Thread
      • start()
      • run()
      • join()
      • name
      • getName()
      • setName()
      • ident
      • native_id
      • is_alive()
      • daemon
      • isDaemon()
      • setDaemon()
  • 锁对象
    • Lock
      • acquire()
      • release()
      • locked()
  • RLock 对象
    • RLock
      • acquire()
      • release()
  • 条件对象
    • Condition
      • acquire()
      • release()
      • wait()
      • wait_for()
      • notify()
      • notify_all()
  • 信号量对象
    • Semaphore
      • acquire()
      • release()
    • BoundedSemaphore
    • Semaphore 范例
  • 事件对象
    • Event
      • is_set()
      • set()
      • clear()
      • wait()
  • 计时器对象
    • Timer
      • cancel()
  • 屏障对象
    • Barrier
      • wait()
      • reset()
      • abort()
      • parties
      • n_waiting
      • broken
    • BrokenBarrierError
  • 使用锁、条件和信号量在 with 语句
• multiprocessing — 基于进程的并行
  • 介绍
    • The Process class
    • 上下文和启动方法
    • 在进程间交换对象
    • 在进程间同步
    • 在进程间共享状态
    • 使用工作者池
  • 参考
    • Process 和异常
      • Process
        • run()
        • start()
        • join()
        • name
        • is_alive()
        • daemon
        • pid
        • exitcode
        • authkey
        • sentinel
        • terminate()
        • kill()
        • close()
      • ProcessError
      • BufferTooShort
      • AuthenticationError
      • TimeoutError
    • 管道和队列
      • Pipe()
      • Queue
        • qsize()
        • empty()
        • full()
        • put()
        • put_nowait()
        • get()
        • get_nowait()
        • close()
        • join_thread()
        • cancel_join_thread()
      • SimpleQueue
        • close()
        • empty()
        • get()
        • put()
      • JoinableQueue
        • task_done()
        • join()
    • 杂项
      • active_children()
      • cpu_count()
      • current_process()
      • parent_process()
      • freeze_support()
      • get_all_start_methods()
      • get_context()
      • get_start_method()
      • set_executable()
      • set_forkserver_preload()
      • set_start_method()
    • 连接对象
      • Connection
        • send()
        • recv()
        • fileno()
        • close()
        • poll()
        • send_bytes()
        • recv_bytes()
        • recv_bytes_into()
    • 同步原语
      • Barrier
      • BoundedSemaphore
      • Condition
      • Event
      • Lock
        • acquire()
        • release()
      • RLock
        • acquire()
        • release()
      • Semaphore
    • 共享 ctypes 对象
      • Value()
      • Array()
      • The multiprocessing.sharedctypes 模块
        • RawArray()
        • RawValue()
        • Array()
        • Value()
        • copy()
        • synchronized()
    • 管理器
      • Manager()
      • BaseManager
        • start()
        • get_server()
        • connect()
        • shutdown()
        • register()
        • address
      • SyncManager
        • Barrier()
        • BoundedSemaphore()
        • Condition()
        • Event()
        • Lock()
        • Namespace()
        • Queue()
        • RLock()
        • Semaphore()
        • Array()
        • Value()
        • dict()
        • list()
      • Namespace
      • 定制管理器
      • 使用远程管理器
    • 代理对象
      • BaseProxy
        • _callmethod()
        • _getvalue()
        • __repr__()
        • __str__()
      • 清理
    • 进程池
      • Pool
        • apply()
        • apply_async()
        • map()
        • map_async()
        • imap()
        • imap_unordered()
        • starmap()
        • starmap_async()
        • close()
        • terminate()
        • join()
      • AsyncResult
        • get()
        • wait()
        • ready()
        • successful()
    • Listener 和 Client
      • deliver_challenge()
      • answer_challenge()
      • Client()
      • Listener
        • accept()
        • close()
        • address
        • last_accepted
      • wait()
      • 地址格式
    • 身份验证键
    • 日志
      • get_logger()
      • log_to_stderr()
    • The multiprocessing.dummy 模块
      • ThreadPool
  • 编程指导方针
    • 所有启动方法
    • The spawn and forkserver 启动方法
  • 范例
• multiprocessing.shared_memory — 用于跨进程直接访问的共享内存
  • SharedMemory
    • close()
    • unlink()
    • buf
    • name
    • size
  • SharedMemoryManager
    • SharedMemory()
    • ShareableList()
  • ShareableList
    • count()
    • index()
    • format
    • shm
• The concurrent 包
• concurrent.futures — 发起并行任务
  • 执行器对象
    • Executor
      • submit()
      • map()
      • shutdown()
  • ThreadPoolExecutor
    • ThreadPoolExecutor
    • ThreadPoolExecutor 范例
  • ProcessPoolExecutor
    • ProcessPoolExecutor
    • ProcessPoolExecutor 范例
  • Future 对象
    • Future
      • cancel()
      • cancelled()
      • running()
      • done()
      • result()
      • exception()
      • add_done_callback()
      • set_running_or_notify_cancel()
      • set_result()
      • set_exception()
  • 模块函数
    • wait()
      • FIRST_COMPLETED
      • FIRST_EXCEPTION
      • ALL_COMPLETED
    • as_completed()
  • 异常类
    • CancelledError
    • TimeoutError
    • BrokenExecutor
    • InvalidStateError
    • BrokenThreadPool
    • BrokenProcessPool
• subprocess — 子进程管理
  • 使用 subprocess 模块
    • run()
    • CompletedProcess
      • args
      • returncode
      • stdout
      • stderr
      • check_returncode()
    • DEVNULL
    • PIPE
    • STDOUT
    • SubprocessError
    • TimeoutExpired
      • cmd
      • timeout
      • output
      • stdout
      • stderr
    • CalledProcessError
      • returncode
      • cmd
      • output
      • stdout
      • stderr
    • 经常使用的自变量
    • Popen 构造函数
      • Popen
    • 异常
  • 安全注意事项
  • Popen 对象
    • poll()
    • wait()
    • communicate()
    • send_signal()
    • terminate()
    • kill()
    • args
    • stdin
    • stdout
    • stderr
    • pid
    • returncode
  • Windows Popen 帮手
    • STARTUPINFO
      • dwFlags
      • hStdInput
      • hStdOutput
      • hStdError
      • wShowWindow
      • lpAttributeList
    • Windows 常量
      • STD_INPUT_HANDLE
      • STD_OUTPUT_HANDLE
      • STD_ERROR_HANDLE
      • SW_HIDE
      • STARTF_USESTDHANDLES
      • STARTF_USESHOWWINDOW
      • STARTF_FORCEONFEEDBACK
      • STARTF_FORCEOFFFEEDBACK
      • CREATE_NEW_CONSOLE
      • CREATE_NEW_PROCESS_GROUP
      • ABOVE_NORMAL_PRIORITY_CLASS
      • BELOW_NORMAL_PRIORITY_CLASS
      • HIGH_PRIORITY_CLASS
      • IDLE_PRIORITY_CLASS
      • NORMAL_PRIORITY_CLASS
      • REALTIME_PRIORITY_CLASS
      • CREATE_NO_WINDOW
      • DETACHED_PROCESS
      • CREATE_DEFAULT_ERROR_MODE
      • CREATE_BREAKAWAY_FROM_JOB
  • 较旧的高级 API
    • call()
    • check_call()
    • check_output()
  • 替换旧函数采用 subprocess 模块
    • 替换 /bin/sh Shell 命令代入
    • 替换 Shell 管道
    • 替换 os.system()
    • 替换 os.spawn 系列
    • 替换 os.popen() , os.popen2() , os.popen3()
    • 替换函数来自 popen2 模块
  • 传统 Shell 援引函数
    • getstatusoutput()
    • getoutput()
  • 注意事项
    • 在 Windows 将自变量序列转换成字符串
    • 禁用使用 vfork() or posix_spawn()
• sched — 事件调度器
  • scheduler
  • 调度器对象
    • enterabs()
    • enter()
    • cancel()
    • empty()
    • run()
    • queue
• queue — 同步队列类
  • Queue
  • LifoQueue
  • PriorityQueue
  • SimpleQueue
  • Empty
  • Full
  • ShutDown
  • Queue 对象
    • qsize()
    • empty()
    • full()
    • put()
    • put_nowait()
    • get()
    • get_nowait()
    • task_done()
    • join()
    • Terminating queues
      • shutdown()
  • SimpleQueue 对象
    • qsize()
    • empty()
    • put()
    • put_nowait()
    • get()
    • get_nowait()
• contextvars — 上下文变量
  • 上下文变量
    • ContextVar
      • name
      • get()
      • set()
      • reset()
    • Token
      • var
      • old_value
      • MISSING
  • 手动上下文管理
    • copy_context()
    • Context
      • run()
      • copy()
      • get()
      • keys()
      • values()
      • items()
  • asyncio 支持

以下是某些上述服务的支持模块：

• _thread — 低级线程 API
  • error
  • LockType
  • start_new_thread()
  • interrupt_main()
  • exit()
  • allocate_lock()
  • get_ident()
  • get_native_id()
  • stack_size()
  • TIMEOUT_MAX
  • acquire()
  • release()
  • locked()