First, clone the sake-tasks repo:
git clone git://github.com/drnic/sake-tasks.git
Or replace 'drnic' with your github username if you have forked the sake-tasks repo.
Then install the sake tasks (this step is repeatable, even if one or more tasks are already exist; that is, any pre-existing tasks with the same name will be overridden)
To see your list of resulting tasks:
What are Sake tasks/recipes?
It's the marvelous Sake, system-wide Rake.
The following sake tasks are installed:
sake archive:create # Create an archive in current path [a=path/to/large_folder.tar.gz] sake archive:extract # Extract archive to current path [a=path/to/archive.tar.gz] sake check:erb # Find all .erb or .rhtml files in the current directory tree and report any syntax errors sake check:ruby # Find all .rb files in the current directory tree and report any syntax errors sake check:yaml # Find all .yml files in the current directory tree and report any syntax errors sake gem:install # Builds and installs a gem within its source; uses 'sake install[_gem]' or the gemspec sake gem:view # View GEM=gemname sake git:analyze:commits:flog_frequent # Flog the most commonly revised files in the git history sake git:ignore:xcode # Ignore build and user-specific files in Xcode projects. sake git:manpages:install # Install man pages for current git version sake git:publish # Push all changes to the SVN repository sake git:pull # Pull new commits from the repository sake git:push # Push all changes to the repository sake git:rebase # Pull new commits from the SVN repository sake git:src:install # Downloads and installs latest version of git sake git:status # Show the current status of the checkout sake git:subtree:diff # Show subtree diff against remote sake git:subtree:update # Update an existing subtree project sake git:topic # Create a new topic branch sake git:track_empty_folders # Place a .gitignore in underlying empty folders sake github:pages:migrate_website # Migrates an existing website folder into a gh-pages branch, and links back as submodule sake github:pages:setup # Creates the gh-pages branch, and links to it as 'website' as submodule sake misc:webserver # Start webrick at port 8000 [p=8000] serving current folder [r=.] sake multiruby # Runs any tests or specs in current project against multiruby sake multiruby:gems:install # Install GEM=gemname or GEMS=gem1,gem2 into each multiruby gem cache sake multiruby:spec # Runs specs in current project against multiruby sake multiruby:test # Runs tests in current project against multiruby sake mysql:console # Launch mysql shell. sake mysql:dump # Dump the database to FILE (depends on mysql:params) sake mysql:load # Load the database from FILE (depends on mysql:params) sake rails:date_formats # Show the date/time format strings defined and example output sake ssh:install_public_key # Install your public key on a remote server.
Adding new recipes/tasks
The installer rake task
rake install works by assuming that each
.sake file contains one sake task. This allows it to uninstall the task from sake first, and then re-install it (sake barfs if you attempt to reinstall an existing task).
So, to create a task
foo:bar:baz, you'll need to add a folder
foo/bar and create a file
baz.sake inside it. Within that file you would then specify your task using
task method calls:
namespace 'foo' do namespace 'bar' do desc "This task ..." task :baz do end end end
Testing tasks (even if not installed)
Whilst a task is in development you can execute it locally, without sake, using
To run the local version of foo/bar/baz.sake, use:
rake testrun foo:bar:baz
Installing individual tasks/files
You can selectively install only tasks/files that you are working on, rather than all the files in your repository, or just install the most recently modified sake file.
To install the latest modified sake file:
rake install to only re-install a task
foo:bar:baz you can either use:
rake install:file f=foo/bar/baz.sake rake install:task t=foo:bar:baz
The values can be comma-separated lists.
So for iterative install & run development you could run the install task and the sake task via the same command line:
rake install:task t=foo:bar:baz && sake foo:bar:baz --trace
--trace runs sake in trace mode so useful stacktrace information is given as necessary. Ultimately you'd probably use
rake testrun foo:bar:baz as above.
The latest Ruby.tmbundle on github includes a
task command that generates the above namespace/task snippet based on the path + file name. That is, inside the
foo/bar/baz.sake file, make sure your grammar is 'Ruby' or 'Ruby on Rails' and then type "task" and press TAB. The above snippet will be generated ready for you to specify your task.
- Luke Melia - many git + mysql + ssh tasks
- Dr Nic Williams - repeatable installer rake task