nbdev 2.3.32__py3-none-any.whl → 2.3.34__py3-none-any.whl

nbdev/__init__.py

@@ -1,4 +1,4 @@
-__version__ = "2.3.32"
+__version__ = "2.3.34"
 
 from .doclinks import nbdev_export
 from .showdoc import show_doc

nbdev/_modidx.py

@@ -3,7 +3,7 @@
 d = { 'settings': { 'branch': 'master',
                 'doc_baseurl': '/',
                 'doc_host': 'https://nbdev.fast.ai',
-                'git_url': 'https://github.com/fastai/nbdev',
+                'git_url': 'https://github.com/AnswerDotAI/nbdev',
                 'lib_path': 'nbdev'},
   'syms': { 'nbdev.clean': { 'nbdev.clean._add_jupyter_hooks': ('api/clean.html#_add_jupyter_hooks', 'nbdev/clean.py'),
                              'nbdev.clean._clean_cell': ('api/clean.html#_clean_cell', 'nbdev/clean.py'),
@@ -58,6 +58,7 @@ d = { 'settings': { 'branch': 'master',
                                 'nbdev.doclinks.NbdevLookup.link_line': ('api/doclinks.html#nbdevlookup.link_line', 'nbdev/doclinks.py'),
                                 'nbdev.doclinks.NbdevLookup.linkify': ('api/doclinks.html#nbdevlookup.linkify', 'nbdev/doclinks.py'),
                                 'nbdev.doclinks._binop_leafs': ('api/doclinks.html#_binop_leafs', 'nbdev/doclinks.py'),
+                                'nbdev.doclinks._build_lookup_table': ('api/doclinks.html#_build_lookup_table', 'nbdev/doclinks.py'),
                                 'nbdev.doclinks._build_modidx': ('api/doclinks.html#_build_modidx', 'nbdev/doclinks.py'),
                                 'nbdev.doclinks._find_mod': ('api/doclinks.html#_find_mod', 'nbdev/doclinks.py'),
                                 'nbdev.doclinks._get_exps': ('api/doclinks.html#_get_exps', 'nbdev/doclinks.py'),
@@ -69,6 +70,7 @@ d = { 'settings': { 'branch': 'master',
                                 'nbdev.doclinks._qual_sym': ('api/doclinks.html#_qual_sym', 'nbdev/doclinks.py'),
                                 'nbdev.doclinks._qual_syms': ('api/doclinks.html#_qual_syms', 'nbdev/doclinks.py'),
                                 'nbdev.doclinks._sym_nm': ('api/doclinks.html#_sym_nm', 'nbdev/doclinks.py'),
+                                'nbdev.doclinks.create_index': ('api/doclinks.html#create_index', 'nbdev/doclinks.py'),
                                 'nbdev.doclinks.nbdev_export': ('api/doclinks.html#nbdev_export', 'nbdev/doclinks.py'),
                                 'nbdev.doclinks.nbglob': ('api/doclinks.html#nbglob', 'nbdev/doclinks.py'),
                                 'nbdev.doclinks.nbglob_cli': ('api/doclinks.html#nbglob_cli', 'nbdev/doclinks.py'),

nbdev/config.py

@@ -138,7 +138,7 @@ def _cfg2txt(cfg, head, sections, tail=''):
 
 # %% ../nbs/api/01_config.ipynb
 _nbdev_cfg_head = '''# All sections below are required unless otherwise specified.
-# See https://github.com/fastai/nbdev/blob/master/settings.ini for examples.
+# See https://github.com/AnswerDotAI/nbdev/blob/main/settings.ini for examples.
 
 '''
 _nbdev_cfg_sections = {'Python library': 'repo lib_name version min_python license black_formatting',

nbdev/doclinks.py

@@ -3,7 +3,7 @@
 # AUTOGENERATED! DO NOT EDIT! File to edit: ../nbs/api/05_doclinks.ipynb.
 
 # %% auto 0
-__all__ = ['patch_name', 'nbglob', 'nbglob_cli', 'nbdev_export', 'NbdevLookup']
+__all__ = ['typs', 'bset', 'patch_name', 'nbglob', 'nbglob_cli', 'nbdev_export', 'create_index', 'NbdevLookup']
 
 # %% ../nbs/api/05_doclinks.ipynb
 from .config import *
@@ -14,14 +14,18 @@ from .imports import *
 from fastcore.script import *
 from fastcore.utils import *
 from fastcore.meta import delegates
+from fastcore.net import urlread
 
-import ast,contextlib
+import ast,builtins,contextlib
 import pkg_resources,importlib
-from astunparse import unparse
 
+from astunparse import unparse
+from io import BytesIO
+from collections import defaultdict
 from pprint import pformat
 from urllib.parse import urljoin
 from functools import lru_cache
+from types import ModuleType
 
 # %% ../nbs/api/05_doclinks.ipynb
 def _sym_nm(klas, sym): return f'{unparse(klas).strip()}.{sym.name}'
@@ -152,6 +156,28 @@ def nbdev_export(
     add_init(get_config().lib_path)
     _build_modidx()
 
+# %% ../nbs/api/05_doclinks.ipynb
+typs = 'module','class','method','function'
+bset = set(dir(builtins))
+
+# %% ../nbs/api/05_doclinks.ipynb
+def create_index(url, pre=None):
+    "Create a documentation index from a sphinx inventory file at `url`, with optional prefix `pre`"
+    try: from sphinx.util.inventory import InventoryFile
+    except ImportError: raise ImportError('`sphinx` is a dependency for building indexes. Run `pip install sphinx` to use `create_index`.')
+    pre = ifnone(pre, f"{url}/")
+    invs = urlread(f'{url}/objects.inv', decode=False)
+    idx = InventoryFile.load(stream=BytesIO(invs), uri=pre, joinfunc=urljoin)
+    _get = lambda o: {k:v[2] for k,v in idx[f'py:{o}'].items() if k[0]!='_'}
+    d = {o:_get(o) for o in typs}
+    syms = defaultdict(dict)
+    for o in typs:
+        for k,v in d[o].items():
+            if k.split('.')[0] in bset: k = 'builtins.' + k
+            modparts = k.split(".")[:-2 if o=='method' else -1]
+            if modparts: syms['.'.join(modparts)][k] = v
+    return syms
+
 # %% ../nbs/api/05_doclinks.ipynb
 import importlib,ast
 from functools import lru_cache
@@ -166,6 +192,7 @@ def _find_mod(mod):
 
 @lru_cache(None)
 def _get_exps(mod):
+    "Get the line numbers for function and class definitions in module"
     mf = _find_mod(mod)
     if not mf: return {}
     txt = mf.read_text(encoding='utf-8')
@@ -181,6 +208,7 @@ def _lineno(sym, fname): return _get_exps(fname).get(sym, None) if fname else No
 
 # %% ../nbs/api/05_doclinks.ipynb
 def _qual_sym(s, settings):
+    "Get qualified nb, py, and github paths for a symbol s"
     if not isinstance(s,tuple): return s
     nb,py = s
     nbbase = urljoin(settings["doc_host"]+'/',settings["doc_baseurl"])
@@ -199,30 +227,41 @@ _re_backticks = re.compile(r'`([^`\s]+?)(?:\(\))?`')
 
 # %% ../nbs/api/05_doclinks.ipynb
 @lru_cache(None)
+def _build_lookup_table(strip_libs=None, incl_libs=None, skip_mods=None):
+    cfg = get_config()
+    if strip_libs is None:
+        try: strip_libs = cfg.get('strip_libs', cfg.get('lib_path', 'nbdev').name).split()
+        except FileNotFoundError: strip_libs = 'nbdev'
+    skip_mods = setify(skip_mods)
+    strip_libs = L(strip_libs)
+    if incl_libs is not None: incl_libs = (L(incl_libs)+strip_libs).unique()
+    entries = {}
+    for o in pkg_resources.iter_entry_points(group='nbdev'):
+        if incl_libs is not None and o.dist.key not in incl_libs: continue
+        try: entries[o.name] = _qual_syms(o.resolve())
+        except Exception: pass
+    py_syms = merge(*L(o['syms'].values() for o in entries.values()).concat())
+    for m in strip_libs:
+        if m in entries:
+            _d = entries[m]
+            stripped = {remove_prefix(k,f"{mod}."):v
+                        for mod,dets in _d['syms'].items() if mod not in skip_mods
+                        for k,v in dets.items()}
+            py_syms = merge(stripped, py_syms)
+    return entries,py_syms
+
+# %% ../nbs/api/05_doclinks.ipynb
 class NbdevLookup:
     "Mapping from symbol names to docs and source URLs"
-    def __init__(self, strip_libs=None, incl_libs=None, skip_mods=None):
-        cfg = get_config()
-        if strip_libs is None:
-            try: strip_libs = cfg.get('strip_libs', cfg.get('lib_path', 'nbdev').name).split()
-            except FileNotFoundError: strip_libs = 'nbdev'
-        skip_mods = setify(skip_mods)
-        strip_libs = L(strip_libs)
-        if incl_libs is not None: incl_libs = (L(incl_libs)+strip_libs).unique()
-        # Dict from lib name to _nbdev module for incl_libs (defaults to all)
-        self.entries = {o.name: _qual_syms(o.resolve()) for o in list(pkg_resources.iter_entry_points(group='nbdev'))
-                       if incl_libs is None or o.dist.key in incl_libs}
-        py_syms = merge(*L(o['syms'].values() for o in self.entries.values()).concat())
-        for m in strip_libs:
-            if m in self.entries:
-                _d = self.entries[m]
-                stripped = {remove_prefix(k,f"{mod}."):v
-                            for mod,dets in _d['syms'].items() if mod not in skip_mods
-                            for k,v in dets.items()}
-                py_syms = merge(stripped, py_syms)
-        self.syms = py_syms
-
-    def __getitem__(self, s): return self.syms.get(s, None)
+    def __init__(self, strip_libs=None, incl_libs=None, skip_mods=None, ns=None):
+        self.entries,self.syms = _build_lookup_table(strip_libs, incl_libs, skip_mods)
+        self.aliases = {n:o.__name__ for n,o in (ns or {}).items() if isinstance(o, ModuleType)}
+        
+    def __getitem__(self, s): 
+        if '.' in s:
+            pre,post = s.split('.', 1)
+            if pre in self.aliases: s = f"{self.aliases[pre]}.{post}"
+        return self.syms.get(s, None)
 
     def doc(self, sym):
         "Link to docs for `sym`"

nbdev/processors.py

@@ -249,7 +249,7 @@ class exec_show_docs(Processor):
         if _do_eval(cell): self.k.cell(cell)
         title = fm.get('title', '')
         if self.k.exc: 
-            raise Exception(f"Error{' in notebook: '+title if title else ''} in cell {cell.idx_} :\n{cell.source}") from self.k.exc[1]
+            raise Exception(f"Error{' in notebook: '+title if title else ''} in cell {cell.idx_} :\n{cell.source}") from self.k.exc
 
     def end(self):
         try: from ipywidgets import Widget

{nbdev-2.3.32.dist-info → nbdev-2.3.34.dist-info}/METADATA

@@ -1,8 +1,8 @@
 Metadata-Version: 2.1
 Name: nbdev
-Version: 2.3.32
+Version: 2.3.34
 Summary: Create delightful software with Jupyter Notebooks
-Home-page: https://github.com/fastai/nbdev
+Home-page: https://github.com/AnswerDotAI/nbdev
 Author: Jeremy Howard and Hamel Husain
 Author-email: j@fast.ai
 License: Apache Software License 2.0
@@ -41,6 +41,7 @@ Requires-Dist: svg.py ; extra == 'dev'
 Requires-Dist: nbclassic ; extra == 'dev'
 Requires-Dist: pysymbol-llm ; extra == 'dev'
 Requires-Dist: llms-txt ; extra == 'dev'
+Requires-Dist: sphinx ; extra == 'dev'
 
 # Getting Started
 

{nbdev-2.3.32.dist-info → nbdev-2.3.34.dist-info}/RECORD

@@ -1,9 +1,9 @@
-nbdev/__init__.py,sha256=Yi4HGTGFuc0G5fWdpRdXjvmn5qNQJiVSA056USVp8MU,90
-nbdev/_modidx.py,sha256=WzOr4ZDIJcKGYijdH-9OUIx3Nn0PZg9_-LwarG_SiWc,41011
+nbdev/__init__.py,sha256=ZX6ZpzceYLyy-v7u62yWomGalDXO3B7da54WH-xylnQ,90
+nbdev/_modidx.py,sha256=mquJnE_EgW0V2fUzt93Fn_NkWBG-wZUrvpQl_1NsHo4,41270
 nbdev/clean.py,sha256=mVgsW2_g7KIXAVh8mwpj86UwMN6QVM-q33PDzA27nWw,9410
 nbdev/cli.py,sha256=8YWXu9jDiVpTd9mhCealLNAd5Fg3xCpNklpZ6Fc8tD0,7045
-nbdev/config.py,sha256=B_LbvyTLi2jDI53MTWypJhgXD8PoyY0ztRzPhYEnG7s,12225
-nbdev/doclinks.py,sha256=5Eoeaoo6HmgmsfLl8q95uw4GpkmMhT_igL0ogys7kk4,10670
+nbdev/config.py,sha256=RQGR-zTmsZrjfszDDF0qdAMnyvmMS7Kn0ccMFLrxnh8,12228
+nbdev/doclinks.py,sha256=-ET_sYAiAU2TnyxXFFFoUSqzI7SyqcL5viS_zg_Z6ms,12334
 nbdev/export.py,sha256=IonpKGYthPgAjEGrm8sK36O2yflQFaxLEXBBrEYe5q4,3955
 nbdev/extract_attachments.py,sha256=O4mS4EFIOXL_yQ3jmsnBStrWxGR_nPNvxLYXHtLeimw,2208
 nbdev/frontmatter.py,sha256=i195bhDLWd-WUEzQT9JBoA4Ee3j6gD1dKMT8yk5fF4Y,2761
@@ -12,7 +12,7 @@ nbdev/maker.py,sha256=JrvvtG23_tgT4i-zzDrUF1GmLhdL_9j4S-dcD-GVui4,9801
 nbdev/merge.py,sha256=xmT7LMY_mQGOGl0ynqkB13M6HwJfUOTis1Xl--YDXR8,4341
 nbdev/migrate.py,sha256=YJTtWC6TPaZpZTcD0Jex6stOSumjju2QrUozF9rvl0Y,7311
 nbdev/process.py,sha256=Vb3SN5YW2gB9rYv5ToeveOeL9qM9AGLRPXCyAFiaE3g,5853
-nbdev/processors.py,sha256=vtby1GBM-iz6axnhPIVU-HTN8jNYA6CzsT-N_EGcUlE,11976
+nbdev/processors.py,sha256=fS4WrowC8bi6sFJJUVA9r9IRgmk-gffrJ9zNfb7vpIM,11973
 nbdev/qmd.py,sha256=VAxE-c1sT7y26VdyreB6j9fge-CuLbHWocRE_WbnYXg,2994
 nbdev/quarto.py,sha256=o-fRR5gqWKvIjr-k4f_XfN3LpMIsO0URC9yEtDOJHLs,12053
 nbdev/release.py,sha256=K8Q7CU-fM5TyLy5Q8AswpA3vE5CHa8aHaeKU9LHtlv0,14159
@@ -21,9 +21,9 @@ nbdev/serve_drv.py,sha256=IZ2acem_KKsXYYe0iUECiR_orkYLBkT1ZG_258ZS7SQ,657
 nbdev/showdoc.py,sha256=v7qUzyr5gMN99jZMzal_ulRLsn617BkRMS1XEq9UqjE,10033
 nbdev/sync.py,sha256=ld-lSOmlX1FdnTOzaSHcxKyIuIguI_SpluqfPSH2BZ8,3201
 nbdev/test.py,sha256=_ECBd5fvfGEICIfkTI2S8w8YatL5CaPltCeDSsiH6yw,4435
-nbdev-2.3.32.dist-info/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-nbdev-2.3.32.dist-info/METADATA,sha256=i5sRYqowR09nR_av8Pr6E1obUDxR1ByNadiYSWmt00E,10510
-nbdev-2.3.32.dist-info/WHEEL,sha256=yQN5g4mg4AybRjkgi-9yy4iQEFibGQmlz78Pik5Or-A,92
-nbdev-2.3.32.dist-info/entry_points.txt,sha256=P7LtWbUX0nXuV5g7HJtSDdTWjn7cq9a9uv3p6VoYDz8,1400
-nbdev-2.3.32.dist-info/top_level.txt,sha256=3cWYLMuaXsZjz3TQRGEkWGs9Z8ieEDmYcq8TZS3y3vU,6
-nbdev-2.3.32.dist-info/RECORD,,
+nbdev-2.3.34.dist-info/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+nbdev-2.3.34.dist-info/METADATA,sha256=gzDkAX7jEZuJZyLf8vYx8bXqDFPLEm8lhX12X5_XkwA,10554
+nbdev-2.3.34.dist-info/WHEEL,sha256=yQN5g4mg4AybRjkgi-9yy4iQEFibGQmlz78Pik5Or-A,92
+nbdev-2.3.34.dist-info/entry_points.txt,sha256=P7LtWbUX0nXuV5g7HJtSDdTWjn7cq9a9uv3p6VoYDz8,1400
+nbdev-2.3.34.dist-info/top_level.txt,sha256=3cWYLMuaXsZjz3TQRGEkWGs9Z8ieEDmYcq8TZS3y3vU,6
+nbdev-2.3.34.dist-info/RECORD,,