quicksilver/plug-ins/subversion.txt · Last modified: 2010/07/14 03:19 (external edit)


Quicksilver Manual > Plug-ins > Subversion Plug-in

About

The Quicksilver Subversion Plug-in allows users to perform actions on Subversion repositories.

It was implemented by Alex Eiser with assistance from Nicholas Jitkoff.

NOTE: The subversion plugin does not currently support SVN 1.4

Usage and Detailed Documentation

To use the Subversion Plug-in, you must install a Subversion Binary. I recommend the pre-compile binaries from http://metissian.com/projects/macosx/subversion/, you can use the Fink as well, but the metissian.com version is more up to date.

This plugin requires the svn command to be accessable at /usr/local/bin. This path can be costomized by setting a new key in the quicksilver preference file for the key QSSVNPluginSVNPATH.

To change the value (e.g. to /opt/local/bin/svn), try:

 defaults write com.blacktree.Quicksilver QSSVNPluginSVNPATH /opt/local/bin/svn

Error messages will show up in the “output” as well as any notification information from the subversion client.

By default the SVN plugin will not show you a list of changed files on commit. If you would like to see such a list use the following command:

 defaults write com.blacktree.Quicksilver QSSVNShowChangedFiles 1

NOTE: If the subversion command is “short” only a notification is shown. If the command output is “a lot” then a textview is shown with the command output.

  • To Update a checked out repository:
    1. Invoke Quicksilver
    2. Select the path for the directory/file to update
    3. use the “SVN UPDATE” Action
  • To get a SVN Log on a checked out repository:
    1. Invoke Quicksilver
    2. Select the path for the directory/file to examine the log
    3. use the “SVN LOG” Action
  • To get a SVN Status on a checked out repository:
    1. Invoke Quicksilver
    2. Select the path for the directory/file to check the status
    3. use the “SVN STATUS” Action
  • To Add/Delete a file in a checked out repository:
    1. Invoke Quicksilver
    2. Select the path for the directory/file to Add/Delete
    3. use the “SVN Add” or “SVN Delete” Action
      1. Quicksilver will determine the correct action for the file.
    4. A SPECIAL command called SVN Add All Directory Contents, causes all items in a directory to be added to a repository. This command will only appear for directories.
  • To Check-Out a repository:
    1. Invoke Quicksilver
    2. Select the path for where you want to check out the repository
    3. use the “SVN CHECKOUT” Action
    4. enter the subversion URL for the repository to check out
  • To Commit a checked out repository:
    1. Invoke Quicksilver
    2. Select the path for the directory/file you want to commit
    3. use the “SVN COMMIT” Action
    4. in the indirect object enter the commit log message

Requirements

  • Quicksilver
  • Subversion Binary

Known Issues

The subversion plugin can take a LONG time to do this work. This is not the fault of the plugin, but rather the underlying repository is large and performing operations is slow.

If your repository requires a network connection, and either the network or the server is down the subversion plugin will fail to accomplish its task.