From 7852c2e999d15262aef744eeef4f52ed4cdc4334 Mon Sep 17 00:00:00 2001 From: Ben Brown Date: Tue, 17 Dec 2013 17:31:07 +0000 Subject: Add newlines to increase readability --- yarns/create-deploy.yarn | 59 ++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 59 insertions(+) diff --git a/yarns/create-deploy.yarn b/yarns/create-deploy.yarn index f63c6ef..6b15eef 100644 --- a/yarns/create-deploy.yarn +++ b/yarns/create-deploy.yarn @@ -5,12 +5,14 @@ The following scenarios test tbdiff-deploy's ability to correctly transform the content of a target directory, to that of a source directory, given an appropriate binary delta created by tbdiff-create. + Changing of a file's contents ----------------------------- The simple tests that follow check that file contents is as expected; if the contents of the given files are different, the test will fail. + SCENARIO Changing the contents of a regular file works GIVEN a directory called 'A_dir' AND a regular file called 'foo_file' containing '1' in directory 'A_dir' @@ -20,6 +22,7 @@ contents of the given files are different, the test will fail. AND tbdiff-deploy applies the delta 'AB.tbdiff' to 'A_dir' THEN the files 'A_dir/foo_file' and 'B_dir/foo_file' have the same contents + SCENARIO Changing the contents of a directory works GIVEN a directory called 'A_dir' AND a directory called '1_dir' in directory 'A_dir' @@ -31,12 +34,14 @@ contents of the given files are different, the test will fail. AND tbdiff-deploy applies the delta 'AB.tbdiff' to 'A_dir' THEN the directories 'A_dir/1_dir' and 'B_dir/1_dir' have the same contents + Changing of a file's ownership ------------------------------ Trebuchet also takes into account POSIX metadata such as ownership, these scenarios are written to test that functionality. + SCENARIO Changing the group that owns a regular file works GIVEN a directory called 'A_dir' AND a regular file called 'foo_file' in directory 'A_dir' @@ -47,6 +52,7 @@ scenarios are written to test that functionality. AND tbdiff-deploy applies the delta 'AB.tbdiff' to 'A_dir' THEN the file 'A_dir/foo_file' is owned by the group '893' + SCENARIO Changing the group that owns a named pipe works GIVEN a directory called 'A_dir' AND a named pipe called 'foo_pipe' in directory 'A_dir' @@ -57,6 +63,7 @@ scenarios are written to test that functionality. AND tbdiff-deploy applies the delta 'AB.tbdiff' to 'A_dir' THEN the named pipe 'A_dir/foo_pipe' is owned by the group '594' + SCENARIO Changing the group that owns a symbolic link works GIVEN a directory called 'A_dir' AND a regular file called 'foo_file' in directory 'A_dir' @@ -69,6 +76,7 @@ scenarios are written to test that functionality. AND tbdiff-deploy applies the delta 'AB.tbdiff' to 'A_dir' THEN the symbolic link 'A_dir/link_to_foo_file' is owned by the group '608' + SCENARIO Changing the group that owns a directory works GIVEN a directory called 'A_dir' AND a directory called '1_dir' in directory 'A_dir' @@ -79,12 +87,14 @@ scenarios are written to test that functionality. AND tbdiff-deploy applies the delta 'AB.tbdiff' to 'A_dir' THEN the directory 'A_dir/1_dir' is owned by the group '675' + Changing of a file's permissions -------------------------------- These scenarios test that file permissions are correctly changed upon the deployment of a binary delta. + SCENARIO Changing the permissions of a regular file works GIVEN a directory called 'A_dir' AND a regular file called 'foo_file' in directory 'A_dir' @@ -95,6 +105,7 @@ deployment of a binary delta. AND tbdiff-deploy applies the delta 'AB.tbdiff' to 'A_dir' THEN the file 'A_dir/foo_file' has the permissions '-rw-rw-rw-' + SCENARIO Changing the permissions of a named pipe works GIVEN a directory called 'A_dir' AND a named pipe called 'foo_pipe' in directory 'A_dir' @@ -105,6 +116,7 @@ deployment of a binary delta. AND tbdiff-deploy applies the delta 'AB.tbdiff' to 'A_dir' THEN the named pipe 'A_dir/foo_pipe' has the permissions 'prw-rw-r--' + SCENARIO Changing the permissions of a directory works GIVEN a directory called 'A_dir' AND a directory called '1_dir' in directory 'A_dir' @@ -115,12 +127,14 @@ deployment of a binary delta. AND tbdiff-deploy applies the delta 'AB.tbdiff' to 'A_dir' THEN the directory 'A_dir/1_dir' has the permissions 'drwx---rwx' + Adding and removing of files ---------------------------- The following scenarios check that the deployment of a binary delta successfully removes and creates the appropriate files. + SCENARIO Adding and removing of regular files works GIVEN a directory called 'A_dir' AND a regular file called 'minus_file' in directory 'A_dir' @@ -131,6 +145,7 @@ successfully removes and creates the appropriate files. THEN the file 'A_dir/minus_file' no longer exists AND the directory 'A_dir' contains the regular file 'plus_file' + SCENARIO Adding and removing of named pipes works GIVEN a directory called 'A_dir' AND a named pipe called 'minus_pipe' in directory 'A_dir' @@ -141,6 +156,7 @@ successfully removes and creates the appropriate files. THEN the named pipe 'A_dir/minus_pipe' no longer exists AND the directory 'A_dir' contains the named pipe 'plus_pipe' + SCENARIO Adding and removing of symbolic links works GIVEN a directory called 'A_dir' AND a regular file called 'minus_file' in directory 'A_dir' @@ -153,6 +169,7 @@ successfully removes and creates the appropriate files. THEN the symbolic link 'A_dir/link_to_minus_file' no longer exists AND the directory 'A_dir' contains the symbolic link 'link_to_plus_file' + SCENARIO Adding and removing of directories works GIVEN a directory called 'A_dir' AND a directory called 'minus_dir' in directory 'A_dir' @@ -163,6 +180,7 @@ successfully removes and creates the appropriate files. THEN the directory 'A_dir/minus_dir' no longer exists AND the directory 'A_dir' contains the directory 'plus_dir' + SCENARIO Adding and removing of character devices works GIVEN a directory called 'A_dir' AND a character device called 'minus_chardev' with major number '1' and minor number '3' in directory 'A_dir' @@ -173,6 +191,7 @@ successfully removes and creates the appropriate files. THEN the character device 'A_dir/minus_chardev' no longer exists AND the directory 'A_dir' contains the character device 'plus_chardev' + SCENARIO Adding and removing of block devices works GIVEN a directory called 'A_dir' AND a block device called 'minus_blockdev' with major number '1' and minor number '3' in directory 'A_dir' @@ -183,12 +202,14 @@ successfully removes and creates the appropriate files. THEN the block device 'A_dir/minus_blockdev' no longer exists AND the directory 'A_dir' contains the block device 'plus_blockdev' + Changing modification time of a file ------------------------------------ In the following scenarios we check that modification times are correctly changed, if modification times are not identical, the test fails. + SCENARIO Changing the modification time of a regular file works GIVEN a directory called 'A_dir' AND a regular file called 'foo_file' containing '1' in directory 'A_dir' @@ -200,6 +221,7 @@ changed, if modification times are not identical, the test fails. AND tbdiff-deploy applies the delta 'AB.tbdiff' to 'A_dir' THEN the files 'A_dir/foo_file' and 'B_dir/foo_file' have the same modification time + SCENARIO Changing the modification time of a named pipe works GIVEN a directory called 'A_dir' AND a named pipe called 'foo_pipe' in directory 'A_dir' @@ -211,6 +233,7 @@ changed, if modification times are not identical, the test fails. AND tbdiff-deploy applies the delta 'AB.tbdiff' to 'A_dir' THEN the named pipes 'A_dir/foo_pipe' and 'B_dir/foo_pipe' have the same modification time + SCENARIO Changing the modification time of a symbolic link works GIVEN a directory called 'A_dir' AND a regular file called 'foo_file' in directory 'A_dir' @@ -224,6 +247,7 @@ changed, if modification times are not identical, the test fails. AND tbdiff-deploy applies the delta 'AB.tbdiff' to 'A_dir' THEN the symbolic links 'A_dir/link_to_foo_file' and 'B_dir/link_to_foo_file' have the same modification time + SCENARIO Changing the modification time of a directory works GIVEN a directory called 'A_dir' AND a directory called '1_dir' in directory 'A_dir' @@ -235,11 +259,13 @@ changed, if modification times are not identical, the test fails. AND tbdiff-deploy applies the delta 'AB.tbdiff' to 'A_dir' THEN the directories 'A_dir/1_dir' and 'B_dir/1_dir' have the same modification time + Changing what a symbolic link refers to --------------------------------------- Here we check that referenced files of symbolic links are correctly transformed. + SCENARIO Changing what a symbolic link refers to works GIVEN a directory called 'A_dir' AND a regular file called 'foo_file' in directory 'A_dir' @@ -251,12 +277,14 @@ Here we check that referenced files of symbolic links are correctly transformed. AND tbdiff-deploy applies the delta 'AB.tbdiff' to 'A_dir' THEN the symbolic links 'A_dir/link_to_foo_file' and 'B_dir/link_to_foo_file' refer to the same thing + Setting special file permissions for directories ------------------------------------------------ This scenario checks that the sticky bit of a directory has been changed appropriately upon the deployment of a binary delta. + SCENARIO Setting the sticky bit of a directory works GIVEN a directory called 'A_dir' AND a directory called '1_dir' in directory 'A_dir' @@ -267,8 +295,10 @@ appropriately upon the deployment of a binary delta. AND tbdiff-deploy applies the delta 'AB.tbdiff' to 'A_dir' THEN the directory 'A_dir/1_dir' has its sticky bit set + And this scenario checks that the setgid bit of a directory is set accordingly. + SCENARIO Setting the setgid bit of a directory works GIVEN a directory called 'A_dir' AND a directory called '1_dir' in directory 'A_dir' @@ -279,12 +309,14 @@ And this scenario checks that the setgid bit of a directory is set accordingly. AND tbdiff-deploy applies the delta 'AB.tbdiff' to 'A_dir' THEN the directory 'A_dir/1_dir' has its setgid bit set + Changing the device numbers of special files -------------------------------------------- These scenarios check that the minor and major device numbers of special files are appropriately changed when a patch has been generated and deployed. + SCENARIO Changing a character special file's device numbers works GIVEN a directory called 'A_dir' AND a character device called 'foo_chardev' with major number '3' and minor number '9' in directory 'A_dir' @@ -294,6 +326,7 @@ are appropriately changed when a patch has been generated and deployed. AND tbdiff-deploy applies the delta 'AB.tbdiff' to 'A_dir' THEN the character devices 'A_dir/foo_chardev' and 'B_dir/foo_chardev' have the same device numbers + SCENARIO Changing a block special file's device numbers works GIVEN a directory called 'A_dir' AND a block device called 'foo_blockdev' with major number '2' and minor number '7' in directory 'A_dir' @@ -303,6 +336,7 @@ are appropriately changed when a patch has been generated and deployed. AND tbdiff-deploy applies the delta 'AB.tbdiff' to 'A_dir' THEN the block devices 'A_dir/foo_blockdev' and 'B_dir/foo_blockdev' have the same device numbers + Changing, adding and removing of sockets ---------------------------------------- @@ -310,6 +344,7 @@ Sockets can only be moved, linked or removed by the file system, creation is only performed by the program that acts as the server, tbdiff won't be doing that so the only sensible operation is removal. + SCENARIO Removing of a socket works GIVEN a directory called 'A_dir' AND a socket called 'minus_socket' in directory 'A_dir' @@ -318,6 +353,7 @@ that so the only sensible operation is removal. AND tbdiff-deploy applies the delta 'AB.tbdiff' to 'A_dir' THEN the socket 'A_dir/minus_socket' no longer exists + SCENARIO Creation of a socket doesn't work GIVEN a directory called 'A_dir' AND a directory called 'B_dir' @@ -325,6 +361,7 @@ that so the only sensible operation is removal. WHEN tbdiff-create attempts to create a binary delta between directories 'A_dir' and 'B_dir', called 'AB.tbdiff' THEN stderr contains "tbdiff-create cannot create sockets" + SCENARIO Changing a socket doesn't work GIVEN a directory called 'A_dir' AND a socket called 'foo_socket' in directory 'A_dir' @@ -339,6 +376,7 @@ IMPLEMENTS Implementations for the creating and deploying of binary deltas --------------------------------------------------------------- + IMPLEMENTS GIVEN a regular file called '([^']+)' containing '([^']+)'(?: in directory '([^']+)')? [ -n "$MATCH_3" ] && mkdir -p "$DATADIR/$MATCH_3" echo "$MATCH_2" > "$DATADIR/$MATCH_3/$MATCH_1" @@ -347,31 +385,39 @@ Implementations for the creating and deploying of binary deltas [ -n "$MATCH_2" ] && mkdir -p "$DATADIR/$MATCH_2" touch "$DATADIR/$MATCH_2/$MATCH_1" + IMPLEMENTS GIVEN the (?:file|directory|named pipe|symbolic link) '([^']+)' is owned by the group '([^']+)' chgrp -h "$MATCH_2" "$DATADIR/$MATCH_1" + IMPLEMENTS GIVEN the (?:file|directory|named pipe) '([^']+)' has its permissions set to '([^']+)' chmod "$MATCH_2" "$DATADIR/$MATCH_1" + IMPLEMENTS GIVEN the (?:file|directory|named pipe|symbolic link) '([^']+)' has its modification time set to '([^']+)' "$SRCDIR/symtime" "$DATADIR/$MATCH_1" "$MATCH_2" + IMPLEMENTS GIVEN a named pipe called '([^']+)'(?: in directory '([^']+)')? [ -n "$MATCH_2" ] && mkdir -p "$DATADIR/$MATCH_2" mkfifo "$DATADIR/$MATCH_2/$MATCH_1" + IMPLEMENTS GIVEN a symbolic link called '([^']+)' referring to '([^']+)'(?: in directory '([^']+)')? [ -n "$MATCH_3" ] && mkdir -p "$DATADIR/$MATCH_3" ln -s "$DATADIR/$MATCH_2" "$DATADIR/$MATCH_3/$MATCH_1" + IMPLEMENTS GIVEN a directory called '([^']+)'(?: in directory '([^']+)')? [ -n "$MATCH_2" ] && mkdir -p "$DATADIR/$MATCH_2" mkdir "$DATADIR/$MATCH_2/$MATCH_1" + IMPLEMENTS GIVEN a (character|block) device called '([^']+)' with major number '([0-9]+)' and minor number '([0-9]+)'(?: in directory '([^']+)')? [ -n "$MATCH_5" ] && mkdir -p "$DATADIR/$MATCH_5" mknod "$DATADIR/$MATCH_5/$MATCH_2" "$(echo "$MATCH_1" | head -c 1)" "$MATCH_3" "$MATCH_4" + IMPLEMENTS GIVEN a socket called '([^']+)'(?: in directory '([^']+)')? [ -n "$MATCH_2" ] && mkdir -p "$DATADIR/$MATCH_2" "$SRCDIR/sockbind" "$DATADIR/$MATCH_2/$MATCH_1" @@ -383,42 +429,55 @@ Implementations for the creating and deploying of binary deltas set +e; "$@" 2> "$DATADIR/stderr"; set -e fi + IMPLEMENTS WHEN tbdiff-deploy applies the delta '([^']+)' to '([^']+)' cd "$DATADIR/$MATCH_2" "$SRCDIR/tbdiff-deploy/tbdiff-deploy" "$DATADIR/$MATCH_1" + IMPLEMENTS THEN the (?:files|directories) '([^']+)' and '([^']+)' have the same contents diff "$DATADIR/$MATCH_1" "$DATADIR/$MATCH_2" + IMPLEMENTS THEN the (?:file|directory|named pipe|symbolic link) '([^']+)' is owned by the group '([^']+)' test "$(stat -c %g "$DATADIR/$MATCH_1")" = "$MATCH_2" + IMPLEMENTS THEN the (?:file|directory|named pipe) '([^']+)' has the permissions '([^']+)' test "$(stat -c %A "$DATADIR/$MATCH_1")" = "$MATCH_2" + IMPLEMENTS THEN the (?:file|directory|named pipe|symbolic link|(?:character|block) device|socket) '([^']+)' no longer exists test ! -e "$DATADIR/$MATCH_1" + IMPLEMENTS THEN the (?:files|directories|named pipes|symbolic links) '([^']+)' and '([^']+)' have the same modification time test "$(stat -c %y "$DATADIR/$MATCH_1")" = "$(stat -c %y "$DATADIR/$MATCH_2")" + IMPLEMENTS THEN the directory '([^']+)' contains the symbolic link '([^']+)' test -h "$DATADIR/$MATCH_1/$MATCH_2" + IMPLEMENTS THEN the symbolic links '([^']+)' and '([^']+)' refer to the same thing test "$(readlink "$DATADIR/$MATCH_1")" = "$(readlink "$DATADIR/$MATCH_2")" + IMPLEMENTS THEN the directory '([^']+)' has its sticky bit set test -k "$DATADIR/$MATCH_1" + IMPLEMENTS THEN the directory '([^']+)' has its setgid bit set test -g "$DATADIR/$MATCH_1" + IMPLEMENTS THEN the directory '([^']+)' contains the ((?:character|block) device|named pipe|directory|regular file) '([^']+)' test -"$(echo "$MATCH_2" | sed -r 's/(named|regular) //' | head -c 1)" "$DATADIR/$MATCH_1/$MATCH_3" + IMPLEMENTS THEN the (?:block|character) devices '([^']+)' and '([^']+)' have the same device numbers test "$(stat -c '%t %T' "$DATADIR/$MATCH_1")" = "$(stat -c '%t %T' "$DATADIR/$MATCH_2")" + IMPLEMENTS THEN (\S+) contains "([^"]+)" grep "$MATCH_2" "$DATADIR/$MATCH_1" -- cgit v1.2.1