mayutils¶

Utilities for Python — plotting helpers, dataframe adapters, Snowflake/SQL glue, PowerPoint/PDF export, notebook display tweaks, OAuth helpers, and a fistful of miscellaneous object helpers. Heavy dependencies are grouped behind extras so the core install stays small.

Quick Start¶

Bash

uv add mayutils                   # core only
uv add "mayutils[plotting]"       # + plotly/kaleido/matplotlib/scipy
uv add "mayutils[recommended]"    # curated data-analysis set (console+pandas+datetime+notebook+plotting+secrets)
uv add "mayutils[all]"            # everything

Python

import mayutils
from mayutils.objects.numbers import prettify

mayutils.setup()
print(prettify(num=1_234_567))  # "1.23M"

Dependency Groups¶

Group	Use it for
`plotting`	`plotly`, `kaleido`, `matplotlib`, `scipy`, `great-tables`
`notebook`	`jupyter`, `ipykernel`, `nbconvert`, `itables`, `jupysql`, `quarto-cli`
`pandas`	`pandas`, `pyarrow`
`dataframes`	`polars`, `modin`, `dask` (+ `pandas`)
`mathematics`	`sympy`, `numba`
`statistics`	`scikit-learn`, `scipy`, `statsmodels`
`financials`	`numpy-financial`
`google`	Google Drive / Sheets / Cloud Storage + auth
`microsoft`	`python-pptx`, `openpyxl`
`sql`	`sqlalchemy`
`snowflake`	`snowflake-connector-python`, `snowflake-sqlalchemy` (+ `sql`)
`streamlit`	`streamlit`
`web`	`selenium`, `playwright`, `chromedriver-autoinstaller`
`pdf`	`pymupdf`, `pillow`
`datetime`	`pendulum`
`cli`	`typer`, `cookiecutter`
`filesystem`	`gitpython`, `watchdog`
`secrets`	`python-dotenv`, `keyring`
`recommended`	meta: `console` + `pandas` + `datetime` + `notebook` + `plotting` + `secrets`
`all`	Every runtime extra

Full details: docs/guides/dependency-groups.md.

Documentation¶

Getting Started
Development
Testing
Documentation
Roadmap — translated from the legacy .todo file
Changelog
API Reference — auto-generated from docstrings

Contributing¶

See the contributing guide for setup, commit conventions (Conventional Commits), and release flow.

License¶

MIT — see LICENSE.