t2-server 0.6.1 → 0.9.0

data/t2-server.gemspec

@@ -0,0 +1,112 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = "t2-server"
+  s.version = "0.9.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Robert Haines"]
+  s.date = "2012-03-26"
+  s.description = "This gem provides access to the Taverna 2 Server REST interface from Ruby."
+  s.email = ["rhaines@manchester.ac.uk"]
+  s.executables = ["t2-delete-runs", "t2-run-workflow", "t2-server-info", "t2-get-output", "t2-server-admin"]
+  s.extra_rdoc_files = [
+    "CHANGES.rdoc",
+    "LICENCE.rdoc",
+    "README.rdoc"
+  ]
+  s.files = [
+    "CHANGES.rdoc",
+    "LICENCE.rdoc",
+    "README.rdoc",
+    "Rakefile",
+    "bin/t2-delete-runs",
+    "bin/t2-get-output",
+    "bin/t2-run-workflow",
+    "bin/t2-server-admin",
+    "bin/t2-server-info",
+    "lib/t2-server-cli.rb",
+    "lib/t2-server.rb",
+    "lib/t2-server/admin.rb",
+    "lib/t2-server/connection-parameters.rb",
+    "lib/t2-server/connection.rb",
+    "lib/t2-server/credentials.rb",
+    "lib/t2-server/exceptions.rb",
+    "lib/t2-server/port.rb",
+    "lib/t2-server/run.rb",
+    "lib/t2-server/server.rb",
+    "lib/t2-server/util.rb",
+    "lib/t2-server/xml/libxml.rb",
+    "lib/t2-server/xml/nokogiri.rb",
+    "lib/t2-server/xml/rexml.rb",
+    "lib/t2-server/xml/xml.rb",
+    "lib/t2server.rb",
+    "test/tc_admin.rb",
+    "test/tc_params.rb",
+    "test/tc_perms.rb",
+    "test/tc_run.rb",
+    "test/tc_secure.rb",
+    "test/tc_server.rb",
+    "test/tc_util.rb",
+    "test/ts_t2server.rb",
+    "test/workflows/always_fail.t2flow",
+    "test/workflows/empty_list.t2flow",
+    "test/workflows/empty_list_input.baclava",
+    "test/workflows/in.txt",
+    "test/workflows/list_and_value.t2flow",
+    "test/workflows/list_with_errors.t2flow",
+    "test/workflows/pass_through.t2flow",
+    "test/workflows/secure/basic-http.t2flow",
+    "test/workflows/secure/basic-https.t2flow",
+    "test/workflows/secure/client-https.t2flow",
+    "test/workflows/secure/digest-http.t2flow",
+    "test/workflows/secure/digest-https.t2flow",
+    "test/workflows/secure/heater-pk.pem",
+    "test/workflows/secure/user-cert.p12",
+    "test/workflows/secure/ws-http.t2flow",
+    "test/workflows/secure/ws-https.t2flow",
+    "test/workflows/strings.txt",
+    "test/workflows/xml_xpath.t2flow",
+    "version.yml"
+  ]
+  s.homepage = "http://www.taverna.org.uk/"
+  s.rdoc_options = ["-N", "--tab-width=2", "--main=README.rdoc"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = "1.8.10"
+  s.summary = "Support for interacting with Taverna 2 Server."
+  s.test_files = ["test/ts_t2server.rb"]
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_development_dependency(%q<rake>, ["~> 0.9.2"])
+      s.add_development_dependency(%q<libxml-ruby>, [">= 1.1.4"])
+      s.add_development_dependency(%q<nokogiri>, [">= 1.5.0"])
+      s.add_development_dependency(%q<rdoc>, [">= 3.9.4"])
+      s.add_development_dependency(%q<jeweler>, ["~> 1.8.3"])
+      s.add_runtime_dependency(%q<taverna-baclava>, ["~> 1.0.0"])
+      s.add_runtime_dependency(%q<hirb>, [">= 0.4.0"])
+    else
+      s.add_dependency(%q<rake>, ["~> 0.9.2"])
+      s.add_dependency(%q<libxml-ruby>, [">= 1.1.4"])
+      s.add_dependency(%q<nokogiri>, [">= 1.5.0"])
+      s.add_dependency(%q<rdoc>, [">= 3.9.4"])
+      s.add_dependency(%q<jeweler>, ["~> 1.8.3"])
+      s.add_dependency(%q<taverna-baclava>, ["~> 1.0.0"])
+      s.add_dependency(%q<hirb>, [">= 0.4.0"])
+    end
+  else
+    s.add_dependency(%q<rake>, ["~> 0.9.2"])
+    s.add_dependency(%q<libxml-ruby>, [">= 1.1.4"])
+    s.add_dependency(%q<nokogiri>, [">= 1.5.0"])
+    s.add_dependency(%q<rdoc>, [">= 3.9.4"])
+    s.add_dependency(%q<jeweler>, ["~> 1.8.3"])
+    s.add_dependency(%q<taverna-baclava>, ["~> 1.0.0"])
+    s.add_dependency(%q<hirb>, [">= 0.4.0"])
+  end
+end
+

data/test/tc_admin.rb

@@ -0,0 +1,63 @@
+# Copyright (c) 2010-2012 The University of Manchester, UK.
+#
+# All rights reserved.
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are met:
+#
+#  * Redistributions of source code must retain the above copyright notice,
+#    this list of conditions and the following disclaimer.
+#
+#  * Redistributions in binary form must reproduce the above copyright notice,
+#    this list of conditions and the following disclaimer in the documentation
+#    and/or other materials provided with the distribution.
+#
+#  * Neither the names of The University of Manchester nor the names of its
+#    contributors may be used to endorse or promote products derived from this
+#    software without specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
+# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+# POSSIBILITY OF SUCH DAMAGE.
+#
+# Author: Robert Haines
+
+require 't2-server'
+
+class TestAdmin < Test::Unit::TestCase
+
+  def test_admin
+    T2Server::Server.new($uri, $conn_params) do |server|
+
+      # unauthorized
+      assert_raise(T2Server::AuthorizationError) do
+        server.administrator(T2Server::HttpBasic.new("u", "p"))
+      end
+
+      begin
+        server.administrator($creds)
+      rescue T2Server::T2ServerError => e
+        # ignore, just don't run more tests
+        return
+      end
+
+      server.administrator($creds) do |admin|
+        assert_equal(admin["allownew"].name, "allowNew")
+
+        save = admin["allownew"].value
+        admin["allownew"].value = false
+        assert_equal(admin["allownew"].value, "false")
+        admin["allownew"].value = save
+        assert_equal(admin["allownew"].value, save)
+      end
+    end
+  end
+end

data/test/{tc_paths.rb → tc_params.rb}

@@ -14,7 +14,7 @@
 #
 #  * Neither the names of The University of Manchester nor the names of its
 #    contributors may be used to endorse or promote products derived from this
-#    software without specific prior written permission. 
+#    software without specific prior written permission.
 #
 # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
 # AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
@@ -31,30 +31,16 @@
 # Author: Robert Haines
 
 require 't2-server'
-require 'test/unit'
 
-class TestFilePaths < Test::Unit::TestCase
-  def test_standard
-    assert_equal("dir/with/child", "dir/with/child".strip_path)
-    assert_equal("dir/with/child", "/dir/with/child".strip_path)
-    assert_equal("dir/with/child", "dir/with/child/".strip_path)
-    assert_equal("dir/with/child", "/dir/with/child/".strip_path)
-    
-    # make sure it is not stripping in place
-    dir = "/dir/with/child/"
-    dir.strip_path
-    assert_equal("/dir/with/child/", dir)
-  end
-  
-  def test_inplace
-    assert_nil("dir/with/child".strip_path!)
-    assert_not_nil("/dir/with/child".strip_path!)
-    assert_not_nil("dir/with/child/".strip_path!)
-    assert_not_nil("/dir/with/child/".strip_path!)
-    
-    # make sure it is stripping in place
-    dir = "/dir/with/child/"
-    dir.strip_path!
-    assert_equal("dir/with/child", dir)
+class TestParams < Test::Unit::TestCase
+
+  def test_params
+    params = T2Server::ConnectionParameters.new
+
+    params[:verify_peer] = true
+    assert_not_nil(params[:verify_peer])
+
+    params[:not_a_chance] = true
+    assert_nil(params[:not_a_chance])
   end
 end

data/test/tc_perms.rb

@@ -0,0 +1,132 @@
+# Copyright (c) 2010-2012 The University of Manchester, UK.
+#
+# All rights reserved.
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are met:
+#
+#  * Redistributions of source code must retain the above copyright notice,
+#    this list of conditions and the following disclaimer.
+#
+#  * Redistributions in binary form must reproduce the above copyright notice,
+#    this list of conditions and the following disclaimer in the documentation
+#    and/or other materials provided with the distribution.
+#
+#  * Neither the names of The University of Manchester nor the names of its
+#    contributors may be used to endorse or promote products derived from this
+#    software without specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
+# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+# POSSIBILITY OF SUCH DAMAGE.
+#
+# Author: Robert Haines
+
+require 't2-server'
+
+class TestPermissions < Test::Unit::TestCase
+
+  def test_ownership
+    server = T2Server::Server.new($uri, $conn_params)
+
+    server.create_run($wkf_pass, $creds) do |run|
+      assert(run.owner?)
+      assert_equal(run.owner, $creds.username)
+
+      run.grant_permission($creds1.username, :read)
+      run_id = run.identifier
+      run1 = server.run(run_id, $creds1)
+
+      assert(!run1.owner?)
+      assert_not_equal(run1.owner, $creds1.username)
+    end
+  end
+
+  def test_read_permission
+    server = T2Server::Server.new($uri, $conn_params)
+
+    server.create_run($wkf_pass, $creds) do |run|
+      assert_nothing_raised(T2Server::AccessForbiddenError) do
+        run.grant_permission($creds1.username, :read)
+      end
+
+      run_id = run.identifier
+
+      run1 = nil
+      assert_nothing_raised(T2Server::AccessForbiddenError) do
+        run1 = server.run(run_id, $creds1)
+      end
+
+      assert_raise(T2Server::AccessForbiddenError) do
+        run1.input_port("IN").value = "Hello, World!"
+        run1.start
+      end
+
+      run.input_port("IN").value = "Hello, World!"
+      run.start
+      run.wait
+
+      assert_nothing_raised(T2Server::AccessForbiddenError) do
+        run1.output_port("OUT").value
+      end
+
+      assert_raise(T2Server::AccessForbiddenError) do
+        run1.delete
+      end
+    end
+  end
+
+  def test_update_permission
+    server = T2Server::Server.new($uri, $conn_params)
+
+    server.create_run($wkf_pass, $creds) do |run|
+      assert_nothing_raised(T2Server::AccessForbiddenError) do
+        run.grant_permission($creds1.username, :update)
+      end
+
+      run_id = run.identifier
+
+      run1 = nil
+      assert_nothing_raised(T2Server::AccessForbiddenError) do
+        run1 = server.run(run_id, $creds1)
+        run1.input_port("IN").value = "Hello, World!"
+        run1.start
+        run1.wait
+        run1.output_port("OUT").value
+      end
+
+      assert_raise(T2Server::AccessForbiddenError) do
+        run1.delete
+      end
+    end
+  end
+
+  def test_destroy_permission
+    server = T2Server::Server.new($uri, $conn_params)
+
+    server.create_run($wkf_pass, $creds) do |run|
+      assert_nothing_raised(T2Server::AccessForbiddenError) do
+        run.grant_permission($creds1.username, :destroy)
+      end
+
+      run_id = run.identifier
+
+      assert_nothing_raised(T2Server::AccessForbiddenError) do
+        run1 = server.run(run_id, $creds1)
+        run1.input_port("IN").value = "Hello, World!"
+        run1.start
+        run1.wait
+        run1.output_port("OUT").value
+        run1.delete
+      end
+    end
+  end
+end

data/test/tc_run.rb

@@ -1,4 +1,4 @@
-# Copyright (c) 2010, 2011 The University of Manchester, UK.
+# Copyright (c) 2010-2012 The University of Manchester, UK.
 #
 # All rights reserved.
 #
@@ -14,7 +14,7 @@
 #
 #  * Neither the names of The University of Manchester nor the names of its
 #    contributors may be used to endorse or promote products derived from this
-#    software without specific prior written permission. 
+#    software without specific prior written permission.
 #
 # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
 # AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
@@ -34,93 +34,226 @@ require 't2-server'
 
 class TestRun < Test::Unit::TestCase
 
-  def test_run
-    # connection
+  # Test run connection
+  def test_run_misc
     assert_nothing_raised(T2Server::ConnectionError) do
-      @run = T2Server::Run.create($address, $wkf_pass)
+      T2Server::Run.create($uri, $wkf_pass, $creds, $conn_params)
     end
+  end
 
-    # test bad state code
-    assert_raise(T2Server::RunStateError) do
-      @run.wait
-    end
+  # Test misc run functions
+  def test_status_codes
+    T2Server::Run.create($uri, $wkf_pass, $creds, $conn_params) do |run|
 
-    # test mkdir
-    assert(@run.mkdir("test"))
+      # test mkdir
+      assert(run.mkdir("test"))
 
-    # set input, start, check state and wait
-    assert_nothing_raised(T2Server::AttributeNotFoundError) do
-      @run.set_input("IN", "Hello, World!")
-    end
-    @run.start
-    assert(@run.running?)
-    assert_nothing_raised(T2Server::RunStateError) do
-      @run.wait
+      # set input, start, check state and wait
+      assert_nothing_raised(T2Server::AttributeNotFoundError) do
+        run.input_port("IN").value = "Hello, World!"
+      end
+      assert_equal(run.input_port("IN").value, "Hello, World!")
+
+      # test correct/incorrect status codes
+      assert_equal(run.status, :initialized)
+      assert_raise(T2Server::RunStateError) { run.wait }
+      assert_nothing_raised(T2Server::RunStateError) { run.start }
+      assert(run.running?)
+      assert_equal(run.status, :running)
+      assert_nothing_raised(T2Server::RunStateError) { run.wait }
+      assert_equal(run.status, :finished)
+      assert_raise(T2Server::RunStateError) { run.start }
+
+      # exitcode and output
+      assert_instance_of(Fixnum, run.exitcode)
+      assert_equal(run.output_port("OUT").value, "Hello, World!")
+      assert_equal(run.output_port("wrong!"), nil)
+
+      # get zip file
+      assert_nothing_raised(T2Server::T2ServerError) do
+        assert_not_equal(run.zip_output, "")
+      end
+
+      # deletion
+      assert(run.delete)
     end
+  end
+
+  # Test run with list inputs
+  def test_run_list_input
+    T2Server::Run.create($uri, $wkf_lists, $creds, $conn_params) do |run|
+      many = [[["boo"]], [["", "Hello"]], [], [[], ["test"], []]]
+      single = [1, 2, 3, 4, 5]
+      single_out = single.map { |v| v.to_s } # Taverna outputs strings!
+
+      run.input_port("SINGLE_IN").value = single
+      run.input_port("MANY_IN").value = many
+      assert_nothing_raised { run.start }
+      assert(run.running?)
+      run.wait
 
-    # exitcode and output
-    assert_instance_of(Fixnum, @run.exitcode)
-    assert_equal(@run.get_output("OUT"), "Hello, World!")
-    assert_raise(T2Server::AccessForbiddenError) do
-      @run.get_output("wrong!")
+      assert_equal(run.output_port("MANY").value, many)
+      assert_equal(run.output_port("SINGLE").value, single_out)
     end
+  end
 
-    # deletion
-    assert(@run.delete)
+  # Test run with a list and file input
+  def test_run_list_and_file
+    T2Server::Run.create($uri, $wkf_l_v, $creds, $conn_params) do |run|
+      list = ["one", 2, :three]
+      list_out = list.map { |v| v.to_s }
 
-    # run with xml input
-    @run = T2Server::Run.create($address, $wkf_xml)
-    @run.set_input("xml","<hello><yes>hello</yes><no>everybody</no><yes>world</yes></hello>")
-    @run.set_input("xpath","//yes")
-    @run.start
-    @run.wait
-    assert_equal(@run.get_output("nodes"), ["hello", "world"])
+      run.input_port("list_in").value = list
+      run.input_port("singleton_in").file = $file_input
+      assert_nothing_raised { run.start }
+      assert(run.running?)
+      run.wait
 
-    # run with file input
-    @run = T2Server::Run.create($address, $wkf_pass)
+      assert_equal(run.output_port("list_out").value, list_out)
+      assert_equal(run.output_port("singleton_out").value, "Hello, World!")
+    end
+  end
 
-    assert_nothing_raised(T2Server::AttributeNotFoundError) do
-      @run.upload_input_file("IN", $file_input)
+  # Test run with xml input
+  def test_run_xml_input
+    T2Server::Run.create($uri, $wkf_xml, $creds, $conn_params) do |run|
+      run.input_port("xml").value =
+        "<hello><yes>hello</yes><no>everybody</no><yes>world</yes></hello>"
+      run.input_port("xpath").value = "//yes"
+      run.start
+      run.wait
+      assert_equal(run.output_port("nodes").value, ["hello", "world"])
     end
+  end
 
-    @run.start
-    assert(@run.running?)
-    assert_nothing_raised(T2Server::RunStateError) do
-      @run.wait
+  def test_run_file_input
+    # run with file input
+    T2Server::Run.create($uri, $wkf_pass, $creds, $conn_params) do |run|
+
+      assert_nothing_raised(T2Server::AttributeNotFoundError) do
+        run.input_port("IN").file = $file_input
+      end
+
+      run.start
+      assert(run.running?)
+      assert_nothing_raised(T2Server::RunStateError) { run.wait }
+      assert_equal(run.output_port("OUT").value, "Hello, World!")
     end
-    assert_equal(@run.get_output("OUT"), "Hello, World!")
+  end
+
+  # Test run that returns list of lists, some empty, using baclava for input
+  def test_baclava_input
+    T2Server::Run.create($uri, $wkf_lists, $creds, $conn_params) do |run|
+      assert_nothing_raised(T2Server::AttributeNotFoundError) do
+        run.baclava_input = $list_input
+      end
 
-    # run that returns list of lists, some empty, using baclava for input
-    @run = T2Server::Run.create($address, $wkf_lists)
-    assert_nothing_raised(T2Server::AttributeNotFoundError) do
-      @run.upload_baclava_file($list_input)
+      assert_equal(run.input_ports.keys.sort, ["MANY_IN", "SINGLE_IN"])
+      assert_equal(run.input_port("MANY_IN").depth, 3)
+      assert_equal(run.input_port("SINGLE_IN").depth, 1)
+      assert(run.baclava_input?)
+      assert(run.input_port("SINGLE_IN").baclava?)
+      assert(run.input_port("SINGLE_IN").set?)
+
+      run.start
+      assert(run.running?)
+      assert_nothing_raised(T2Server::RunStateError) { run.wait }
+      assert_equal(run.output_ports.keys.sort, ["MANY", "SINGLE"])
+      assert_equal(run.output_port("SINGLE").value, [])
+      assert_equal(run.output_port("MANY").value,
+        [[["boo"]], [["", "Hello"]], [], [[], ["test"], []]])
+      assert_equal(run.output_port("MANY").total_size, 12)
+      assert_equal(run.output_port("MANY")[1][0][1].value(1..3), "ell")
+      assert_raise(NoMethodError) { run.output_port("SINGLE")[0].value }
     end
-    
-    @run.start
-    assert(@run.running?)
-    assert_nothing_raised(T2Server::RunStateError) do
-      @run.wait
+  end
+
+  # Test run with baclava output
+  def test_baclava_output
+    T2Server::Run.create($uri, $wkf_pass, $creds, $conn_params) do |run|
+      run.input_port("IN").value = "Some input..."
+      assert_nothing_raised(T2Server::AttributeNotFoundError) do
+        run.request_baclava_output
+      end
+      assert(run.baclava_output?)
+
+      run.start
+      assert(run.running?)
+      assert_nothing_raised(T2Server::RunStateError) { run.wait }
+
+      assert_nothing_raised(T2Server::AccessForbiddenError) do
+        output = run.baclava_output
+      end
     end
-    assert_equal(@run.get_output_ports, ["SINGLE", "MANY"])
-    assert_equal(@run.get_output("SINGLE"), [])
-    assert_equal(@run.get_output("MANY"),
-      [[["boo"]], [["", "Hello"]], [], [[], ["test"], []]])
-
-    # run with baclava output
-    @run = T2Server::Run.create($address, $wkf_pass)
-    @run.set_input("IN", "Some input...")
-    assert_nothing_raised(T2Server::AttributeNotFoundError) do
-      @run.set_baclava_output
+  end
+
+  # Test partial result download
+  def test_result_download
+    T2Server::Run.create($uri, $wkf_pass, $creds, $conn_params) do |run|
+      assert_nothing_raised(T2Server::AttributeNotFoundError) do
+        file = run.upload_file($file_strs)
+        run.input_port("IN").remote_file = file
+      end
+
+      run.start
+      run.wait
+
+      # get total data size (without downloading the data)
+      assert_equal(run.output_port("OUT").total_size, 100)
+      assert_equal(run.output_port("OUT").size, 100)
+
+      # no data downloaded yet
+      assert(run.output_port("OUT").value(:debug).nil?)
+
+      # get just the first 10 bytes
+      assert_equal(run.output_port("OUT").value(0...10),
+        "123456789\n")
+
+      # get a bad range - should return the first 10 bytes
+      assert_equal(run.output_port("OUT").value(-10...10),
+        "123456789\n")
+
+      # confirm only the first 10 bytes have been downloaded
+      assert_equal(run.output_port("OUT").value(:debug),
+        "123456789\n")
+
+      # ask for a separate 10 byte range
+      assert_equal(run.output_port("OUT").value(20...30),
+        "323456789\n")
+
+      # confirm that enough was downloaded to connect the two ranges
+      assert_equal(run.output_port("OUT").value(:debug),
+        "123456789\n223456789\n323456789\n")
+
+      # ask for a range that we already have
+      assert_equal(run.output_port("OUT").value(5..25),
+        "6789\n223456789\n323456")
+
+      # confirm that no more has actually been downloaded
+      assert_equal(run.output_port("OUT").value(:debug),
+        "123456789\n223456789\n323456789\n")
+
+      # now get the lot and check its size
+      out = run.output_port("OUT").value
+      assert_equal(out.length, 100)
     end
+  end
 
-    @run.start
-    assert(@run.running?)
-    assert_nothing_raised(T2Server::RunStateError) do
-      @run.wait
+  # test error handling
+  def test_always_fail
+    T2Server::Run.create($uri, $wkf_fail, $creds, $conn_params) do |run|
+      run.start
+      run.wait
+      assert(run.output_port("OUT").value.nil?)
+      assert(run.output_port("OUT").error?)
     end
+  end
 
-    assert_nothing_raised(T2Server::AttributeNotFoundError) do
-      output = @run.get_baclava_output
+  def test_errors
+    T2Server::Run.create($uri, $wkf_errors, $creds, $conn_params) do |run|
+      run.start
+      run.wait
+      assert(run.output_port("OUT").error?)
     end
   end
 end