serval-dna/tests/dna_rhizome

#!/bin/bash

# Tests for Serval DNA rhizome operations.
#
# Copyright 2012 Paul Gardner-Stephen
#
# This program is free software; you can redistribute it and/or
# modify it under the terms of the GNU General Public License
# as published by the Free Software Foundation; either version 2
# of the License, or (at your option) any later version.
# 
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
# GNU General Public License for more details.
# 
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.

source "${0%/*}/../testframework.sh"
source "${0%/*}/../testdefs.sh"

setup_dna_rhizome() {
   setup_dna "$@"
   executeOk $dna config set debug rhizome
}

assert_rhizome_list() {
   executeOk $dna rhizome list
   assertStdoutLineCount '==' $#
   assertStdoutGrep --matches=$# '^fileid=.*:name='
   local filename
   for filename; do
      local filehash='[^:]\+'
      # If there is a manifest file that looks like it matches this payload
      # file, then use its file hash to check the rhizome list output.
      if [ -r "$filename.manifest" ]; then
         local name=$(sed -n -e '/^name=/s///p' "$filename.manifest")
         if [ "$name" == "$filename" ]; then
            filehash=$(sed -n -e '/^filehash=/s///p' "$filename.manifest")
         fi
      fi
      assertStdoutGrep --matches=1 "^\(.*:\)\?fileid=$filehash:.*:name=$filename\$"
   done
}

assert_manifest_newer() {
   local manifest1="$1"
   local manifest2="$2"
   # The new manifest must have a higher version than the original.
   extract_manifest_version oldversion "$manifest1"
   extract_manifest_version newversion "$manifest2"
   assert [ $newversion -gt $oldversion ]
   # The new manifest must have a different filehash from the original.
   extract_manifest_filehash oldfilehash "$manifest1"
   extract_manifest_filehash newfilehash "$manifest2"
   assert [ $oldfilehash != $newfilehash ]
}

strip_signatures() {
   for file; do
      cat -v "$file" | sed -e '/^^@/,$d' >"tmp.$file" && mv -f "tmp.$file" "$file"
   done
}

extract_manifest_version() {
   local _var="$1"
   local _manifestfile="$2"
   local _version=$(sed -n -e '/^version=[0-9]\+$/s/^version=//p' "$_manifestfile")
   assert --message="$_manifestfile contains valid 'version=' line" [ -n "$_version" ]
   [ -n "$_var" ] && eval $_var=$_version
}

extract_manifest_filehash() {
   local _var="$1"
   local _manifestfile="$2"
   local _filehash=$(sed -n -e '/^filehash=[0-9a-fA-F]\+$/s/^filehash=//p' "$_manifestfile")
   assert --message="$_manifestfile contains valid 'filehash=' line" [ -n "$_filehash" ]
   eval $_var=$_filehash
}

doc_InitialEmptyList="Initial list is empty"
setup_InitialEmptyList() {
   setup_dna_rhizome
}
test_InitialEmptyList() {
   assert_rhizome_list
}

doc_AddNoManifest="Add with no manifest file"
setup_AddNoManifest() {
   setup_dna_rhizome
   assert_rhizome_list
   echo "A test file" >file1
   echo "Another test file" >file2
}
test_AddNoManifest() {
   executeOk $dna rhizome add file file1
}

doc_AddNonExistManifest="Add with non-existent manifest file"
setup_AddNonExistManifest() {
   setup_dna_rhizome
   assert_rhizome_list
   echo "A test file" >file1
   echo "Another test file" >file2
}
test_AddNonExistManifest() {
   assert --error-on-fail [ ! -e file1.manifest ]
   executeOk $dna rhizome add file file1 file1.manifest
   assert [ -r file1.manifest ]
   tfw_cat -v file1.manifest
   assertGrep file1.manifest '^name=file1$'
   assertGrep file1.manifest '^date=[0-9]\+$'
   assertGrep file1.manifest '^version=[0-9]\+$'
   assertGrep file1.manifest '^id=[0-9a-fA-F]\+$'
   assertGrep file1.manifest "^filesize=$(cat file1 | wc --bytes)\$"
   assertGrep file1.manifest "^first_byte=0$"
   assertGrep file1.manifest "^last_byte=$(cat file1 | wc --bytes)\$"
}

doc_AddManifest="Add with minimal manifest file"
setup_AddManifest() {
   setup_dna_rhizome
   assert_rhizome_list
   echo "A test file" >file1
   echo -e 'name=wah\ndate=12345' >file1.manifest
   echo "Another test file" >file2
}
test_AddManifest() {
   executeOk $dna rhizome add file file1 file1.manifest
   tfw_cat --stdout
   tfw_cat --stderr
   tfw_cat -v file1.manifest
   assertGrep file1.manifest '^name=wah$'
   assertGrep file1.manifest '^date=12345$'
   assertGrep file1.manifest '^version=[0-9]\+$'
   assertGrep file1.manifest '^id=[0-9a-fA-F]\+$'
   assertGrep file1.manifest "^filesize=$(cat file1 | wc --bytes)\$"
   assertGrep file1.manifest "^first_byte=0$"
   assertGrep file1.manifest "^last_byte=$(cat file1 | wc --bytes)\$"
}

doc_AddThenList="List contains one file after one add"
setup_AddThenList() {
   setup_dna_rhizome
   assert_rhizome_list
   echo "A test file" >file1
   echo "Another test file" >file2
}
test_AddThenList() {
   # Add first file
   executeOk $dna rhizome add file file1 file1.manifest
   assert_rhizome_list file1
   # Add second file
   executeOk $dna rhizome add file file2 file2.manifest
   assert_rhizome_list file1 file2
}

doc_AddDuplicate="Add same manifest detects duplicate"
setup_AddDuplicate() {
   setup_dna_rhizome
   assert_rhizome_list
   echo "A test file" >file1
   echo "Another test file" >file2
   echo "A test file, second version" >file1_2
   # Add first file
   executeOk $dna rhizome add file file1 file1.manifest
   # Add second file
   executeOk $dna rhizome add file file2 file2.manifest
   # Make sure they are both in the list.
   assert_rhizome_list file1 file2
}
test_AddDuplicate() {
   # Add first file again - nothing should change in its manifests, and it
   # should appear that the add command succeeded (with perhaps some grumbling
   # on stderr).
   execute --exit-status=2 $dna rhizome add file file1 file1.manifestA
   assert [ -s file1.manifestA ]
   assert_rhizome_list file1 file2
   strip_signatures file1.manifest file1.manifestA
   assert diff file1.manifest file1.manifestA
   # Repeat for second file.
   execute --exit-status=2 $dna rhizome add file file2 file2.manifestA
   assert [ -s file2.manifestA ]
   assert_rhizome_list file1 file2
   strip_signatures file2.manifest file2.manifestA
   assert diff file2.manifest file2.manifestA
}

doc_AddMismatched="Add mismatched manifest/payload fails"
setup_AddMismatched() {
   setup_AddDuplicate
}
test_AddMismatched() {
   # Try to add another file using an existing manifest, should fail and leave
   # the manifest file unchanged.
   cp file1.manifest file1_2.manifest
   execute $dna rhizome add file file1_2 file1_2.manifest
   assertExitStatus '!=' 0
   assert cmp file1.manifest file1_2.manifest
   # And rhizome store should be unchanged.
   assert_rhizome_list file1 file2
}

doc_AddUpdateSameVersion="Add new payload to existing manifest with same version"
setup_AddUpdateSameVersion() {
   setup_AddDuplicate
   cp file1.manifest file1_2.manifest
   strip_signatures file1_2.manifest
   sed -i -e '/^date=/d' -e '/^filehash=/d' -e '/^filesize=/d' file1_2.manifest
   assertGrep --matches=0 file1_2.manifest '^filehash='
   extract_manifest_version '' file1_2.manifest # asserts has version= line
   assertGrep file1_2.manifest '^id='
   cp file1_2.manifest file1_2.manifest.orig
}
test_AddUpdateSameVersion() {
   tfw_cat -v file1_2.manifest
   execute $dna rhizome add file file1_2 file1_2.manifest
   assertExitStatus --stderr '!=' 0
   tfw_cat -v file1_2.manifest
   assert cmp file1_2.manifest file1_2.manifest.orig
   # And rhizome store should be unchanged.
   assert_rhizome_list file1 file2
}

doc_AddUpdateNewVersion="Add new payload to existing manifest with new version"
setup_AddUpdateNewVersion() {
   setup_AddUpdateSameVersion
   extract_manifest_version version file1_2.manifest
   let version=version+1
   sed -i -e "/^version=/s/=.*/=$version/" file1_2.manifest
   assertGrep --matches=1 file1_2.manifest "^version=$version$"
}
test_AddUpdateNewVersion() {
   tfw_cat file1_2.manifest
   executeOk $dna rhizome add file file1_2 file1_2.manifest
   assert_manifest_newer file1.manifest file1_2.manifest
   # Rhizome store contents reflect new payload.
   mv -f file1_2.manifest file1.manifest
   assert_rhizome_list file1 file2
}

doc_AddUpdateAutoVersion="Add new payload to existing manifest with automatic version"
setup_AddUpdateAutoVersion() {
   setup_AddUpdateSameVersion
   sed -i -e '/^version=/d' file1_2.manifest
   assertGrep --matches=0 file1_2.manifest '^version='
}
test_AddUpdateAutoVersion() {
   tfw_cat file1_2.manifest
   sleep 0.001 # Ensure that at least one millisecond has elapsed
   executeOk $dna rhizome add file file1_2 file1_2.manifest
   assert_manifest_newer file1.manifest file1_2.manifest
   # Rhizome store contents reflect new payload.
   mv -f file1_2.manifest file1.manifest
   assert_rhizome_list file1 file2
}

runTests "$@"