GhVersionManager 1.0.4-beta

GhVersionManager

GhVersionManager is a .NET 7 CLI tool and library for reading and writing version information in Grasshopper .gh and .ghx files. It is designed for automation, CI/CD, and team workflows, and is distributed as a NuGet package for easy integration.

Features

• Read version from the first panel with NickName "version" in a .gh or .ghx file.
• Set or update version in that panel, or create it if missing.
• Interactive console mode for manual workflows.
• CLI mode for scripting and automation, with clear exit codes for integration.
• Reusable C# API for .NET projects.
• Single-file deployment: all dependencies are embedded and loaded at runtime.
• Windows support (due to Grasshopper/GH_IO dependency).

Usage

As a CLI Tool

Install via NuGet (see nuget.org/packages/GhVersionManager) or download from your CI/CD pipeline.

Print the version from a .gh or .ghx file: GhVersionManager.exe path\to\file.ghx GhVersionManager.exe path\to\file.gh

Set the version: GhVersionManager.exe path\to\file.ghx -v 1.2.3 GhVersionManager.exe path\to\file.gh -v 1.2.3

Interactive mode:
Run without arguments to enter an interactive prompt.

As a .NET Library

Reference the NuGet package in your project:

using GhVersionManager;
string? version = GhVersionService.GetVersion("path/to/file.ghx");
bool ok = GhVersionService.SetVersion("path/to/file.ghx", "1.2.3");

Versioning & Changelog

Current version: 1.0.0-beta (public beta)

Changelog

• 1.0.0-beta
  • Initial public beta release
  • CLI and interactive modes
  • Read/write version panel in .gh and .ghx files
  • Single-file deployment (no extra DLLs needed)
  • Windows support only

Feedback & Issues

This is a beta release.
Please report bugs, feature requests, or feedback via GitHub Issues.

License

MIT License. See LICENSE.txt for details.

Credits

• Inspired by scripts and advice from the Grasshopper community, especially David Rutten and Andrew Heumann.
• Uses GH_IO.dll for Grasshopper file access.