JarCasting
Sushi
Sushi is a scripting library for Java. It provides a simple API for
- file system operations
- ssh-, http (incl webdav), and svn filesystems
- process launching
- Diff
- ... x Rationale: I prefer to do my scripting stuff in Java, not with a scripting languages and not with a special-purpose-language like Ant. Sushi enables me to do so: it provides similar functionality like Ant or Apache Commons - but packaged in an API that makes my "scripts" almost as readable and concise as other approaches.
Note that Sushi releases are not necessarily backward compatible. In particular, if i find a better - but incompatible - api for a given task, I'll change the api. I can't keep old apis just for compatibility (not enough time) and I don't want to have multiple alternative api's if I have a clear preference. But I'll mark incompatible changes by bumping the minor or major version number. (Version number format is major.minor.micro)
Prerequisites
- Linux or Mac OS (Windows might do, but it's untested)
- Java 8
- if you want to build Sushi: Maven 3
Usage
Sushi is available from Maven Central. To use it in a Maven project, add this dependency:
<dependency>
<groupId>net.oneandone</groupId>
<artifactId>sushi</artifactId>
<version>3.0.0</version>
</dependency>
Optional Dependencies
Sushi itself has several transitive dependencies that are marked optional because not everybody needs them. You have to add them to your project if you want to use the respective sushi feature:
For SshNodes (e.g. world.node("ssh//user@host/my/path")):
<dependency>
<groupId>com.jcraft</groupId>
<artifactId>jsch</artifactId>
<version>0.1.53</version>
</dependency>
Additionally, you can add
<dependency>
<groupId>com.jcraft</groupId>
<artifactId>jsch.agentproxy.core</artifactId>
<version>0.0.7</version>
</dependency>
<dependency>
<groupId>com.jcraft</groupId>
<artifactId>jsch.agentproxy.jsch</artifactId>
<version>0.0.7</version>
</dependency>
<dependency>
<groupId>com.jcraft</groupId>
<artifactId>jsch.agentproxy.sshagent</artifactId>
<version>0.0.7</version>
</dependency>
<dependency>
<groupId>com.jcraft</groupId>
<artifactId>jsch.agentproxy.usocket-jna</artifactId>
<version>0.0.7</version>
</dependency>
to make passphrases stored in ssh agent available to Sushi.
For SvnNodes (e.g. world.node("svn:https//host/my/path")):
<dependency>
<groupId>org.tmatesoft.svnkit</groupId>
<artifactId>svnkit</artifactId>
<version>1.8.5</version>
</dependency>
Migrating from Sushi 2.8.x
- Command line parsing has been moved into a separate project https://github.com/mlhartme/inline, see migration instructions there
- replace Node.createReader/Writer with Node.newReader/Writer
- replace new World() with World.create()
Tests
mvn clean testonly runs a subset of the available tests. Some of the test need special setup. To run them, adjust test.properties and run mvn test -Dfull
Ssh Setup
Make sure to can ssh to the host specified in test.properties, authenticating with your public key, not a password. If the key is protected with a passphrase, store this passphrase in ~/.ssh/passphrase to make if available to SshNodes.
Webdav Setup
Note: I used https://github.com/adamfisk/LittleProxy for proxy tests.
Ubuntu 10.10 or later
(see also: http://how-to.linuxcareer.com/webdav-server-setup-on-ubuntu-linux)
sudo apt-get install apache2sudo a2enmod davsudo a2enmod dav_fssudo mkdir /var/www/webdavsudo chown www-data:www-data /var/www/webdavsudoedit /etc/apache2/mods-available/dav_fs.conf
DAVLockDB ${APACHE_LOCK_DIR}/DAVLock <Directory "/var/www/webdav"> Dav On Options +Indexes </Directory> Alias /webdav /var/www/webdav
- ensure the lock file exists:
sudo touch /var/lock/apache2/DAVLocksudo chown www-data:www-data /var/lock/apache2/DAVLock
sudo /etc/init.d/apache2 reload- point your browser to
http://localhost/webdavto verify. You should get an empty directory listing
Mac OS
(tested with Mojave)
-
sudo apachectl start
-
/etc/apache2/httpd.conf: make sure the following lines are present
- LoadModule dav_module
- LoadModule dav_fs_module
- LoadModule dav_lock_module
- Include /private/etc/apache2/extra/httpd-dav.conf
-
In /private/etc/apache2/extra/httpd-dav.conf replace uploads config with
Alias /webdav "/Library/WebServer/WebDAV" <Directory "/Library/WebServer/WebDAV"> Dav On Options +Indexes Require all granted </Directory>
and change the lock file to
DavLockDB "/var/webdav/DavLock"
sudo mkdir -p /var/webdavfor lock filesudo chown -R _www:_www /var/webdavsudo mkdir -p /Library/WebServer/WebDAVfor datasudo chown -R _www:_www /Library/WebServer/WebDAVsudo apachectl graceful- point your browser to
http://localhost/webdav. - trouble shooting
- try "apachectl -S" to check the apache config
- open http://localhost:80 to check if apache starts
- if you get 'permission denied', you forgot Options +Indexes