How mcellteam/mcell_tools works
mcell_tools is a command-line build and repository-management tool for MCell and related projects. Its principal workflow parses options, checks prerequisites, obtains source repositories, builds MCell and companion components, then optionally assembles a Blender/CellBlender bundle or a PyPI wheel. The README documents the checkout-and-build flow and the resulting build directory. Source excerpts are partial, so relationships within build orchestration and unsampled bundle stages are shown only where documented or directly evidenced.
Main entry points: run.py CLI workflow · build.py Build orchestration · bundle.py Blender bundle · pypi_wheel.py PyPI wheel
Components 18
Workflow control
- CLI workflow
run.py - CLI options
scripts/options.py - Multi-repo CLI
mcell_git.py
Source management
- Repository operations
scripts/repositories.py
Build system
- Build orchestration
scripts/build.py - MCell build
scripts/build.py - Companion builds
scripts/build.py - CMake provisioner
scripts/cmake_builder.py
Packaging outputs
- Blender bundle
scripts/bundle.py - Plugin package
scripts/cellblender_mcell_plugin.py - PyPI wheel
scripts/pypi_wheel.py - Wheel metadata
pypi_wheel/setup.py - Build directory
- Bundle archive
Shared configuration
- Build settings
scripts/build_settings.py - Process utilities
scripts/utils.py
Other components
- Developer
- Git
Connections 23
- Developer → CLI workflow: runs
README.md - CLI workflow → CLI options: parses options
run.py - CLI workflow → CMake provisioner: checks CMake
run.py - CLI workflow → Repository operations: gets sources
run.py - CLI workflow → Build orchestration: starts builds
run.py - CLI workflow → Blender bundle: creates bundle
run.py - CLI workflow → Plugin package: creates package
run.py - CLI workflow → PyPI wheel: creates wheel
run.py - Multi-repo CLI → Repository operations: dispatches commands
mcell_git.py - Repository operations → Git: runs commands
scripts/repositories.py - Build orchestration → MCell build: builds MCell
scripts/build.py - Build orchestration → Companion builds: builds companions
scripts/build.py - Build orchestration → Build directory: writes build output
README.md - Build orchestration → Build settings: uses settings
scripts/build.py - Build orchestration → Process utilities: uses utilities
scripts/build.py - Blender bundle → Build orchestration: uses build command
scripts/bundle.py - Blender bundle → Build settings: uses settings
scripts/bundle.py - Blender bundle → Process utilities: uses utilities
scripts/bundle.py - Blender bundle → Bundle archive: writes archive
scripts/bundle.py - Plugin package → Blender bundle: archives package
scripts/cellblender_mcell_plugin.py - PyPI wheel → Wheel metadata: invokes metadata
scripts/pypi_wheel.py - PyPI wheel → Build settings: uses settings
scripts/pypi_wheel.py - PyPI wheel → Process utilities: uses utilities
scripts/pypi_wheel.py