A command line interface for editing files from your ScraperWiki box, on your local machine.


A command line interface for editing files from your box, on your local machine.

The perfect partner if you're developing ScraperWiki tools, and want to use your normal text editor like TextMate or Sublime Text.

Supports two alternative workflows:

  1. Copying the remote box files to your local machine, then pushing changes.
  2. Mounting the remote box as a local filesystem, using SSHFS.

swbox clone fegy5tq – Makes a local copy of fegy5tq@box.scraperwiki.com

swbox clone g6ut126@free - Makes a local copy of g6ut126@free.scraperwiki.com

swbox mount fegy5tq - Mounts fegy5tq@box.scraperwiki.com as a local filesystem

  1. Git clone the swbox repo to somewhere safe.

    cd ~ # feel free to change this directory  
    git clone git://github.com/scraperwiki/swbox.git
    cd swbox
  2. Add swbox to your $PATH, so you can type "swbox" from anywhere on your filesystem.

    ln -s $(pwd)/swbox.coffee /usr/local/bin/swbox
  3. Read the documentation by running swbox help

Mounting boxes as local drives requires Fuse and SSHFS. Both are available on the Fuse for OS X homepage.

The swbox command line client requires Node.js and CoffeeScript to be installed. swbox update requires Git.

  • Rsync reports of "Permanently added [url] to the list of known hosts" no longer fool swbox into thinking the push/clone operation failed.
  • Mentions of "beta.scraperwiki.com" changed to "scraperwiki.com"

0.0.8 – post box

  • swbox push --preview will show a preview of what would be created/updated/deleted, without changing anything on the remote box.
  • <boxName> can now include an optional @boxServer suffix, allowing you to clone and mount boxes on free.scraperwiki.com and ds.scraperwiki.com (eg: via swbox clone abcd123@free or swbox mount wxyz789@ds)
  • swbox sync renamed to swbox push since it doesn't actually sync, it removes any files on the destination that aren't present on the local copy.
  • fixed a bug that caused swbox sync/push to loop forever when invoked outside of a local box clone
  • swbox clone no longer takes an optional destination directory – it will always create a clone, in new directory named after the box, in the current working directory
  • removed /swbox symbolic link in root directory – it's no longer needed
  • standardised display of required and optional arguments in help messages
  • swbox sync command to synchronise local changes inside a clone, back up to the original box
  • swbox clone command to clone an entire box's contents to your local filesystem
  • added -oworkaround=rename to sshfs options, to allow rsync and git to rename/update files
  • swbox update command to download the latest version of swbox
  • mounting and unmounting boxes as sshfs drives
  • license, help and docs