amaranth/nmigen/__init__.py

try:
    try:
        from importlib import metadata as importlib_metadata # py3.8+ stdlib
    except ImportError:
        import importlib_metadata # py3.7- shim
    __version__ = importlib_metadata.version(__package__)
except ImportError:
    # No importlib_metadata. This shouldn't normally happen, but some people prefer not installing
    # packages via pip at all, instead using PYTHONPATH directly or copying the package files into
    # `lib/pythonX.Y/site-packages`. Although not a recommended way, we still try to support it.
    __version__ = "unknown"


from .hdl import *


__all__ = [
    "Shape", "unsigned", "signed",
    "Value", "Const", "C", "Mux", "Cat", "Repl", "Array", "Signal", "ClockSignal", "ResetSignal",
    "Module",
    "ClockDomain",
    "Elaboratable", "Fragment", "Instance",
    "Memory",
    "Record",
    "DomainRenamer", "ResetInserter", "EnableInserter",
]
setup: replace versioneer with setuptools_scm. Has the same problems with git-archive but is much less invasive. 2019-09-05 23:11:41 -06:00			`try:`
Gracefully handle missing dependencies. Some people's workflows involve not using `pip`. This is not a recommended way to use nMigen, but is prevalent enough for good enough reason that we try to keep them working anyway. 2020-07-01 01:00:02 -06:00			`try:`
			`from importlib import metadata as importlib_metadata # py3.8+ stdlib`
			`except ImportError:`
			`import importlib_metadata # py3.7- shim`
			`__version__ = importlib_metadata.version(__package__)`
Don't use pkg_resources. This package is deprecated and introduces a massive amount of startup latency. On my machine with 264 installed Python packages, it reduces the time required to `import nmigen` from ~100ms to ~200ms. 2020-06-30 16:08:59 -06:00			`except ImportError:`
Gracefully handle missing dependencies. Some people's workflows involve not using `pip`. This is not a recommended way to use nMigen, but is prevalent enough for good enough reason that we try to keep them working anyway. 2020-07-01 01:00:02 -06:00			`# No importlib_metadata. This shouldn't normally happen, but some people prefer not installing`
			`# packages via pip at all, instead using PYTHONPATH directly or copying the package files into`
			# `lib/pythonX.Y/site-packages`. Although not a recommended way, we still try to support it.
			`__version__ = "unknown"`
Add versioneer. 2019-05-26 05:20:13 -06:00
Explicitly restrict prelude imports. It turns out that while Python does not import _private identifiers when using * imports, it does nevertheless import all submodules. Avoid polluting the namespace in the prelude by explicitly listing all exported identifiers. 2019-10-21 04:39:21 -06:00
Clean up imports. This commit: * moves lists of universally useful imports from `nmigen` to `nmigen.hdl` and `nmigen.lib`, reimporting them in `nmigen`; * replaces lots of imports from individual parts of `nmigen.hdl` with a star import from `nmigen.hdl`; * replaces imports in tests with what we expect downstream code to use; * adds some missing imports in `nmigen.formal`. 2019-06-04 02:18:50 -06:00			`from .hdl import *`
Explicitly restrict prelude imports. It turns out that while Python does not import _private identifiers when using * imports, it does nevertheless import all submodules. Avoid polluting the namespace in the prelude by explicitly listing all exported identifiers. 2019-10-21 04:39:21 -06:00

			`__all__ = [`
			`"Shape", "unsigned", "signed",`
			`"Value", "Const", "C", "Mux", "Cat", "Repl", "Array", "Signal", "ClockSignal", "ResetSignal",`
			`"Module",`
			`"ClockDomain",`
			`"Elaboratable", "Fragment", "Instance",`
			`"Memory",`
			`"Record",`
			`"DomainRenamer", "ResetInserter", "EnableInserter",`
			`]`