Fred Drake | 295da24 | 1998-08-10 19:42:37 +0000 | [diff] [blame] | 1 | \section{\module{ni} --- |
| 2 | None} |
Fred Drake | b91e934 | 1998-07-23 17:59:49 +0000 | [diff] [blame] | 3 | \declaremodule{standard}{ni} |
| 4 | |
| 5 | \modulesynopsis{None} |
| 6 | |
Guido van Rossum | 5938011 | 1997-09-07 02:56:35 +0000 | [diff] [blame] | 7 | |
Guido van Rossum | 1622112 | 1997-09-07 03:02:39 +0000 | [diff] [blame] | 8 | \strong{Warning: This module is obsolete.} As of Python 1.5a4, |
| 9 | package support (with different semantics for \code{__init__} and no |
Guido van Rossum | 138dac5 | 1997-12-09 15:03:41 +0000 | [diff] [blame] | 10 | support for \code{__domain__} or \code{__}) is built in the |
Guido van Rossum | 1622112 | 1997-09-07 03:02:39 +0000 | [diff] [blame] | 11 | interpreter. The ni module is retained only for backward |
Guido van Rossum | 138dac5 | 1997-12-09 15:03:41 +0000 | [diff] [blame] | 12 | compatibility. As of Python 1.5b2, it has been renamed to \code{ni1}; |
| 13 | if you really need it, you can use \code{import ni1}, but the |
| 14 | recommended approach is to rely on the built-in package support, |
| 15 | converting existing packages if needed. Note that mixing \code{ni} |
Fred Drake | 0cf785a | 1998-01-09 22:37:52 +0000 | [diff] [blame] | 16 | and the built-in package support doesn't work: once you import |
Guido van Rossum | 138dac5 | 1997-12-09 15:03:41 +0000 | [diff] [blame] | 17 | \code{ni}, all packages use it. |
Guido van Rossum | 1622112 | 1997-09-07 03:02:39 +0000 | [diff] [blame] | 18 | |
Guido van Rossum | 5938011 | 1997-09-07 02:56:35 +0000 | [diff] [blame] | 19 | The \code{ni} module defines a new importing scheme, which supports |
| 20 | packages containing several Python modules. To enable package |
| 21 | support, execute \code{import ni} before importing any packages. Importing |
| 22 | this module automatically installs the relevant import hooks. There |
| 23 | are no publicly-usable functions or variables in the \code{ni} module. |
| 24 | |
| 25 | To create a package named \code{spam} containing sub-modules \code{ham}, \code{bacon} and |
| 26 | \code{eggs}, create a directory \file{spam} somewhere on Python's module search |
| 27 | path, as given in \code{sys.path}. Then, create files called \file{ham.py}, \file{bacon.py} and |
| 28 | \file{eggs.py} inside \file{spam}. |
| 29 | |
| 30 | To import module \code{ham} from package \code{spam} and use function |
| 31 | \code{hamneggs()} from that module, you can use any of the following |
| 32 | possibilities: |
| 33 | |
Fred Drake | 1947991 | 1998-02-13 06:58:54 +0000 | [diff] [blame] | 34 | \begin{verbatim} |
Guido van Rossum | 5938011 | 1997-09-07 02:56:35 +0000 | [diff] [blame] | 35 | import spam.ham # *not* "import spam" !!! |
| 36 | spam.ham.hamneggs() |
Fred Drake | 1947991 | 1998-02-13 06:58:54 +0000 | [diff] [blame] | 37 | \end{verbatim} |
Guido van Rossum | 5938011 | 1997-09-07 02:56:35 +0000 | [diff] [blame] | 38 | % |
Fred Drake | 1947991 | 1998-02-13 06:58:54 +0000 | [diff] [blame] | 39 | \begin{verbatim} |
Guido van Rossum | 5938011 | 1997-09-07 02:56:35 +0000 | [diff] [blame] | 40 | from spam import ham |
| 41 | ham.hamneggs() |
Fred Drake | 1947991 | 1998-02-13 06:58:54 +0000 | [diff] [blame] | 42 | \end{verbatim} |
Guido van Rossum | 5938011 | 1997-09-07 02:56:35 +0000 | [diff] [blame] | 43 | % |
Fred Drake | 1947991 | 1998-02-13 06:58:54 +0000 | [diff] [blame] | 44 | \begin{verbatim} |
Guido van Rossum | 5938011 | 1997-09-07 02:56:35 +0000 | [diff] [blame] | 45 | from spam.ham import hamneggs |
| 46 | hamneggs() |
Fred Drake | 1947991 | 1998-02-13 06:58:54 +0000 | [diff] [blame] | 47 | \end{verbatim} |
Guido van Rossum | 5938011 | 1997-09-07 02:56:35 +0000 | [diff] [blame] | 48 | % |
| 49 | \code{import spam} creates an |
| 50 | empty package named \code{spam} if one does not already exist, but it does |
| 51 | \emph{not} automatically import \code{spam}'s submodules. |
| 52 | The only submodule that is guaranteed to be imported is |
| 53 | \code{spam.__init__}, if it exists; it would be in a file named |
| 54 | \file{__init__.py} in the \file{spam} directory. Note that |
| 55 | \code{spam.__init__} is a submodule of package spam. It can refer to |
| 56 | spam's namespace as \code{__} (two underscores): |
| 57 | |
Fred Drake | 1947991 | 1998-02-13 06:58:54 +0000 | [diff] [blame] | 58 | \begin{verbatim} |
Guido van Rossum | 5938011 | 1997-09-07 02:56:35 +0000 | [diff] [blame] | 59 | __.spam_inited = 1 # Set a package-level variable |
Fred Drake | 1947991 | 1998-02-13 06:58:54 +0000 | [diff] [blame] | 60 | \end{verbatim} |
Guido van Rossum | 5938011 | 1997-09-07 02:56:35 +0000 | [diff] [blame] | 61 | % |
| 62 | Additional initialization code (setting up variables, importing other |
| 63 | submodules) can be performed in \file{spam/__init__.py}. |