fastcore 2.1.1__tar.gz → 2.1.2__tar.gz

{fastcore-2.1.1/fastcore.egg-info → fastcore-2.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fastcore
-Version: 2.1.1
+Version: 2.1.2
 Summary: Python supercharged for fastai development
 Author-email: Jeremy Howard and Sylvain Gugger <infos@fast.ai>
 License: Apache-2.0

fastcore-2.1.2/fastcore/__init__.py

@@ -0,0 +1 @@
+__version__ = "2.1.2"

{fastcore-2.1.1 → fastcore-2.1.2}/fastcore/_modidx.py

@@ -483,7 +483,13 @@ d = { 'settings': { 'branch': 'main',
                                'fastcore.nbio.NbCell.__eq__': ('nbio.html#nbcell.__eq__', 'fastcore/nbio.py'),
                                'fastcore.nbio.NbCell.__hash__': ('nbio.html#nbcell.__hash__', 'fastcore/nbio.py'),
                                'fastcore.nbio.NbCell.__init__': ('nbio.html#nbcell.__init__', 'fastcore/nbio.py'),
+                               'fastcore.nbio.NbCell.__setattr__': ('nbio.html#nbcell.__setattr__', 'fastcore/nbio.py'),
+                               'fastcore.nbio.NbCell.__setitem__': ('nbio.html#nbcell.__setitem__', 'fastcore/nbio.py'),
+                               'fastcore.nbio.NbCell._partition': ('nbio.html#nbcell._partition', 'fastcore/nbio.py'),
+                               'fastcore.nbio.NbCell.directive': ('nbio.html#nbcell.directive', 'fastcore/nbio.py'),
+                               'fastcore.nbio.NbCell.has_directive': ('nbio.html#nbcell.has_directive', 'fastcore/nbio.py'),
                                'fastcore.nbio.NbCell.parsed_': ('nbio.html#nbcell.parsed_', 'fastcore/nbio.py'),
+                               'fastcore.nbio.NbCell.remove_directives': ('nbio.html#nbcell.remove_directives', 'fastcore/nbio.py'),
                                'fastcore.nbio.NbCell.set_source': ('nbio.html#nbcell.set_source', 'fastcore/nbio.py'),
                                'fastcore.nbio.Notebook': ('nbio.html#notebook', 'fastcore/nbio.py'),
                                'fastcore.nbio.Notebook.__contains__': ('nbio.html#notebook.__contains__', 'fastcore/nbio.py'),
@@ -506,8 +512,14 @@ d = { 'settings': { 'branch': 'main',
                                'fastcore.nbio.Notebook.save': ('nbio.html#notebook.save', 'fastcore/nbio.py'),
                                'fastcore.nbio.Notebook.view': ('nbio.html#notebook.view', 'fastcore/nbio.py'),
                                'fastcore.nbio._dict2obj': ('nbio.html#_dict2obj', 'fastcore/nbio.py'),
+                               'fastcore.nbio._dir_line': ('nbio.html#_dir_line', 'fastcore/nbio.py'),
+                               'fastcore.nbio._dir_pre': ('nbio.html#_dir_pre', 'fastcore/nbio.py'),
+                               'fastcore.nbio._directive': ('nbio.html#_directive', 'fastcore/nbio.py'),
+                               'fastcore.nbio._directives_get': ('nbio.html#_directives_get', 'fastcore/nbio.py'),
+                               'fastcore.nbio._directives_set': ('nbio.html#_directives_set', 'fastcore/nbio.py'),
                                'fastcore.nbio._is_json_mime': ('nbio.html#_is_json_mime', 'fastcore/nbio.py'),
                                'fastcore.nbio._join': ('nbio.html#_join', 'fastcore/nbio.py'),
+                               'fastcore.nbio._meta_directives': ('nbio.html#_meta_directives', 'fastcore/nbio.py'),
                                'fastcore.nbio._mkout': ('nbio.html#_mkout', 'fastcore/nbio.py'),
                                'fastcore.nbio._read_json': ('nbio.html#_read_json', 'fastcore/nbio.py'),
                                'fastcore.nbio._rejoin_cell': ('nbio.html#_rejoin_cell', 'fastcore/nbio.py'),
@@ -515,10 +527,12 @@ d = { 'settings': { 'branch': 'main',
                                'fastcore.nbio._render_text': ('nbio.html#_render_text', 'fastcore/nbio.py'),
                                'fastcore.nbio._split_cell': ('nbio.html#_split_cell', 'fastcore/nbio.py'),
                                'fastcore.nbio._split_mime': ('nbio.html#_split_mime', 'fastcore/nbio.py'),
+                               'fastcore.nbio._unparse_dir': ('nbio.html#_unparse_dir', 'fastcore/nbio.py'),
                                'fastcore.nbio.cell2xml': ('nbio.html#cell2xml', 'fastcore/nbio.py'),
                                'fastcore.nbio.cells2xml': ('nbio.html#cells2xml', 'fastcore/nbio.py'),
                                'fastcore.nbio.concat_streams': ('nbio.html#concat_streams', 'fastcore/nbio.py'),
                                'fastcore.nbio.dict2nb': ('nbio.html#dict2nb', 'fastcore/nbio.py'),
+                               'fastcore.nbio.first_code_ln': ('nbio.html#first_code_ln', 'fastcore/nbio.py'),
                                'fastcore.nbio.mk_cell': ('nbio.html#mk_cell', 'fastcore/nbio.py'),
                                'fastcore.nbio.mk_display': ('nbio.html#mk_display', 'fastcore/nbio.py'),
                                'fastcore.nbio.mk_error': ('nbio.html#mk_error', 'fastcore/nbio.py'),
@@ -526,6 +540,7 @@ d = { 'settings': { 'branch': 'main',
                                'fastcore.nbio.mk_stream': ('nbio.html#mk_stream', 'fastcore/nbio.py'),
                                'fastcore.nbio.nb2dict': ('nbio.html#nb2dict', 'fastcore/nbio.py'),
                                'fastcore.nbio.nb2str': ('nbio.html#nb2str', 'fastcore/nbio.py'),
+                               'fastcore.nbio.nb_lang': ('nbio.html#nb_lang', 'fastcore/nbio.py'),
                                'fastcore.nbio.new_nb': ('nbio.html#new_nb', 'fastcore/nbio.py'),
                                'fastcore.nbio.preferred_msg_out': ('nbio.html#preferred_msg_out', 'fastcore/nbio.py'),
                                'fastcore.nbio.preferred_out': ('nbio.html#preferred_out', 'fastcore/nbio.py'),
@@ -533,6 +548,8 @@ d = { 'settings': { 'branch': 'main',
                                'fastcore.nbio.render_output': ('nbio.html#render_output', 'fastcore/nbio.py'),
                                'fastcore.nbio.render_outputs': ('nbio.html#render_outputs', 'fastcore/nbio.py'),
                                'fastcore.nbio.render_text': ('nbio.html#render_text', 'fastcore/nbio.py'),
+                               'fastcore.nbio.repair_cell': ('nbio.html#repair_cell', 'fastcore/nbio.py'),
+                               'fastcore.nbio.repair_nb': ('nbio.html#repair_nb', 'fastcore/nbio.py'),
                                'fastcore.nbio.validate_cell': ('nbio.html#validate_cell', 'fastcore/nbio.py'),
                                'fastcore.nbio.validate_nb': ('nbio.html#validate_nb', 'fastcore/nbio.py'),
                                'fastcore.nbio.write_nb': ('nbio.html#write_nb', 'fastcore/nbio.py')},
@@ -542,7 +559,9 @@ d = { 'settings': { 'branch': 'main',
                               'fastcore.net._SafeRedirectHandler.redirect_request': ( 'net.html#_saferedirecthandler.redirect_request',
                                                                                       'fastcore/net.py'),
                               'fastcore.net._socket_det': ('net.html#_socket_det', 'fastcore/net.py'),
+                              'fastcore.net._waitfor': ('net.html#_waitfor', 'fastcore/net.py'),
                               'fastcore.net.http_response': ('net.html#http_response', 'fastcore/net.py'),
+                              'fastcore.net.is_port_free': ('net.html#is_port_free', 'fastcore/net.py'),
                               'fastcore.net.recv_once': ('net.html#recv_once', 'fastcore/net.py'),
                               'fastcore.net.start_client': ('net.html#start_client', 'fastcore/net.py'),
                               'fastcore.net.start_server': ('net.html#start_server', 'fastcore/net.py'),
@@ -557,7 +576,11 @@ d = { 'settings': { 'branch': 'main',
                               'fastcore.net.urlretrieve': ('net.html#urlretrieve', 'fastcore/net.py'),
                               'fastcore.net.urlsave': ('net.html#urlsave', 'fastcore/net.py'),
                               'fastcore.net.urlvalid': ('net.html#urlvalid', 'fastcore/net.py'),
-                              'fastcore.net.urlwrap': ('net.html#urlwrap', 'fastcore/net.py')},
+                              'fastcore.net.urlwrap': ('net.html#urlwrap', 'fastcore/net.py'),
+                              'fastcore.net.wait_port_free': ('net.html#wait_port_free', 'fastcore/net.py'),
+                              'fastcore.net.wait_port_free_async': ('net.html#wait_port_free_async', 'fastcore/net.py'),
+                              'fastcore.net.waitfor': ('net.html#waitfor', 'fastcore/net.py'),
+                              'fastcore.net.waitfor_async': ('net.html#waitfor_async', 'fastcore/net.py')},
             'fastcore.parallel': { 'fastcore.parallel.ProcessPoolExecutor': ('parallel.html#processpoolexecutor', 'fastcore/parallel.py'),
                                    'fastcore.parallel.ProcessPoolExecutor.__init__': ( 'parallel.html#processpoolexecutor.__init__',
                                                                                        'fastcore/parallel.py'),
@@ -852,6 +875,7 @@ d = { 'settings': { 'branch': 'main',
                                 'fastcore.xtras.ssh': ('xtras.html#ssh', 'fastcore/xtras.py'),
                                 'fastcore.xtras.str_diff': ('xtras.html#str_diff', 'fastcore/xtras.py'),
                                 'fastcore.xtras.stringfmt_names': ('xtras.html#stringfmt_names', 'fastcore/xtras.py'),
+                                'fastcore.xtras.take_lines': ('xtras.html#take_lines', 'fastcore/xtras.py'),
                                 'fastcore.xtras.time_policy': ('xtras.html#time_policy', 'fastcore/xtras.py'),
                                 'fastcore.xtras.timed_cache': ('xtras.html#timed_cache', 'fastcore/xtras.py'),
                                 'fastcore.xtras.trace': ('xtras.html#trace', 'fastcore/xtras.py'),

{fastcore-2.1.1 → fastcore-2.1.2}/fastcore/nbio.py

@@ -5,18 +5,20 @@ Docs: https://fastcore.fast.ai/nbio.html.md"""
 # AUTOGENERATED! DO NOT EDIT! File to edit: ../nbs/13_nbio.ipynb.
 
 # %% auto #0
-__all__ = ['NbCell', 'dict2nb', 'read_nb', 'mk_cell', 'new_nb', 'nb2dict', 'nb2str', 'write_nb', 'validate_cell', 'validate_nb',
-           'preferred_out', 'mk_stream', 'mk_result', 'mk_display', 'mk_error', 'concat_streams', 'preferred_msg_out',
-           'render_output', 'render_outputs', 'render_text', 'cell2xml', 'cells2xml', 'Notebook']
+__all__ = ['langs', 'nb_lang', 'NbCell', 'dict2nb', 'read_nb', 'mk_cell', 'new_nb', 'first_code_ln', 'nb2dict', 'nb2str',
+           'write_nb', 'validate_cell', 'validate_nb', 'repair_cell', 'repair_nb', 'preferred_out', 'mk_stream',
+           'mk_result', 'mk_display', 'mk_error', 'concat_streams', 'preferred_msg_out', 'render_output',
+           'render_outputs', 'render_text', 'cell2xml', 'cells2xml', 'Notebook']
 
 # %% ../nbs/13_nbio.ipynb #954ca1aa
 from .basics import *
-from .xtras import rtoken_hex,clean_cli_output
+from .xtras import rtoken_hex,clean_cli_output,take_lines
 from .imports import *
 from .ansi import ansi2html
 from .meta import delegates
 
 import ast,functools
+from collections import defaultdict
 from pprint import pformat,pprint
 from json import loads,dumps
 
@@ -42,18 +44,39 @@ def _rejoin_cell(c):
             if o.get('output_type') in ('execute_result','display_data'): _rejoin_mime(o.get('data', {}))
             elif o.get('output_type')=='stream' and isinstance(o.get('text'), list): o['text'] = ''.join(o['text'])
 
+# %% ../nbs/13_nbio.ipynb #e13f61b8
+# from https://github.com/quarto-dev/quarto-cli/blob/main/src/resources/jupyter/notebook.py
+langs = defaultdict(
+    lambda: '#',  r = "#", python = "#", julia = "#", scala = "//", matlab = "%", csharp = "//", fsharp = "//",
+    c = ["/*","*/"], css = ["/*","*/"], sas = ["*",";"], powershell = "#", bash = "#", sql = "--", mysql = "--", psql = "--",
+    lua = "--", cpp = "//", cc = "//", stan = "#", octave = "#", fortran = "!", fortran95 = "!", awk = "#", gawk = "#", stata = "*",
+    java = "//", groovy = "//", sed = "#", perl = "#", ruby = "#", tikz = "%", javascript = "//", js = "//", d3 = "//", node = "//",
+    sass = "//", coffee = "#", go = "//", asy = "//", haskell = "--", dot = "//", apl = "⍝")
+
+def nb_lang(nb): return nested_attr(nb, 'metadata.kernelspec.language', 'python')
+
 # %% ../nbs/13_nbio.ipynb #49d7bf89
 class NbCell(AttrDict):
-    def __init__(self, idx, cell):
+    def __init__(self, idx, cell, lang='python'):
         super().__init__(cell)
         self.idx_ = idx
+        self.lang_ = nested_attr(self, 'metadata.language', lang)
         if 'id' not in self: self.id = rtoken_hex(4)
         if 'source' in self: self.set_source(self.source)
         _rejoin_cell(self)
 
-    def set_source(self, source):
-        self.source = ''.join(source)
-        if '_parsed_' in self: del(self['_parsed_'])
+    def __setattr__(self, k, v):
+        prop = getattr(type(self), k, None)
+        if isinstance(prop, property) and prop.fset: prop.fset(self, v)
+        else: super().__setattr__(k, v)
+
+    def __setitem__(self, k, v):
+        super().__setitem__(k, v)
+        if k in ('source','metadata'):
+            for c in ('_parsed_','_directives_','_meta_names_'):
+                if c in self: del(self[c])
+
+    def set_source(self, source): self.source = ''.join(source)
 
     def parsed_(self):
         if self.cell_type!='code' or self.source.strip()[:1] in ['%', '!']: return
@@ -77,7 +100,7 @@ def _dict2obj(d, list_func=list, dict_func=AttrDict):
 def dict2nb(js=None, **kwargs):
     "Convert dict `js` to an `AttrDict`, "
     nb = _dict2obj(js or kwargs)
-    nb.cells = [NbCell(*o) for o in enumerate(nb.cells)]
+    nb.cells = [NbCell(i, o, nb_lang(nb)) for i,o in enumerate(nb.cells)]
     return nb
 
 # %% ../nbs/13_nbio.ipynb #0626f06e
@@ -104,9 +127,94 @@ def mk_cell(
 # %% ../nbs/13_nbio.ipynb #e7af3290
 def new_nb(cells=None, meta=None, nbformat=4, nbformat_minor=5):
     "Returns an empty new notebook"
-    cells = [o if isinstance(o,dict) else mk_cell(o) for o in cells]
+    cells = [o if isinstance(o,dict) else mk_cell(o) for o in cells or []]
     return dict2nb(cells=cells or [],metadata=meta or {},nbformat=nbformat,nbformat_minor=nbformat_minor)
 
+# %% ../nbs/13_nbio.ipynb #c2ed0d5e
+def _dir_pre(lang=None): return fr"\s*{langs[lang]}\s*\|"
+_cell_mgc = re.compile(r"^\s*%%\w+")
+
+def first_code_ln(code_list, re_pattern=None, lang='python'):
+    "get first line number where code occurs, where `code_list` is a list of code"
+    if re_pattern is None: re_pattern = _dir_pre(lang)
+    return first(i for i,o in enumerate(code_list) if o.strip() != '' and not re.match(re_pattern, o) and not _cell_mgc.match(o))
+
+# %% ../nbs/13_nbio.ipynb #b0cc33c0
+def _directive(s, lang='python'):
+    "Parse a directive line into `(name, value)`; None if `s` is not a directive line"
+    if not re.match(_dir_pre(lang), s): return None
+    s = re.sub('^'+_dir_pre(lang), '', s).strip()
+    m = re.match(r'([^\s:]+)\s*:?\s?(.*?)\s*$', s, flags=re.S)
+    if not m: return None
+    name,v = m.groups()
+    return name, ('' if v=='true' else v)
+
+# %% ../nbs/13_nbio.ipynb #16c08410
+def _meta_directives(cell):
+    "Directives from the `nbdev` dict in cell metadata, as `{name: value}`"
+    def _v(v):
+        if isinstance(v,bool): return '' if v else 'false'
+        if isinstance(v,(list,tuple)): return ' '.join(map(str,v))
+        return '' if v=='true' else str(v)
+    return {k:_v(v) for k,v in cell.get('metadata',{}).get('nbdev',{}).items()}
+
+def _unparse_dir(v):
+    "Inverse of `_meta_directives` value parsing: value string back to a metadata value"
+    if v=='': return True
+    if v=='false': return False
+    return v
+
+def _dir_line(k, v, lang='python', quarto=False):
+    "A canonical directive comment line; with `quarto`, bare directives render as `: true`"
+    if quarto and not v: v = 'true'
+    return f"{langs[lang]}| {k}" + (f": {v}" if v else '') + '\n'
+
+# %% ../nbs/13_nbio.ipynb #428ecb6a
+@patch
+def _partition(self:NbCell):
+    "Split source into leading directive lines (with magics and blanks) and the rest"
+    dirs = take_lines(self.source, fr'^({_dir_pre(self.lang_)}|\s*%%\w+|\s*$)')
+    return dirs.splitlines(True), self.source[len(dirs):].splitlines(True)
+
+def _directives_get(self):
+    "Directives from leading comments and the metadata `nbdev` key; comments win. Assign a modified copy back to update the cell."
+    if '_directives_' not in self:
+        dirs,_ = self._partition()
+        cmts = dict(t for t in (_directive(s, self.lang_) for s in dirs) if t)
+        meta = _meta_directives(self)
+        self['_meta_names_'] = set(meta) - set(cmts)
+        self['_directives_'] = cmts | {k:v for k,v in meta.items() if k not in cmts}
+    return dict(self['_directives_'])
+
+def _directives_set(self, d):
+    if d == self.directives: return
+    mnames = self['_meta_names_']
+    meta = {k:_unparse_dir(v) for k,v in d.items() if k in mnames}
+    lines = [_dir_line(k, v, self.lang_) for k,v in d.items() if k not in mnames]
+    if meta: self.setdefault('metadata', AttrDict())['nbdev'] = meta
+    elif 'nbdev' in self.get('metadata', {}): del self.metadata['nbdev']
+    dirs,code = self._partition()
+    self.set_source(''.join([o for o in dirs if _cell_mgc.match(o)] + lines + code))
+
+NbCell.directives = property(_directives_get, _directives_set)
+
+# %% ../nbs/13_nbio.ipynb #281f7f8a
+@patch
+def directive(self:NbCell, name, default=None):
+    "Value of directive `name` (`''` if bare), or `default` if absent"
+    return self.directives.get(name, default)
+
+@patch
+def has_directive(self:NbCell, name): return self.directive(name) is not None
+
+@patch
+def remove_directives(self:NbCell, quarto=False):
+    "Strip directives from source, keeping cell magics; with `quarto`, instead materialize every directive (metadata included) as a Quarto option line"
+    dirs,code = self._partition()
+    keep = [o for o in dirs if _cell_mgc.match(o)]
+    if quarto: keep += [_dir_line(k, v, self.lang_, quarto=True) for k,v in self.directives.items()]
+    self.set_source(''.join(keep + code))
+
 # %% ../nbs/13_nbio.ipynb #7c7bab22
 def _split_mime(data):
     "Copy of mimebundle `data` with multiline text split to lists of lines, like nbformat's `split_lines`"
@@ -171,6 +279,47 @@ def validate_nb(nb):
     if dups := {o for o in ids if ids.count(o)>1}: raise ValueError(f"duplicate cell id(s): {', '.join(sorted(dups))}")
     return nb
 
+# %% ../nbs/13_nbio.ipynb #d38902eb
+def repair_cell(cell, idx=None):
+    "Fix deterministic structural problems in `cell`, returning a list of repairs made"
+    res,where = [],f"cell {cell.get('id', idx)}"
+    src = cell.get('source', '')
+    if not (isinstance(src,str) or (isinstance(src,list) and all(isinstance(o,str) for o in src))):
+        cell['source'] = ''.join(map(str, listify(src)))
+        res.append(f"{where}: coerced source to text")
+    if not isinstance(cell.get('metadata', {}), dict):
+        cell['metadata'] = {}
+        res.append(f"{where}: reset non-dict metadata")
+    if cell.get('cell_type')=='code':
+        if not isinstance(cell.get('outputs'), list):
+            cell['outputs'] = []
+            res.append(f"{where}: added outputs list")
+        if 'execution_count' not in cell:
+            cell['execution_count'] = None
+            res.append(f"{where}: added execution_count")
+    else:
+        for k in ('outputs','execution_count'):
+            if k in cell:
+                del cell[k]
+                res.append(f"{where}: removed {k}")
+    return res
+
+def repair_nb(nb):
+    "Fix deterministic structural problems in `nb`, returning a list of repairs made"
+    res = []
+    for k,v in dict(cells=[], metadata={}, nbformat=4).items():
+        if k not in nb:
+            nb[k] = v
+            res.append(f"added notebook {k}")
+    for i,c in enumerate(nb['cells']): res += repair_cell(c, i)
+    seen = set()
+    for c in nb['cells']:
+        if (i := c.get('id')) in seen:
+            c['id'] = rtoken_hex(4)
+            res.append(f"cell {i}: duplicate id, regenerated as {c['id']}")
+        seen.add(c.get('id'))
+    return res
+
 # %% ../nbs/13_nbio.ipynb #530b9cd1
 from .xml import NB,to_xml,ft,item2xml
 

{fastcore-2.1.1 → fastcore-2.1.2}/fastcore/net.py

@@ -7,7 +7,8 @@ Docs: https://fastcore.fast.ai/net.html.md"""
 # %% auto #0
 __all__ = ['url_default_headers', 'ExceptionsHTTP', 'urlquote', 'urlwrap', 'HTTP4xxClientError', 'HTTP5xxServerError',
            'urlopener', 'urlopen', 'urlread', 'urljson', 'urlclean', 'urlretrieve', 'urldest', 'urlsave', 'urlvalid',
-           'start_server', 'start_client', 'tobytes', 'http_response', 'recv_once', 'HTTP400BadRequestError',
+           'start_server', 'start_client', 'tobytes', 'http_response', 'recv_once', 'waitfor', 'waitfor_async',
+           'is_port_free', 'wait_port_free', 'wait_port_free_async', 'HTTP400BadRequestError',
            'HTTP401UnauthorizedError', 'HTTP402PaymentRequiredError', 'HTTP403ForbiddenError', 'HTTP404NotFoundError',
            'HTTP405MethodNotAllowedError', 'HTTP406NotAcceptableError', 'HTTP407ProxyAuthRequiredError',
            'HTTP408RequestTimeoutError', 'HTTP409ConflictError', 'HTTP410GoneError', 'HTTP411LengthRequiredError',
@@ -23,7 +24,7 @@ from .utils import *
 from .parallel import *
 
 import json,urllib,contextlib,tempfile
-import socket,urllib.request,urllib,asyncio,threading
+import socket,urllib.request,urllib,asyncio,threading,time
 from contextlib import contextmanager
 from urllib.request import Request,urlretrieve
 from urllib.error import HTTPError,URLError
@@ -240,3 +241,39 @@ def recv_once(host:str='localhost', port:int=8000):
     res = conn.recv(1024)
     conn.sendall(http_response(res))
     return res
+
+# %% ../nbs/03b_net.ipynb #8896fe36
+def _waitfor(f, timeout, msg):
+    end = time.time()+timeout
+    while not f():
+        if time.time()>end: raise TimeoutError(msg or f"Timeout after {timeout}s")
+        yield 0.1
+
+def waitfor(f, timeout=20, msg=None):
+    "Call `f` every 0.1s until it returns truthy, raising `TimeoutError` with `msg` after `timeout` secs"
+    for d in _waitfor(f, timeout, msg): time.sleep(d)
+
+async def waitfor_async(f, timeout=20, msg=None):
+    "Async version of `waitfor`"
+    for d in _waitfor(f, timeout, msg): await asyncio.sleep(d)
+
+# %% ../nbs/03b_net.ipynb #38a94895
+def is_port_free(port, host='localhost'):
+    "Is `port` free on `host`?"
+    sock = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
+    sock.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1)
+    try:
+        sock.bind((host,port))
+        sock.listen(1)
+        return True
+    except OSError: return False
+    finally: sock.close()
+
+# %% ../nbs/03b_net.ipynb #e0a7369a
+def wait_port_free(port, host='localhost', max_wait=20):
+    "Wait for `port` to be free on `host`"
+    waitfor(partial(is_port_free, port, host), max_wait, f"Port {host}:{port} not free after {max_wait}s")
+
+async def wait_port_free_async(port, host='localhost', max_wait=20):
+    "Async wait for `port` to be free on `host`"
+    await waitfor_async(partial(is_port_free, port, host), max_wait, f"Port {host}:{port} not free after {max_wait}s")

{fastcore-2.1.1 → fastcore-2.1.2}/fastcore/xtras.py

@@ -9,14 +9,14 @@ __all__ = ['UNSET', 'spark_chars', 'walk_join', 'walk', 'exttypes', 'globtastic'
            'img_bytes', 'detect_mime', 'bunzip', 'loads', 'loads_multi', 'dumps', 'untar_dir', 'repo_details', 'shell',
            'ssh', 'rsync_multi', 'run', 'open_file', 'save_pickle', 'load_pickle', 'parse_env', 'expand_wildcards',
            'atomic_save', 'load_mod', 'import_no_init', 'save_config_file', 'read_config_file', 'find_file_parents',
-           'Config', 'Unset', 'dict2obj', 'obj2dict', 'repr_dict', 'is_listy', 'mapped', 'IterLen', 'ReindexCollection',
-           'SaveReturn', 'trim_wraps', 'save_iter', 'asave_iter', 'frontmatter', 'clean_cli_output', 'unqid',
-           'rtoken_hex', 'friendly_name', 'n_friendly_names', 'exec_eval', 'get_source_link', 'sparkline',
-           'modify_exception', 'round_multiple', 'set_num_threads', 'join_path_file', 'autostart', 'EventTimer',
-           'stringfmt_names', 'PartialFormatter', 'partial_format', 'truncstr', 'str_diff', 'utc2local', 'local2utc',
-           'trace', 'modified_env', 'ContextManagers', 'shufflish', 'console_help', 'hl_md', 'type2str',
-           'dataclass_src', 'nullable_dc', 'make_nullable', 'flexiclass', 'asdict', 'vars_pub', 'is_typeddict',
-           'is_namedtuple', 'CachedIter', 'flexicache', 'time_policy', 'mtime_policy', 'timed_cache']
+           'Config', 'Unset', 'dict2obj', 'obj2dict', 'repr_dict', 'is_listy', 'mapped', 'take_lines', 'IterLen',
+           'ReindexCollection', 'SaveReturn', 'trim_wraps', 'save_iter', 'asave_iter', 'frontmatter',
+           'clean_cli_output', 'unqid', 'rtoken_hex', 'friendly_name', 'n_friendly_names', 'exec_eval',
+           'get_source_link', 'sparkline', 'modify_exception', 'round_multiple', 'set_num_threads', 'join_path_file',
+           'autostart', 'EventTimer', 'stringfmt_names', 'PartialFormatter', 'partial_format', 'truncstr', 'str_diff',
+           'utc2local', 'local2utc', 'trace', 'modified_env', 'ContextManagers', 'shufflish', 'console_help', 'hl_md',
+           'type2str', 'dataclass_src', 'nullable_dc', 'make_nullable', 'flexiclass', 'asdict', 'vars_pub',
+           'is_typeddict', 'is_namedtuple', 'CachedIter', 'flexicache', 'time_policy', 'mtime_policy', 'timed_cache']
 
 # %% ../nbs/03_xtras.ipynb #3401d507
 from .imports import *
@@ -562,6 +562,17 @@ def mapped(f, it):
     "map `f` over `it`, unless it's not listy, in which case return `f(it)`"
     return L(it).map(f) if is_listy(it) else f(it)
 
+# %% ../nbs/03_xtras.ipynb #062ca713
+def take_lines(s, pat, atstart=True, atend=False, drop=False):
+    "Take contiguous lines matching `pat` from either end of `s`"
+    ls,pred = s.splitlines(keepends=True),re.compile(pat).search
+    i,j = 0,len(ls)
+    if atstart:
+        while i<j and pred(ls[i]): i += 1
+    if atend:
+        while i<j and pred(ls[j-1]): j -= 1
+    return ''.join(ls[i:j] if drop else ls[:i]+ls[j:])
+
 # %% ../nbs/03_xtras.ipynb #ab0758e6
 @patch
 def readlines(self:Path, hint=-1, encoding='utf8'):

{fastcore-2.1.1 → fastcore-2.1.2/fastcore.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fastcore
-Version: 2.1.1
+Version: 2.1.2
 Summary: Python supercharged for fastai development
 Author-email: Jeremy Howard and Sylvain Gugger <infos@fast.ai>
 License: Apache-2.0

{fastcore-2.1.1 → fastcore-2.1.2}/pyproject.toml

@@ -44,6 +44,5 @@ tst_flags = ''
 custom_sidebar = false
 allowed_cell_metadata_keys = ['solveit_ai']
 
-
 [tool.chkstyle]
 skip_paths = ["_modidx.py"]

fastcore-2.1.1/fastcore/__init__.py

@@ -1 +0,0 @@
-__version__ = "2.1.1"