From e1ec1332dbedbe5d1cd700fc9ab4d29bed21a768 Mon Sep 17 00:00:00 2001 From: Anthony Scopatz Date: Wed, 22 Feb 2017 11:49:45 -0500 Subject: [PATCH] doc fixes --- docs/changelog.rst | 1 + docs/index.rst | 2 +- docs/previous/0.1_release_notes.rst | 84 ------- docs/previous/0.2_release_notes.rst | 350 ---------------------------- docs/previous/changelog.rst | 1 - docs/previous/index.rst | 26 --- xonsh/imphooks.py | 14 +- 7 files changed, 9 insertions(+), 469 deletions(-) create mode 100644 docs/changelog.rst delete mode 100644 docs/previous/0.1_release_notes.rst delete mode 100644 docs/previous/0.2_release_notes.rst delete mode 100644 docs/previous/changelog.rst delete mode 100644 docs/previous/index.rst diff --git a/docs/changelog.rst b/docs/changelog.rst new file mode 100644 index 000000000..4d7817ae3 --- /dev/null +++ b/docs/changelog.rst @@ -0,0 +1 @@ +.. include:: ../CHANGELOG.rst \ No newline at end of file diff --git a/docs/index.rst b/docs/index.rst index f05211c06..089264c86 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -167,7 +167,7 @@ Contents api/index advanced_events devguide/ - previous/index + changelog faq todo diff --git a/docs/previous/0.1_release_notes.rst b/docs/previous/0.1_release_notes.rst deleted file mode 100644 index c494c8079..000000000 --- a/docs/previous/0.1_release_notes.rst +++ /dev/null @@ -1,84 +0,0 @@ -============================= -Xonsh 0.1 Release Notes -============================= -xonsh is a Python-ish, BASHwards-compatible shell language and command prompt. -The language is a superset of Python 3.4 with additional shell primitives -that you are used to from BASH and IPython. xonsh is -meant for the daily use of experts and novices alike. - -Features include: - -* Naturally typed environment variables -* Inherits the environment from BASH -* Uses BASH completion for subprocess commands -* Regular expression filename globbing -* Its own PLY-based lexer and parser -* xonsh code parses into a Python AST -* You can do all the normal Python things, like arithmetic and importing -* Captured and uncaptured subprocesses -* Pipes, redirection, and non-blocking subprocess syntax support -* Help and superhelp with ? and ?? -* Command aliasing -* Multiline input, unlike ed -* History matching like in IPython -* Color prompts -* Low system overhead - -Feedback, bug reports, and pull requests are always welcome! - -Installation -============ -You can install xonsh using conda, pip, or from source. - -conda:: - - $ conda install -c https://conda.binstar.org/scopatz xonsh - -pip:: - - $ pip install xonsh - -source: Download the source from github (https://github.com/scopatz/xonsh) -or the zip file (https://github.com/scopatz/xonsh/archive/master.zip), then -run the following from the source directory:: - - $ python setup.py install - -If you run into any problems, please let us know! - -Dependencies -============ -Polyphemus currently has the following external dependencies, - -*Run Time:* - - 1. Python v3.4+ - 2. PLY - -Contributing -============ -We highly encourage contributions to xonsh! If you would like to contribute, -it is as easy as forking the repository on GitHub, making your changes, and -issuing a pull request. If you have any questions about this process don't -hesitate to ask the mailing list (xonsh@googlegroups.com). - -Contact Us -========== -If you have questions or comments, please send them to the mailing list -xonsh@googlegroups.com, contact the author directly, or open an issue on -GitHub. - -Join the mailing list here: https://groups.google.com/forum/#!forum/xonsh - -Helpful Links -============= -* Documentation - http://xon.sh -* Mailing list - https://groups.google.com/forum/#!forum/xonsh -* GitHub Repository - https://github.com/scopatz/xonsh - -Authors -======= -This release contains code written by the following people (in alphabetical -order): - -* Anthony Scopatz diff --git a/docs/previous/0.2_release_notes.rst b/docs/previous/0.2_release_notes.rst deleted file mode 100644 index 8c01aba69..000000000 --- a/docs/previous/0.2_release_notes.rst +++ /dev/null @@ -1,350 +0,0 @@ -============================= -Xonsh 0.2 Release Notes -============================= -Xonsh is a Python-ish, BASHwards-looking shell language and command prompt. -The language is a superset of Python 3.4+ with additional shell primitives -that you are used to from Bash and IPython. It works on all major systems including -Linux, Mac OSX, and Windows. Xonsh is meant for the daily use of experts and novices -alike. - -Features include: - -* Naturally typed environment variables -* Inherits the environment from BASH -* Uses BASH completion for subprocess commands -* Regular expression filename globbing -* Its own PLY-based lexer and parser -* xonsh code parses into a Python AST -* You can do all the normal Python things, like arithmetic and importing -* Captured and uncaptured subprocesses -* Pipes, redirection, and non-blocking subprocess syntax support -* Help and superhelp with ? and ?? -* Command aliasing -* Multiline input, unlike ed -* History matching like in IPython -* Color prompts -* Low system overhead -* Rich history recording and replaying - -Feedback, bug reports, and pull requests are always welcome! - -Installation -============ -You can install xonsh using conda, pip, or from source. - -**conda:** - -.. code-block:: bash - - $ conda install -c scopatz xonsh - -**pip:** - -.. code-block:: bash - - $ pip install xonsh - -**source:** Download the source `from github `_ -(`zip file `_), then run -the following from the source directory, - -.. code-block:: bash - - $ python setup.py install - -ArchLinux users can install xonsh with e.g. yaourt or aura: - -**yaourt:** - -.. code-block:: bash - - $ yaourt -Sa xonsh # yaourt will call sudo when needed - -**aura:** - -.. code-block:: bash - - $ sudo aura -A xonsh - -If you run into any problems, please let us know! - -Dependencies -============ -Polyphemus currently has the following external dependencies, - -*Run Time:* - - 1. Python v3.4+ - 2. PLY - 3. prompt-toolkit (optional) - -Contributing -============ -We highly encourage contributions to xonsh! If you would like to contribute, -it is as easy as forking the repository on GitHub, making your changes, and -issuing a pull request. If you have any questions about this process don't -hesitate to ask the mailing list (xonsh@googlegroups.com). - -Contact Us -========== -If you have questions or comments, please send them to the mailing list -xonsh@googlegroups.com, contact the author directly, or open an issue on -GitHub. - -Join the mailing list here: https://groups.google.com/forum/#!forum/xonsh - -Helpful Links -============= -* Documentation - http://xon.sh -* Mailing list - https://groups.google.com/forum/#!forum/xonsh -* GitHub Repository - https://github.com/scopatz/xonsh -* IRC: channel #xonsh on OFTC - http://www.oftc.net/ - -Authors -======= -This release contains code written by the following people: - -* Anthony Scopatz -* Adam J Hartz -* Klaus Alexander Seistrup -* Aaron Griffin -* Robert W. Brewer -* Morten Enemark Lund -* Michał Zając -* Burak Yigit Kaya -* Mattias Ugelvik -* Nathan Goldbaum -* anula -* mel -* James Elías -* Jonathan Slenders -* JuanPablo -* Marcel Bollmann -* Matteo Bertini -* Thomas Marquart -* Alexandre Ferland -* Michael Droettboom -* javValverde -* Greg Thole -* K.-Michael Aye -* Pablo Barton -* Paul Barton -* Steven Silvester -* zajaczajac -* Aaron Meurer -* Austin Bingham -* Brian S. Corbin -* Cameron Bates -* Charlie Arnold -* Daniel Hahler -* Florian Mounier -* Glen Zangirolami -* Katriel Cohn-Gordon -* Michael Ensslin -* Ronny Pfannschmidt -* admiralobvious -* eyalzek -* torgny - -Changelog -============ -- some v3.5 updates (`#387 `_) by scopatz [feature] -- fix to actually quit on certain signals (`#386 `_) by scopatz [bug] -- Display completions in columns. (`#384 `_) by jonathanslenders -- Display completions in columns. (`#383 `_) by jonathanslenders [feature] -- Added LimitedFileHistory.__iter__. Required for prompt_toolkit==0.50 (`#382 `_) by jonathanslenders [feature] -- Documentation updates (`#376 `_) by scopatz [docs] -- Expand `FORCE_POSIX_PATHS` behavior to `cwd` in `FORMATTER_DICT` (`#373 `_) by BYK [feature] -- Fix bug in attribute completer: unresolved reference `oattr` (`#372 `_) by BYK [bug] -- Add `FORCE_POSIX_PATH` option to force `/` as path separator on WINDOWS (`#371 `_) by BYK [feature] -- Allow environment variables in PROMPT (`#370 `_) by mdboom [feature] -- Fix for 122361eeca5189e70ff81931f80812fb16a75c3d: history was partly broken. (`#369 `_) by jonathanslenders [bug] -- First attempt to make a hack for prompt-toolkit coloring (`#368 `_) by melund [feature] -- One fix to be compatible with prompt_toolkit==0.47 (`#366 `_) by jonathanslenders [feature] -- Fix error where _normpath wrapper converted ./ to ././ (`#363 `_) by melund [bug] -- tutorial: remove DEFAULT_ALIASES from aliases section (`#361 `_) by rbrewer123 [docs] -- Fix regression in _normpath. (`#359 `_) by melund [bug] -- Update _normpath wrapper to prevent removing a trailing slash (`#357 `_) by melund [bug, feature] -- fixed SUID issues, I think (`#356 `_) by scopatz [bug] -- allow xonsh to run unreadable binaries (`#355 `_) by larsks [bug] -- Rich History (`#353 `_) by scopatz [feature] -- remove logo printing from setup.py (`#349 `_) by RonnyPfannschmidt [build] -- Fix error when checking for indentation (`#348 `_) by BYK [bug] -- Added DIRS rule to environ (`#347 `_) by scopatz [feature] -- Added more cwd formatters (`#346 `_) by scopatz [feature] -- fix pretty printing bug on windows (`#345 `_) by adqm [bug] -- Prompt Indentation After Colon (`#343 `_) by scopatz [feature] -- prompt formatting functions may return None (`#342 `_) by scopatz [feature] -- add exception handling to prompt evaluation (`#341 `_) by scopatz [bug] -- fixes hanging indent error (`#340 `_) by scopatz [bug] -- Prompt toolkit fixes (`#339 `_) by scopatz [bug] -- Prevent os.path.normpath() from removing current dir (`#337 `_) by kseistrup [bug] -- Prevent os.path.normpath() from removing initial ‘./’ (`#336 `_) by kseistrup -- ignore case on completion (`#335 `_) by scopatz [feature] -- Some fixes for prompt-toolkit integration. (`#334 `_) by jonathanslenders [bug] -- open()'ed files were never closed (`#333 `_) by kseistrup [bug] -- Renaming a few variables (`#332 `_) by kseistrup [build] -- Hiding traceback in the shell (`#331 `_) by melund [feature] -- Assorted style changes (PEP8) (`#330 `_) by kseistrup [bug] -- Removed trailing whitespace (`#328 `_) by kseistrup [bug] -- Add -V/--version (`#327 `_) by kseistrup [feature] -- Add link to IRC (`#325 `_) by kseistrup [docs] -- ArchLinux installation instructions (`#322 `_) by kseistrup [docs] -- ArchLinux instructions (`#321 `_) by kseistrup [docs] -- Closes #307, do not use full path for completion, use basename only (`#320 `_) by naufraghi [bug] -- added login shell to bash (`#319 `_) by scopatz [bug] -- Fixing typos and end of line white space in docs (`#317 `_) by michaelaye [docs] -- Added config file for binstar build service (`#314 `_) by melund [build] -- fix for vim/emacs not coming back from background (`#309 `_) by adqm [bug] -- Remove the Python version restriction from the conda recipe (`#304 `_) by asmeurer [build] -- Add pretty printing (`#303 `_) by melund [feature] -- Enable `locate_binary` on Windows (`#302 `_) by BYK [bug, feature] -- Fix a bunch of `hg` related errors on Windows (`#300 `_) by BYK [bug] -- bash completions: use set() with `declare -F` (`#292 `_) by blueyed [feature] -- added command-not-found capability for ubuntu and debian (`#287 `_) by scopatz [feature] -- Temporary work-around for bug in conda-build (`#284 `_) by melund [build] -- Work-around a bug in "conda convert" (`#283 `_) by melund -- Catch cases where the commands launched by subprocess are not found. (`#282 `_) by melund [bug] -- Update to conda recipe (`#279 `_) by melund [build, feature] -- improved man tests (`#271 `_) by scopatz [feature] -- Favor runnable extensions on Windows (`#270 `_) by BYK -- aliases: fixed bash aliases with single quotes (`#267 `_) by mic-e [bug, feature] -- windows: automated builds via appveyor (`#264 `_) by rbrewer123 [build, feature] -- "source" alias (`#263 `_) by adqm [feature] -- Change handling of tilde (`#261 `_) by adqm [bug] -- windows: more cmd.exe builtins as aliases (`#258 `_) by rbrewer123 [feature] -- some minor cli changes to shell type (`#255 `_) by scopatz [feature] -- Fix prompt_toolkit autocompletion bug (`#252 `_) by anula [bug] -- Add possibility to insert indent in prompt_toolkit shell. (`#251 `_) by anula [feature] -- fix issue where prompt_toolkit is always preferred (`#250 `_) by adqm [bug] -- Add option to run xonsh in prompt_toolkit mode from command line. (`#249 `_) by anula [feature] -- Completion from man pages (`#248 `_) by zajaczajac [feature] -- windows: use PATHEXT to find runnable files and skip shebang parsing (`#245 `_) by rbrewer123 [bug, feature] -- Aliases as Environment Variable (`#244 `_) by adqm -- Fix bugs in LimitedFileHistory plus tests (`#243 `_) by anula [bug] -- proposed fix for alias bug from #241 (`#242 `_) by adqm [bug] -- Windows Shebang (`#241 `_) by adqm [bug] -- IO Redirection (`#240 `_) by adqm [feature] -- Add prompt output for mercurial repository branches and bookmarks (`#239 `_) by ngoldbaum [feature] -- windows: enable git branch checking in prompt (`#238 `_) by rbrewer123 [feature] -- windows: doc updates (`#237 `_) by rbrewer123 [docs] -- Env overhaul (`#230 `_) by scopatz [feature] -- Prompt toolkit as alternative shell (`#229 `_) by anula [feature] -- Update prompt to display different color branch name if git is dirty (`#228 `_) by gthole [feature] -- small fix from ProcProxy changes (`#227 `_) by adqm [bug] -- Add support for CDPATH (`#225 `_) by naufraghi [feature] -- ProcProxy Rewrite (`#224 `_) by adqm [feature] -- Feature: Windows support (`#223 `_) by rbrewer123 [feature] -- allow grouping syntax to be part of subprocess expressions (`#222 `_) by adqm -- timeit alias (`#221 `_) by scopatz [feature] -- Fix For Quoted Args (`#219 `_) by adqm [bug] -- completing module to import (`#218 `_) by zajaczajac [feature] -- Lazy JSON File (`#216 `_) by scopatz [feature] -- History object (`#213 `_) by aig787 [feature] -- Names in subprocess mode (`#212 `_) by adqm [feature] -- unpack targets in comprehension (`#211 `_) by scopatz [bug] -- cd Changes (`#209 `_) by adqm [bug, feature] -- Reorganize Job Control Code and Fix Bugs (`#203 `_) by adqm [bug] -- Added exec builtin support (`#200 `_) by aig787 [feature] -- wrap develop too (`#199 `_) by scopatz [bug, build] -- Documentation for Job Control (`#197 `_) by adqm [docs] -- Added readthedocs support (`#196 `_) by aig787 [docs] -- I see a string and I want to paint it black (`#195 `_) by scopatz [bug] -- Completer Update (`#194 `_) by adqm [feature] -- Completer Bugfix (`#193 `_) by adqm [bug] -- Attribute Completion (`#192 `_) by scopatz [feature] -- prevents detyping mappings as string to env. (`#191 `_) by scopatz [bug] -- Attempt to fix #188 (`#190 `_) by adqm [bug] -- More IO Redirection Options (`#189 `_) by adqm [feature] -- license updates. (`#187 `_) by scopatz [docs] -- Improved Command Suggestions (`#186 `_) by adqm [feature] -- Documentation Updates (`#185 `_) by adqm [docs] -- Completer Updates (`#184 `_) by adqm [bug, feature] -- Many PEP8 Changes (`#183 `_) by adqm [build] -- some landscape fixes (`#182 `_) by scopatz [build, feature] -- Glob Fix (`#180 `_) by adqm [bug] -- Bash completion clarifications (`#179 `_) by blink1073 [build] -- SSH fixes (`#177 `_) by adqm [bug] -- Un-detypes env for mutable value access (`#175 `_) by scopatz [bug] -- Pygments Hooks (`#173 `_) by scopatz [build, docs, feature] -- Attempt to fix #148 (`#170 `_) by adqm [bug] -- Interactive Flag, and Parser Bugfix (`#169 `_) by adqm [bug, feature] -- more robust subproc injection (`#168 `_) by scopatz [bug] -- Alternative Prompt Format Refactor (`#165 `_) by adqm [feature] -- Import hooks for xonsh files (``*.xsh``) (`#164 `_) by scopatz [feature] -- Optimization for waiting for active job to stop (`#163 `_) by adqm [feature] -- Prompt via prompt (`#162 `_) by abadger [feature] -- Job control bugfix (`#160 `_) by adqm [bug] -- implements non-string sequences to @() (`#159 `_) by scopatz [feature] -- Change semantics for running executables from outside the path (`#158 `_) by adqm -- Fix lexer's handling of # (`#157 `_) by adqm [bug] -- Fix #154 (`#156 `_) by adqm [bug] -- Error Reporting (`#155 `_) by adqm -- Job control (`#152 `_) by adqm [feature] -- Ignore Python keywords in subprocess mode (`#151 `_) by adqm [feature] -- xonsh should error on finding a line break inside a regex path (backtick) (`#150 `_) by adqm [bug] -- fix and tests for mutliple assignment (`#149 `_) by scopatz [bug] -- Use landscape.io (`#145 `_) by javValverde [build] -- Lexer Overhaul (`#144 `_) by adqm [feature] -- Version (`#143 `_) by adqm [feature] -- Command line switch --no-rc (`#140 `_) by mbollmann [feature] -- attempt to fix #131 (`#138 `_) by adqm [bug] -- xonsh should be able to run binaries outside the path, as well as scripts (`#136 `_) by adqm [bug] -- `lstrip` the first line of shell input (`#130 `_) by SmartViking [feature] -- Documentation for running scripts (`#129 `_) by adqm [docs] -- Handling of ~ (`#128 `_) by adqm [bug, feature] -- Allow arguments for xonsh shell scripts (`#126 `_) by adqm [bug] -- Prompt formatter refactor (`#125 `_) by abadger [feature] -- travis badge to README (`#123 `_) by juanpabloaj [docs] -- Nested structures (`#122 `_) by adqm [bug] -- Allow running scripts not in the path (`#121 `_) by adqm [feature] -- Modify string regex (allow multiline strings) (`#120 `_) by adqm [bug] -- Complex numbers (`#119 `_) by adqm [bug, feature] -- Implement pushd, popd, dirs (`#116 `_) by adqm [feature] -- Tabulated command suggestions, and tried to improve readability here and... (`#115 `_) by SmartViking [feature] -- Fall back to using git binary to determine branch when necessary (`#114 `_) by adqm [feature] -- Syntax (`#113 `_) by adqm [feature] -- convert result of ${} expression to string (`#112 `_) by adqm [feature] -- Removed `subproc_line`, fixed typos, small changes (`#105 `_) by SmartViking [build] -- Add an explanation for shift+tab indentation to the docs (`#104 `_) by eyalzek [docs] -- Documentation and refactoring of window title and suggestions (`#103 `_) by adqm [docs] -- Nested Lists and Tuples (`#100 `_) by scopatz [bug] -- fix for comment parsing (`#99 `_) by adqm [bug] -- fix for comment only lines (`#98 `_) by scopatz [bug] -- Non-recursive refactor of shell.cmdloop() (`#97 `_) by SavinaRoja [bug] -- main.py takes script file or script on stdin (`#95 `_) by adqm [feature] -- updating the webm with some slight pauses (`#94 `_) by SavinaRoja [docs] -- Tab Completion on OS X (`#93 `_) by corbinbs [bug] -- specify full path to README.rst (`#89 `_) by cwalv [bug] -- Updated environ.current_branch to bounce if git isnt installed and check... (`#83 `_) by glenbot [bug] -- HTML5 Video format for the demo (`#82 `_) by SavinaRoja [build] -- Fixes #56 about taking over bash aliases into xonsh. (`#77 `_) by ivh [feature] -- update oldpwd when using cd (`#76 `_) by admiralobvious [feature] -- minimize calls to reset_screen_size (`#75 `_) by adqm [bug] -- Attempt to fix #73 (`#74 `_) by adqm [bug] -- Auto-completer: wrap paths in quotes where necessary (`#72 `_) by adqm [feature] -- Propagate SyntaxError message in exec-ing .xonshrc to the user (`#67 `_) by naufraghi [feature] -- Added cleaner error for commands not found (`#65 `_) by Samathy [feature] -- subprocess mode error message (`#58 `_) by adqm [feature] -- Fix typos in faq (`#57 `_) by naufraghi [bug] -- parser_test_table.py to gitignore (`#53 `_) by juanpabloaj [build] -- a first approach to a travis file (`#52 `_) by juanpabloaj [build] -- gitignore: lexer_table and parser_table added (`#51 `_) by juanpabloaj [build] -- ``*.egg`` to gitignore (`#50 `_) by juanpabloaj [build] -- Add a #coding declaration to setup.py (`#47 `_) by katrielalex [build] -- Prompt documentation (for #31) (`#43 `_) by mbollmann -- Second attempt at fix for #34 (`#42 `_) by adqm [bug] -- Accept -c argument (a la bash) (`#41 `_) by adqm [feature] -- fix for multiline prompt (given the update from #31) (`#40 `_) by adqm [bug] -- Update to #38 (Virtual Terminal Title) (`#39 `_) by adqm [feature] -- change terminal title to show message or current directory (`#38 `_) by adqm [feature] -- Attempt to fix #34 (`#37 `_) by adqm [bug] -- Slightly modified cd error messages (`#36 `_) by adqm [feature] -- Auto-formatting prompt string (`#31 `_) by mbollmann [feature] -- fix #28 (`#30 `_) by adqm [bug] -- Fix for issue "Multi-line input never terminates #13" (`#19 `_) by torgny [bug, feature] -- changed aliasing to support optional return values, and interactive prompts (`#15 `_) by jamiees2 [feature] -- xonsh's not polyphemus (`#14 `_) by crbates -- cd with no arguments now changes to home dir. (`#11 `_) by abingham [bug, feature] -- Pipes (`#10 `_) by jamiees2 [feature] -- Fix #1 by uppercasing readme.rst. (`#3 `_) by paradoxxxzero [feature] diff --git a/docs/previous/changelog.rst b/docs/previous/changelog.rst deleted file mode 100644 index 6f90edd99..000000000 --- a/docs/previous/changelog.rst +++ /dev/null @@ -1 +0,0 @@ -.. include:: ../../CHANGELOG.rst \ No newline at end of file diff --git a/docs/previous/index.rst b/docs/previous/index.rst deleted file mode 100644 index f3231fece..000000000 --- a/docs/previous/index.rst +++ /dev/null @@ -1,26 +0,0 @@ -.. _previous_versions: - -Previous Versions -================== -The following are notes for and links to previously released versions of -xonsh: - -.. toctree:: - :maxdepth: 1 - - changelog - 0.2_release_notes - 0.1_release_notes - -======= ========== ============== ============== -Version Date Zip Tar -======= ========== ============== ============== -0.2.0 2015-09-13 `zip 0.2`_ `tar 0.2`_ -0.1.0 2015-03-09 `zip 0.1`_ `tar 0.1`_ -======= ========== ============== ============== - -.. _zip 0.2: https://github.com/xonsh/xonsh/zipball/0.2 -.. _tar 0.2: https://github.com/xonsh/xonsh/tarball/0.2 -.. _zip 0.1: https://github.com/xonsh/xonsh/zipball/0.1 -.. _tar 0.1: https://github.com/xonsh/xonsh/tarball/0.1 - diff --git a/xonsh/imphooks.py b/xonsh/imphooks.py index 37fe4e86b..039ba6f34 100644 --- a/xonsh/imphooks.py +++ b/xonsh/imphooks.py @@ -105,10 +105,10 @@ on_import_pre_find_spec(fullname: str, path: str, target: module or None) -> Non Fires before any import find_spec() calls have been executed. The parameters here are the same as importlib.abc.MetaPathFinder.find_spec(). Namely, -``fullname``: The full name of the module to import. -``path``: None if a top-level import, otherwise the ``__path__`` of the parent +:``fullname``: The full name of the module to import. +:``path``: None if a top-level import, otherwise the ``__path__`` of the parent package. -``target``: Target module used to make a better guess about the package spec. +:``target``: Target module used to make a better guess about the package spec. """) events.doc('on_import_post_find_spec', """ @@ -117,11 +117,11 @@ on_import_post_find_spec(spec, fullname, path, target) -> None Fires after all import find_spec() calls have been executed. The parameters here the spec and the arguments importlib.abc.MetaPathFinder.find_spec(). Namely, -``spec``: A ModuleSpec object if the spec was found, or None if it was not. -``fullname``: The full name of the module to import. -``path``: None if a top-level import, otherwise the ``__path__`` of the parent +:``spec``: A ModuleSpec object if the spec was found, or None if it was not. +:``fullname``: The full name of the module to import. +:``path``: None if a top-level import, otherwise the ``__path__`` of the parent package. -``target``: Target module used to make a better guess about the package spec. +:``target``: Target module used to make a better guess about the package spec. """) events.doc('on_import_pre_create_module', """