Jul 16, 2024 · Jun 19, 2025 · Jun 20, 2025 · Jun 26, 2025 · Jun 30, 2025 · Jun 30, 2025
diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
        name: Run Ruff (lint) on Doc/
        args: [--exit-non-zero-on-fix]
        files: ^Doc/
        exclude: ^Doc/howto/multiple-interpreters-run-examples.py
      - id: ruff
        name: Run Ruff (lint) on Lib/test/
        args: [--exit-non-zero-on-fix]
        name: Run Ruff (format) on Doc/
        args: [--check]
        files: ^Doc/
        exclude: ^Doc/howto/multiple-interpreters-run-examples.py
      - id: ruff-format
        name: Run Ruff (format) on Tools/build/check_warnings.py
        args: [--check, --config=Tools/build/.ruff.toml]
diff --git a/Doc/howto/index.rst b/Doc/howto/index.rst
   isolating-extensions.rst
   timerfd.rst
   mro.rst
   multiple-interpreters.rst
   free-threading-python.rst
   free-threading-extensions.rst
   remote_debugging.rst
 * :ref:`freethreading-python-howto`
 * :ref:`freethreading-extensions-howto`
 * :ref:`isolating-extensions-howto`
 * :ref:`multiple-interpreters-howto`
 * :ref:`python_2.3_mro`
 * :ref:`socket-howto`
 * :ref:`timerfd-howto`
diff --git a/Doc/howto/multiple-interpreters-run-examples.py b/Doc/howto/multiple-interpreters-run-examples.py
 importos
 importos.path
 importshutil
 importsubprocess
 importsys
 importtempfile
 fromtextwrapimportdedent
 importtraceback


 HOWTO_DIR=os.path.dirname(__file__)
 HOWTO_FILE=os.path.join(HOWTO_DIR,'multiple-interpreters.rst')

 VERBOSITY=3


 defget_examples(lines):
 examples= {}
 current=None
 expected=None
 start=None
 forlno,lineinenumerate(lines,1):
 ifcurrentisNone:
 ifline.endswith('::'):
 # It *might* be an example.
 current= []
 else:
 ifnotcurrent:
 ifline.strip():
 ifline=='    from concurrent import interpreters':
 # It *is* an example.
 current.append(line)
 expected= []
 start=lno
 else:
 # It wasn't actually an example.
 current=None
 elifnotline.strip()orline.startswith('    '):
 # The example continues.
 current.append(line)
 before,sep,after=line.partition('# prints: ')
 ifsep:
 assertnotbefore.strip(),before
 expected.append(after)
 else:
 # We've reached the end of the example.
 assertnotcurrent[-1].strip(),current
 example=dedent(os.linesep.join(current))
 expected=''.join(f'{l}{os.linesep}'forlinexpected)
 examples[start]= (example,expected)
 current=expected=start=None

 ifline.endswith('::'):
 # It *might* be an example.
 current= []
 ifcurrent:
 ifcurrent[-1].strip():
 current.append('')
 example=dedent(os.linesep.join(current))
 expected=''.join(f'{l}{os.linesep}'forlinexpected)
 examples[start]= (example,expected)
 current=expected=start=None
 returnexamples


 defwrite_example(examplesdir,name,text):
 filename=os.path.join(examplesdir,f'example-{name}.py')
 withopen(filename,'w')asoutfile:
 outfile.write(text)
 returnfilename,name,text


 defrun_example(filename,expected):
 ifisinstance(expected,str):
 rc=0
 stdout=expected
 stderr=''
 else:
 rc,stdout,stderr=expected

 proc=subprocess.run(
        [sys.executable,filename],
 stdout=subprocess.PIPE,
 stderr=subprocess.PIPE,
 text=True,
 cwd=os.path.dirname(filename),
    )
 ifproc.returncode!=rc:
 ifproc.returncode!=0andproc.stderr:
 print(proc.stderr)
 raiseAssertionError((proc.returncode,rc))
 assertproc.stdout==stdout, (proc.stdout,stdout)
 assertproc.stderr==stderr, (proc.stderr,stderr)


 #######################################
 # the script

 defparse_args(argv=sys.argv[1:],prog=sys.argv[0]):
 importargparse
 parser=argparse.ArgumentParser(prog=prog)

 parser.add_argument('--dry-run',dest='dryrun',action='store_true')

 parser.add_argument('-v','--verbose',action='count',default=0)
 parser.add_argument('-q','--quiet',action='count',default=0)

 parser.add_argument('requested',nargs='*')

 args=parser.parse_args(argv)
 ns=vars(args)

 args.verbosity=max(0,VERBOSITY+ns.pop('verbose')-ns.pop('quiet'))

 requested= []
 forreqinargs.requested:
 foriinreq.replace(',',' ').split():
 requested.append(int(i))
 args.requested=requestedorNone

 returnns


 defmain(requested=None,*,verbosity=VERBOSITY,dryrun=False):
 withopen(HOWTO_FILE)asinfile:
 examples=get_examples(l.rstrip(os.linesep)forlininfile)
 examplesdir=tempfile.mkdtemp(prefix='multi-interp-howto-')
 try:
 ifrequested:
 requested=set(requested)
 _req=f',{len(requested)} requested'
 else:
 _req=''
 summary=f'({len(examples)} found{_req})'
 print('#',summary)

 failed= []
 fori, (lno, (text,expected))inenumerate(examples.items(),1):
 ifrequestedandinotinrequested:
 continue
 name='multiinterp-{i}'
 print()
 print('#'*60)
 print(f'# example{i}  ({os.path.relpath(HOWTO_FILE)}:{lno})')
 print('#'*60)
 print()
 ifverbosity>VERBOSITYor (verbosity==VERBOSITYanddryrun):
 print(text)
 print('----')
 ifexpected.rstrip():
 print(expected.rstrip(os.linesep))
 print('----')
 ifdryrun:
 continue
 filename,_,_=write_example(examplesdir,name,text)
 try:
 run_example(filename,expected)
 exceptException:
 traceback.print_exc()
 failed.append(str(i))

 print()
 iffailed:
 print(f'{len(failed)} failed:{",".join(failed)}')
 else:
 print(f'all succeeded')
 print(summary)

 returnlen(failed)
 finally:
 shutil.rmtree(examplesdir)


 if__name__=='__main__':
 kwargs=parse_args()
 ec=main(**kwargs)
 sys.exit(ec)
Original file line number	Diff line number	Diff line change
Expand Up		@@ -32,6 +32,7 @@ Python Library Reference.
		isolating-extensions.rst
		timerfd.rst
		mro.rst
		multiple-interpreters.rst
		free-threading-python.rst
		free-threading-extensions.rst
		remote_debugging.rst
Expand All		@@ -57,6 +58,7 @@ Advanced development:
		* :ref:`freethreading-python-howto`
		* :ref:`freethreading-extensions-howto`
		* :ref:`isolating-extensions-howto`
		* :ref:`multiple-interpreters-howto`
		* :ref:`python_2.3_mro`
		* :ref:`socket-howto`
		* :ref:`timerfd-howto`
Expand Down