Hey, everyone!

A while ago I posted about Stitch, an internal toolkit that we use to create pipelines around GameMaker Studio 2.3 development, and that we decided to open source.

I made some major (breaking!) updates to Stitch's import/merge system. Now you can point Stitch at a GitHub repo, or at a URL where a zipped GameMaker project is hosted, or just at a path on your local machine, and have it import exactly the subset of resources you want!

The most powerful way to use this is with GitHub as the source, because it's very easy to control which version of the project you're getting. Plus, you don't have to take any steps to zip up your project (or subsets of it). The code is the release.

Below are some examples (note that these examples might not be importing the important parts of the source -- I'm using them to demonstrate how merging options work).

1) Import everything in gdash, from the most recent commit:

stitch merge --source-github=gm-core/gdash

2) Import everything in gdash, from the most recent release:

stitch merge --source-github=gm-core/gdash?^(\\d \\.){2}\\d

3) Import all the scripts beginning with an "_", or that are in the "gdash" folder, from version 4.0.0 of gdash:

stitch merge --source-github=gm-core/[email protected] --types=scripts --if-name-matches=^_ --if-folder-matches=gdash

Number 2 is admittedly pretty cryptic, but the point is that you can use a regex pattern that will be tested against your Git tags, with Stitch selecting the most recent tag matching the pattern. (Since there is no requirement for exactly what a "release" name looks like on GitHub, a pattern match is the most effective way to ensure you can get what you want.)

See the docs and the CLI help (e.g. stitch merge -h) for full details.

I hope you find it helpful!