I/O libraries for Scala
Switch branches/tags
Nothing to show
Pull request Compare This branch is 96 commits ahead, 2 commits behind arnostv:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
project
src
.gitignore
.newdeps
.travis.yml
CHANGES
COPYRIGHT
LICENSE
README.md
build.sbt
version.sbt

README.md

Build Status Rapture I/O

Version 0.8.1 (beta) for Scala 2.10.2

Rapture I/O is a general purpose I/O library for Scala, providing much of the functionality of java.io and java.net, plus comprehensive support for working with JSON.

See rapture.io for more information, examples and documentation.

Building Rapture I/O

Rapture I/O has no dependencies (apart from Scala), and you can build it from source with just a few simple commands.

Using Scala 2.10.2 (or later), compile Rapture I/O as follows:

    git clone https://github.com/propensive/rapture-io.git
    cd rapture-io
    scalac -d bin src/*.scala
    jar cf io.jar -C bin rapture

Just include io.jar on your classpath to use Rapture I/O.

Building Rapture I/O using Maven

Thanks to Michel Daviot, you can also use Maven to compile the project using:

    git clone https://github.com/propensive/rapture-io.git
    cd rapture-io
    mvn clean scala:compile package

To use Rapture I/O in your own projects, just include io.jar on your classpath andimport rapture.io._.

For most functionality, you will also need to specify a strategy for handling exceptions. Import one of the following return-type strategies:

  • strategy.throwExceptions
  • strategy.captureExceptions
  • strategy.returnTry
  • strategy.returnFutures

Now, you're ready to go! Try this:

    $ scala -cp io.jar
    Welcome to Scala version 2.10.2 (Java HotSpot(TM) 64-Bit Server VM, Java 1.6.0_24).
    Type in expressions to have them evaluated.
    Type :help for more information.

    scala> import rapture.io._
    import rapture.io._

    scala> import strategy.throwExceptions
    throwExceptions

    scala> json"""{ "foo": "Hello world!" }"""
    res0: rapture.io.Json = 
    {
     "foo": "Hello world!"
    }