nbdev 2.3.32__tar.gz → 2.3.34__tar.gz

{nbdev-2.3.32/nbdev.egg-info → nbdev-2.3.34}/PKG-INFO

@@ -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 → nbdev-2.3.34}/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-2.3.32 → nbdev-2.3.34}/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-2.3.32 → nbdev-2.3.34}/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-2.3.32 → nbdev-2.3.34}/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-2.3.32 → nbdev-2.3.34}/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 → nbdev-2.3.34/nbdev.egg-info}/PKG-INFO

@@ -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 → nbdev-2.3.34}/nbdev.egg-info/requires.txt

@@ -19,3 +19,4 @@ svg.py
 nbclassic
 pysymbol_llm
 llms-txt
+sphinx

{nbdev-2.3.32 → nbdev-2.3.34}/settings.ini

@@ -4,12 +4,12 @@ repo = nbdev
 description = Create delightful software with Jupyter Notebooks
 copyright = 2020 onwards, Jeremy Howard
 keywords = nbdev fastai jupyter notebook export
-user = fastai
+user = AnswerDotAI
 author = Jeremy Howard and Hamel Husain
 author_email = j@fast.ai
 branch = master
 min_python = 3.7
-version = 2.3.32
+version = 2.3.34
 audience = Developers
 language = English
 custom_sidebar = True
@@ -19,7 +19,7 @@ requirements = fastcore>=1.5.27 execnb>=0.1.4 astunparse ghapi>=1.0.3 watchdog a
 pip_requirements = PyYAML
 conda_requirements = pyyaml
 conda_user = fastai
-dev_requirements = ipywidgets nbdev-numpy nbdev-stdlib pandas matplotlib black svg.py nbclassic pysymbol_llm llms-txt
+dev_requirements = ipywidgets nbdev-numpy nbdev-stdlib pandas matplotlib black svg.py nbclassic pysymbol_llm llms-txt sphinx
 console_scripts = nbdev_create_config=nbdev.config:nbdev_create_config
 	nbdev_update=nbdev.sync:nbdev_update
 	nbdev_update_license=nbdev.cli:nbdev_update_license
@@ -50,15 +50,15 @@ console_scripts = nbdev_create_config=nbdev.config:nbdev_create_config
 	nbdev_requirements=nbdev.release:write_requirements
 	nbdev_proc_nbs=nbdev.quarto:nbdev_proc_nbs
 	nbdev_help=nbdev.cli:chelp
-    nb_export=nbdev.cli:nb_export_cli
-    watch_export=nbdev.cli:watch_export
+	nb_export=nbdev.cli:nb_export_cli
+	watch_export=nbdev.cli:watch_export
 tst_flags = notest
 nbs_path = nbs
 doc_path = _docs
 recursive = True
 doc_host = https://nbdev.fast.ai
 doc_baseurl = /
-git_url = https://github.com/fastai/nbdev
+git_url = https://github.com/AnswerDotAI/nbdev
 lib_path = nbdev
 title = nbdev
 black_formatting = False