Skip to content

A Rez plugin for managing production environments through staged changes, tailored for animation/VFX workflows where stability is critical.

License

Notifications You must be signed in to change notification settings

PiloeGAO/RezProductionResolver

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

9 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Rez Production Resolver

CI Tests
Docs Deploy Tests coverage

A Rez plugin for managing production environments in animation/VFX workflows. It enables context-aware package management with staged validation, ensuring pipeline stability and preventing production breakage during testing.


Key Features

  • SQLite-backed environment storage
  • 🧩 Multi-level context hierarchy (studio → project → category → entity)
  • 🔄 Automatic validation of package combinations during install/uninstall
  • 📦 Staging/deployment workflow with optional history backups
  • 🧪 Extensive test suite with coverage tracking

Installation

  1. Clone the repository:
git clone https://github.com/PiloeGAO/RezProductionResolver.git
   cd RezProductionResolver
  1. Install Rez (see Rez docs).

  2. Add the plugin to your rezconfig.py:

plugin_path = [
       "/path/to/RezProductionResolver/src",
   ]
  1. Initialize the database:
rez manage --initialize

Usage

Manage Commands

  • Install a package:
rez manage --install maya-2024 --software maya my_project assets character
  • Uninstall a package:
rez manage --uninstall houdini-19 --step lighting
  • List packages:
rez manage --list --step modeling --software blender my_game project
  • Deploy changes:
rez manage --deploy

Resolve Commands

  • Launch software in a context:
rez resolve my_project assets character --software maya
  • Test staged changes:
rez resolve my_project assets character --software maya --staging

Testing & Coverage

Requirements

Install test dependencies:

pip install -e .[tests]

Run Tests

pytest tests/

Run Tests with Coverage

coverage run -m pytest tests/ && coverage report

Documentation

Build documentation using Sphinx:

cd docs
pip install -e .[docs]
make html

Generated HTML will be in docs/build/html/.


CI/CD Workflows

  • CI Tests: Runs tests on every push/pull request.
  • Docs Deploy: Deploys documentation to GitHub Pages automatically.

License

MIT License. See LICENSE for details.


Contributing

  1. Fork the repository.
  2. Create a feature branch: git checkout -b feature-name.
  3. Commit changes and push to your fork.
  4. Submit a pull request with a clear description.

About

A Rez plugin for managing production environments through staged changes, tailored for animation/VFX workflows where stability is critical.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages