The 12 Tips of (CommandBox) Christmas - Day 3 - GitHub Integration

12 Tips of (CommandBox) Christmas, CommandBox, Tutorials

Brad Wood December 17, 2016

Spread the word

Brad Wood

December 17, 2016

Spread the word

Share your thoughts

Snuggle up with a warm cup of eggnog (if you're into that sort of thing) because here comes the 3rd installment of our 12 Tips of (CommandBox) Christmas aimed at lifting holiday spirits and empowering developers. Today we look at the sweet GitHub integrations we offer.

GitHub Integration

We support installing packages directly from any Git repository via our Git endpoint. We even let you target branches, tags, and specific commits which can make it easy to grab the bleeding edge version of packages as soon as changes are committed:

CommandBox> install git://site.com/user/repo.git#development
CommandBox> install git://site.com/user/repo.git#v1.2.3
CommandBox> install git://site.com/user/repo.git#09d302b4fffa0b988d1edd8ea747dc0c0f2883ea

GitHub shortcuts

GitHub specifically is a very popular service for devs who want Git-hosted repos. When installing a package from GitHub you can simplify the URL above to be just the user name followed by the repo name like so:

CommandBox> install user/repo
CommandBox> install user/repo#development
CommandBox> install user/repo#v1.2.3
CommandBox> install user/repo#09d302b4fffa0b988d1edd8ea747dc0c0f2883ea

When we see this pattern, we'll convert it to the full Git URL behind the scenes.

Authentication

Don't forget we also support SSH-based authentication which works for private Git repos, Bitbucket, or your own personal Gitlab server. See the instructions at the bottom of this page. The short version is that it should "just work" the same as the Git CLI by picking up the SSH keys in your user's .ssh folder.

Release Life Cycle

You're certainly not required to use Git for your projects, but if you do you'll have some nice perks such as auto-tagging your Git repos when you bump your package's version. You can create a new version of any package by using the "bump" command. This will increment the major, minor, or patch version number in your box.json file using semantic version rules. If the folder also happens to be a Git repo, the command will create a new Git tag and commit it for you.

CommandBox> bump --patch
Set version = 1.0.1
Package is a Git repo.  Tagging...
Tag [v1.0.1] created.

Don't Let These Incredible Offers Slip Away!

Utilize the code THKSGIVING24 at checkout to take advantage of these fantastic discounts before they end...

BoxLang Newsletter: October 2024

Welcome to the October edition of the BoxLang Newsletter! **This month has been packed with exciting updates, new features, and enhancements that continue to shape BoxLang into a robust and versatile programming language. In this edition, we highlight the latest beta releases, new integrations, and key features that have been introduced.

BoxLang 1.0.0 Beta 21 Launched

This release brings another round of powerful tools and refinements to the BoxLang community, making development more dynamic and robust than ever. We’ve added new capabilities for debugging and tracing, expanded context-sensitive controls for thread management, and introduced new methods for fluent attachment handling.

For deeper flexibility, our improvements enhance configurability, streamline session control, and add deeper levels of JSON serialization management. Plus, we’ve squashed a wide range of bugs, enhancing stability across database connections, date handling, and runtime compatibility with CFML.

In addition, CSRF Token functionality is now provided via the bx-csrf module.

Blog