xmod

What it is and what it does

xmod is a lightweight library that lets you give a module the behavior of a callable or container object. Normally, modules are static namespaces; xmod wraps a module so it can respond to function calls, indexing, or other object protocols. This is useful for single-purpose modules where you want to avoid boilerplate and instead call or index the module directly.

The package has no runtime dependencies and works with modern Python versions (3.10–3.14). It's maintained actively with no known vulnerabilities. The core use case is simplifying APIs of modules that "just do one thing" by letting them behave like the objects they export.

Use it for:

• Make a module callable so the module itself can be invoked as a function without intermediate imports.
• Wrap a module around a list or dict to support indexing and mutation directly on the module.
• Reduce import boilerplate in libraries where the module itself is the primary interface.
• Create a module that mimics a built-in type's interface for a more intuitive API.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Lets a module behave like a callable object or container by wrapping it with special methods, eliminating redundant import patterns.

Yes, if you want to simplify module APIs or reduce import boilerplate in single-purpose modules. The package is lightweight, actively maintained, permissively licensed, and carries no security vulnerabilities. Install friction is minimal. It's a niche tool, but well-suited to its specific use case.

Install

xmod on PyPI

pip install xmod

uv add xmod

poetry add xmod

Installing xmod

Before you install

Low install friction with no runtime dependencies. Active maintenance with a recent release 97 days ago and current Python version support (3.10–3.14).

License in practice

MIT license is permissive; you can use, modify, and distribute this package freely with minimal restrictions.

Quickstart

pip install xmod

import xmod

@xmod
def a_function():
    return 'result'

# Module is now callable
print(a_function())  # 'result'

Requires Python 3.10 or later.

Verify before relying

• Whether the decorator approach preserves standard module attributes like __all__ and __doc__.
• Performance overhead of the module wrapping mechanism for frequently-accessed modules.
• Compatibility with module introspection tools and import hooks.

Package facts

Evidence: xmod-1.10.0-py3-none-any.whl

Tags

More Software Development packages