command-line client for the rallydev API
A usable command-line client for rally.
$ npm install -g ralio
ralio also uses elinks to format HTML content - install it using homebrew or apt-get.
Run the command
ralio configure and follow the steps.
password should be self-explanatory.
should contain the names of the Rally projects that correspond to your project
backlog and your team. Where I work, we run multiple teams from a common
product backlog, hence the different options. If you don't work that way,
put the same project name in both.
Unfortunately, Rally doesn't use OAuth (or any other kind of API keys), so
ralio needs your password. I suggest you
chmod 0600 ~/.raliorc to prevent
your password going walkies. In future I'll be stashing credentials in the OS
See the built-in help:
$ ralio --help Usage: ralio [options] [command] Commands: backlog [options] Show the product backlog sprint [options] Show the current team iteration show <item> Show related information for an individual story, defect or task edit <item> <field> Edit a field of an individual story, defect or task in the system EDITOR open <item> Open a story, defect or task in a web browser start <item> Set a task, defect or story state to in-progress and assign it to you finish [options] <item> Set a task, defect or story state to completed and assign it to you abandon <item> Set a task, defect or story state to defined and clear the owner block <item> Set a task, defect or story state to blocked unblock <item> Set a task, defect or story state to unblocked current Show your current tasks and stories point <story> <points> Set the points for a story or defect task [options] <option> <target> Allow you to create and delete story tasks. Available options <option> [create|delete]. In case of <option> create, <target> is the story name. In case of <option> delete, <target> is the task itself. Options: -h, --help output usage information -V, --version output the version number Usage Examples Creating and deleting story tasks: $ ralio task create US1234 -n "name of the task" $ ralio task create US1234 -n "name of the task" -t "BLUE TASK" $ ralio task delete TA54322 Bug fixing: $ ralio finish DE1234 $ ralio finish DE1234 --rootcause "Code Design/Error" --resolution "Code Change" Finishing a task: $ ralio finish TA1234 Punctuating a story or defect: $ ralio point US1234 $ ralio point DE1234 Viewing your current sprint story and/or tasks: $ ralio sprint $ ralio sprint -t Viewing your current sprint story and/or tasks with filter by story's name: $ ralio sprint -t -f "some name" Viewing current's sprint of another project: $ ralio sprint -p "project_name" Pair programming: $ ralio start TA1234 --pair "Mark" $ ralio finish TA1234 --pair "Mark"
Copyright (c) Olly Smith All rights reserved.
Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
- Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
- Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.