Add API module to provide a simple interface to the Meshroom scene

[Alxiice]

Description

Add a new api module to offer an easier interface to scene and nodes.

Features

• core:
  • set the log level
  • initialize (load plugins, nodes, etc)
  • list registered plugins
  • register a plugin
  • unregister a plugin
  • list registered NodePlugins
  • register a NodePlugin
  • unregister a NodePlugin
• scene:
  • load a graph
  • get nodes inside a graph, possibility to filter on node type
  • get backdrop nodes
  • get node by instance name
  • list nodes inside a backdrop node
  • get nodes attributes

[gemini-code-assist]

Code Review

This pull request introduces a new meshroom.api package to provide a simplified interface for interacting with Meshroom plugins and scenes, along with comprehensive unit tests. The review feedback highlights several key improvement opportunities and potential bugs: a type error in setLoglevel when handling invalid log levels, a type mismatch in getBackdropNodes that could cause incorrect node filtering, unnecessary access to private attributes (_name and _compatibilityNodes), an inefficient O(N) lookup in getNode that can be optimized to O(1), redundant list comprehensions in getNodeAttributes, and unused or duplicate imports in the test file.

Important

The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.

[codecov]

⚠️ JUnit XML file not found

The CLI was unable to find any JUnit XML files to upload.
For more help, visit our troubleshooting guide.

[fabiencastan]

Meshroom currently has no notion of public versus private APIs. Adding such a concept would require a larger architectural change and project-wide agreement, which is beyond the scope of this PR.

In its current state, the proposed changes introduce additional complexity and ambiguity without establishing the underlying framework needed to support them. Consequently, this PR will not be merged.

The new features to manipulate scenes should be moved in an existing module.