repo_manager 0.7.1

data/examples/pc_saved_game_backup/repo_manager/tasks/remote.rb

@@ -0,0 +1,57 @@
+require 'fileutils'
+
+module RepoManager
+
+  class Generate < Thor
+
+    # full path to the remote folder
+    REMOTE = File.expand_path('remote')
+
+    # Create, add, and commit the contents of the current working directory and
+    # then push it to a predefined remote folder
+    #
+    # @example From the repo working
+    #
+    #   cd ~/my_repo_name
+    #   repo generate:remote my_repo_name
+    #
+    # @example Specify the path to the working folder
+    #
+    #   repo generate:remote my_repo_name --path=/path/to/my_repo_name
+
+    method_option :remote, :type => :string, :desc => "remote folder or git host, defaults to '#{REMOTE}'"
+    method_option :path, :type => :string, :desc => "path to working folder, defaults to CWD"
+
+    desc "remote REPO_NAME", "init a git repo in CWD and push to remote '#{REMOTE}'"
+    def remote(name)
+      path = options[:path] || FileUtils.pwd
+      remote = options[:remote] || "#{File.join(REMOTE, name + '.git')}"
+
+      Dir.chdir path do
+        run("git init")
+
+        # core config with windows in mind but works fine on POSIX
+        run("git config core.autocrlf false")
+        run("git config core.filemode false")
+        exit $?.exitstatus if ($?.exitstatus > 1)
+
+        # add everthing and commit
+        run("git add .")
+        run("git commit --message #{shell_quote('initial commit')}")
+        exit $?.exitstatus if ($?.exitstatus > 1)
+
+        # remove old origin first, if it exists
+        run("git remote add origin #{remote}")
+        run("git config branch.master.remote origin")
+        run("git config branch.master.merge refs/heads/master")
+        exit $?.exitstatus if ($?.exitstatus > 1)
+      end
+
+      run("git clone --bare #{shell_quote(path)} #{remote}")
+      exit $?.exitstatus if ($?.exitstatus > 1)
+
+      say "init done on '#{name}'", :green
+    end
+
+  end
+end

data/examples/pc_saved_game_backup/repo_manager/tasks/update.rb

@@ -0,0 +1,65 @@
+# @see features/tasks/action.feature
+module RepoManager
+  class Action < Thor
+    namespace :action
+    include Thor::Actions
+    include RepoManager::ThorHelper
+
+    class_option :force, :type => :boolean, :desc => "Force overwrite and answer 'yes' to any prompts"
+
+    method_option :repos, :type => :string, :desc => "Restrict update to comma delimited list of repo names", :banner => "repo1,repo2"
+    method_option :message, :type => :string, :desc => "Override 'automatic commit' message"
+    method_option 'no-push', :type => :boolean, :default => false, :desc => "Force overwrite of existing config file"
+
+    desc "update", "run repo add -A, repo commit, and repo push on all modified repos"
+    def update
+
+      initial_filter = options[:repos] ? "--repos=#{options[:repos]}" : ""
+      output = run("repo status --short --unmodified=HIDE --no-verbose --no-color #{initial_filter}", :capture => true)
+
+      case $?.exitstatus
+        when 0
+          say 'no changed repos', :green
+        else
+
+          unless output
+            say "failed to successfully run 'repo status'", :red
+            exit $?.exitstatus
+          end
+
+          repos = []
+          output = output.split("\n")
+          while line = output.shift
+            st,repo = line.split("\t")
+            repos << repo
+          end
+          filter = repos.join(',')
+
+          unless options[:force]
+            say "Repo(s) '#{filter}' have changed."
+            unless ask("Add, commit and push them? (y/n)") == 'y'
+              say "aborting"
+              exit 0
+            end
+          end
+
+          say "updating #{filter}"
+
+          run "repo add -A --no-verbose --repos #{filter}"
+          exit $?.exitstatus if ($?.exitstatus > 1)
+
+          commit_message = options[:message] || "automatic commit @ #{Time.now}"
+          run "repo commit --message=#{shell_quote(commit_message)} --no-verbose --repos #{filter}"
+          exit $?.exitstatus if ($?.exitstatus > 1)
+
+          unless options['no-push']
+            run "repo push --no-verbose --repos #{filter}"
+            exit $?.exitstatus if ($?.exitstatus > 1)
+          end
+
+          say "update finished", :green
+        end
+
+    end
+  end
+end

data/examples/pc_saved_game_backup/saved_games/hearts/save1

@@ -0,0 +1 @@
+# dummy save

data/examples/pc_saved_game_backup/saved_games/hearts/save2

@@ -0,0 +1 @@
+# dummy save

data/examples/pc_saved_game_backup/saved_games/mines/my_profile.ini

@@ -0,0 +1 @@
+# dummy profile data

data/examples/pc_saved_game_backup/saved_games/mines/saves/save1

@@ -0,0 +1 @@
+# dummy save

data/examples/pc_saved_game_backup/saved_games/mines/saves/save2

@@ -0,0 +1 @@
+# dummy save

data/features/actions/git.feature

@@ -0,0 +1,296 @@
+@announce
+Feature: Running an arbitrary git command
+
+  The application should run an arbitrary git command echoing output and
+  collecting status result codes.  RepoManager provides alternatives to some of the
+  git commands. For example, RepoManager has its own status command that provides
+  summary information.  To use the native command, you must place the arg 'git'
+  in front of the status command.
+
+  Example:
+
+   Run the native Git status command
+
+      repo git status -v
+
+   Run RepoManager version of the status command
+
+      repo status -v
+
+   Add and commit all
+
+      repo add .
+      repo commit -m "automatic add and commit"
+
+   Since there is no RepoManager version of the 'ls-files' command, these command
+   lines are equivalent:
+
+      repo git ls-files --others --ignored -v
+      repo ls-files --others --ignored -v
+
+   These command lines are also equivalent, note the alias for '--filter' is '--repos':
+
+      repo add . --filter=test
+      repo git add . --filter=test
+      repo git add . --repos=test
+
+    Git native commands do not allow any args that match exactly to a repo name
+    unless a filter is specified or args=0.  Example, if 'screenshots' is a
+    repo name:
+
+        repo push # OK
+        repo push screenshots # error
+        repo git push screenshots # error
+        repo push -r screenshots # OK
+        repo git push -r screenshots # OK
+
+    Short formatted log information
+
+      repo git log -1 --pretty=format:"%h committed %cr"
+
+  Background: A valid config file
+    Given a file named "repo.conf" with:
+      """
+      ---
+      folders:
+        assets : repo_assets
+      commands:
+      - diff
+      - grep
+      - log
+      - ls-files
+      - show
+      - status
+      - add
+      - commit
+      """
+    And a repo in folder "test_path_1" with the following:
+      | filename         | status | content  |
+      | .gitignore       | C      |          |
+    And a repo in folder "test_path_2" with the following:
+      | filename         | status | content  |
+      | .gitignore       | C      |          |
+    And the folder "repo_assets" with the following asset configurations:
+      | name       | path          |
+      | test1      | test_path_1   |
+      | test2      | test_path_2   |
+
+  Scenario: Missing all run arguments
+    When I run `repo git`
+    Then the exit status should be 1
+    And the output should contain:
+      """
+      no git command given
+      """
+
+  Scenario: Run 'git ls-files' on each repo
+    When I run `repo git ls-files`
+    Then the exit status should be 0
+    And the output should contain:
+      """
+      test1
+      .gitignore
+      test2
+      .gitignore
+      """
+
+  Scenario: Run 'ls-files' on each repo, 'git' is an optional first argument
+    When I run `repo ls-files`
+    Then the exit status should be 0
+    And the output should contain:
+      """
+      test1
+      .gitignore
+      test2
+      .gitignore
+      """
+
+  Scenario: Run 'ls-files' on each repo using a filter
+    When I run `repo --verbose ls-files --repos=test1`
+    Then the exit status should be 0
+    And the output should contain:
+      """
+      test1
+      .gitignore
+      """
+    And the output should not contain:
+      """
+      test2
+      .gitignore
+      """
+
+  Scenario: Run 'ls-files' using a repo name as an argument with no filter
+    supplied (failure)
+    When I run `repo  ls-files test1`
+    Then the exit status should be 1
+    And the output should contain:
+      """
+      'test1' cannot be used as a filter
+      """
+
+  Scenario: Run 'git ls-files' using a repo name as an argument with no filter
+    supplied (failure)
+    When I run `repo git ls-files test1`
+    Then the exit status should be 1
+    And the output should contain:
+      """
+      'test1' cannot be used as a filter
+      """
+
+  Scenario: Run 'git ls-files' using argument that is not a repo name with no
+    filter supplied (success)
+    When I run `repo git ls-files .gitignore`
+    Then the exit status should be 0
+
+  Scenario: Run 'git status' on each repo with no changes
+    When I run `repo git status`
+    Then the exit status should be 0
+    And the output should contain:
+      """
+      test1
+      # On branch master
+      nothing to commit (working directory clean)
+      test2
+      # On branch master
+      nothing to commit (working directory clean)
+      """
+
+  Scenario: Run 'git status --porcelain' on each repo with no changes shows nothing on stdout
+    When I run `repo git status --porcelain`
+    Then the exit status should be 0
+    And the output should not contain:
+      """
+      test1: test_path_1
+      """
+    And the output should not contain:
+      """
+      test2: test_path_2
+      """
+
+  Scenario: Run native 'git status' on each repo with uncommited change
+    Given a repo in folder "test_path_1" with the following:
+      | filename         | status | content  |
+      | .gitignore       | M      | tmp/*    |
+    When I run `repo --verbose git status --porcelain`
+    Then the exit status should be 0
+    And the output should contain:
+      """
+      test1
+       M .gitignore
+      """
+
+  Scenario: Run native git status command on an invalid repo
+    Given the folder "repo_assets" with the following asset configurations:
+      | name       | path          |
+      | test1      | test_path_1   |
+      | test2      | test_path_2   |
+      | bad_repo   | not_a_repo    |
+    And a directory named "not_a_repo"
+    When I run `repo git status --porcelain --repos=test1,test2,bad_repo`
+    Then the exit status should be 128
+    And the output should contain:
+      """
+      bad_repo
+      fatal: Not a git repository
+      """
+
+  Scenario: Run RepoManager status command on an invalid repo
+    Given the folder "repo_assets" with the following asset configurations:
+      | name       | path          |
+      | test1      | test_path_1   |
+      | test2      | test_path_2   |
+      | bad_repo   | not_a_repo    |
+    And a directory named "not_a_repo"
+    When I run `repo status --repos=test1,bad_repo --unmodified=SHOW --no-verbose`
+    Then the exit status should be 2
+    And the normalized output should contain:
+      """
+      I       bad_repo: ./not_a_repo [not a valid repo]
+              test1
+      """
+
+  Scenario: Native and repo_manager status command missing repo folder has different
+    exit status values
+    Given the folder "repo_assets" with the following asset configurations:
+      | name       | path          |
+      | bad_repo   | bad_repo_path |
+    When I run `repo git status --filter=bad_repo --unmodified DOTS --no-verbose`
+    Then the exit status should be 0
+    And the output should contain exactly:
+      """
+      bad_repo: ./bad_repo_path [no such path]
+
+      """
+    When I run `repo status --filter=bad_repo --unmodified DOTS --no-verbose`
+    Then the exit status should be 1
+
+  Scenario: Folders with spaces in path
+    Given a file named "repo1.conf" with:
+      """
+      ---
+      folders:
+        assets : assets1
+      """
+    And a repo in folder "test 1/test path 1" with the following:
+      | filename         | status | content   |
+      | testfile 1.txt   | CM     | something |
+    And the folder "assets1" with the following asset configurations:
+      | name       | path                 |
+      | test1      | test 1/test path 1   |
+      | test2      | test_path_2          |
+    When I run `repo git ls-files --config=repo1.conf`
+    Then the exit status should be 0
+    And the output should contain:
+      """
+      test1
+      testfile 1.txt
+      test2
+      .gitignore
+      """
+
+  Scenario: Git 'add' on a repo with uncommited change
+    Given a repo in folder "test_path_1" with the following:
+      | filename         | status | content  |
+      | .gitignore       | M      | tmp/*    |
+    When I run `repo add . --repo test1`
+    Then the exit status should be 0
+    And the output should not contain:
+      """
+      test1: test_path_1
+      """
+
+  Scenario: Git 'commit' on a repo with an added file
+    Given a repo in folder "test_path_1" with the following:
+      | filename         | status | content  |
+      | new_stuff.txt    | A      | tmp/*    |
+    When I run `repo commit -m 'automatic commit via repo_manager' --repos test1`
+    Then the exit status should be 0
+    And the output should contain:
+      """
+       1 files changed, 1 insertions(+), 0 deletions(-)
+      """
+
+  Scenario: Running a git command that is not whitelisted
+    Given a file named "repo.conf" with:
+      """
+      ---
+      folders:
+        assets : repo_assets
+      commands:
+      - diff
+      - grep
+      - log
+      """
+    And a repo in folder "test_path_1" with the following:
+      | filename         | status | content  |
+      | new_stuff.txt    | A      | tmp/*    |
+    When I run `repo commit -m 'automatic commit via repo_manager' --repos test1`
+    Then the exit status should be 1
+    And the output should not contain:
+      """
+       1 files changed, 1 insertions(+), 0 deletions(-)
+      """
+    And the output should contain:
+      """
+      repo failed: git command 'commit' is not enabled
+      """

data/features/actions/help.feature

@@ -0,0 +1,53 @@
+Feature: Show help on actions
+
+  Show action specific help to STDOUT for a given action
+
+  Example usage:
+
+      repo help list
+      repo help task
+      repo help help
+
+  Notes
+
+  * abbreviated help general app help is available via the --help option
+
+ Background: Empty configuration file so that we don't read global config locations
+   Given an empty file named "repo.conf"
+
+ Scenario Outline: Valid action, help available
+    When I run `repo help <action>`
+    Then the exit status should be 0
+    And its output should match:
+      """
+      Usage: repo.* <action>
+      """
+    And its output should match:
+      """
+      Options:
+      """
+
+  Examples:
+    | action  |
+    | help    |
+    | list    |
+    | task    |
+    | git     |
+    | path    |
+    | status  |
+
+  Scenario: Missing action
+    When I run `repo help`
+    Then the exit status should be 0
+    And the output should contain:
+      """
+      no action specified
+      """
+
+  Scenario: Invalid action
+    When I run `repo help badaction`
+    Then the exit status should be 0
+    And the output should contain:
+      """
+      invalid help action
+      """