NOTE: 9/24/2021 - A few months ago Split Skunkworks (aka developer advocacy) embarked on an experiment to create a command line interface (CLI) tool to provision and interact with Split accounts. The experiment was a success and we are now assessing putting formal engineering muscle behind it. For now, we are taking it offline until such time as we are ready to release a fully supported version.
The Split CLI is a Command Line Interface built to simplify onboarding, and make it easy to manage your entire feature flag lifecycle. The changes and updates you make to your splits through the CLI will be reflected immediately in the Split UI.
Throughout the CLI, to select an option, press the Enter/Return button on your keyboard unless otherwise noted.
Note: Python >=3.6 is required to use the CLI
pip install splitcli
splitcliUpon running splitcli, the CLI will ask you if you have an existing account. Users who are new to Split should select the first option No, I need to create an account to create an account. You will be prompted to enter your first name, last name, email address, and phone number. You will then recieve a 6 digit one time password to authenticate.
If you have a Split account already, select Yes, take me to sign in from the initial prompt. You will then enter your email address, followed by your Admin API Key, which can be found in the Admin Settings of your Split profile. For more information on finding your Admin API Key, follow the directions here.
A split is another name for a feature flag, which allows you to separate code deployment from feature release. When you select Manage Splits from the Main Menu, you will see a list of the splits that are already in your organization, as well as the option to create a new split.
To create a new split, select Create a new split from the menu. You will then be prompted to enter a name for your split, as well as a description. Next, you will choose whether you want a simple rollout, which will give you the ability to turn a feature on or off in any environment, or a custom rollout, where you can have a custom set of treatments.
You will then choose which environment you wish to manage your split in.
Selecting this option will output the full JSON configuration of your split into your terminal.
Selecting this option will allow you to target users into your feature flag. You will select which treatment you are targeting, then add the users.
Selecting this option will allow you to target a segmented user goup to your feature flag. First select which treatment you are targeting, then select the segments you wish to target by pressing the space bar.
Ramp split allows you to ramp up your split to a specific percentage of users. After selecting this option, you will be prompted to enter percentage of the userbase you wish to be in the ON treatment.
Killing a split turns the feature off in the environment you select. To kill a split, navigate to the split, and select Kill from the menu.
Restoring a split turns the split back on after it was killed. Your previous configurations for the Split will still be in place. To restore your split after it has been killed, select Restore from the menu.
Deleting a split's definition will remove all targeting rules from the split. To delete a split's definition, select Delete definition from the menu.
Once your Split has met its definition of done, it can be deleted. To delete a split, select Delete split from the menu. This will delete the split in all environments.
Segments are groups of users that you can use to target in your feature flags. When you select Manage Segments from the Main Menu, you will see a list of the segments that are already in your organization, as well as the option to create a new segment.
To create a new segment, select Create a new segment from the menu. You will then be prompted to enter a name, and description for that segmented user group. Once that segment is created, you will see it listed in the Manage Segments menu. Select the segment you created, and choose which environment you wish to manage it in. Here is where we will soon be adding key management capabilities, stay tuned!
To delete a segment, navigate into the segment you wish to delete, and select Delete segment.
Selecting Log Out will log you out of the CLI.
Selecting Exit will exit out of the CLI.
👤 Talia Nassi
- Twitter: @talia_nassi
- Github: @talianassi921
👤 Henry Jewkes
- Twitter: @HenryJewkes
- Github: @HJewkes
👤 Micah Silverman
Give a ⭐️ if this project helped you!