Learn how to use the wizard to manage your application
Navigate to the Sagittarius-Wizard/
directory of your Sagittarius distribution and run the command python SagittariusWizard.py
in your favorite command line.
Using the wizard revolves around the idea of RECIPES. A recipe is a collection of buttons (you can think of them as “ingredients”), each with certain attributes, that does something when submitted to your application. The following buttons are available:
object_type==”motd”
filter would only return objects whose type is “motd”.
&f=v
.
In addition, there is a special action button automatically added to each recipe. To select the action you want your recipe to carry out, simply left-click the action button (it should be the first button in the Recipe row) and select the action from the drop-down list. The following actions are available:
Consider the recipe below:
This is a simple recipe that queries for the current Message of the Day. The first button tells Sagittarius that it wants to GET data. The two filters make sure that all returned objects have object_type==motd
and object_name==motd
. Since we only want the actual message, we add a projection on the message
attribute of our MOTD object. Finally, we only want one MOTD returned, so we set a limit of 1.
Add a button to your recipe by clicking on it in the Available Buttons row. Not all buttons in the row will be clickable; whether or not you can add a button depends on the action you have selected. Once you have added a button, you can click on it in the Recipe row to modify its attributes. Doing so will bring up a dialogue of available options for that button type.
If you want to delete a button from your recipe, just right-click it. For a quick way to clear an entire recipe, go to File → Clear Recipe or press Ctrl+N. Note that you can never delete the action button.
The best part about recipes is that you can save and load them at any time. To save a new recipe, go to File → Save Recipe As… or press Alt+S and enter the name you would like to give the recipe. You can also use the quicker File → Save Recipe or Ctrl+S (if the recipe has not already been saved, you will be prompted to name it).
You can load a recipe by going to File → Load Recipe or pressing Ctrl+O. Choose the recipe you want to load from the dropdown list and press Load to load it.
A saved recipe can be deleted by going to File → Delete Recipe (for safety reasons there is no shortcut command). This will NOT clear the recipe from the Recipe row, but it will remove it from the save file. Similarly, if you clear a loaded recipe you can still save it to file; the saved recipe will be empty.
recipes.dat
in the same directory as SagittariusWizard.py
. Avoid modifying this file. Also, this file is not written to until the wizard is closed, meaning that if the wizard should crash or be process-interrupted, you will lose any changes you have made in the current session.
Before submitting a recipe, you must fill out the App ID and Password fields in the Global Options row. These values are the same as the values of [APP ID HERE]
and [APP PASSWORD HERE]
from your application’s app.yaml
file. For more information, see here.
For convenience, these fields are saved every time you exit and will have their previous values the next time you run the wizard.
Coming soon!