wendelin.py 2.94 KB
Newer Older
1
# Wendelin.core | Top-level in-tree python import redirector
Kirill Smelkov's avatar
Kirill Smelkov committed
2 3 4 5 6 7 8 9
# Copyright (C) 2014-2015  Nexedi SA and Contributors.
#                          Kirill Smelkov <kirr@nexedi.com>
#
# This program is free software: you can Use, Study, Modify and Redistribute
# it under the terms of the GNU General Public License version 3, or (at your
# option) any later version, as published by the Free Software Foundation.
#
# You can also Link and Combine this program with other software covered by
10 11 12 13
# the terms of any of the Free Software licenses or any of the Open Source
# Initiative approved licenses and Convey the resulting work. Corresponding
# source of such a combination shall include the source code for all other
# software used.
Kirill Smelkov's avatar
Kirill Smelkov committed
14 15 16 17 18
#
# This program is distributed WITHOUT ANY WARRANTY; without even the implied
# warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
#
# See COPYING file for full licensing terms.
19
# See https://www.nexedi.com/licensing for rationale and options.
20 21 22 23 24 25 26 27 28 29 30 31 32 33


# tell python wendelin.* modules hierarchy starts at top-level
#
# This allows e.g.          `import wendelin.bigarray`
# to resolve to importing   `bigarray/__init__.py`
#
# and thus avoid putting everything in additional top-level wendelin/
# directory in source tree.
#
# see https://www.python.org/doc/essays/packages/ about __path__
# XXX avoid being imported twice, e.g. `import wendelin.wendelin` should not work.


34 35 36 37 38 39 40
# first make sure setuptools will recognize wendelin.py as package,
# but do not setup proper __path__ yet.
# ( _handle_ns() checks for __path__ attribute presence and refuses to further
#   process "not a package"
#
#   https://github.com/pypa/setuptools/blob/9803058d/pkg_resources/__init__.py#L2012 )
__path__ = []
41

42
# tell setuptools/pkg_resources 'wendelin' is a namespace package
43 44 45 46
# ( so that wendelin.core installed in development mode does not brake
#   'wendelin' namespacing wrt other wendelin software )
__import__('pkg_resources').declare_namespace(__name__)

47 48 49 50 51 52 53 54 55 56 57 58 59 60
# pkg_resources will append '.../wendelin.core/wendelin' to __path__ which is
# not right for in-tree setup and thus needs to be corrected:
# Rewrite '.../wendelin.core/wendelin' -> '.../wendelin.core'
from os.path import dirname, realpath, splitext
myfile = realpath(__file__)
mymod  = splitext(myfile)[0]    # .../wendelin.py   -> .../wendelin
mydir  = dirname(myfile)        # .../wendelin      -> ...
i = None    # in case vvv loop is empty, so we still can `del i` in the end
for i in range(len(__path__)):
    # NOTE realpath(...) for earlier setuptools, where __path__ entry could be
    # added as relative
    if realpath(__path__[i]) == mymod:
        __path__[i] = mydir
del dirname, realpath, splitext, myfile, mymod, mydir, i
61 62 63


# in the end we have:
64 65
# __path__ has >= 1 items
# __path__ entry for wendelin.core points to top of working tree
66 67 68 69 70
# __name__ registered as namespace package
#
# so the following should work:
#   - importing from in-tree files
#   - importing from other children of wendelin packages