Skip to main content

Interactive CLI inspector for any MCS driver -- inspect tools, test connections, execute calls.

Project description

mcs-inspector

Interactive CLI inspector for any MCS driver.

Point it at a driver, verify the connection, browse discovered tools, and execute them interactively -- all from the terminal.

Installation

# Core inspector (bring your own driver)
pip install mcs-inspector

# With mail-reading driver (IMAP)
pip install mcs-inspector[mailread]

# With mail-sending driver (SMTP)
pip install mcs-inspector[mailsend]

# With composite mail driver (read + send)
pip install mcs-inspector[mail]

# With REST/OpenAPI driver
pip install mcs-inspector[rest]

# Everything
pip install mcs-inspector[all]

Usage

# Inspect a mailbox (read)
mcs-inspect mailread --host imap.example.com --user alice@example.com

# Inspect a mail-sending server
mcs-inspect mailsend --host smtp.example.com --user alice@example.com

# Inspect both read + send as a composite driver
mcs-inspect mail --read-host imap.example.com --read-user alice@example.com \
                 --send-host smtp.example.com --send-user alice@example.com

# Inspect a REST API via OpenAPI spec
mcs-inspect rest https://api.example.com/openapi.json

# Same via python -m
python -m mcs.inspector mailread --host imap.example.com --user alice@example.com

What it does

  1. Connects to the target system and verifies the driver works
  2. Lists all discovered tools in a rich table
  3. Inspects any tool in detail (parameters, types, descriptions)
  4. Executes tools interactively -- enter arguments, see results

Programmatic use

from mcs.inspector import run_inspector
from mcs.driver.mailread import MailreadToolDriver

td = MailreadToolDriver(host="...", user="...", password="...")
run_inspector(td, title="Mailread Inspector")

Links

License

Apache-2.0

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mcs_inspector-0.1.2.tar.gz (14.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

mcs_inspector-0.1.2-py3-none-any.whl (15.2 kB view details)

Uploaded Python 3

File details

Details for the file mcs_inspector-0.1.2.tar.gz.

File metadata

  • Download URL: mcs_inspector-0.1.2.tar.gz
  • Upload date:
  • Size: 14.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.5

File hashes

Hashes for mcs_inspector-0.1.2.tar.gz
Algorithm Hash digest
SHA256 fcdb5810ca2313d91e9e005631d399225e7b1de9c2861904dedd847433ff2f49
MD5 f4a5d2008ba0a3734c20069b3f92eaab
BLAKE2b-256 2323673dedf23d7a420c9eec0ee022de3c231b467b99c4129ab4bbe90a1bc274

See more details on using hashes here.

File details

Details for the file mcs_inspector-0.1.2-py3-none-any.whl.

File metadata

  • Download URL: mcs_inspector-0.1.2-py3-none-any.whl
  • Upload date:
  • Size: 15.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.5

File hashes

Hashes for mcs_inspector-0.1.2-py3-none-any.whl
Algorithm Hash digest
SHA256 b17f354b7a0e9fc95c8c5bb125723af336912553fdb164ea27b806e625e3f4b6
MD5 11f0e8fa2f82b9192e47a4c39ee622e8
BLAKE2b-256 6d0518baa8bc5356a8025be1ba5dd0bacd13525d0b56556fbb532d3559ce7c60

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page