modxpy 2.4.2

ModX — The Python Module Universe at Your Fingertips

🌟 ModXPy — The Python Module Universe at Your Fingertips

Welcome to ModXPy, the ultimate playground for Python’s modules.
With ModXPy you can instantly import, explore, and experiment with the entire Python standard library — plus any installed third-party modules — all from one simple interface.

UPDATE 2.4.2

MAINTENANCE & QOL UPDATE 2!

New parameter for almost every ModX function! as_data: Defaulted to False,

this function's output will be a nice organized print for humans to read.

as_data = True, it will return raw Python data (list or dict). Great for

actual coding, when you want to use real data, and NOT a pretty print chart!

Added pretty printing to some functions who default prints Python data.

Fixed bug for modbench: Deletes given module from cache for a fresh import to avoid any 0 second import bugs.

Test suite updated to work with new as_data parameters

Other fixes: Removed duplicate modx_direct_deps and modx_exact_order from importlog(now using single source of truth)

  All functions now return None in print mode (no accidental data leakage)

  if show_imported is False, but as_data is False, nothing will return.

Output style for as_data = True:

All bulk import functions: returns ([success_list],[failed_imports])

modfunctions: returns [{name : function_name}, {args: [function_args]}, other_functions, etc.]

dependencies, whyloaded, importlog, preloaded, revdeps, modclasses, and modximported: returns list (str)

nonimported, searchmodules and listimportall: Now prints bullet list by default, list with as_data = True

info, modorigin, modglobals, modbench and vcompat: returns dict

🚀 Installation and Importing

IMPORTANT: Before you install ModX, you MUST first (if not already) run "pip install packaging" inside of powershell/terminal. ModX will NOT work without the packaging module.

Install directly from terminal.

Type: "pip install modxpy"

In Python, import as import modx (not modxpy)

Functions:

🔹 dependencies(module, as_data=False)

Shows what other modules a specific module depends on without importing it.

🔹 importall(show_imported=False, as_data=False)

Imports about every standard library module at once.

🔹 importexternal(show_imported=False, as_data=False)

Attempts to import every third-party module you currently have installed.

🔹 importletter(letter, show_imported=False, as_data=False)

Imports all standard library modules whose names start with the given letter (case-insensitive).

🔹 importlog(include_deps=False, as_data=False)

Shows every module imported since ModX loaded in CHRONOLOGICAL order.

include_deps=True: Includes ModX's dependencies in the list.

🔹 importrandom(n, strict_mode=False, show_imported=False, as_data=False)

Imports n random stdlib modules.

strict_mode=False: May import less than n due to dependencies.

strict_mode=True: Forces import until EXACTLY n NEW modules.

🔹 importscreen(show_imported=False, as_data=False)

Imports every module that uses a screen/GUI (like pygame or turtle).

🔹 info(module_name, as_data=False)

Shows basic info about a module: file path, built-in status, full docstring.

🔹 isimported(module)

Checks if a module is currently imported into the Python shell (not just sys.modules).

🔹 listimportall(as_data=False)

Returns a list of modules that import_all() would import.

🔹 modbench(module, as_data=False)

Shows how much time and memory a module takes to import.

Note: The module IS imported, and cache is cleared before each benchmark.

🔹 modclasses(module, as_data=False)

Shows how many and what classes a module has WITHOUT importing it.

🔹 modfunctions(module, as_data=False)

Shows how many and what functions a module has WITHOUT importing it.

🔹 modglobals(module, show_private=False, export=None, as_data=False)

Shows a module's global names (not functions/classes/modules).

show_private=True: Includes names starting with '_'.

export=filename.md: Exports results as Markdown.

🔹 modorigin(module, as_data=False)

Shows where a module came from (e.g., built-in, standard library, or pip-installed).

🔹 modsloaded()

Shows how many modules are currently loaded in your Python session.

🔹 modxhelp(export=None, compact=False, banner=True)

Shows ModX's built-in help dialogue.

export=filename.md: Exports help as Markdown.

compact=True: Shows single-line summaries only.

banner=False: Hides the ASCII banner.

🔹 modximported(as_data=False)

Lists modules that were ONLY imported by ModX — NOT including user imports or dependencies.

🔹 nonimported(as_data=False)

Returns a list of STANDARD LIBRARY modules that have NOT been imported yet.

🔹 preloaded(show_builtins=True, show_internal=False, show_submodules=False, as_data=False)

Shows modules pre-loaded by Python before ModX started.

show_builtins=False: Hides built-in modules.

show_internal=True: Shows modules starting with '_'.

show_submodules=True: Includes submodules (names with '.').

🔹 revdeps(module, as_data=False)

Shows what modules import the given module WITHOUT importing it.

🔹 searchmodules(keyword, as_data=False)

Searches for modules whose names contain the keyword.

🔹 vcompat(module_name, python_version=None, as_data=False)

Checks if a module is compatible with a given Python version.

If no version is given, sweeps ALL Python versions 2.0–3.14.

🔹 whyloaded(module, as_data=False)

Returns a comma-separated string explaining why a module is in memory.

Tags: not_loaded, preloaded, user, referenced, modx, modx_dep, dependency or unknown

Rule: user swallows referenced.

Note: For functions who have a show_imported parameter, if it is True,

then it will show what this function imported, otherwise it won't.

💡 Why Use ModX?

1.) Explore the Python standard library in seconds 2.) Stress-test your environment by bulk importing modules 3.) See hidden dependencies that load behind the scenes 4.) Experiment with random imports for fun or testing 5.) Discover new modules you didn’t know existed

ModXPy turns Python’s module system into a playground — perfect for learning, testing, or just satisfying your curiosity. Install it today with pip install modxpy, import it with import modx, and start discovering how many modules Python already has waiting for you!