Metadata-Version: 2.4
Name: modxpy
Version: 1.5.1
Summary: ModX — The Python Module Universe at Your Fingertips
Author: Austin Wang
Author-email: austinw87654@gmail.com
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Dynamic: author
Dynamic: author-email
Dynamic: description
Dynamic: description-content-type
Dynamic: requires-python
Dynamic: summary

# 🌟 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 1.5.1---

Minor update: renamed modximported(), modxhelp(), and isimported()
to modx_imported(), modx_help(), and is_imported() for function name 
consistency.
---

## 🚀 Installation

Install directly from PyPI:

```pip install modxpy

In Python, import as import modx (not modxpy)


Functions: 


🔹 import_all()

Imports about every standard library module at once.

🔹 import_random(n)

Imports n random modules from the standard library.

🔹 import_letter(letter)

Imports all standard library modules whose names start with the given letter.

🔹 import_external()

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

🔹 import_screen()

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

🔹 list_importall()

Returns a list of modules that would be imported by import_all().

🔹 modules_loaded()

Shows how many modules you currently have downloaded on your device.

🔹 imported()

Lists the modules imported since ModX loaded (user + ModX), including dependencies.

🔹 modx_imported()

Lists the modules that were ONLY imported by ModX, NOT including user imports
and dependencies.

🔹 import_letter(letter)

Import every standard library module from the ModX 'modules' list
whose name starts with the given letter (case-insensitive).

🔹 search_modules(keyword)

Search for modules whose names contain the keyword.

🔹 info(module_name)

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

🔹 isimported(module)

Checks if module is currently imported into Python Shell (Not Pythonlib)

🔹 dependencies()

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



Example Code:


import modx  # import ModX module

# Import almost every standard library module at once
modx.import_all()
# Output: (Imports 200+ standard library modules silently)
# Bulk import completed!

# Show all modules imported after ModX loaded (user + ModX)
modx.imported()
# Output:
# Modules imported after ModX load (user, ModX and dependencies):
# - _collections_abc
# - _weakrefset
# - abc
# - collections
# - codecs
# - copyreg
# - encodings
# - encodings.aliases
# - encodings.utf_8
# - enum
# - io
# - keyword
# - linecache
# - os
# - random
# - re
# - sys
# - turtle
# - zipfile
# Total modules imported after ModX load: 19

# Show only modules imported via ModX functions
modx.modx_imported()
# Output:
# Modules imported via ModX:
# - collections
# - json
# - math
# - random
# - re
# - turtle
# - zipfile
# Total modules imported via ModX: 7

# Import 5 random modules from ModX list
modx.import_random(5)
# Output: ['turtle', 'json', 'zipfile', 'math', 're']
# These 5 modules were randomly selected and imported

# Import all modules starting with letter 't'
modx.import_letter('t')
# Output: ['tkinter', 'turtle', 'tarfile', 'tempfile', 'threading', 'timeit', 'token', 'tokenize', 'trace', 'traceback', 'tracemalloc', 'types']
# All standard library modules starting with 't' were imported

# Import all installed third-party modules (if any)
modx.import_external()
# Output: (Imports numpy, pandas, requests, etc. if installed silently)
# Third-party modules imported if available

# Import common screen/GUI/game modules if available
modx.import_screen()
# Output: (Imports pygame, tkinter, turtle, etc. if available silently)
# GUI modules imported if available

# Get the list of modules import_all() would import
modx.list_importall()
# Output: ['collections', 'sys', 'asyncio', 'concurrent', 'ctypes', 'dbm', 'email', 'encodings', 'ensurepip', 'html', ...] (287 modules)
# Complete list of all modules ModX can import

# Get list of standard library modules NOT yet imported
modx.nonimported()
# Output: ['abc', 'argparse', 'ast', 'base64', 'bdb', 'bisect', 'bz2', 'calendar', 'cmd', 'codecs', ...] (150 modules)
# Standard library modules that haven't been imported yet

# Search for modules containing the keyword 'json'
modx.search_modules('json')
# Output: ['json']
# Found modules containing 'json' in their names

# Show information about a specific module
modx.info('random')
# Output:
# Module: random
# Path: /usr/lib/python3.11/random.py
# Docstring:
# Random variable generators.
# Shows file path and docstring for the random module

#Check if random is imported
isimported("random")
#Output: True

#Check all dependencies of module random
dependencies("random")
#Output: Dependencies found:
   _collections_abc
   _random
   _sha2
   argparse
   bisect
   hashlib
   itertools
   math
   operator
   os
   statistics
   time
   warnings

# Show ModX built-in help screen
modx.modxhelp()
# Output:
# ModX — The Python Module Universe
# =================================
# 
# Functions:
# ----------
# 
# import_all()
#     Import almost every standard library module at once.
#     Example: modx.import_all()
# 
# import_external()
#     Import all installed third-party modules.
#     Example: modx.import_external()
# 
# ... (full help text continues)


💡 Why Use ModX?



Explore the Python standard library in seconds

Stress-test your environment by bulk importing modules

See hidden dependencies that load behind the scenes

Experiment with random imports for fun or testing

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!
