116 lines
3.4 KiB
Python
116 lines
3.4 KiB
Python
# This file is part of h5py, a Python interface to the HDF5 library.
|
|
#
|
|
# http://www.h5py.org
|
|
#
|
|
# Copyright 2008-2013 Andrew Collette and contributors
|
|
#
|
|
# License: Standard 3-clause BSD; see "license.txt" for full license terms
|
|
# and contributor agreement.
|
|
|
|
"""
|
|
This is the h5py package, a Python interface to the HDF5
|
|
scientific data format.
|
|
"""
|
|
|
|
from __future__ import absolute_import
|
|
|
|
from warnings import warn as _warn
|
|
|
|
|
|
# --- Library setup -----------------------------------------------------------
|
|
|
|
# When importing from the root of the unpacked tarball or git checkout,
|
|
# Python sees the "h5py" source directory and tries to load it, which fails.
|
|
# We tried working around this by using "package_dir" but that breaks Cython.
|
|
try:
|
|
from . import _errors
|
|
except ImportError:
|
|
import os.path as _op
|
|
if _op.exists(_op.join(_op.dirname(__file__), '..', 'setup.py')):
|
|
raise ImportError("You cannot import h5py from inside the install directory.\nChange to another directory first.")
|
|
else:
|
|
raise
|
|
|
|
_errors.silence_errors()
|
|
|
|
from ._conv import register_converters as _register_converters
|
|
_register_converters()
|
|
|
|
from .h5z import _register_lzf
|
|
_register_lzf()
|
|
|
|
|
|
# --- Public API --------------------------------------------------------------
|
|
|
|
from . import h5a, h5d, h5ds, h5f, h5fd, h5g, h5r, h5s, h5t, h5p, h5z
|
|
|
|
from ._hl import filters
|
|
from ._hl.base import is_hdf5, HLObject, Empty
|
|
from ._hl.files import (
|
|
File,
|
|
register_driver,
|
|
unregister_driver,
|
|
registered_drivers,
|
|
)
|
|
from ._hl.group import Group, SoftLink, ExternalLink, HardLink
|
|
from ._hl.dataset import Dataset
|
|
from ._hl.datatype import Datatype
|
|
from ._hl.attrs import AttributeManager
|
|
|
|
from .h5 import get_config
|
|
from .h5r import Reference, RegionReference
|
|
from .h5t import special_dtype, check_dtype
|
|
|
|
from . import version
|
|
from .version import version as __version__
|
|
|
|
|
|
if version.hdf5_version_tuple != version.hdf5_built_version_tuple:
|
|
_warn(("h5py is running against HDF5 {0} when it was built against {1}, "
|
|
"this may cause problems").format(
|
|
'{0}.{1}.{2}'.format(*version.hdf5_version_tuple),
|
|
'{0}.{1}.{2}'.format(*version.hdf5_built_version_tuple)
|
|
))
|
|
|
|
|
|
def run_tests(verbose=False):
|
|
"""Run tests with TextTestRunner and returns a TestResult instance.
|
|
"""
|
|
# Lazy-loading of tests package to avoid strong dependency on unittest2
|
|
from .tests import run_tests
|
|
return run_tests(verbose=verbose)
|
|
|
|
|
|
def enable_ipython_completer():
|
|
""" Call this from an interactive IPython session to enable tab-completion
|
|
of group and attribute names.
|
|
"""
|
|
import sys
|
|
if 'IPython' in sys.modules:
|
|
ip_running = False
|
|
try:
|
|
from IPython.core.interactiveshell import InteractiveShell
|
|
ip_running = InteractiveShell.initialized()
|
|
except ImportError:
|
|
# support <ipython-0.11
|
|
from IPython import ipapi as _ipapi
|
|
ip_running = _ipapi.get() is not None
|
|
except Exception:
|
|
pass
|
|
if ip_running:
|
|
from . import ipy_completer
|
|
return ipy_completer.load_ipython_extension()
|
|
|
|
raise RuntimeError('Completer must be enabled in active ipython session')
|
|
|
|
|
|
# --- Legacy API --------------------------------------------------------------
|
|
|
|
from .h5t import py_new_vlen as new_vlen
|
|
from .h5t import py_get_vlen as get_vlen
|
|
from .h5t import py_new_enum as new_enum
|
|
from .h5t import py_get_enum as get_enum
|
|
|
|
|
|
|
|
|