mirrors/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-12-09 02:35:14 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 10

first update from Ken

Browse source
This commit is contained in:
Guido van Rossum 1995-04-07 09:06:50 +00:00
parent fa486a2d53
commit 96044da680
1 changed files with 39 additions and 25 deletions
Download patch file Download diff file Expand all files Collapse all files

64
Lib/newimp.py
View file

@ -25,39 +25,53 @@ can be used to:
path using a '.' dot-delimited nesting syntax. The nesting is fully path using a '.' dot-delimited nesting syntax. The nesting is fully
recursive. recursive.
- import an entire package as a unit, by importing the package directory. For example, 'import test.test_types' will import the test_types
If there is a module named '__main__.py' in the package, it controls the module within the 'test' package. The calling environment would
load. Otherwise, all the modules in the dir, including packages, are then access the module as 'test.test_types', which is the name of
inherently loaded into the package module's namespace. the fully-loaded 'test_types' module. It is found contained within
the stub (ie, only partially loaded) 'test' module, hence accessed as
__main__.py can load the entire directory, by loading the package 'test.test_types'.
itself, via eg 'import __', or even 'from __ import *'. The benefit
is (1) the ability to do additional things before and after the loads
of the other modules, and (2) the ability to populate the package
module with the *contents* of the component modules, ie with a
'from __ import *'.)
- import siblings from modules within a package, using '__.' as a shorthand - import siblings from modules within a package, using '__.' as a shorthand
prefix to refer to the parent package. This enables referential prefix to refer to the parent package. This enables referential
transparency - package modules need not know their package name. transparency - package modules need not know their package name.
- The '__' package references are actually names assigned within The '__' package references are actually names assigned within
modules, to refer to their containing package. This means that modules, to refer to their containing package. This means that
variable references can be made to imported modules, or variables variable references can be made to imported modules, or to variables
defined via 'import ... from' of the modules, also using the '__.var' defined via 'import ... from', also using the '__.var' shorthand
shorthand notation. This establishes an proper equivalence between notation. This establishes a proper equivalence between the import
the import reference '__.sibling' and the var reference '__.sibling'. reference '__.sibling' and the var reference '__.sibling'.
Modules have a few new attributes, in support of packages. As - import an entire package as a unit, by importing the package directory.
mentioned above, '__' is a shorthand attribute denoting the If there is a module named '__main__.py' in the package, it controls the
modules' parent package, also denoted in the module by load. Otherwise, all the modules in the dir, including packages, are
'__package__'. Additionally, modules have associated with them a inherently loaded into the package module's namespace.
'__pkgpath__', a path by which sibling modules are found."""
For example, 'import test' will load the modules of the entire 'test'
package, at least until a test failure is encountered.
In a package, a module with the name '__main__' has a special role.
If present in a package directory, then it is loaded into the package
module, instead of loading the contents of the directory. This
enables the __main__ module to control the load, possibly loading
the entire directory deliberately (using 'import __', or even
'from __ import *', to load all the module contents directly into the
package module).
- perform any combination of the above - have a package that contains
packages, etc.
Modules have a few new attributes in support of packages. As mentioned
above, '__' is a shorthand attribute denoting the modules' parent package,
also denoted in the module by '__package__'. Additionally, modules have
associated with them a '__pkgpath__', a path by which sibling modules are
found."""
__version__ = "$Revision$" __version__ = "$Revision$"
# $Id$ # $Id$ First release:
# First release: Ken.Manheimer@nist.gov, 5-Apr-1995, for python 1.2 # Ken.Manheimer@nist.gov, 5-Apr-1995, for python 1.2
# Developers Notes: # Developers Notes:
# #
@ -114,10 +128,10 @@ def install():
"""Install newimp import_module() routine, for package support. """Install newimp import_module() routine, for package support.
newimp.revert() reverts to __import__ routine that was superceded.""" newimp.revert() reverts to __import__ routine that was superceded."""
import __builtin__
global origImportFunc global origImportFunc
if not origImportFunc: if not origImportFunc:
try: try:
import __builtin__
origImportFunc = __builtin__.__import__ origImportFunc = __builtin__.__import__
except AttributeError: except AttributeError:
pass pass
@ -716,7 +730,7 @@ def exterior():
# TESTING FACILITIES # # TESTING FACILITIES #
def note(msg, threshold=1): def note(msg, threshold=1):
if VERBOSE >= threshold: print '(import:', msg, ')' if VERBOSE >= threshold: sys.stderr.write('(import: ' + msg + ')\n')
class TestDirHier: class TestDirHier:
"""Populate a transient directory hierarchy according to a definition """Populate a transient directory hierarchy according to a definition