自定义内建模块 - Python Build Your Own Built-In Module

 在 python 中, 用户可以通过 py 文件创建自定义的 module, 也可以通过 C 创建 dll, 扩展 python module.
 当用户在一个正在编辑的模块 module 中, 引入(import)另一个已经编辑好的 module 的时候,
 需要名字指明另一个 module 的所在位置,python 才能成功 import 该模块.
     例如,
         在 A.py 中 import abc 文件夹下的 123 module,
             A.py,
                 import abc/123

             目录结构如下,
             A.py
             - abc
                 - 123.py

 然而当引入 built in module 的时候, 只需要以 import + name of built in module 的形式即可,
 如 import sys . 这是为什么呢？为什么 python 会知道所要 import 的 built in module 所在的位置呢？
 毫无疑问, 一定是有这么一个机制 - 能否告诉 python 所引用的 built in module 在什么地方儿呢,
 所以对与 built in module 的 import 来说,在 import 的时候不需要显示的指出 module 所在位置.

 下面来具体看一下儿,
     在 python 启动之后, python 已经创建了一个 名字空间 namespace,
     在这个 namespace 中的符号和值来至于系统 module.而这些系统 module 中，
     __builtin__ module 就是其中一个被创建的 module .
     而 python 会创建一个 PyDictObject 对象,来维护系统所有 modules.

         static PyMethodDef builtin_methods[] = {
         {"__built_class__", (PyCFunction)builtin___built_class__,METH_VARARGS | METH_KEYWORDS, built_class_doc},
         {"__import__",      (PyCFunction)builtin___import__, METH_VARARGS | METH_KEYWORDS, import_doc},
         {"dir",             builtin_dir,     METH_VARARGS | METH_KEYWORDS, built_class_doc},   METH_VARARGS, dir_doc},
         {"getattr",         builtin_getattr,    METH_VARARGS, getattr_doc},
         {"iter",            builtin_iter,       METH_VARARGS, iter_doc},
         {"max",             (PyCFunction)builtin_max,        METH_VARARGS | METH_KEYWORDS, max_doc},
         {"min",             (PyCFunction)builtin_min,        METH_VARARGS | METH_KEYWORDS, min_doc},
         {"next",            (PyCFunction)builtin_next,       METH_VARARGS, next_doc},
         {"print",           (PyCFunction)builtin_print,      METH_VARARGS | METH_KEYWORDS, print_doc},
         {"round",           (PyCFunction)builtin_round,      METH_VARARGS | METH_KEYWORDS, round_doc},
         {"vars",            builtin_vars,       METH_VARARGS, vars_doc},};

     设置完 builtin methods 的属性, 接下就需要这个一个函数, 可以告诉 python 所引入 builtin module 的搜索路径了.
     这个函数就是,
         void Py_SetPath(const wchar_t *)

         python docs org 上面的解释如下,
             Set the default module search path. If this function is called before
             Py_Initialize(),then Py_GetPath() won’t attempt to compute a default
             search path but uses the one provided instead.This is useful if Python
             is embedded by an application that has full knowledge of the location
             of all modules.The path components should be separated by the platform
             dependent delimiter character,which is ':' on Unix and Mac OS X,
             ';' on Windows.
             This also causes sys.executable to be set only to the raw program name
             (see Py_SetProgramName()) and for sys.prefix and sys.exec_prefix to be
             empty. It is up to the caller to modify these if required after calling
             Py_Initialize().Use Py_DecodeLocale() to decode a bytes string to get
             a wchar_* string.The path argument is copied internally, so the caller
             may free it after the call completes.

     最后,来一起看一个添加自定义 builtin module 的示例,
         例子,
             其实很简单, 值需要将自定义模块(zzyzz.py), 放在路径 "\Python\Python36-32\lib" 下就可以了,
                 zzyzz.py
                     + import datetime
                       def weeknumber():
                           print  ("Week - %s" % datetime.date.today().isocalendar()[1])
                           print ("Date - %s" % str(datetime.date.today().isocalendar()))
                           print ("Date - %s" % str(datetime.date.today()))

                 Output,
                     >>>import zzyzz
                     >>>zzyzz.weeknumber()
                     Week - 43
                     Date - (2017, 43, 1)
                     Date - 2017-10-23
                     >>>sys.modules['zzyzz']
                     <module 'zzyzz' from '...\\Python\\Python36-32\\lib\\zzyzz.py'>