---

codeop.py

r"""Utilities to compile possibly incomplete Python source code. This module provides two interfaces, broadly similar to the builtin function compile(), which take program text, a filename and a 'mode' and: - Return code object if the command is complete and valid - Return None if the command is incomplete - Raise SyntaxError, ValueError or OverflowError if the command is a syntax error (OverflowError and ValueError can be produced by malformed literals). The two interfaces are: compile_command(source, filename, symbol): Compiles a single command in the manner described above. CommandCompiler(): Instances of this class have __call__ methods identical in signature to compile_command; the difference is that if the instance compiles program text containing a __future__ statement, the instance 'remembers' and compiles all subsequent program texts with the statement in force. The module also provides another class: Compile(): Instances of this class act like the built-in function compile, but with 'memory' in the sense described above. """ import __future__ import warnings _features = [getattr(__future__, fname) for fname in __future__.all_feature_names] __all__ = ["compile_command", "Compile", "CommandCompiler"] # The following flags match the values from Include/cpython/compile.h # Caveat emptor: These flags are undocumented on purpose and depending # on their effect outside the standard library is **unsupported**. PyCF_DONT_IMPLY_DEDENT = 0x200 PyCF_ALLOW_INCOMPLETE_INPUT = 0x4000 def _maybe_compile(compiler, source, filename, symbol): # Check for source consisting of only blank lines and comments. for line in source.split("\n"): line = line.strip() if line and line[0] != '#': break # Leave it alone. else: if symbol != "eval": source = "pass" # Replace it with a 'pass' statement # Disable compiler warnings when checking for incomplete input. with warnings.catch_warnings(): warnings.simplefilter("ignore", (SyntaxWarning, DeprecationWarning)) try: compiler(source, filename, symbol) except SyntaxError: # Let other compile() errors propagate. try: compiler(source + "\n", filename, symbol) return None except SyntaxError as e: if "incomplete input" in str(e): return None # fallthrough return compiler(source, filename, symbol, incomplete_input=False) def _is_syntax_error(err1, err2): rep1 = repr(err1) rep2 = repr(err2) if "was never closed" in rep1 and "was never closed" in rep2: return False if rep1 == rep2: return True return False def _compile(source, filename, symbol, incomplete_input=True): flags = 0 if incomplete_input: flags |= PyCF_ALLOW_INCOMPLETE_INPUT flags |= PyCF_DONT_IMPLY_DEDENT return compile(source, filename, symbol, flags) def compile_command(source, filename="<input>", symbol="single"): r"""Compile a command and determine whether it is incomplete. Arguments: source -- the source string; may contain \n characters filename -- optional filename from which source was read; default "<input>" symbol -- optional grammar start symbol; "single" (default), "exec" or "eval" Return value / exceptions raised: - Return a code object if the command is complete and valid - Return None if the command is incomplete - Raise SyntaxError, ValueError or OverflowError if the command is a syntax error (OverflowError and ValueError can be produced by malformed literals). """ return _maybe_compile(_compile, source, filename, symbol) class Compile: """Instances of this class behave much like the built-in compile function, but if one is used to compile text containing a future statement, it "remembers" and compiles all subsequent program texts with the statement in force.""" def __init__(self): self.flags = PyCF_DONT_IMPLY_DEDENT | PyCF_ALLOW_INCOMPLETE_INPUT def __call__(self, source, filename, symbol, **kwargs): flags = self.flags if kwargs.get('incomplete_input', True) is False: flags &= ~PyCF_DONT_IMPLY_DEDENT flags &= ~PyCF_ALLOW_INCOMPLETE_INPUT codeob = compile(source, filename, symbol, flags, True) for feature in _features: if codeob.co_flags & feature.compiler_flag: self.flags |= feature.compiler_flag return codeob class CommandCompiler: """Instances of this class have __call__ methods identical in signature to compile_command; the difference is that if the instance compiles program text containing a __future__ statement, the instance 'remembers' and compiles all subsequent program texts with the statement in force.""" def __init__(self,): self.compiler = Compile() def __call__(self, source, filename="<input>", symbol="single"): r"""Compile a command and determine whether it is incomplete. Arguments: source -- the source string; may contain \n characters filename -- optional filename from which source was read; default "<input>" symbol -- optional grammar start symbol; "single" (default) or "eval" Return value / exceptions raised: - Return a code object if the command is complete and valid - Return None if the command is incomplete - Raise SyntaxError, ValueError or OverflowError if the command is a syntax error (OverflowError and ValueError can be produced by malformed literals). """ return _maybe_compile(self.compiler, source, filename, symbol)

---

docroot: /home/induvedam/public_html

---

curdir: /opt/alt/python312/lib64/python3.12

	.		8192
	..		114
X	LICENSE.txt		13936
X	__future__.py		5218
X	__hello__.py		227
	__pycache__		28672
X	_aix_support.py		4021
X	_collections_abc.py		32089
X	_compat_pickle.py		8761
X	_compression.py		5681
X	_markupbase.py		14653
X	_osx_support.py		22023
X	_py_abc.py		6189
X	_pydatetime.py		92087
X	_pydecimal.py		227283
X	_pyio.py		93593
X	_pylong.py		10790
X	_sitebuiltins.py		3128
X	_strptime.py		28393
X	_sysconfigdata__linux_x86_64-linux-gnu.py		77582
X	_sysconfigdata_d_linux_x86_64-linux-gnu.py		77578
X	_threading_local.py		7220
X	_weakrefset.py		5893
X	abc.py		6538
X	aifc.py		34211
X	antigravity.py		500
X	argparse.py		101155
X	ast.py		64452
	asyncio		4096
X	base64.py		20648
X	bdb.py		33573
X	bisect.py		3423
X	bz2.py		11847
X	cProfile.py		6569
X	calendar.py		25864
X	cgi.py		34432
X	cgitb.py		12421
X	chunk.py		5500
X	cmd.py		14873
X	code.py		10962
X	codecs.py		36870
X	codeop.py		5908
	collections		58
X	colorsys.py		4062
X	compileall.py		20507
	concurrent		59
	config-3.12-x86_64-linux-gnu		4096
X	configparser.py		54331
X	contextlib.py		27637
X	contextvars.py		129
X	copy.py		8412
X	copyreg.py		7614
X	crypt.py		3913
X	csv.py		17132
	ctypes		127
	curses		112
X	dataclasses.py		62085
X	datetime.py		268
	dbm		88
X	decimal.py		2805
X	difflib.py		83368
X	dis.py		30227
X	doctest.py		106749
	email		4096
	encodings		8192
	ensurepip		84
X	enum.py		81540
X	filecmp.py		10381
X	fileinput.py		15714
X	fnmatch.py		5999
X	fractions.py		38147
X	ftplib.py		35240
X	functools.py		37940
X	genericpath.py		5572
X	getopt.py		7488
X	getpass.py		5990
X	gettext.py		21320
X	glob.py		8732
X	graphlib.py		9648
X	gzip.py		25402
X	hashlib.py		9349
X	heapq.py		23024
X	hmac.py		7716
	html		80
	http		116
X	imaplib.py		54245
X	imghdr.py		4398
	importlib		4096
X	inspect.py		127125
X	io.py		3582
X	ipaddress.py		81414
	json		113
X	keyword.py		1073
	lib-dynload		8192
	lib2to3		4096
X	linecache.py		5800
X	locale.py		78599
	logging		80
X	lzma.py		13277
X	mailbox.py		78911
X	mailcap.py		9333
X	mimetypes.py		23338
X	modulefinder.py		23699
	multiprocessing		4096
X	netrc.py		6922
X	nntplib.py		41087
X	ntpath.py		30404
X	nturl2path.py		2374
X	numbers.py		11467
X	opcode.py		13174
X	operator.py		10965
X	optparse.py		60369
X	os.py		40858
X	pathlib.py		51052
X	pdb.py		70311
X	pickle.py		66911
X	pickletools.py		94052
X	pipes.py		8978
X	pkgutil.py		18281
X	platform.py		43402
X	plistlib.py		28582
X	poplib.py		14742
X	posixpath.py		17356
X	pprint.py		24158
X	profile.py		23106
X	pstats.py		29289
X	pty.py		6137
X	py_compile.py		7837
X	pyclbr.py		11396
X	pydoc.py		113522
	pydoc_data		79
X	queue.py		11496
X	quopri.py		7197
X	random.py		34689
	re		122
X	reprlib.py		7148
X	rlcompleter.py		7827
X	runpy.py		12885
X	sched.py		6351
X	secrets.py		1984
X	selectors.py		19671
X	shelve.py		8560
X	shlex.py		13353
X	shutil.py		56608
X	signal.py		2495
	site-packages		43
X	site.py		23198
X	smtplib.py		43545
X	sndhdr.py		7448
X	socket.py		37815
X	socketserver.py		28065
	sqlite3		95
X	sre_compile.py		231
X	sre_constants.py		232
X	sre_parse.py		229
X	ssl.py		51536
X	stat.py		5485
X	statistics.py		50227
X	string.py		11786
X	stringprep.py		25834
X	struct.py		257
X	subprocess.py		88747
X	sunau.py		18478
X	symtable.py		12477
X	sysconfig.py		31850
X	tabnanny.py		11545
X	tarfile.py		114929
X	telnetlib.py		23334
X	tempfile.py		35406
X	textwrap.py		19718
X	this.py		1003
X	threading.py		60200
X	timeit.py		13477
X	token.py		2511
X	tokenize.py		21570
	tomllib		93
X	trace.py		29366
X	traceback.py		46393
X	tracemalloc.py		18047
X	tty.py		2035
X	types.py		10993
X	typing.py		118836
	unittest		4096
	urllib		135
X	uu.py		7341
X	uuid.py		29656
	venv		78
X	warnings.py		21909
X	wave.py		22769
X	weakref.py		21513
X	webbrowser.py		24220
	wsgiref		155
X	xdrlib.py		5942
	xml		94
	xmlrpc		78
X	zipapp.py		7543
	zipfile		76
X	zipimport.py		27840
	zoneinfo		100