2j<:SrSSKJr SSKrSSKrSSKrSSKrSSKrSSKrSSK r SSK r \R"\ 5RRr\S- r\S- r\S- S- r\R$"S5r\R$"S5r\R$"S 5r\R$"S 5rS r\R0"\5rSS jrSS jrSSSjjrSSjrSSjrSSjr SSjr!\S:Xa"\RD"\RFS9 \"5 gg)aPCommand-line interface for the ``portalocker`` package. Invoked as ``python -m portalocker``. The only subcommand is `combine`, which bundles the package into a single vendorable ``portalocker.py`` file; see `combine` for what that transform does and why it exists. Every file this module reads while doing that -- the package's own modules, ``README.md`` and ``LICENSE`` -- is opened with ``encoding='ascii'`` (see `_read_file` and `combine`). That means the entire ``portalocker`` source tree, plus ``README.md`` and ``LICENSE``, must stay ASCII-only: a non-ASCII character in any of them makes this module raise `UnicodeDecodeError` instead of silently mis-decoding it. ``portalocker_tests/test_combined.py`` asserts the combined output can still be produced, which is how a stray non-ASCII character elsewhere in the package would be caught. ) annotationsN portalockerdistzportalocker.pyz(?P[^()]+)$z=^from \.(?P.*?) import (?P\(?)(?P[^()]+)$z^(?P\w+) = \1\n$z!if (?:typing\.)?TYPE_CHECKING\s*:z ''' {} ''' c URup#pEnSnU[XG- S5XW-n[RSUSUSUSUSU<3 5 g) aLog a snippet of `path` around the bytes that failed to decode. Shared by every ASCII read in this module (see `_read_text_ascii`), so a stray non-ASCII byte in a source file, ``README.md`` or ``LICENSE`` always produces an error naming the offending file and showing the surrounding context instead of a bare traceback. Args: path: The file that failed to decode, named in the log message. exception: The decode failure. Its ``args`` carry the undecoded bytes and the offset range of the offending byte(s). drzInvalid encoding for z: z at byte (:z ) Snippet: N)argsmaxloggererror) path exception_text start_byteend_byter offsetsnippets ڢC:\Users\johnn\AppData\Local\Packages\PythonSoftwareFoundation.Python.3.13_qbz5n2kfra8p0\LocalCache\local-packages\Python313\site-packages\portalocker/__main__.py_log_decode_errorr2sj ,5>>(AZ5 F3z*A.1BCG LL vRw/ .`` prefix removed for every `name` in `names`, and then with a resulting useless self-assignment (``spam = spam``, left behind when a qualified name turned out to equal its own unqualified form) removed entirely. |z\b(z)\.)joinresub_USELESS_ASSIGNMENT_RE)rTr< joined_namess rrErEsD< xx vv\N#.D9 " % %b$ //rc## U(d UShvN gUH"nUR5(aUU3OUv M$ gN.7f)aPrefix each non-blank inlined line with ``indent``. Used when a relative import is itself indented (e.g. the optional-redis guard's ``try`` block): the inlined module is emitted at that indentation so it stays inside the guard while preserving its own relative structure. N)rD)linesrVrTs rrMrM%s@ #'::<<T9 s A>/Ac URnS[R[[S- 55[R[[S- 55/n[ 5nUR [[S- U55 URRSSS9 URSRU55 [RSU35 [R "S S [#U5/S S 9 [R "S S SS[#U5/S S 9 [R "[(R*[#U5/5 g![$a [R'S5 NQf=f)a) Bundle the package into a single vendorable ``portalocker.py`` file. This is the ``combine`` subcommand's implementation (see `main`). It exists for projects that cannot add ``portalocker`` as a dependency -- for example a vendoring or single-file-deployment constraint -- and instead copy one generated file with the same public API into their own tree. Starting from ``portalocker/__init__.py``, the package's modules are read with `_read_file`, which inlines every relative import recursively (so the result has none left) while leaving ``TYPE_CHECKING`` blocks intact. That includes the optional ``try: from .redis import RedisLock`` guard in ``__init__.py``: ``redis.py`` is inlined the same way as any other sibling module, re-indented to stay inside the ``try``, so the combined file binds `RedisLock` the same way the package does -- to the stub class that raises ``ImportError`` on construction if importing it fails. Every module under `src_path`, plus ``README.md`` and ``LICENSE``, is read with ``encoding='ascii'`` (see the module docstring): all of them must be ASCII-only or this raises `UnicodeDecodeError`. ``README.md`` and ``LICENSE`` are also written near the top of the output, each wrapped in a triple-quoted string, for reference; they are not the output file's docstring, since the single ``from __future__ import annotations`` line this function writes first has to stay the first statement. All inputs are read and assembled in memory first, and the output file is only opened once the assembly has succeeded. Writing first used to truncate ``--output-file`` before the first input was read, so a decode failure destroyed a pre-existing build. A plain write is deliberate here: ``--output-file`` legitimately overwrites its previous build, which is exactly the no-replace semantic `portalocker.utils.open_atomic` exists to forbid. If the ``ruff`` command is available, the output is formatted and lint-fixed in place; if not, that step is skipped with a warning. Either way, the output is then executed once with `sys.executable`. That run's exit status is not checked, so it surfaces problems in the log rather than failing `combine` itself. Args: args: Parsed CLI namespace; only `args.output_file` is used. Populated by `main` via the ``combine`` subparser, whose ``--output-file``/``-o`` option defaults to `_default_output_path` (``dist/portalocker.py``). Note: The combined file still needs the ``redis`` package installed for `RedisLock` to work: combining inlines the code that binds to ``redis``, not ``redis`` itself. z#from __future__ import annotations z README.mdLICENSEz __init__.pyT)parentsexist_okrZzWrote combined file to ruffformat)timeoutcheckz--fixz --fix-onlyzextendrNrOparentmkdir write_textr[r info subprocessrunstrrwarningsys executable)r output_pathpartsrPs rr#r#5s/j!% 0 0K /.y;/FGH.y9/DEF E%(EJ LLH}4jABTD92775>* KK)+78  #k*:;QG Wg|S5E F NNCNNC $456   J  sAE E-,E-__main__)level)r pathlib.PathrrreturnNone)r r}r~ru)N)r2ztyping.Sequence[str] | Noner~r)r r}rPzset[pathlib.Path]r~typing.Iterator[str])rTrur<zset[str]r~ru)rarrVrur~r)r zargparse.Namespacer~r)$__doc__r8rr(r@loggingr-r\rsrwtypingr.__file__rormrO dist_pathr/compilerIrJr^rFrl getLogger__name__r rr r6rNrErMr# basicConfigINFOrrrs`"#   LL " ) ) 0 0 } $    6),<< JJ, - jjD$=>JJCD   8 $ ! 6+6'Tj+ j+!j+j+Z#0L :  :), : : S7l z gll+Fr