From 67e57d74929200757ae4946f9c2279ba9bf583e9 Mon Sep 17 00:00:00 2001 From: "Elf M. Sternberg" Date: Fri, 2 Sep 2016 21:12:04 -0700 Subject: [PATCH] ELI5-ification underway\! --- README.rst | 106 +++++++------- docs/_sources/details.txt | 111 ++++++++++++++ docs/_sources/eli5.txt | 37 +++++ docs/_sources/index.txt | 5 +- docs/_sources/installation.txt | 14 +- docs/_sources/readme.txt | 2 +- docs/_sources/usage.txt | 19 ++- docs/contributing.html | 10 +- docs/details.html | 223 +++++++++++++++++++++++++++++ docs/doctrees/details.doctree | Bin 0 -> 29142 bytes docs/doctrees/eli5.doctree | Bin 0 -> 6701 bytes docs/doctrees/environment.pickle | Bin 9983 -> 18168 bytes docs/doctrees/index.doctree | Bin 6402 -> 5674 bytes docs/doctrees/installation.doctree | Bin 7732 -> 7567 bytes docs/doctrees/readme.doctree | Bin 2771 -> 15404 bytes docs/doctrees/usage.doctree | Bin 2939 -> 4735 bytes docs/eli5.html | 126 ++++++++++++++++ docs/index.html | 24 ++-- docs/installation.html | 20 +-- docs/objects.inv | 4 +- docs/readme.html | 76 +++++++++- docs/searchindex.js | 2 +- docs/src/details.rst | 111 ++++++++++++++ docs/src/eli5.rst | 37 +++++ docs/src/index.rst | 5 +- docs/src/installation.rst | 14 +- docs/src/readme.rst | 2 +- docs/src/usage.rst | 19 ++- docs/usage.html | 24 +++- 29 files changed, 873 insertions(+), 118 deletions(-) create mode 100644 docs/_sources/details.txt create mode 100644 docs/_sources/eli5.txt create mode 100644 docs/details.html create mode 100644 docs/doctrees/details.doctree create mode 100644 docs/doctrees/eli5.doctree create mode 100644 docs/eli5.html create mode 100644 docs/src/details.rst create mode 100644 docs/src/eli5.rst diff --git a/README.rst b/README.rst index 981cc49..c38fb60 100644 --- a/README.rst +++ b/README.rst @@ -1,67 +1,65 @@ Synopsis -------- -**Polyloader** is a python module that enables the discovery and loading -of heterogenous source code packages. This discovery and loading is -critical to the functioning of other programming languages that use the -Python AST and Python interpreter, languages such as Hy, Doge, and -Mochi. - -Problem Statement ------------------ - -The Python module loader system is hard-coded to prevent the discovery -of heterogenous source code packages. From Python 2.6 through the -current (as of this writing) Python 3.5, the import mechanism allows for -the creation of file finders and importers that would transform Python's -import syntax into a *path,* assert whether or not that path could be -made to correspond to a *syntax object*, and then attempt to *load* that -syntax object as a Python module. Python *packages*, however, are -assumed to be uniformly made up of Python syntax objects, be they -**.py** source files, **.pyc/.pyo** bytecode, or **.so/.dll** files with -an exposed Python-to-C API. In Python 2 these suffixes are hard-coded -into the source in the **imp** builtin module; in Python 3 these -suffixes are constants defined in a private section of **importlib**; in -either case, they are unavailable for modification. This lack of access -to the extensions list prevents the *discovery* of heterogenous source +**Polyloader** is a python module that extends the Python `import` +statement to enable the discovery and loading of heterogenous source code packages. -The discovery mechanism is outlined in Python's **pkgutil** module; -features such as **pkgutil.iter_modules** do not work with heterogenous -source code, which in turn means that one cannot write, for one -important example, Django management commands in an alternative syntax. +Say What? +--------- -**polyloader** is a Python module that intercepts calls to the default -finder, loader, and package module iterator, and if the path resolves to -an alternative syntax, provide the appropriate finder, loader and -iterator. **polyloader** is different from traditional importlib shims -in that it directly affects the default source file loader, and thus -allows for the discovery and importation of suffixes not listed in -Python's defaults. +The ``import`` statement is how the Python interpreter finds a module +written in Python and loads it, turning it into variables, executable +functions, constructable classes, and other Python objects, and then +exposes those objects to the currently running program. -To use: -------- +The ``import`` statement has long been extensible so that things other +than Python code could be imported, but this feature has always had two +limitations: -Import polyloader in your python script's launcher or library, as well -as the syntax compiler(s) you plan to use. For example, if you have -`Mochi `__ and -`Hy `__ installed, and you wanted to -write a Django app, edit manage.py and add the following lines at the -top: +1. It's annoyingly hard to write an importer. (Believe me. Polyloader + *is* one!) +2. For filesystem-based modules (which is 99% of them) Python's importer + only understands one loader type per directory. It's not possible to + store code or data written in something other than Python in the same + directory with Python module code and load it via ``import``. -:: +The former requires a certain degree of abstraction and thought. For +the latter, most people ignore the problem and load module configuration +files written in JSON or YAML or whatever directly. This is fine, +except when you want to write in one of Python's extended languages like +Hy or Coconut in a framework like Django, Flask or Glitch. - from mochi.main import compile_file as mochi_compile - from hy.importer import ast_compile as hy_compile - from polyloader import polyimport - polyimport(mochi_compile, ['.mochi']) - polyimport(hy_compile, ['.hy'])} +**Polyloader** eliminates these limitations. -Now your views can be written in Hy and your models in Mochi, and -everything will just work. +What's the real problem? +------------------------ -Dependencies ------------- +The real problem is that Python's traditional extensions, ``.py``, +``.pyc/.pyo``, and ``.so/.dll`` files, are hard-coded in Python. In +Python 2, they're in the ``imp`` builtin; In Python 3, they're defined +in a private section of `importlib`. Either way, they're not accessible +for modification and extension. + +This problem is made harder by the ``pkglib`` module, which is part of +Python's standard library. This module uses ``inspect.getmoduleinfo``, +which again only recognizes the usual extensions. Which means you can't +list multilingual modules either; this hampers the development of Django +management commands in a syntax other than Python. + +What the solution? +------------------ + +At its heart, the Python import system runs two different internal +mechanisms to figure out what the *import string* (the dotted terms +after the word "import") "means." Each mechanism has one or more +*finders*, and the first finder to report "I have a *loader* that knows +what that import string means" wins. + +The very last finder is for the filesystem. The solution is to get in +front of that finder with one that can handle all the other syntax +loaders *and* knows how to fall back on the last one for those files the +last one handles. + +That's what ``polyloader`` does. -polymorph is self-contained. It has no dependencies other than Python -itself and your choice of language. diff --git a/docs/_sources/details.txt b/docs/_sources/details.txt new file mode 100644 index 0000000..fc64dd2 --- /dev/null +++ b/docs/_sources/details.txt @@ -0,0 +1,111 @@ +Details on Import and Polyloader +================================ + +Welcome to the Python Import ELI5! +********************************** + +What is `import`? +----------------- + +``import`` is a Python statement that finds a *module* that is accessible +by the currently running process, loads it, and makes its contents +available to the scope in which the statement was made. A statement +like + +``import django.db.models`` + +is looking for a module named ``django.db.models``. If the statement is +successful, ``django.db.models`` will be a variable name in the scope, +it will be a Python *object* (of ``class Module``, but that's not +important), and it will have functions, class constructors, variables +and constants. These Python objects will be accessible through the dot +operator. + +An alternative way of writing import statements is + +``from django.utils import encoding`` + +And then the variable will just be ``encoding``. The ``encoding`` +module has a function for handling unicode-to-web translation. +Accessing it through the dot operator, it looks like this: + +``ready_str = encoding.smart_str(unready_str)`` + +We call the parts of the import statement that describe the module the +*import string*. + +``sys.path_hooks``: How does Python know where to look? +------------------------------------------------------- + +That's what's funny. Python has two independent ways of making sense of +of the import string. The old system is based on the assumption that +everything is a filesystem, with folders and filenames. This is called +the ``sys.path_hooks`` system. + +In the old system, the parts of the import string would be split up, and +then a collection of directories would be scanned to see if the first +name in the import string could be matched with a subdirectory. If it +could, that directory would be scanned until the last name on the import +string. If that name was a *filename*, it would be loaded as a module. +If that name was a *directory* and that directory had a file named +``__init__.py``, then that file would be loaded as the module. + +The ``sys.path_hooks`` array has a list of different methods for trying to +scan a filesystem for the parts of the import string. A ``path_hook`` is +a function that takes a path to a directory; if it can handle the +contents of the directory, it returns a **Finder**, an object whose job +is to figure out how to load the module; if it can't, it returns an +ImportError exception. The object that loads the module is called, +naturally, a **Loader**. + +* To read more about **Finders**, see :ref:`eli5-finders` +* To read more about **Loaders**, see :ref:`eli5-loaders` +* To read more about **Path Hooks**, see :ref:`eli5-pathhooks` + +``sys.path``: What directories are searched? +-------------------------------------------- + +The list of directories is stored in an array, ``sys.path``. This path is +initialized by Python when it starts up, but programs can modify it at +run-time to point to extra directories if they want. + + +``sys.meta_path``: What is the new system? +------------------------------------------ + +The new system is called ``sys.meta_path``, and it's an array of +**Finders**, objects that have one method, ``find_module(fullname)``. +It's an anything-goes API that gives developers the freedom to import +modules from anywhere: databases, archives, remote web resources, even +code written on-the-fly internally. The new system can apply any +meaning at all to the import string. + +In Python, the import string is offered to each object in +``sys.meta_path`` before being offered to each ``sys.path_hook``. The +filesystem is typically the last finder tried. + +To read more about **Meta Paths**, see :ref:`eli5-metapaths` + +Is it different between Python 2 and Python 3? +--------------------------------------------- + +Python 3 moves almost everything about this process into python's +library, leaving only a bare minimum of functionality inside the Python +executable to load this library and run it. When the Python developers +did that, they added a lot of functionality to make it easier to write +new import modules. The old way still works, but there are now *Module +Specifications*, which are metadata about a module, and the old +``path_hooks`` system is now just a ``meta_path`` handler added to the +new system as the last resort. + +To read more about **Module Specifications**, see :ref:`eli5-specs` + +Does the old system still matter? +--------------------------------- + +Yes, for one reason: *iteration*. Iteration is the ability to take a +path where you believe Python modules can be found, and list through +them. This facility is useful for large frameworks where a user wants +to add new commands, or new objects, or new operations; Django uses this +facility a lot! The ``pkgutil`` library depends upon Finders being able +to iterate their contents. diff --git a/docs/_sources/eli5.txt b/docs/_sources/eli5.txt new file mode 100644 index 0000000..667777f --- /dev/null +++ b/docs/_sources/eli5.txt @@ -0,0 +1,37 @@ +ELI5: Explain Like I'm Five! +============================ + +.. _eli5-finders: + +Finders +======= + +TODO + +.. _eli5-loaders: + +Loaders +======= + +TODO + +.. _eli5-pathhooks: + +Path Hooks +========== + +TODO + +.. _eli5-metapaths: + +Meta Paths +========== + +TODO + +.. _eli5-specs: + +Module Specifications +===================== + +TODO diff --git a/docs/_sources/index.txt b/docs/_sources/index.txt index 71cd28f..fb05f4b 100644 --- a/docs/_sources/index.txt +++ b/docs/_sources/index.txt @@ -3,8 +3,8 @@ You can adapt this file completely to your liking, but it should at least contain the root `toctree` directive. -Welcome to py-polymorphic-loader's documentation! -====================================== +Welcome to polyloader +===================== Contents: @@ -14,6 +14,7 @@ Contents: readme installation usage + details contributing authors history diff --git a/docs/_sources/installation.txt b/docs/_sources/installation.txt index 5eca886..578e385 100644 --- a/docs/_sources/installation.txt +++ b/docs/_sources/installation.txt @@ -8,11 +8,11 @@ Installation Stable release -------------- -To install py-polymorphic-loader, run this command in your terminal: +To install polyloader, run this command in your terminal: .. code-block:: console - $ pip install py-polymorphic-loader + $ pip install polyloader If you don't have `pip`_ installed, this `Python installation guide`_ can guide you through the process. @@ -24,19 +24,19 @@ you through the process. From sources ------------ -The sources for py-polymorphic-loader can be downloaded from the `Github repo`_. +The sources for polyloader can be downloaded from the `Github repo`_. You can either clone the public repository: .. code-block:: console - $ git clone git://github.com/elfsternberg/py-polymorphic-loader + $ git clone git://github.com/elfsternberg/polyloader Or download the `tarball`_: .. code-block:: console - $ curl -OL https://github.com/elfsternberg/py-polymorphic-loader/tarball/master + $ curl -OL https://github.com/elfsternberg/polyloader/tarball/master Once you have a copy of the source, you can install it with: @@ -45,5 +45,5 @@ Once you have a copy of the source, you can install it with: $ python setup.py install -.. _Github repo: https://github.com/elfsternberg/py-polymorphic-loader -.. _tarball: https://github.com/elfsternberg/py-polymorphic-loader/tarball/master +.. _Github repo: https://github.com/elfsternberg/polyloader +.. _tarball: https://github.com/elfsternberg/polyloader/tarball/master diff --git a/docs/_sources/readme.txt b/docs/_sources/readme.txt index 72a3355..a6210d3 100644 --- a/docs/_sources/readme.txt +++ b/docs/_sources/readme.txt @@ -1 +1 @@ -.. include:: ../README.rst +.. include:: ../../README.rst diff --git a/docs/_sources/usage.txt b/docs/_sources/usage.txt index 587eb68..5f01efd 100644 --- a/docs/_sources/usage.txt +++ b/docs/_sources/usage.txt @@ -2,6 +2,21 @@ Usage ===== -To use py-polymorphic-loader in a project:: +Import polyloader in your python script's launcher or library, as well +as the syntax compiler(s) you plan to use. For example, if you have +`Mochi `__ and `Hy +`__ installed, and you wanted to +write a Django app, edit manage.py and add the following lines at the +top: + +:: + + from mochi.main import compile_file as mochi_compile + from hy.importer import ast_compile as hy_compile + import polyloader + polyloader.install(mochi_compile, ['.mochi']) + polyloader.install(hy_compile, ['.hy'])} + +Now your views can be written in Hy and your models in Mochi, and +everything will just work. - import py-polymorphic-loader diff --git a/docs/contributing.html b/docs/contributing.html index 7565fbc..758ed39 100644 --- a/docs/contributing.html +++ b/docs/contributing.html @@ -25,7 +25,7 @@ - +
@@ -41,7 +41,7 @@ next |
  • - previous |
  • polyloader 0.1.0 documentation »
    • @@ -60,8 +60,8 @@

    Previous topic

    -

    Usage

    +

    Details on Import and Polyloader

    Next topic

    <no title>

    @@ -100,7 +100,7 @@ next |
  • - previous |
  • polyloader 0.1.0 documentation »
    • diff --git a/docs/details.html b/docs/details.html new file mode 100644 index 0000000..bb80d05 --- /dev/null +++ b/docs/details.html @@ -0,0 +1,223 @@ + + + + + + + + Details on Import and Polyloader — polyloader 0.1.0 documentation + + + + + + + + + + + + + +
    +

    Navigation

    + +
    + +
    +
    +
    +
    + +
    +

    Details on Import and Polyloader

    +
    +

    Welcome to the Python Import ELI5!

    +
    +

    What is import?

    +

    import is a Python statement that finds a module that is accessible +by the currently running process, loads it, and makes its contents +available to the scope in which the statement was made. A statement +like

    +

    import django.db.models

    +

    is looking for a module named django.db.models. If the statement is +successful, django.db.models will be a variable name in the scope, +it will be a Python object (of class Module, but that’s not +important), and it will have functions, class constructors, variables +and constants. These Python objects will be accessible through the dot +operator.

    +

    An alternative way of writing import statements is

    +

    from django.utils import encoding

    +

    And then the variable will just be encoding. The encoding +module has a function for handling unicode-to-web translation. +Accessing it through the dot operator, it looks like this:

    +

    ready_str = encoding.smart_str(unready_str)

    +

    We call the parts of the import statement that describe the module the +import string.

    +
    +
    +

    sys.path_hooks: How does Python know where to look?

    +

    That’s what’s funny. Python has two independent ways of making sense of +of the import string. The old system is based on the assumption that +everything is a filesystem, with folders and filenames. This is called +the sys.path_hooks system.

    +

    In the old system, the parts of the import string would be split up, and +then a collection of directories would be scanned to see if the first +name in the import string could be matched with a subdirectory. If it +could, that directory would be scanned until the last name on the import +string. If that name was a filename, it would be loaded as a module. +If that name was a directory and that directory had a file named +__init__.py, then that file would be loaded as the module.

    +

    The sys.path_hooks array has a list of different methods for trying to +scan a filesystem for the parts of the import string. A path_hook is +a function that takes a path to a directory; if it can handle the +contents of the directory, it returns a Finder, an object whose job +is to figure out how to load the module; if it can’t, it returns an +ImportError exception. The object that loads the module is called, +naturally, a Loader.

    +
      +
    • To read more about Finders, see Finders
      • +
    • To read more about Loaders, see Loaders
      • +
    • To read more about Path Hooks, see Path Hooks
      • +
    +
    +
    +

    sys.path: What directories are searched?

    +

    The list of directories is stored in an array, sys.path. This path is +initialized by Python when it starts up, but programs can modify it at +run-time to point to extra directories if they want.

    +
    +
    +

    sys.meta_path: What is the new system?

    +

    The new system is called sys.meta_path, and it’s an array of +Finders, objects that have one method, find_module(fullname). +It’s an anything-goes API that gives developers the freedom to import +modules from anywhere: databases, archives, remote web resources, even +code written on-the-fly internally. The new system can apply any +meaning at all to the import string.

    +

    In Python, the import string is offered to each object in +sys.meta_path before being offered to each sys.path_hook. The +filesystem is typically the last finder tried.

    +

    To read more about Meta Paths, see Meta Paths

    +
    +
    +

    Is it different between Python 2 and Python 3?

    +

    Python 3 moves almost everything about this process into python’s +library, leaving only a bare minimum of functionality inside the Python +executable to load this library and run it. When the Python developers +did that, they added a lot of functionality to make it easier to write +new import modules. The old way still works, but there are now Module +Specifications, which are metadata about a module, and the old +path_hooks system is now just a meta_path handler added to the +new system as the last resort.

    +

    To read more about Module Specifications, see Module Specifications

    +
    +
    +

    Does the old system still matter?

    +

    Yes, for one reason: iteration. Iteration is the ability to take a +path where you believe Python modules can be found, and list through +them. This facility is useful for large frameworks where a user wants +to add new commands, or new objects, or new operations; Django uses this +facility a lot! The pkgutil library depends upon Finders being able +to iterate their contents.

    +
    +
    +
    + + +
    +
    +
    +
    +
    +

    Table Of Contents

    + + +

    Previous topic

    +

    Usage

    +

    Next topic

    +

    <no title>

    +

    This Page

    + + + +
    +
    +
    +
    +
    +

    Navigation

    + +
    +
    + © Copyright 2016, Kenneth M. "Elf" Sternberg. + Created using Sphinx 1.2.2. +
    + + \ No newline at end of file diff --git a/docs/doctrees/details.doctree b/docs/doctrees/details.doctree new file mode 100644 index 0000000000000000000000000000000000000000..3f156c3445f734ade92fcf383994db82070805bf GIT binary patch literal 29142 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�}B4d$l3;+GI+e4ARgMJw@q!s-;s0B(dLN`#eo^ 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%0Dmn9?}! zVzH`(4)bodN{^##j!-s7tdRnEoiW8)-osi;M%VFP)>=yBdY`prxn<{&9I+uKPE0Ib zb;`_Af@9(&EV@J>PR62>#%z?wQ&W`cA^ zd_3iIc)=svI~J#Uzd46JV&Z?>y98O>8HinQj+5>4{fyyf7Q^99m^J};DMFbH#BK^@ z8R#1wji>dRi`LS3mG>>-B(aCwPbSD~_#Or^o?^|&x0Mrn`2a=I6h-1^Oh3bEne7Y2 zWiZ1U0NF?hVJoq)u|m?AXkxKt&0IP&pVq`*9*8S=8=q8sGv7k?_Sd9KumoSv2TY_* zT$$j#yv-z|tz?v~s0$0%t_s8yA0SY$dv$^nkJkj^S_+=_rHN>}ybd1j3n}B8t5l8g zh%0T3kgn$wHPh2z;D$gL!~j8EQ+(y>QIXzTm zO7rogdZv0yd_1|DkEg)S?SXhI*&&=;D}3A$hy}83EmcxD18{Tj{4vl6_M$224TB}Sgj*U((#@i`$QcLn0P z0IVsmqDy!Rb4zNqK&anTV7S7GN(xrWPT*5czshAYM%QBDA|Iyxbj#mypde zFE6dKrg?c;J!>mUyu7@cmsh~fD+BQ=vO_p`S9rN65U(aXHN2G1apI*EqUPl_b$A&f zUREB#%e{ekEs$$@c^&WI_mp{geN71B4GF%A4{2WBh`NP$XkG?Nyu67I(OjhR%^@%M z1>!B_J7skbRggrE5^sgm_g3@rwi+`LFCi?z-X8H%h42pK>z#pk7v+o4?yK-}e<0pX zHp{%cr^=e<<-PT+tts*HzG`0H4?7$GnL;@hkZw_$zuoj`n-^{V+o#UJ);lebOZDJb zne3~MPc~sLg(#afZc8<8YlK@{{ck)#E+AalM!yqNTaV6axhkj^vuwxw+YiYYegfHn zYZUnb@}+L@om#c4tcu{f_25{8Us)4;59aFNdo}K|YTUjEcX9CK0tLUEexES-^3hv2 z_~S4i!S~}QkjLX%3Z8ta8~h5bdO}$h!LQVVV+}rD6Z|U7)xodUxC7O=gAwlH;K>CF zehvLjOl>+k^ZI(JjvRuT-YFy>o7)- zq^o+HRdPL~DY*ex)>Ya~^$sgfge;IJ(UV?$L0OW%>B3D&$%LMEGCgclrsrACw34S_ zShcI>rR#X6lZ#zx*gkqE;{IYPRuuXF~a>C2wBIVDH&1b!}uJy+(?EGhy6 zpOKcSG6w_YygbAGL1aBIgpVKhum;-Hg3;_8tbJ16ee=mw~-8a z9*LWCX2zeE=Mxg^H47PhuPblfHWfEbPhJ4|VK(UcUeWiChJPUewUBFBPhLcWE^6>N zejz=A4BtB1!~bMOnO*pqp7s)^+mMw4BtCnsY4f z8B1B7E9Gu2?a$%>I+!*KhGnOX9J+4QhLU^maDfdX)Izy}sVt+kDpF#TP&&+(n$C>e ztHHv+i^}wKh_YbIeOla$o`#EcY~e+bj$tc#nU?oa_Rurcjio3nmut+9uxXd3cST;I zmAmP6C>H=q?$^?uMT|)XF>Cg{{K$5BCEdp&D0+#m3Xv?Qnq)aeYVCT;h(fxqrg2X? zXDK5C0-_{dqvy6`qbb4*YffHEYV^h#ne?oc^SHbYlF2soN^2IWOp#(U+dl!9uBZFf zsOKxwG#dZ^yN>b(0_Z_A%tMEbUT5%vbqDDJYo9h96WwG`oq-_9y7jWGkdW2VPE|l- zIW2rNnU%~zc9?b2>ML(OCS+_V+InVZXGe?k9(NtR_2kT%F(|7snI|n2y^d$hrMWfD zZTxw1n#4`E>r6{dw*$4wU-SlBP&uIAEVMU0H(km00h-)s<>W!S>Bg&6y=rU-53|+b zu3_4y-qpa0$J0?`RTiLvcQB$;zgtQ=5T>L{kjLw{&2p3}b^G3Qi2a-_;^6}8K!X|E zLMRdt(HW!jSw0seq)9)+`WIL7x^piTO={5nT^`aeLm}}`45Bs+K@9EY!+9PzvrNWmvb5zy-nTZTwJ^Rti5y| zDLD_-l)MpF)Zf%3F PNy$TWdxzosnbH3OdjYe- literal 0 HcmV?d00001 diff --git a/docs/doctrees/environment.pickle b/docs/doctrees/environment.pickle index 441de3d897083ce016c0752d77a72ea66e4b5156..14a642123dc792f6399817b051bdc03f4c4b7cd8 100644 GIT binary patch literal 18168 zcmbVU34B!5^$uHrfv~8!q4FSVf-(t$prV2x31WmG@MI9j$z%`sWwkUB7eA{qDKTTkc#x zxi#et3O6_0=H&LdDxVv0a(-k(!Of;S$};4nyqv7%lvaCsI@{-F9ZyaTfd${qMmmv~ zOAa`8&XpV8lpm4PmL8CesYId|vV1p}NJKmb+0)|(x62v5_LSt{pq#nYo|za*s$5?o zmy(gKcBAk5Bz%^Zvs+`+8X6khT-q6yO{sJ~MT)$(Tt4l15v~`JbD(6dmh)QenJPKt zmnT*mveOwxs}{xg27$(&-YSlXiv@9UY+M`{7ifck}2_yw7jG! ze{)UwmqPwYKy_TUdDR-LV|Xx|baU2a?q0{*+%jNwy8E2PvI`n7({c+nbll2Y(ezCv zlZfoJ<0mn$WH(#2P0P!RR&B3o)ecx?0l3ist$fbfJTRD7zLm_St!*X8-wDfXEw3QU zCIr|8>$X)|mn`@quRIxJ>vn5-Wzo7lHLbg9Y@fto$JJUU4AK(2ODY=C4&@}%7-l`J zA*p3=QA4VxhBP$H0B*-fEBqvf?l6}qO1myK0%9aLPe<$+MeHANK#JCe>1U?ilIep23` z<&CZO6wgn~o3uQL1!|w8JenCtyJ#86<#X9&uLB1^q~*<62Kt?xSyK*+!*;_cPkS^h zqkWVOSGz@Y+OsQiZXLB}U`{fy+w56`BhfGk33j9BBvnet+rwCeShEUv@{Xd|Fz3$E z*c`CMss@w35c&LGPu_)kbE@+0E~`0!VMnz+`SN1TQrZ^s#d{7gsXWrpGsz(NMff-<~*~;Y*YE+k%+vns>;AfzvKJ7{M~O)+sy0q z1EUAztHu4|frIijqrHa&xD>a>$R|1tyN5(If8suIzdd^kPx+RS@*t$V7E&HOC|^fX zZWp&>Wutntb}-e}Hgf)lQ0?`o_RvB32C4>z#ht9|GG2MTLjq)qyP1(~pv=027(OIG zoVbT`w}4Ct1Dl5gh!Xem3LO};1N^ytZi*LL?@$39uk!u*L0We``9>`twx{QNGfv9) z0*SW@xL?7ZJUAlXrsdl??;WkNd0?V6jN6ohJ&}AwxIAyrCWzPc zcbZNtRg{kk*KUN*VOf;#8m$`YZLV3;`9zhV8>zeuOhW%9#bbsXv?VP5AkguN${m&W!m7lj8p`p+1 zmtP16fk{U$=In_4A~s=P((=o#c9YqKCcHvlpF1qSVoz-Yo%Vc;6gStGPtZn|Hrby1 zYFvJ;)t+Xil_%^-sjc$K*zpyfVr>jiX4Cgn>_ilIIk}tzuinyTE$PViEwOg^j>`2q zs$V`Wp0us*oMUBOT(DtIDVP1$%J*6DV&b{YZrb8{DF-{roRcr0%fFrkclp5)<@O6- zeuEe770b_Bz09hw%AVsp1K5~gqn)5>Nq#dfpRpr}Vy^sF(w}ku}&T3mOpS7n4T*#kRZ4&J{#$-TD zXZ=ju^MyZ<6;5_A(F-xWH~+caRB8cwR*Z^gG20INPL9?fPyQk2Kolw`eQp$mf!FglqT$w#nb&mdxo( z7C_kZ_DpaGNI&@ceO&&b=v^;Vc-J4rQ*rsCcskiN$(MhExPhbx&ZvLnpT!IIG|Wnc zLHU=hgeLJO`K~>1PL`6jYv#L|%zpyFzx0e6ujjfy1(9mo}&xl&6 ziWy*yRq*?w=Tc6@HM>!7#EV1{3A2MtB&-Xqmilhof|?FC6LbHA$?(|FvBWqO+?}ba%}VF~obirV1Bz6yp17 z)oXMI$OY9Dzy+QIsHqg8l|fBItk<3oRhXxobaCZSjm0X{5wjzG`9dyD9_gtWrbx|1 z2x~;MSS8kCvF;Wzu}rw4M<}u1f$#_;v-w=Vd5oZDAw#R#0d6jkrvecLel;YlgN#j( zvJG-}LrM~|GLYqo{ohOuj#w2}ODVhZPD`DEykx>=svp6yK zsf$`c1=T`HTEc}j5w#NK5P3ENtyZy=K;&vpRExASq#e(5)Hzfh?naX7w0SOuNecId zKGp!0>{rP_5mD!&B2=7*K&v%`3LX@x^EokA1zAHXE z9;>MhsBrLrx)_008*znpu?P~#9==(`Gr`bU)ltlxKZYXJ$%UDqdp9Aa)g`zV+q0Py z^@+L^aO55zi z)yz!~X6v}>CP7;>Gy+G}He9!6Xxxpe%Q;SiZd7gOIE}YawS(g{%0|^rj?(}eRW`?I zY>lcbI8GyLRPDmmu^WY(#)NnnyMp8}rbl0NO}1wT69hjNj;k1Iwz4H`LWXo_NNI+& zWk^ki9RL>)i}4K9Z1>e}WSKslRW>5km7MLM=FH-lQhPWv6O62@ zkkTrSYq2-4=ET_E3`bT1<(XjA^e{YG4)3i4Cr#wJDTJ9|Y@`v_%3(y%=Y5o@7#l}7 z;}*b8IbIYG(4u~_7tcN?I$X#;Qrb_Uc}#?RXcERxQkQBG4*>E4bjB$gy?7 zKN-zrXNsdHV}=MG1!oMs;5=j47tP_o*~{XyMm#@?Rs)=}zS5bM`M;;Pd`3wn2E^wk+uazNHgx`lS?4u#XwHjtb03V@5MIV*sujcAeSUG=@ zF{EKXg=3$%t80*tuDBL~RvK5Dw(z7qLuS-wJ>>UgjJeKW48PZNqJBFMPJc_thhZqs?bTcQ$swYhZKa4P>`4+^rx|I@!2Tq!(nfD_Md3^wJtzONDfY;Yh zqJr0^X1eo;nnx3*$z>c?$ud&+Ace-4JLv`{5Tjm;d~o_Y1X?|WD{)G%Qz~k`p3qi? z>>Q8L(yT%;Gt&^?!A!F(90_k=jc+s>4dV}UqMC6S|0WcKJ@sbBy`>!Y)|xmgLn^54 zZ$lXN)Y}o)>K%*-sD6YK)oQH_X(ISL5r#eWDB@bZixC0*F-lbQRB57FcI1hMj3Ev0 zrm*Zan|cp2&?}E4(CWRo(hP&QY#Gu&UJsP9y((n;eJttyMv`Is1DvRCHmvy|3PQF& z#JCTa<33UoXJtqQHRhvK9@70WB((ZCLjt}&!HH_UR)$m&{*wqpx<7@uR-a}>0RIdn z>d?LF$aIr2q~Ws^R=;gjpF=J<|2zV%zJM!nj`xfiGNLx;A-i8>%$E$tu={0B)Nkci zP@d_+1-r_xBGBqvy7h!KI+KjuWW)mDZy5&S0zLl=G)ajkyJ zhyeaGO4M=T&Lg`p8ABR=PT}}(mens%4^I6{1X}$HS8{5+LC%m_wVitG;`nPu|HhzA zzx|dIV;Kkud=BLyfxlz;^X2g0*MXBJYTh3Zh6KKVxK@8;L_pw+l&BzZMsx7$uejS7 zhe$GtH2sOfh2^ie)SrUm11C+?rY3|Tdvg%i zYAz!J-mzxtghfn*mcn@^!xis%)ldAq5OLM}Kw8i7{F;7T0Q1F=#a z&`8Ejl*R=t>R2Pn(0Cjt>eF~U%0n7YVEBpU@P&2Yq={N~62g$ilM&bI6h;IzE}}#g zjr5u#N?ew9x8sarvWt{i6dD>!uY=WMe1vPpNm4}^mJ`!48z>t9L3pr7(*UFG8!mmXb zcGfz?wYrEA0en3rDmtrlr_g=mb)SqO4I3z&*tc8iV$?+sZA73|2d?NLf$y_2WLoW> z2s!U$%qD{|oL|C;`fcBg@{syV8QxV6zpM_NG*QF0P$ zB^U%{pOHegwT)jEhTquHw}6Y)6{wBw*@Zx>7_KycCWzgQ>gY&n=#e|}O4QJ553Z1I zI`S$`)MqkIADhfz!paSK-)OCq(HG~P;~ zd0tv6L*0fFbnWd3w7LV=&@o8Aag6DKY3feSf}GP}%^K`Ohb$r{oVkb?i;1BxMlSa{%!HOAiLva2F7_&vhc0#>!|yML zKTrownuy$2BMe>aHHd5VAR_`7do3j@T&$(!VmvM3lQn#&m8TCfqBt86HQ$*!>52Lk z*-VDKjx=Qg|9J=rtzJ)Apq!r8miz~v^9I7ebKb}m#&SaqA(;xYjFm#ajBCgf@7!f$g`zcZ3 zAg8f|6mNAf+nB|RwjeoYD2krIR|OMw53-od_yFk%-Q$BuX!Rk=f_uy_x(6xckI~>G zA0{At@mUuCIV0Y<#^*UPw(X&7d;#U5YkZO6 zUn+-xxelB(5p`cd7`nz+5yvB5Mg*?$1SKk5qpg`XF@7}d_VEWAeze!|ha4vtE>A1? z?Q*bIt(>Tjkm+R4lN2tDwV^XMdzR~4MLkxaC!Fn9m}4Mj)4FnIRr+$LU=$vN};5jp{)HxG_{*3fk8EWNt{ZYCzry<7`fhB_iap3FRS=a~M9i z96qlOoHSA6<|7PwJPL8Gj%Gx_<1v(|;PH5K!|d@>51jDGM)3tbKG-O2I>w=uj3mtq zC|tVW0r5NLHguEa7OjHrt^fuvd)YRW`OKar&`G|~;} zCvl=a=_jK+B>fbIFDi#yb>O6ln!XreNcs}Q@qC#P0qLhwqJs3J4C%B;c=;@jLFaQ5 z^3?Gl;(!4L+a7I3Z zb)0E*7`m5nqMB|P9YsMn$Fwo7y&Si^CeF%`3TpFNR37%z3M8~z$&i5PvpG?%*UFG8 z!mmOY_S0&_wK|6p0sLG_RPNnT9|4{v<4SWgj&o+n znA+TjEMLf&wFYBYUdM_0t-T24A=&F0zM&j`aUD2mqNZ#_7;@c#xK^Ev2*}#RiLu&A z6TvS*7;?QCajh<8L;&xiL^;>&o#ESx()aYmVKGhzkcFi7G71;Q=EBv3R}b_RI-Sl^ zTTle{w<5sfWL#-X)T+3RWLO!px^}0OUW$*i=}}?#UCv6k8>OcEc5tGa!17Jc{t&&B z(RMldit*4m?!f2J!t)=ySVoLtO>xm27t7-Kyk4x0i_W;{j*D1a^u&c5SG%cBD^4fj z6i(JrS0c&BB1)ZNwVJm|OZj%v#G|ERyTMm`NJxgU7WyJMtEo&hG{r~g&)o6_f!v?mL${c1u490-y57$!YBV|F@D2B^`h`*`(zxR z7)bQx^L{Sxmp!gccsLN?s1zz4#=$WhtV?8_eNI-Tk<&E|XVd5aYoXUX7>nBJ5M-{ulhKD_Ml^qz$FSQtNM{=FA}~#xTd{*XlMv0S?F+6TVD0Ir=5N6 zsO+^XLAB<9>~b|Oi&XJaX(auWD`G*s;OhbnWJ?o!!^&TEBfO&gxv-v3+~@ z_G@=^T+y+;V`=-I<XZda0^Gr}JzQ3^>q6E_9Fm7+W(1ipS(eJMT< z$Yl5gSQwDu=kxfz64&wjm<&3z*RBdw<5>Du9tUeYN6})AQ&;rSYg+9?;m!8k;9NB~ z0f#x%5NFSEbAtsRbb@k+0P?xVG{a z`E&&6TBJl1olw$<@t66O{jy^Ab(GzVXY`bPeKGq0WuF>k-%!lHk+M$@vTrJ8AEfNX zLH1}d`w(T*S7jvoX3AbgmK>(+)*$@I@!w*4QE%Vk*r literal 9983 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 Vj$gq=JBAo~2VPRmtyEI!`xo<@ilzVn diff --git a/docs/doctrees/installation.doctree b/docs/doctrees/installation.doctree index 1343fec4a0afb8f4e881a2fc22a236eb9fc1fa6d..9da555c1d61bb2d435d6a52e49f64fe62695d67d 100644 GIT binary patch delta 342 zcmdmD({H`OmQ~o2fq@|;Um-KExFj(rN1-4;r*d*MYbFkH?a91sj$#r(Jt_(XnFXlY z^4VH&NNpBjuVs~R1zDAms!*I?T9lkxtdN#p1hKE5S84J!9v2BSd_F3U@)J`g`-_TAJ|tqr=r;MUh#}ZY8_^#e0EY}|B>(^b delta 503 zcmeCT-eR-CmQ~J$fq@|;Um-KExFj(rN1>onw;(^KGB>}dAR{wbcX9x0CSfJolfSb% zDk=j_Qc)<#EWl})A6pAyRhwV1)v_uFfSi?)s!*I?T9lkxtdN#pgyFVYo-}1gqSPr( zmgVIoT5Sq%0E;Qm+{xL3ihQWyvH1?K79*qmWOjZ%G?~d3{Jz*Fw)6jG0fjOa<0i`s ziB0|_kjWS@IY!U`-Nb&u7_1VT<%PB}GP+H^CTxnXg-;}eF>rFSh#|T}zo6LWwIYu= E03CU#1poj5 diff --git a/docs/doctrees/readme.doctree b/docs/doctrees/readme.doctree index 5a9cbacdfaa12da5ee02945710592041d91869be..b36d334bd3e22b12c875b88ef6e561860d3f2529 100644 GIT binary patch literal 15404 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 diff --git a/docs/doctrees/usage.doctree b/docs/doctrees/usage.doctree index df6f7a7fe481741d29d25e8306ada64f42568f6f..befda8488d89c25235565be711f1dc803d8f1239 100644 GIT binary patch literal 4735 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 diff --git a/docs/eli5.html b/docs/eli5.html new file mode 100644 index 0000000..3b2a380 --- /dev/null +++ b/docs/eli5.html @@ -0,0 +1,126 @@ + + + + + + + + ELI5: Explain Like I’m Five! — polyloader 0.1.0 documentation + + + + + + + + + + + +
    +

    Navigation

    +     +
    + +
    +
    +
    +
    + +
    +

    ELI5: Explain Like I’m Five!

    +
    +
    +

    Finders

    +

    TODO

    +
    +
    +

    Loaders

    +

    TODO

    +
    +
    +

    Path Hooks

    +

    TODO

    +
    +
    +

    Meta Paths

    +

    TODO

    +
    +
    +

    Module Specifications

    +

    TODO

    +
    + + +
    +
    +
    +
    +
    +

    Table Of Contents

    + + +

    This Page

    + + + +
    +
    +
    +
    +
    +

    Navigation

    + +
    +
    + © Copyright 2016, Kenneth M. "Elf" Sternberg. + Created using Sphinx 1.2.2. +
    + + \ No newline at end of file diff --git a/docs/index.html b/docs/index.html index 65afa4a..a0f3662 100644 --- a/docs/index.html +++ b/docs/index.html @@ -6,7 +6,7 @@ - Welcome to py-polymorphic-loader’s documentation! — polyloader 0.1.0 documentation + Welcome to polyloader — polyloader 0.1.0 documentation @@ -24,7 +24,7 @@ - +
    @@ -37,7 +37,7 @@ modules |
  • - next |
  • polyloader 0.1.0 documentation »
    • @@ -48,17 +48,25 @@
    -
    -

    Welcome to py-polymorphic-loader’s documentation!

    + @@ -79,13 +87,13 @@

    Table Of Contents

    Next topic

    <no title>

    + title="next chapter">Synopsis

    This Page

    diff --git a/docs/installation.html b/docs/installation.html index 0c1c160..0b27f14 100644 --- a/docs/installation.html +++ b/docs/installation.html @@ -25,7 +25,7 @@ - +
    @@ -41,7 +41,7 @@ next |
  • - previous |
  • polyloader 0.1.0 documentation »
    • @@ -56,8 +56,8 @@

    Installation

    Stable release

    -

    To install py-polymorphic-loader, run this command in your terminal:

    -
    $ pip install py-polymorphic-loader
+
    To install polyloader, run this command in your terminal:
    
+
    $ pip install polyloader
 
    
 
    
 
    If you don’t have pip installed, this Python installation guide can guide
@@ -65,13 +65,13 @@ you through the process.

    From sources

    -

    The sources for py-polymorphic-loader can be downloaded from the Github repo.

    +

    The sources for polyloader can be downloaded from the Github repo.

    You can either clone the public repository:

    -
    $ git clone git://github.com/elfsternberg/py-polymorphic-loader
+
    $ git clone git://github.com/elfsternberg/polyloader
 
    
 
    
-
    Or download the tarball:
    
-
    $ curl  -OL https://github.com/elfsternberg/py-polymorphic-loader/tarball/master
+
    Or download the tarball:
    
+
    $ curl  -OL https://github.com/elfsternberg/polyloader/tarball/master
 
    
 
    
 
    Once you have a copy of the source, you can install it with:
    
@@ -98,7 +98,7 @@ you through the process.
    
 
   
    Previous topic
    
   
    <no title>
    
+                        title="previous chapter">Synopsis
    
   
    Next topic
    
   
    Usage
    
@@ -137,7 +137,7 @@ you through the process.
    
           next |
         
  • 
-          previous |
    • 
         
  • polyloader 0.1.0 documentation »
    •  
       
diff --git a/docs/objects.inv b/docs/objects.inv
index 3d52b9e..1e958d2 100644
--- a/docs/objects.inv
+++ b/docs/objects.inv
@@ -2,6 +2,4 @@
 # Project: polyloader
 # Version: 0.1.0
 # The remainder of this file is compressed using zlib.
-xڍ=
-0FBЬ͚t(z7Vl[mK{)	LjBIn!ÆAKjF]TV
-';b53a='FSy)e%9BU~$>fDD79h
\ No newline at end of file
+xڍ0
     
     
-    <no title> — polyloader 0.1.0 documentation
+    Synopsis — polyloader 0.1.0 documentation
     
     
     
@@ -25,7 +25,7 @@
     
     
     
-     
+     
   
   
     
    
@@ -41,7 +41,7 @@
           next |
         
  • 
-          previous |
    • 
         
  • polyloader 0.1.0 documentation »
    •  
       
@@ -52,16 +52,80 @@
         
    
           
    
             
-  
+  
    
+
    Synopsis
    
+
    Polyloader is a python module that extends the Python import
+statement to enable the discovery and loading of heterogenous source
+code packages.
    
+
    
+
    
+
    Say What?
    
+
    The import statement is how the Python interpreter finds a module
+written in Python and loads it, turning it into variables, executable
+functions, constructable classes, and other Python objects, and then
+exposes those objects to the currently running program.
    
+
    The import statement has long been extensible so that things other
+than Python code could be imported, but this feature has always had two
+limitations:
    
+
      
+
    1. It’s annoyingly hard to write an importer. (Believe me. Polyloader
+is one!)
      2. 
+
    2. For filesystem-based modules (which is 99% of them) Python’s importer
+only understands one loader type per directory.  It’s not possible to
+store code or data written in something other than Python in the same
+directory with Python module code and load it via import.
      3. 
+
    
+
    The former requires a certain degree of abstraction and thought.  For
+the latter, most people ignore the problem and load module configuration
+files written in JSON or YAML or whatever directly.  This is fine,
+except when you want to write in one of Python’s extended languages like
+Hy or Coconut in a framework like Django, Flask or Glitch.
    
+
    Polyloader eliminates these limitations.
    
+
    
+
    
+
    What’s the real problem?
    
+
    The real problem is that Python’s traditional extensions, .py,
+.pyc/.pyo, and .so/.dll files, are hard-coded in Python.  In
+Python 2, they’re in the imp builtin; In Python 3, they’re defined
+in a private section of importlib.  Either way, they’re not accessible
+for modification and extension.
    
+
    This problem is made harder by the pkglib module, which is part of
+Python’s standard library.  This module uses inspect.getmoduleinfo,
+which again only recognizes the usual extensions.  Which means you can’t
+list multilingual modules either; this hampers the development of Django
+management commands in a syntax other than Python.
    
+
    
+
    
+
    What the solution?
    
+
    At its heart, the Python import system runs two different internal
+mechanisms to figure out what the import string (the dotted terms
+after the word “import”) “means.”  Each mechanism has one or more
+finders, and the first finder to report “I have a loader that knows
+what that import string means” wins.
    
+
    The very last finder is for the filesystem.  The solution is to get in
+front of that finder with one that can handle all the other syntax
+loaders and knows how to fall back on the last one for those files the
+last one handles.
    
+
    That’s what polyloader does.
    
+
    
+
 
           
    
         
    
       
    
       
    
         
    
+  
    Table Of Contents
    
+  
+
   
    Previous topic
    
   
    Welcome to py-polymorphic-loader’s documentation!
    
+                        title="previous chapter">Welcome to polyloader
    
   
    Next topic
    
   
    Installation
    
@@ -100,7 +164,7 @@
           next |
         
  • 
-          previous |
    • 
         
  • polyloader 0.1.0 documentation »
    •  
       
diff --git a/docs/searchindex.js b/docs/searchindex.js
index 1239563..d8bb13d 100644
--- a/docs/searchindex.js
+++ b/docs/searchindex.js
@@ -1 +1 @@
-Search.setIndex({envversion:42,terms:{compil:[7,8],set:8,suffix:[7,8],creat:8,process:1,onc:1,modul:[0,2],automat:8,pip:1,through:1,have:1,instal:0,tarbal:1,stabl:0,download:1,guid:1,assum:8,your:1,page:0,index:0,git:1,from:0,activ:8,content:[0,2],leav:8,which:8,master:1,you:1,"public":1,can:1,elfsternberg:1,setup:1,sourc:0,run:[8,1],thi:1,python:[8,1],usag:0,clone:1,copi:1,upon:8,curl:1,standard:8,repo:1,releas:0,mechan:8,repositori:1,termin:1,pair:8,don:1,reset:7,search:0,github:1,last:8,packag:2,remov:8,current:8,http:1,manag:8,project:6,instanc:8,command:1,either:1,context:8,lifetim:8,com:1,scope:8,"import":6},objtypes:{"0":"py:module","1":"py:function"},objnames:{"0":["py","module","Python module"],"1":["py","function","Python function"]},filenames:["index","installation","modules","contributing","readme","authors","usage","polyloader","todo","history"],titles:["Welcome to py-polymorphic-loader’s documentation!","Installation","polyloader","<no title>","<no title>","<no title>","Usage","polyloader package","<no title>","<no title>"],objects:{"":{polyloader:[7,0,0,"-"]},polyloader:{reset:[7,1,1,""],install:[7,1,1,""]}},titleterms:{polymorph:0,sourc:1,from:1,welcom:0,modul:7,usag:6,indic:0,loader:0,content:7,packag:7,polyload:[7,2],tabl:0,releas:1,stabl:1,document:0,instal:1}})
\ No newline at end of file
+Search.setIndex({envversion:42,terms:{load:[9,5],all:[9,5],code:[9,5],just:[7,5],move:5,multilingu:9,syntax:[7,9],veri:9,through:[1,5],abil:5,follow:7,discoveri:9,annoyingli:9,find:[9,5],languag:9,suffix:[8,10],access:[9,5],onli:[9,5],depend:5,execut:[9,5],smart_str:5,flask:9,point:5,had:[9,5],except:[9,5],than:9,resort:5,add:[7,5],program:[9,5],those:9,appli:5,reason:5,sens:5,folder:5,main:7,app:7,match:5,take:5,real:0,fly:5,them:[9,5],sourc:0,"return":5,string:[9,5],thei:[9,5],get:9,handl:[9,5],initi:5,util:5,framework:[9,5],ast_compil:7,mechan:[9,10],fall:9,front:9,now:[7,5],archiv:5,requir:9,name:5,tri:5,term:9,like:5,specif:5,hook:5,edit:7,anyth:5,list:[9,5],iter:5,method:5,"try":5,collect:5,either:[9,1],each:[9,5],did:5,unicod:5,page:0,mean:[9,5],compil:[7,8,10],everyth:[7,5],been:9,set:10,natur:5,hard:9,resourc:5,assumpt:5,see:5,meta:5,bare:5,stabl:0,download:1,http:1,fullnam:5,todo:4,hamper:9,librari:[7,9,5],out:[9,5],variabl:[9,5],index:0,insid:5,goe:5,unready_str:5,someth:9,abl:5,per:9,dll:9,current:[9,10,5],figur:[9,5],leav:[10,5],limit:9,content:[0,2,5],"public":1,metadata:5,altern:5,elfsternberg:1,elimin:9,object:[9,5],run:[9,10,1,5],extend:9,web:5,importerror:5,inspect:9,usag:0,privat:9,standard:[9,10],extens:9,job:5,base:[9,5],modif:9,believ:[9,5],repositori:1,found:5,releas:0,from:[0,5],process:[1,5],modifi:5,problem:0,interpret:9,importlib:9,about:5,last:[9,10,5],would:5,befor:5,freedom:5,could:[9,5],success:5,manag:[7,9,10],turn:9,degre:9,instanc:10,context:10,constructor:5,typic:5,view:7,com:1,first:[9,5],oper:5,via:9,user:5,finder:5,directli:9,extra:5,win:9,arrai:5,independ:5,encod:5,pkglib:9,automat:10,loader:5,mochi:7,glitch:9,api:5,yaml:9,latter:9,instal:0,guid:1,facil:5,your:[7,1],git:1,ready_str:5,pkgutil:5,wai:[9,5],script:7,top:7,scan:5,two:[9,5],"long":9,github:1,avail:5,start:5,json:9,handler:5,master:1,statement:[9,5],time:5,call:5,type:9,until:5,store:[9,5],more:[9,5],"function":[9,5],setup:1,lot:5,offer:5,termin:1,peopl:9,copi:1,back:9,remot:5,part:[9,5],understand:9,translat:5,scope:[10,5],line:7,former:9,written:[7,9,5],reset:8,made:[9,5],word:9,describ:5,possibl:9,launcher:7,remov:10,work:[7,5],harder:9,intern:[9,5],can:[7,9,1,5],easier:5,defin:9,"__init__":5,minimum:5,compile_fil:7,whatev:9,assum:10,report:9,modul:5,find_modul:5,heart:9,coconut:9,featur:9,constant:5,file:[9,5],creat:10,give:5,almost:5,certain:9,"abstract":9,filenam:5,ani:5,activ:10,packag:2,pip:1,hy_compil:7,have:[7,9,1,5],tarbal:1,synopsi:0,curl:1,sai:0,getmoduleinfo:9,alwai:9,develop:[9,5],want:[7,9,5],thing:9,make:5,expos:9,when:[9,5],same:9,write:[7,9,5],funni:5,builtin:9,other:9,read:5,split:5,which:[9,10,5],subdirectori:5,command:[9,1,5],you:[7,9,1,5],mochi_compil:7,enabl:9,even:5,imp:9,recogn:9,again:9,configur:9,clone:1,after:9,upon:[10,5],solut:0,most:9,larg:5,plan:7,pyo:9,pair:10,construct:9,pyc:9,data:9,"class":[9,5],tradit:9,repo:1,lifetim:10,don:1,whose:5,filesystem:[9,5],anywher:5,well:7,fine:9,django:[7,9,5],thought:9,heterogen:9,exampl:7,ignor:9,thi:[9,1,5],databas:5,onc:1,model:[7,5],section:9,dot:[9,5],usual:9},objtypes:{"0":"py:module","1":"py:function"},objnames:{"0":["py","module","Python module"],"1":["py","function","Python function"]},filenames:["index","installation","modules","contributing","eli5","details","authors","usage","polyloader","readme","todo","history"],titles:["Welcome to polyloader","Installation","polyloader","<no title>","ELI5: Explain Like I’m Five!","Details on Import and Polyloader","<no title>","Usage","polyloader package","Synopsis","<no title>","<no title>"],objects:{"":{polyloader:[8,0,0,"-"]},polyloader:{reset:[8,1,1,""],install:[8,1,1,""]}},titleterms:{sai:9,old:5,modul:[4,8],meta_path:5,system:5,hook:4,meta:4,tabl:0,stabl:1,still:5,what:[9,5],from:1,welcom:[0,5],explain:4,solut:9,detail:5,content:8,how:5,between:5,"new":5,instal:1,finder:4,real:9,sourc:1,synopsi:9,python:5,usag:7,differ:5,eli5:[4,5],path_hook:5,indic:0,"import":5,releas:1,path:[4,5],loader:4,look:5,search:5,like:4,specif:4,packag:8,directori:5,doe:5,matter:5,polyload:[0,2,5,8],five:4,problem:9,where:5,know:5}})
\ No newline at end of file
diff --git a/docs/src/details.rst b/docs/src/details.rst
new file mode 100644
index 0000000..fc64dd2
--- /dev/null
+++ b/docs/src/details.rst
@@ -0,0 +1,111 @@
+Details on Import and Polyloader
+================================
+
+Welcome to the Python Import ELI5!
+**********************************
+
+What is `import`?
+-----------------
+
+``import`` is a Python statement that finds a *module* that is accessible
+by the currently running process, loads it, and makes its contents
+available to the scope in which the statement was made.  A statement
+like
+
+``import django.db.models``
+
+is looking for a module named ``django.db.models``. If the statement is
+successful, ``django.db.models`` will be a variable name in the scope,
+it will be a Python *object* (of ``class Module``, but that's not
+important), and it will have functions, class constructors, variables
+and constants.  These Python objects will be accessible through the dot
+operator.
+
+An alternative way of writing import statements is
+
+``from django.utils import encoding``
+
+And then the variable will just be ``encoding``.  The ``encoding``
+module has a function for handling unicode-to-web translation.
+Accessing it through the dot operator, it looks like this:
+
+``ready_str = encoding.smart_str(unready_str)``
+
+We call the parts of the import statement that describe the module the
+*import string*.
+
+``sys.path_hooks``: How does Python know where to look?
+-------------------------------------------------------
+
+That's what's funny.  Python has two independent ways of making sense of
+of the import string.  The old system is based on the assumption that
+everything is a filesystem, with folders and filenames.  This is called
+the ``sys.path_hooks`` system.
+
+In the old system, the parts of the import string would be split up, and
+then a collection of directories would be scanned to see if the first
+name in the import string could be matched with a subdirectory.  If it
+could, that directory would be scanned until the last name on the import
+string.  If that name was a *filename*, it would be loaded as a module.
+If that name was a *directory* and that directory had a file named
+``__init__.py``, then that file would be loaded as the module.
+
+The ``sys.path_hooks`` array has a list of different methods for trying to
+scan a filesystem for the parts of the import string.  A ``path_hook`` is
+a function that takes a path to a directory; if it can handle the
+contents of the directory, it returns a **Finder**, an object whose job
+is to figure out how to load the module; if it can't, it returns an
+ImportError exception.  The object that loads the module is called,
+naturally, a **Loader**.
+
+* To read more about **Finders**, see :ref:`eli5-finders`
+* To read more about **Loaders**, see :ref:`eli5-loaders`
+* To read more about **Path Hooks**, see :ref:`eli5-pathhooks`  
+
+``sys.path``: What directories are searched?
+--------------------------------------------
+
+The list of directories is stored in an array, ``sys.path``.  This path is
+initialized by Python when it starts up, but programs can modify it at
+run-time to point to extra directories if they want.
+
+
+``sys.meta_path``: What is the new system?
+------------------------------------------
+
+The new system is called ``sys.meta_path``, and it's an array of
+**Finders**, objects that have one method, ``find_module(fullname)``.
+It's an anything-goes API that gives developers the freedom to import
+modules from anywhere: databases, archives, remote web resources, even
+code written on-the-fly internally.  The new system can apply any
+meaning at all to the import string.
+
+In Python, the import string is offered to each object in
+``sys.meta_path`` before being offered to each ``sys.path_hook``.  The
+filesystem is typically the last finder tried.
+
+To read more about **Meta Paths**, see :ref:`eli5-metapaths`
+
+Is it different between Python 2 and Python 3?
+---------------------------------------------
+
+Python 3 moves almost everything about this process into python's
+library, leaving only a bare minimum of functionality inside the Python
+executable to load this library and run it.  When the Python developers
+did that, they added a lot of functionality to make it easier to write
+new import modules.  The old way still works, but there are now *Module
+Specifications*, which are metadata about a module, and the old
+``path_hooks`` system is now just a ``meta_path`` handler added to the
+new system as the last resort.
+
+To read more about **Module Specifications**, see :ref:`eli5-specs`
+
+Does the old system still matter?
+---------------------------------
+
+Yes, for one reason: *iteration*.  Iteration is the ability to take a
+path where you believe Python modules can be found, and list through
+them.  This facility is useful for large frameworks where a user wants
+to add new commands, or new objects, or new operations; Django uses this
+facility a lot!  The ``pkgutil`` library depends upon Finders being able
+to iterate their contents.
diff --git a/docs/src/eli5.rst b/docs/src/eli5.rst
new file mode 100644
index 0000000..667777f
--- /dev/null
+++ b/docs/src/eli5.rst
@@ -0,0 +1,37 @@
+ELI5: Explain Like I'm Five!
+============================
+
+.. _eli5-finders:
+
+Finders
+=======
+
+TODO
+
+.. _eli5-loaders:
+
+Loaders
+=======
+
+TODO
+
+.. _eli5-pathhooks:
+
+Path Hooks
+==========
+
+TODO
+
+.. _eli5-metapaths:
+
+Meta Paths
+==========
+
+TODO
+
+.. _eli5-specs:
+
+Module Specifications
+=====================
+
+TODO
diff --git a/docs/src/index.rst b/docs/src/index.rst
index 71cd28f..fb05f4b 100644
--- a/docs/src/index.rst
+++ b/docs/src/index.rst
@@ -3,8 +3,8 @@
    You can adapt this file completely to your liking, but it should at least
    contain the root `toctree` directive.
 
-Welcome to py-polymorphic-loader's documentation!
-======================================
+Welcome to polyloader
+=====================
 
 Contents:
 
@@ -14,6 +14,7 @@ Contents:
    readme
    installation
    usage
+   details
    contributing
    authors
    history
diff --git a/docs/src/installation.rst b/docs/src/installation.rst
index 5eca886..578e385 100644
--- a/docs/src/installation.rst
+++ b/docs/src/installation.rst
@@ -8,11 +8,11 @@ Installation
 Stable release
 --------------
 
-To install py-polymorphic-loader, run this command in your terminal:
+To install polyloader, run this command in your terminal:
 
 .. code-block:: console
 
-    $ pip install py-polymorphic-loader
+    $ pip install polyloader
 
 If you don't have `pip`_ installed, this `Python installation guide`_ can guide
 you through the process.
@@ -24,19 +24,19 @@ you through the process.
 From sources
 ------------
 
-The sources for py-polymorphic-loader can be downloaded from the `Github repo`_.
+The sources for polyloader can be downloaded from the `Github repo`_.
 
 You can either clone the public repository:
 
 .. code-block:: console
 
-    $ git clone git://github.com/elfsternberg/py-polymorphic-loader
+    $ git clone git://github.com/elfsternberg/polyloader
 
 Or download the `tarball`_:
 
 .. code-block:: console
 
-    $ curl  -OL https://github.com/elfsternberg/py-polymorphic-loader/tarball/master
+    $ curl  -OL https://github.com/elfsternberg/polyloader/tarball/master
 
 Once you have a copy of the source, you can install it with:
 
@@ -45,5 +45,5 @@ Once you have a copy of the source, you can install it with:
     $ python setup.py install
 
 
-.. _Github repo: https://github.com/elfsternberg/py-polymorphic-loader
-.. _tarball: https://github.com/elfsternberg/py-polymorphic-loader/tarball/master
+.. _Github repo: https://github.com/elfsternberg/polyloader
+.. _tarball: https://github.com/elfsternberg/polyloader/tarball/master
diff --git a/docs/src/readme.rst b/docs/src/readme.rst
index 72a3355..a6210d3 100644
--- a/docs/src/readme.rst
+++ b/docs/src/readme.rst
@@ -1 +1 @@
-.. include:: ../README.rst
+.. include:: ../../README.rst
diff --git a/docs/src/usage.rst b/docs/src/usage.rst
index 587eb68..5f01efd 100644
--- a/docs/src/usage.rst
+++ b/docs/src/usage.rst
@@ -2,6 +2,21 @@
 Usage
 =====
 
-To use py-polymorphic-loader in a project::
+Import polyloader in your python script's launcher or library, as well
+as the syntax compiler(s) you plan to use. For example, if you have
+`Mochi `__ and `Hy
+`__ installed, and you wanted to
+write a Django app, edit manage.py and add the following lines at the
+top:
+
+::
+
+     from mochi.main import compile_file as mochi_compile
+     from hy.importer import ast_compile as hy_compile
+     import polyloader
+     polyloader.install(mochi_compile, ['.mochi'])
+     polyloader.install(hy_compile, ['.hy'])}
+
+Now your views can be written in Hy and your models in Mochi, and
+everything will just work.
 
-    import py-polymorphic-loader
diff --git a/docs/usage.html b/docs/usage.html
index f046638..0295b0d 100644
--- a/docs/usage.html
+++ b/docs/usage.html
@@ -24,7 +24,7 @@
     
     
     
-    
+    
      
   
   
@@ -38,7 +38,7 @@
           modules |
         
  • 
-          next |
    • 
         
  • 
           
 
    Usage
    
-
    To use py-polymorphic-loader in a project:
    
-
    import py-polymorphic-loader
+
    Import polyloader in your python script’s launcher or library, as well
+as the syntax compiler(s) you plan to use. For example, if you have
+Mochi and Hy installed, and you wanted to
+write a Django app, edit manage.py and add the following lines at the
+top:
    
+
    from mochi.main import compile_file as mochi_compile
+from hy.importer import ast_compile as hy_compile
+import polyloader
+polyloader.install(mochi_compile, ['.mochi'])
+polyloader.install(hy_compile, ['.hy'])}
 
    
 
    
+
    Now your views can be written in Hy and your models in Mochi, and
+everything will just work.
    
 
    
 
 
@@ -70,8 +80,8 @@
   
    Installation
    
   
    Next topic
    
-  
    <no title>
    
+  
    Details on Import and Polyloader
    
   
    This Page