repo_manager 0.7.1

data/features/actions/path.feature

@@ -0,0 +1,195 @@
+@announce
+Feature: Listing repo path information
+
+  Show the repository path defined in the config file to stdout so that it can
+  be used for scripting.
+
+  The 'path' action is an alias for the 'list' action with the 'list=path' option
+
+  Example: chdir to the path of the repo named "my_repo_name"
+
+      cd $(repo path my_repo_name)
+      cd $(repo path my_repo_name)
+
+  Example: chdir to the path of the repo named "my_repo_name"
+
+      cd $(repo path --filter=my_repo_name)
+
+  Example: chdir to the path of the repo named "my_repo_name" using a Bash
+           function. This handles repo paths that contain spaces.
+
+    vim ~/.bashrc
+
+        function rcd(){ cd "$(repo --match=ONE --no-color path $@)"; }
+
+    usage:
+
+        rcd my_repo_n
+
+  Example: repo versions of Bash's pushd and popd
+
+    vim ~/.bashrc
+
+        function rpushd(){ pushd "$(repo path --match=ONE --no-color $@)"; }
+        alias rpopd="popd"
+
+    usage:
+
+        rpushd my
+
+
+  Example: enable bash repo name completion for the repo, rcd, and rpushd commands
+
+    vim ~/.bashrc
+
+        function _repo_names()
+        {
+          local cur opts
+          COMPREPLY=()
+          cur="${COMP_WORDS[COMP_CWORD]}"
+          opts=`repo list --list=name --no-color`
+
+          COMPREPLY=( $(compgen -W "${opts}" -- ${cur}) )
+          return 0
+        }
+        complete -F _repo_names rcd rpushd repo
+
+
+  Background: A valid config file
+    Given a file named ".repo_manager/repo.conf" with:
+      """
+      ---
+      folders:
+        assets : app_assets
+      """
+    And the folder ".repo_manager/app_assets" with the following asset configurations:
+      | name       | path          |
+      | test1      | test_path_1   |
+      | test2      | test_path_2   |
+
+  Scenario: Show path using 'path' as alias for 'list --list=path'
+    When I run `repo path`
+    Then the exit status should be 0
+    And the output should match:
+      """
+      .+/test_path_1$
+      .+/test_path_2$
+      """
+
+  Scenario: Show path using list action directly
+    When I run `repo list --list=path`
+    Then the exit status should be 0
+    And the output should match:
+      """
+      .+/test_path_1$
+      .+/test_path_2$
+      """
+
+  Scenario: Show path only using liberal regex filter
+    When I run `repo list --list=path --filter=test --no-verbose`
+    Then the exit status should be 0
+    And the output should match:
+      """
+      .+/test_path_1$
+      .+/test_path_2$
+      """
+
+  Scenario: Show path only using with restrictive regex filter
+    When I run `repo list --list=path --filter=test$ --no-verbose`
+    Then the exit status should be 0
+    And the output should not contain:
+      """
+      test_path_1
+      """
+
+  Scenario: Show path only using an exact string filter '--match mode=EXACT'
+    When I run `repo list --list=path --filter=test --no-verbose --match=EXACT`
+    Then the exit status should be 0
+    And the output should not contain:
+      """
+      test_path_1
+      """
+    When I run `repo list --list=path --filter=t.st --no-verbose --match=EXACT`
+    Then the exit status should be 0
+    And the output should not contain:
+      """
+      test_path_1
+      """
+    When I run `repo list --list=path --filter=est1 --no-verbose --match=EXACT`
+    Then the exit status should be 0
+    And the output should not contain:
+      """
+      test_path_1
+      """
+    When I run `repo list --list=path --filter=test1 --no-verbose --match=EXACT`
+    Then the exit status should be 0
+    And the output should match:
+      """
+      .+/test_path_1$
+      """
+
+  Scenario: Show path only using with character placeholder regex filter
+    When I run `repo list --list=path --filter=t.st1 --no-verbose`
+    Then the exit status should be 0
+    And the output should match:
+      """
+      .+/test_path_1$
+      """
+    And the output should not contain:
+      """
+      test_path_2
+      """
+
+  Scenario: Show path only using --match mode=ALL
+    When I run `repo list --list=path --filter=test --match ALL`
+    Then the exit status should be 0
+    And the output should match:
+      """
+      .+/test_path_1$
+      .+/test_path_2$
+      """
+
+  Scenario: Show path only using --match mode=FIRST
+    When I run `repo list --list=path --filter=test --match=FIRST --no-verbose`
+    Then the exit status should be 0
+    And the output should match:
+      """
+      .+/test_path_1$
+      """
+    And the output should not contain:
+      """
+      test_path_2
+      """
+
+  Scenario: Show path only using --match mode=ONE
+    When I run `repo list --list=path --filter=test --match=ONE`
+    Then the exit status should be 1
+
+  Scenario: Show path only using multiple delimited filters. Regex allowed on
+    each filter separately. Switch style: --filter
+    When I run `repo list --list=path --filter=test1,t...2,t...3`
+    Then the exit status should be 0
+    And the output should match:
+      """
+      .+/test_path_1$
+      .+/test_path_2$
+      """
+
+  Scenario: Show path only using multiple delimited filters. Regex allowed on
+    each filter separately. Switch style: --repos
+    When I run `repo list --list=path --repos=test1,t...2,t...3`
+    Then the exit status should be 0
+    And the output should match:
+      """
+      .+/test_path_1$
+      .+/test_path_2$
+      """
+
+  Scenario: Show path only using multiple args instead of filter switch
+    When I run `repo list --list=path test1 t...2 t...3`
+    Then the exit status should be 0
+    And the output should match:
+      """
+      .+/test_path_1$
+      .+/test_path_2$
+      """

data/features/actions/status.feature

@@ -0,0 +1,261 @@
+@announce
+Feature: Listing repo path information
+
+  Show the repository status to stdout
+
+  Example usage:
+
+    repo status
+    repo status --short
+    repo status repo1 --unmodified DOTS
+    repo status repo1 repo2 --unmodified DOTS
+
+  Equivalent filtering:
+
+    repo status --filter=test2 --unmodified DOTS
+    repo status test2 --unmodified DOTS"
+
+  Background: A valid config file
+    Given a file named "repo_manager/repo.conf" with:
+      """
+      ---
+      options:
+        color   : AUTO
+      folders:
+        assets  : assets
+      """
+    And the folder "repo_manager/assets" with the following asset configurations:
+      | name    | path         |
+      | test1   | test_path_1  |
+      | test2   | test_path_2  |
+    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      |          |
+
+
+  Scenario: No uncommitted changes, default output
+    When I run `repo status`
+    Then the exit status should be 0
+    And its output should contain:
+      """
+      no modified repositories, all working folders are clean
+      """
+
+  Scenario: No repos configured or no repos match filter
+    When I run `repo status --filter=garbage`
+    Then the exit status should be 0
+    And its output should contain:
+      """
+      no repositories found
+      """
+    And its output should not contain:
+      """
+      no modified repositories, all working folders are clean
+      """
+
+  Scenario: No uncommitted changes, using dots to show progress, one dot per file
+    When I run `repo status --unmodified=DOTS`
+    Then its output should contain:
+      """
+      ..
+      no modified repositories, all working folders are clean
+      """
+    When I run `repo status`
+    Then its output should contain:
+      """
+      no modified repositories, all working folders are clean
+      """
+    And its output should not contain:
+      """
+      ..
+      """
+
+  Scenario: Uncommittable changes don't show
+    Given a repo in folder "test_path_1" with the following:
+      | filename         | status | content  |
+      | test_file3.txt   | C      | hi file3 |
+    When I run `touch test_path_1/test_file3.txt`
+    And I run `repo status`
+    Then the exit status should be 0
+    Then the output should contain:
+      """
+      no modified repositories, all working folders are clean
+      """
+
+  Scenario: Invalid repo
+    Given the folder "repo_manager/assets" with the following asset configurations:
+      | name    | path         |
+      | bad_repo| not_a_repo   |
+    And a directory named "not_a_repo"
+    When I run `repo status test1 test2 bad_repo --unmodified DOTS --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]
+      """
+    And the normalized output should not contain:
+      """
+      I       bad_repo: ./not_a_repo [not a valid repo]
+      I       bad_repo: ./not_a_repo [not a valid repo]
+      """
+
+  Scenario: Missing repo folder
+    Given the folder "repo_manager/assets" with the following asset configurations:
+      | name    | path         |
+      | bad_repo| not_a_repo   |
+    When I run `repo status --filter=bad_repo --unmodified DOTS --no-verbose`
+    Then the exit status should be 1
+    And the normalized output should contain:
+      """
+      X       bad_repo: ./not_a_repo [no such path]
+      """
+    And the normalized output should not contain:
+      """
+      X       bad_repo: ./not_a_repo [no such path]
+      X       bad_repo: ./not_a_repo [no such path]
+      """
+
+  Scenario: One uncommitted change
+    Given a repo in folder "test_path_1" with the following:
+      | filename         | status | content  |
+      | .gitignore       | M      | tmp/*    |
+    When I run `repo status`
+    Then the exit status should be 4
+    And the normalized output should contain:
+      """
+      M       test1
+                modified: .gitignore
+      """
+
+  Scenario: One uncommitted change, don't show individual files
+    Given a repo in folder "test_path_1" with the following:
+      | filename         | status | content  |
+      | .gitignore       | M      | tmp/*    |
+    When I run `repo status --short --unmodified=DOTS`
+    And the normalized output should contain:
+      """
+      M       test1
+      .
+      """
+
+  Scenario: One new file added
+    Given a repo in folder "test_path_2" with the following:
+      | filename      | status | content          |
+      | new_file2.txt | A      | hello new file2  |
+    When I run `repo status --unmodified=DOTS`
+    Then the exit status should be 8
+    And the normalized output should contain:
+      """
+      .
+        A     test2
+                added: new_file2.txt
+      """
+    And the output should not contain:
+      """
+      no modified repositories, all working folders are clean
+      """
+
+  Scenario: One existing file added to the index
+    Given a repo in folder "test_path_2" with the following:
+      | filename      | status | content    |
+      | .gitignore    | A      | new_stff   |
+    When I run `repo status --unmodified=DOTS`
+    Then the exit status should be 8
+    And the normalized output should contain:
+      """
+      .
+        A     test2
+                added: .gitignore
+      """
+
+  Scenario: One deleted file
+    Given a repo in folder "test_path_1" with the following:
+      | filename         | status |
+      | .gitignore       | D      |
+    When I run `repo status --unmodified=DOTS`
+    Then the exit status should be 16
+    And the normalized output should contain:
+      """
+         D    test1
+                deleted: .gitignore
+      .
+      """
+
+  Scenario: Two untracked files
+    Given a repo in folder "test_path_1" with the following:
+      | filename      | status | content          |
+      | new_file1.txt | ?      | hello new file1  |
+      | new_file2.txt | ?      | hello new file2  |
+    When I run `repo status --unmodified=DOTS`
+    Then the exit status should be 32
+    And the normalized output should contain:
+      """
+       ?      test1
+                untracked: new_file1.txt
+                untracked: new_file2.txt
+      .
+      """
+
+  Scenario: One uncommitted change, two untracked files, one added, and one deleted file
+    Given a repo in folder "test_path_1" with the following:
+      | filename         | status | content            |
+      | deleted_file.txt | D      | hello deleted file |
+    And a repo in folder "test_path_1" with the following:
+      | filename         | status | content            |
+      | added_file.txt   | A      | hello added file   |
+      | .gitignore       | M      | tmp/*              |
+      | new_file1.txt    | ?      | hello new file1    |
+      | new_file2.txt    | ?      | hello new file2    |
+    When I run `repo status --unmodified=DOTS`
+    Then the exit status should be 60
+    And the normalized output should contain:
+      """
+      M?AD    test1
+                modified: .gitignore
+                untracked: new_file1.txt
+                untracked: new_file2.txt
+                added: added_file.txt
+                deleted: deleted_file.txt
+      .
+      """
+
+  Scenario: Two untracked files, one is gitignored
+    Given a repo in folder "test_path_1" with the following:
+      | filename      | status | content          |
+      | .gitignore    | DC     | new_file2.txt    |
+      | new_file1.txt | ?      | hello new file1  |
+      | new_file2.txt | ?      | hello new file2  |
+    When I run `repo status --unmodified=DOTS`
+    Then the exit status should be 32
+    And the normalized output should contain:
+      """
+       ?      test1
+                untracked: new_file1.txt
+      .
+      """
+
+  Scenario: Folders with spaces in path
+    Given a file named "repo1.conf" with:
+      """
+      ---
+      folders:
+        assets : repo1_assets
+      """
+    Given a repo in folder "test 1/test path 1" with the following:
+      | filename         | status | content  |
+      | .gitignore       | CM     | tmp/*    |
+    And the folder "repo1_assets" with the following asset configurations:
+      | name       | path                 |
+      | test1      | test 1/test path 1   |
+      | test2      | test_path_2          |
+    When I run `repo status --unmodified=DOTS --config=repo1.conf`
+    Then the exit status should be 4
+    And the normalized output should contain:
+      """
+      M       test1
+                modified: .gitignore
+      .
+      """