fastcore 2.2.28__tar.gz → 2.2.30__tar.gz

{fastcore-2.2.28/fastcore.egg-info → fastcore-2.2.30}/PKG-INFO

@@ -1,9 +1,9 @@
 Metadata-Version: 2.4
 Name: fastcore
-Version: 2.2.28
+Version: 2.2.30
 Summary: Python supercharged for fastai development
 Author-email: Jeremy Howard and Sylvain Gugger <infos@fast.ai>
-License: Apache-2.0
+License-Expression: Apache-2.0
 Project-URL: Repository, https://github.com/AnswerDotAI/fastcore/
 Project-URL: Documentation, https://fastcore.fast.ai/
 Keywords: python

{fastcore-2.2.28 → fastcore-2.2.30}/fastcore/__init__.py

@@ -55,4 +55,4 @@ Modules:
 - `fastcore.xml`: Concise HTML generation and namespace-aware XML construction.
 - `fastcore.xtras`: Utility functions used in the fastai library"""
 
-__version__ = "2.2.28"
+__version__ = "2.2.30"

{fastcore-2.2.28 → fastcore-2.2.30}/fastcore/_modidx.py

@@ -33,8 +33,6 @@ d = { 'settings': { 'branch': 'main',
                               'fastcore.aio.then': ('aio.html#then', 'fastcore/aio.py'),
                               'fastcore.aio.to_aiter': ('aio.html#to_aiter', 'fastcore/aio.py'),
                               'fastcore.aio.wait_until': ('aio.html#wait_until', 'fastcore/aio.py')},
-            'fastcore.all': {},
-            'fastcore.ansi': {},
             'fastcore.apisurface': { 'fastcore.apisurface.OpGroup': ('apisurface.html#opgroup', 'fastcore/apisurface.py'),
                                      'fastcore.apisurface.OpGroup.__allow__': ( 'apisurface.html#opgroup.__allow__',
                                                                                 'fastcore/apisurface.py'),
@@ -306,7 +304,6 @@ d = { 'settings': { 'branch': 'main',
                                  'fastcore.basics.wrap_class': ('basics.html#wrap_class', 'fastcore/basics.py'),
                                  'fastcore.basics.xdumps': ('basics.html#xdumps', 'fastcore/basics.py'),
                                  'fastcore.basics.zip_cycle': ('basics.html#zip_cycle', 'fastcore/basics.py')},
-            'fastcore.dispatch': {},
             'fastcore.docments': { 'fastcore.docments.DocmentList': ('docments.html#docmentlist', 'fastcore/docments.py'),
                                    'fastcore.docments.DocmentList._fmt': ('docments.html#docmentlist._fmt', 'fastcore/docments.py'),
                                    'fastcore.docments.DocmentList._repr_markdown_': ( 'docments.html#docmentlist._repr_markdown_',
@@ -392,8 +389,6 @@ d = { 'settings': { 'branch': 'main',
                                    'fastcore.docments.qual_name': ('docments.html#qual_name', 'fastcore/docments.py'),
                                    'fastcore.docments.sig2str': ('docments.html#sig2str', 'fastcore/docments.py'),
                                    'fastcore.docments.sig_source': ('docments.html#sig_source', 'fastcore/docments.py')},
-            'fastcore.docscrape': {},
-            'fastcore.editskill': {},
             'fastcore.foundation': { 'fastcore.foundation.CollBase': ('foundation.html#collbase', 'fastcore/foundation.py'),
                                      'fastcore.foundation.CollBase.__delitem__': ( 'foundation.html#collbase.__delitem__',
                                                                                    'fastcore/foundation.py'),
@@ -513,8 +508,6 @@ d = { 'settings': { 'branch': 'main',
                                    'fastcore.funccall.resolve_nm': ('funccall.html#resolve_nm', 'fastcore/funccall.py'),
                                    'fastcore.funccall.schema2sig': ('funccall.html#schema2sig', 'fastcore/funccall.py'),
                                    'fastcore.funccall.union_schema': ('funccall.html#union_schema', 'fastcore/funccall.py')},
-            'fastcore.imghdr': {},
-            'fastcore.imports': {},
             'fastcore.meta': { 'fastcore.meta.AutoInit': ('meta.html#autoinit', 'fastcore/meta.py'),
                                'fastcore.meta.AutoInit.__pre_init__': ('meta.html#autoinit.__pre_init__', 'fastcore/meta.py'),
                                'fastcore.meta.BypassNewMeta': ('meta.html#bypassnewmeta', 'fastcore/meta.py'),
@@ -541,7 +534,6 @@ d = { 'settings': { 'branch': 'main',
                                'fastcore.meta.test_sig': ('meta.html#test_sig', 'fastcore/meta.py'),
                                'fastcore.meta.use_kwargs': ('meta.html#use_kwargs', 'fastcore/meta.py'),
                                'fastcore.meta.use_kwargs_dict': ('meta.html#use_kwargs_dict', 'fastcore/meta.py')},
-            'fastcore.nb_imports': {},
             'fastcore.nbio': { 'fastcore.nbio.CellRow': ('nbio.html#cellrow', 'fastcore/nbio.py'),
                                'fastcore.nbio.CellRow.__init__': ('nbio.html#cellrow.__init__', 'fastcore/nbio.py'),
                                'fastcore.nbio.CellRow.__repr__': ('nbio.html#cellrow.__repr__', 'fastcore/nbio.py'),
@@ -753,10 +745,10 @@ d = { 'settings': { 'branch': 'main',
                                  'fastcore.script.bool_arg': ('script.html#bool_arg', 'fastcore/script.py'),
                                  'fastcore.script.call_parse': ('script.html#call_parse', 'fastcore/script.py'),
                                  'fastcore.script.is_cli': ('script.html#is_cli', 'fastcore/script.py'),
+                                 'fastcore.script.parse_cli': ('script.html#parse_cli', 'fastcore/script.py'),
                                  'fastcore.script.set_ctx': ('script.html#set_ctx', 'fastcore/script.py'),
                                  'fastcore.script.store_false': ('script.html#store_false', 'fastcore/script.py'),
                                  'fastcore.script.store_true': ('script.html#store_true', 'fastcore/script.py')},
-            'fastcore.shutil': {},
             'fastcore.style': { 'fastcore.style.Style': ('style.html#style', 'fastcore/style.py'),
                                 'fastcore.style.Style.__call__': ('style.html#style.__call__', 'fastcore/style.py'),
                                 'fastcore.style.Style.__dir__': ('style.html#style.__dir__', 'fastcore/style.py'),
@@ -801,8 +793,6 @@ d = { 'settings': { 'branch': 'main',
                                 'fastcore.tools.str_replace': ('tools.html#str_replace', 'fastcore/tools.py'),
                                 'fastcore.tools.strs_replace': ('tools.html#strs_replace', 'fastcore/tools.py'),
                                 'fastcore.tools.view_file': ('tools.html#view_file', 'fastcore/tools.py')},
-            'fastcore.transform': {},
-            'fastcore.utils': {},
             'fastcore.xdg': { 'fastcore.xdg._path_from_env': ('xdg.html#_path_from_env', 'fastcore/xdg.py'),
                               'fastcore.xdg._paths_from_env': ('xdg.html#_paths_from_env', 'fastcore/xdg.py'),
                               'fastcore.xdg.xdg_cache_home': ('xdg.html#xdg_cache_home', 'fastcore/xdg.py'),

{fastcore-2.2.28 → fastcore-2.2.30}/fastcore/editskill.py

@@ -50,7 +50,7 @@ Edits accept line numbers, lnhash addresses, or section tokens. Get addresses wh
 
 Prefer lnhash addresses when `exhash` is installed. The editor checks the hash against current content and rejects stale addresses. Plain line numbers are unverified and can shift after an edit. Re-view after each plain-line-number edit and apply multiple edits from bottom to top. Read `exhash.skill` for address formats and verified editing.
 
-Section tokens identify sections in document outlines. In `1.6.|12|a3f2|,45|b1c3|`, `1.6.` is the section number. The rest is the lnhash range for its first and last lines. `d.at(token)` returns the section after checking its hash. `d.view(tok1, tok2)` prints the rendered text of both sections. Use the boundary range to edit the section: `file_exhash(path, ('12|a3f2|,45|b1c3|', 'c', new_text))`.
+Section tokens identify sections in document outlines. In `1.6.|12|Py|,45|HD|`, `1.6.` is the section number. The rest is the lnhash range for its first and last lines. `d.at(token)` returns the section after checking its hash. `d.view(tok1, tok2)` prints the rendered text of both sections. Use the boundary range to edit the section: `file_exhash(path, ('12|Py|,45|HD|', 'c', new_text))`.
 
 Read `exhash.skill` before working through large Markdown, code, or notebook files, or documentation from a URL. It describes `open_doc` tree searches and link following, including the llms.txt workflow.
 

{fastcore-2.2.28 → fastcore-2.2.30}/fastcore/script.py

@@ -79,6 +79,8 @@ Enums show their choices as `{choice,...}`. Positional parameters show their nam
 
 Union types such as `int|str` try each type in turn, and `enum` types such as those from `str_enum` become argparse choices.
 
+`parse_cli` is the argument-handling half of a `call_parse` run. It parses `sys.argv` for `func`. It returns the positional arguments, the keyword arguments, and whether `--pdb` was passed. `call_parse` then calls `func` with them. Use `parse_cli` to write a decorator that reads arguments as `call_parse` does and runs `func` some other way. [warmpy](https://github.com/AnswerDotAI/warmpy) runs it in a warm background process.
+
 ## The CLI entry point
 
 `call_parse` parses `sys.argv` when you run the function's file directly with `python foo.py`, `python -m foo` or `%run foo.py`. It also parses arguments on a zero-argument call from the top-level body of a directly run file. Console-script wrappers use this form.
@@ -130,8 +132,8 @@ Docs: https://fastcore.fast.ai/script.html.md"""
 # AUTOGENERATED! DO NOT EDIT! File to edit: ../nbs/06_script.ipynb.
 
 # %% auto #0
-__all__ = ['store_true', 'store_false', 'bool_arg', 'anno2str', 'anno_parser', 'args_from_prog', 'set_ctx', 'call_parse',
-           'is_cli', 'CliError']
+__all__ = ['store_true', 'store_false', 'bool_arg', 'anno2str', 'anno_parser', 'args_from_prog', 'set_ctx', 'parse_cli',
+           'call_parse', 'is_cli', 'CliError']
 
 # %% ../nbs/06_script.ipynb #8a36db98
 import inspect,argparse,shutil,types,asyncio,importlib.metadata
@@ -303,20 +305,26 @@ def _pos_split(func, args):
         ks.append(k)
     return [],args
 
+# %% ../nbs/06_script.ipynb #1456b39c
+def parse_cli(func, nested=False, pos:list=None):
+    "Positional args, keyword args, and the `--pdb` flag that `sys.argv` gives for `func`"
+    if len(sys.argv)>1 and sys.argv[1]=='': sys.argv.pop(1)
+    p = anno_parser(func, pos=pos)
+    if nested: args, sys.argv[1:] = p.parse_known_args()
+    else: args = p.parse_args()
+    args = args.__dict__
+    xtra = otherwise(args.pop('xtra', ''), eq(1), p.prog)
+    pdb = args.pop('pdb', False)
+    return *_pos_split(func, merge(args, args_from_prog(func, xtra))), pdb
+
 # %% ../nbs/06_script.ipynb #dee5e259
 _cli_func = ContextVar('_cli_func', default=None)
 
 def _run_cli(func, nested, pos=None):
-    "Parse `sys.argv` with `anno_parser` and call `func` with the result"
+    "Call `func` with the arguments `parse_cli` reads from `sys.argv`"
     with set_ctx(_cli_func, func):
-        if len(sys.argv)>1 and sys.argv[1]=='': sys.argv.pop(1)
-        p = anno_parser(func, pos=pos)
-        if nested: args, sys.argv[1:] = p.parse_known_args()
-        else: args = p.parse_args()
-        args = args.__dict__
-        xtra = otherwise(args.pop('xtra', ''), eq(1), p.prog)
-        tfunc = trace(func) if args.pop('pdb', False) else func
-        pargs,args = _pos_split(func, merge(args, args_from_prog(func, xtra)))
+        pargs,args,pdb = parse_cli(func, nested, pos)
+        tfunc = trace(func) if pdb else func
         try:
             res = tfunc(*pargs, **args)
             if inspect.isawaitable(res): res = asyncio.run(res)

{fastcore-2.2.28 → fastcore-2.2.30}/fastcore/tools.py

@@ -4,7 +4,7 @@ The text editors take a string and return the edited text. Invalid edits raise `
 
 Read `fastcore.editskill` for the editing toolkit's naming, parameter and workflow conventions. It exposes these tools alongside the notebook editors from `fastcore.nbio`.
 
-`line_hash`, `lnhash` and `lnhash_at` create [exhash](https://answerdotai.github.io/exhash) addresses without depending on the exhash package. Addresses use `lineno|hash|`. The hash is the low 16 bits of CRC32, formatted as four hexadecimal characters.
+`line_hash`, `lnhash` and `lnhash_at` create [exhash](https://answerdotai.github.io/exhash) addresses without depending on the exhash package. Addresses use `lineno|hash|`. The hash is the low 12 bits of CRC32, encoded as two Base64url characters (`A–Z`, `a–z`, `0–9`, `-`, `_`), high six bits first.
 
 File editors take the path first and return a unified diff. An unchanged result returns `none: No changes.` Invalid edits return `error: ...`.
 
@@ -152,8 +152,10 @@ def del_lines(
 def line_hash(
     line:str # Text to hash; when hashing a single line, omit its trailing newline
 )->str:
-    "4-char hex hash of `line`"
-    return f'{zlib.crc32(line.encode()) & 0xffff:04x}'
+    "2-char Base64url hash of `line`"
+    alphabet = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_'
+    h = zlib.crc32(line.encode())
+    return alphabet[(h>>6)&63] + alphabet[h&63]
 
 def lnhash(
     lineno:int, # 1-based line number

{fastcore-2.2.28 → fastcore-2.2.30/fastcore.egg-info}/PKG-INFO

@@ -1,9 +1,9 @@
 Metadata-Version: 2.4
 Name: fastcore
-Version: 2.2.28
+Version: 2.2.30
 Summary: Python supercharged for fastai development
 Author-email: Jeremy Howard and Sylvain Gugger <infos@fast.ai>
-License: Apache-2.0
+License-Expression: Apache-2.0
 Project-URL: Repository, https://github.com/AnswerDotAI/fastcore/
 Project-URL: Documentation, https://fastcore.fast.ai/
 Keywords: python

{fastcore-2.2.28 → fastcore-2.2.30}/pyproject.toml

@@ -1,5 +1,5 @@
 [build-system]
-requires = ["setuptools>=64"]
+requires = ["setuptools>=77"]
 build-backend = "setuptools.build_meta"
 
 [project]
@@ -8,7 +8,7 @@ dynamic = ["version"]
 description = "Python supercharged for fastai development"
 readme = "README.md"
 requires-python = ">=3.10"
-license = {text = "Apache-2.0"}
+license = "Apache-2.0"
 authors = [{name = "Jeremy Howard and Sylvain Gugger", email = "infos@fast.ai"}]
 keywords = ['python']
 classifiers = ["Natural Language :: English", "Intended Audience :: Developers", "Development Status :: 5 - Production/Stable", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3 :: Only"]