Metadata-Version: 2.4
Name: maya-brew
Version: 0.0.4
Summary: Safe interaction with python in maya
Project-URL: Homepage, https://github.com/mortenbohne/maya-brew
Project-URL: Repository, https://github.com/mortenbohne/maya-brew
Project-URL: Documentation, https://github.com/mortenbohne/maya-brew#readme
Project-URL: Issues, https://github.com/mortenbohne/maya-brew/issues
Project-URL: Changelog, https://github.com/mortenbohne/maya-brew/releases
Author-email: Morten Bøhne <github@mortenbohne.dk>
License-Expression: MIT
License-File: LICENSE
Keywords: 3d,autodesk,maya,pipeline
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Multimedia :: Graphics :: 3D Modeling
Requires-Python: >=3.11
Requires-Dist: colorama
Requires-Dist: structlog
Provides-Extra: dev
Requires-Dist: maya-stubs; extra == 'dev'
Requires-Dist: pytest; extra == 'dev'
Description-Content-Type: text/markdown

# maya-brew

> **Status: Pre-Alpha** – Interfaces are experimental and may change without notice. Pin exact versions if using in
> automation.

What you need after a long day of wrestling with Maya Python.

[![Super-Linter](https://github.com/mortenbohne/maya-brew/actions/workflows/linter.yml/badge.svg)](https://github.com/marketplace/actions/super-linter)

---

## Overview

`maya-brew` aims to provide safer, more structured interaction patterns when scripting or tooling inside Autodesk Maya.

Goals:

- Reduce foot‑guns when using Python inside Maya
- Offer utilities that behave well with Maya’s quirks

## Background

`maya-brew` draws inspiration from some of the ergonomic goals that motivated
[PyMEL](https://github.com/LumaPictures/pymel): making Maya’s Python interface feel more “Pythonic,” safer, and more
discoverable. PyMEL historically provided rich object wrappers around nodes, attributes, and other scene elements;
for many workflows this improved readability and reduced boilerplate.

However, over time several practical factors led to the decision to start a lightweight alternative instead of
extending PyMEL itself:

- Scope & Complexity: PyMEL’s dynamic wrapping and layered abstractions can introduce startup overhead, indirection, and
  occasional debugging friction.
- Historical Churn: A long evolution, multiple contributors, and some legacy design choices make selective modernization
  non‑trivial.
- Maintenance & Momentum: While still usable, PyMEL no longer appears to have the same pace of active development or
  broad community push it once did.
- Adoption Fit: Many pipelines only need a thin set of safety/ergonomic helpers—not a full object layer over
  `maya.cmds`.

### Acknowledgment

PyMEL significantly influenced how many technical artists approach Maya scripting, and this project stands on that
conceptual foundation. `maya-brew` simply narrows the focus: take the useful ergonomic ideas, shed the heavy wrapping,
and keep to the canonical APIs.
