ronin-repos 0.1.1 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5f165cb9c5c8eda828d18f33114a9407ccae14fb6d5a7edc84fbc5159ba26aad
-  data.tar.gz: 6518e8a7dc2b29c778bf82d8ce32efc692e85b0d3ab108f3575724181b689bd4
+  metadata.gz: 506280f739b7331d473f038402701c458ed835599cd43ecb51069a5e9d58b37d
+  data.tar.gz: 74c164693b1c4be5e2f72391f7a1ce37d16d530159696647ead8adf794dee157
 SHA512:
-  metadata.gz: 0a827887a127c7a8165087e71cd3e8098b154f1ecd72dd0136f66ef640562db59a401ded921ac74877a981974ab16570cc431850f12f8d184291b5834c9d998d
-  data.tar.gz: 4c6e43043c8a93b69b0f55a1a8016e6014e4343b338b90b9a85d6cc9477b93f8c413d5e3d98bf71bf39115731a13bdfc4e3a46e2d40aa9302029089edf502b6c
+  metadata.gz: 6180207390d36dd0b008bf0f10eca93d0eb050828571cf2684ede0a600e03ac35c8b05620cfaadb216b9ba3980e685def62326ddca764d32c8ee42552d8a86aa
+  data.tar.gz: e65b9ce25305ecf572b7149c8a903550516728c62d478a35989edd65ee87186ea8a1cee01ec40c2c698b82a5dbe79156356c432e137612156e0641ab1618b09b

data/.document

@@ -2,4 +2,3 @@ lib/**/*.rb
 - 
 ChangeLog.md
 COPYING.txt
-man/*.md

data/.github/workflows/ruby.yml

@@ -12,11 +12,12 @@ jobs:
           - '3.0'
           - '3.1'
           - '3.2'
+          - '3.3'
           - jruby
           - truffleruby
     name: Ruby ${{ matrix.ruby }}
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v4
       - name: Set up Ruby
         uses: ruby/setup-ruby@v1
         with:
@@ -31,7 +32,7 @@ jobs:
   rubocop:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v4
       - name: Set up Ruby
         uses: ruby/setup-ruby@v1
         with:

data/.gitignore

@@ -1,4 +1,5 @@
 /coverage
+/data/completions/ronin-repos
 /doc
 /pkg
 /man/*.[1-9]

data/.rubocop.yml

@@ -15,3 +15,7 @@ Lint/EmptyFile:
     - 'spec/fixtures/class_dir/file1.rb'
     - 'spec/fixtures/class_dir/file2.rb'
     - 'spec/fixtures/class_dir/only_in_class_dir.rb'
+
+Style/MapIntoArray:
+  Exclude:
+    - 'spec/cache_dir_spec.rb'

data/.ruby-version

@@ -1 +1 @@
-ruby-3.1
+ruby-3.3

data/ChangeLog.md

@@ -1,3 +1,18 @@
+### 0.2.0 / 2024-07-22
+
+* Added {Ronin::Repos::Repository#url}.
+* Added {Ronin::Repos::Repository#last_updated_at}.
+* Added {Ronin::Repos.cache_dir}.
+
+#### CLI
+
+* Added the `ronin-repos show` command.
+* Changed `ronin-repos list` to fuzzy match repo names.
+* Changed `ronin-repos new` to also create empty `exploits/`, `payloads/`,
+  `recon/`, and `brute/`.
+* Added the `ronin-repos completion` command to install shell completion files
+  for all `ronin-repos` commands for Bash and Zsh shells.
+
 ### 0.1.1 / 2023-06-09
 
 * Fixed a bug in {Ronin::Repos::ClassDir::ClassMethods#list_files} where the

data/Gemfile

@@ -9,10 +9,10 @@ platform :jruby do
 end
 
 # Ronin dependencies:
-# gem 'ronin-core', '~> 0.1', github: 'ronin-rb/ronin-core',
+# gem 'ronin-core', '~> 0.2', github: 'ronin-rb/ronin-core',
 #                             branch: 'main'
 
-# gem 'command_kit', '~> 0.4', github: 'postmodern/command_kit.rb',
+# gem 'command_kit', '~> 0.5', github: 'postmodern/command_kit.rb',
 #                              branch: 'main'
 
 group :development do
@@ -22,7 +22,7 @@ group :development do
   gem 'simplecov',       '~> 0.20'
 
   gem 'kramdown',        '~> 2.0'
-  gem 'kramdown-man',    '~> 0.1'
+  gem 'kramdown-man',    '~> 1.0'
 
   gem 'redcarpet',       platform: :mri
   gem 'yard',            '~> 0.9'
@@ -33,4 +33,6 @@ group :development do
   gem 'stackprof',       require: false, platform: :mri
   gem 'rubocop',         require: false, platform: :mri
   gem 'rubocop-ronin',   require: false, platform: :mri
+
+  gem 'command_kit-completion', '~> 0.2', require: false
 end

data/README.md

@@ -9,13 +9,23 @@
 * [Issues](https://github.com/ronin-rb/ronin-repos/issues)
 * [Documentation](https://ronin-rb.dev/docs/ronin-repos/frames)
 * [Discord](https://discord.gg/6WAb3PsVX9) |
-  [Twitter](https://twitter.com/ronin_rb) |
   [Mastodon](https://infosec.exchange/@ronin_rb)
 
 ## Description
 
 ronin-repos provides a repository system for installing, managing, and accessing
-third-party git repositories, which can contain code or other data.
+third-party git repositories, that can contain additional Ruby code or other
+data.
+
+Third-party git repositories can be used to extend parts of Ronin. Other Ronin
+libraries can then list and load additional third-party Ruby classes from
+specific directories within the installed third-party repos:
+
+* `exploits/` - may contain additional exploits for [ronin-exploits].
+* `payloads/` - may contain additional payloads for [ronin-payloads].
+
+**tl;dr** ronin-repos is essentially a decentralized plugin system for Ronin
+using git repos.
 
 ronin-repos is part of the [ronin-rb] project, a toolkit for security research
 and development.
@@ -40,12 +50,14 @@ Arguments:
     [ARGS ...]                       Additional arguments for the command
 
 Commands:
+    completion
     help
     install
     list, ls
     new
     purge
     remove, rm
+    show, info
     update, up
 ```
 
@@ -111,7 +123,7 @@ Rnnin::Repos.glob("wordlists/*.txt")
 ## Requirements
 
 * [Ruby] >= 3.0.0
-* [ronin-core] ~> 0.1
+* [ronin-core] ~> 0.2
 
 ## Install
 
@@ -130,7 +142,7 @@ gem 'ronin-repos', '~> 0.1'
 1. [Fork It!](https://github.com/ronin-rb/ronin-repos/fork)
 2. Clone It!
 3. `cd ronin-repos`
-4. `bundle install`
+4. `./scripts/server`
 5. `git checkout -b my_feature`
 6. Code It!
 7. `bundle exec rake spec`
@@ -138,7 +150,7 @@ gem 'ronin-repos', '~> 0.1'
 
 ## License
 
-Copyright (c) 2021-2023 Hal Brodigan (postmodern.mod3 at gmail.com)
+Copyright (c) 2021-2024 Hal Brodigan (postmodern.mod3 at gmail.com)
 
 ronin-repos is free software: you can redistribute it and/or modify
 it under the terms of the GNU Lesser General Public License as published
@@ -158,3 +170,5 @@ along with ronin-repos.  If not, see <https://www.gnu.org/licenses/>.
 [Ruby]: https://www.ruby-lang.org
 [git]: https://git-scm.com/
 [ronin-core]: https://github.com/ronin-rb/ronin-core#readme
+[ronin-exploits]: https://github.com/ronin-rb/ronin-exploits#readme
+[ronin-payloads]: https://github.com/ronin-rb/ronin-payloads#readme

data/Rakefile

@@ -32,3 +32,13 @@ task :docs => :yard
 
 require 'kramdown/man/task'
 Kramdown::Man::Task.new
+
+require 'command_kit/completion/task'
+CommandKit::Completion::Task.new(
+  class_file:  'ronin/repos/cli',
+  class_name:  'Ronin::Repos::CLI',
+  input_file:  'data/completions/ronin-repos.yml',
+  output_file: 'data/completions/ronin-repos'
+)
+
+task :setup => %w[man command_kit:completion]

data/data/completions/ronin-repos

@@ -0,0 +1,139 @@
+# ronin-repos completion                                   -*- shell-script -*-
+
+# This bash completions script was generated by
+# completely (https://github.com/dannyben/completely)
+# Modifying it manually is not recommended
+
+_ronin-repos_completions_filter() {
+  local words="$1"
+  local cur=${COMP_WORDS[COMP_CWORD]}
+  local result=()
+
+  if [[ "${cur:0:1}" == "-" ]]; then
+    echo "$words"
+
+  else
+    for word in $words; do
+      [[ "${word:0:1}" != "-" ]] && result+=("$word")
+    done
+
+    echo "${result[*]}"
+
+  fi
+}
+
+_ronin-repos_completions() {
+  local cur=${COMP_WORDS[COMP_CWORD]}
+  local compwords=("${COMP_WORDS[@]:1:$COMP_CWORD-1}")
+  local compline="${compwords[*]}"
+
+  case "$compline" in
+    'install'*'--cache-dir')
+      while read -r; do COMPREPLY+=("$REPLY"); done < <(compgen -A directory -- "$cur")
+      ;;
+
+    'update'*'--cache-dir')
+      while read -r; do COMPREPLY+=("$REPLY"); done < <(compgen -A directory -- "$cur")
+      ;;
+
+    'remove'*'--cache-dir')
+      while read -r; do COMPREPLY+=("$REPLY"); done < <(compgen -A directory -- "$cur")
+      ;;
+
+    'purge'*'--cache-dir')
+      while read -r; do COMPREPLY+=("$REPLY"); done < <(compgen -A directory -- "$cur")
+      ;;
+
+    'list'*'--cache-dir')
+      while read -r; do COMPREPLY+=("$REPLY"); done < <(compgen -A directory -- "$cur")
+      ;;
+
+    'show'*'--cache-dir')
+      while read -r; do COMPREPLY+=("$REPLY"); done < <(compgen -A directory -- "$cur")
+      ;;
+
+    'new'*'--cache-dir')
+      while read -r; do COMPREPLY+=("$REPLY"); done < <(compgen -A directory -- "$cur")
+      ;;
+
+    'completion'*)
+      while read -r; do COMPREPLY+=("$REPLY"); done < <(compgen -W "$(_ronin-repos_completions_filter "--print --install --uninstall")" -- "$cur")
+      ;;
+
+    'install'*'-C')
+      while read -r; do COMPREPLY+=("$REPLY"); done < <(compgen -A directory -- "$cur")
+      ;;
+
+    'update'*'-C')
+      while read -r; do COMPREPLY+=("$REPLY"); done < <(compgen -A directory -- "$cur")
+      ;;
+
+    'remove'*'-C')
+      while read -r; do COMPREPLY+=("$REPLY"); done < <(compgen -A directory -- "$cur")
+      ;;
+
+    'purge'*'-C')
+      while read -r; do COMPREPLY+=("$REPLY"); done < <(compgen -A directory -- "$cur")
+      ;;
+
+    'show'*'-C')
+      while read -r; do COMPREPLY+=("$REPLY"); done < <(compgen -A directory -- "$cur")
+      ;;
+
+    'install'*)
+      while read -r; do COMPREPLY+=("$REPLY"); done < <(compgen -W "$(_ronin-repos_completions_filter "--cache-dir -C")" -- "$cur")
+      ;;
+
+    'list'*'-C')
+      while read -r; do COMPREPLY+=("$REPLY"); done < <(compgen -A directory -- "$cur")
+      ;;
+
+    'update'*)
+      while read -r; do COMPREPLY+=("$REPLY"); done < <(compgen -W "$(_ronin-repos_completions_filter "--cache-dir -C $(ronin-repos list)")" -- "$cur")
+      ;;
+
+    'remove'*)
+      while read -r; do COMPREPLY+=("$REPLY"); done < <(compgen -W "$(_ronin-repos_completions_filter "--cache-dir -C $(ronin-repos list)")" -- "$cur")
+      ;;
+
+    'new'*'-C')
+      while read -r; do COMPREPLY+=("$REPLY"); done < <(compgen -A directory -- "$cur")
+      ;;
+
+    'purge'*)
+      while read -r; do COMPREPLY+=("$REPLY"); done < <(compgen -W "$(_ronin-repos_completions_filter "--cache-dir -C")" -- "$cur")
+      ;;
+
+    'info'*)
+      while read -r; do COMPREPLY+=("$REPLY"); done < <(compgen -W "$(_ronin-repos_completions_filter "$(ronin-repos list)")" -- "$cur")
+      ;;
+
+    'show'*)
+      while read -r; do COMPREPLY+=("$REPLY"); done < <(compgen -W "$(_ronin-repos_completions_filter "--cache-dir -C $(ronin-repos list)")" -- "$cur")
+      ;;
+
+    'list'*)
+      while read -r; do COMPREPLY+=("$REPLY"); done < <(compgen -W "$(_ronin-repos_completions_filter "--cache-dir -C")" -- "$cur")
+      ;;
+
+    'new'*)
+      while read -r; do COMPREPLY+=("$REPLY"); done < <(compgen -W "$(_ronin-repos_completions_filter "--cache-dir -C")" -- "$cur")
+      ;;
+
+    'up'*)
+      while read -r; do COMPREPLY+=("$REPLY"); done < <(compgen -W "$(_ronin-repos_completions_filter "$(ronin-repos list)")" -- "$cur")
+      ;;
+
+    'rm'*)
+      while read -r; do COMPREPLY+=("$REPLY"); done < <(compgen -W "$(_ronin-repos_completions_filter "$(ronin-repos list)")" -- "$cur")
+      ;;
+
+    *)
+      while read -r; do COMPREPLY+=("$REPLY"); done < <(compgen -W "$(_ronin-repos_completions_filter "--version -V help completion install list new purge remove show update ls up rm info")" -- "$cur")
+      ;;
+
+  esac
+} &&
+  complete -F _ronin-repos_completions ronin-repos
+
+# ex: filetype=sh

data/data/completions/ronin-repos.yml

@@ -0,0 +1,10 @@
+---
+ronin-repos remove: &remove
+  - $(ronin-repos list)
+ronin-repos rm: *remove
+ronin-repos show: &show
+  - $(ronin-repos list)
+ronin-repos info: *show
+ronin-repos update: &update
+  - $(ronin-repos list)
+ronin-repos up: *update

data/gemspec.yml

@@ -2,7 +2,13 @@ name: ronin-repos
 summary: Third-party git repository support for ronin.
 description:
   ronin-repos provides a repository system for installing, managing, and
-  accessing third-party git repositories, which can contain code or other data.
+  accessing third-party git repositories, that can contain additional Ruby code 
+  or other data. Other Ronin libraries, such as ronin-exploits or
+  ronin-payloads, can then list and load additional third-party Ruby classes
+  from specific directories within the installed third-party reposs.
+
+  ronin-repos is essentially a decentralized plugin system for Ronin using git
+  repos.
 
 license: LGPL-3.0
 authors: Postmodern
@@ -18,11 +24,14 @@ metadata:
   rubygems_mfa_required: 'true'
 
 generated_files:
+ - data/completions/ronin-repos
  - man/ronin-repos.1
+ - man/ronin-repos-completion.1
  - man/ronin-repos-install.1
  - man/ronin-repos-list.1
  - man/ronin-repos-new.1
  - man/ronin-repos-remove.1
+ - man/ronin-repos-show.1
  - man/ronin-repos-update.1
  - man/ronin-repos-purge.1
 
@@ -30,7 +39,7 @@ required_ruby_version: ">= 3.0.0"
 
 dependencies:
   # Library dependencies:
-  ronin-core: ~> 0.1
+  ronin-core: ~> 0.2
 
 development_dependencies:
   bundler: ~> 2.0

data/lib/ronin/repos/cache_dir.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 #
-# Copyright (c) 2021-2023 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2021-2024 Hal Brodigan (postmodern.mod3 at gmail.com)
 #
 # ronin-repos is free software: you can redistribute it and/or modify
 # it under the terms of the GNU Lesser General Public License as published

data/lib/ronin/repos/class_dir.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 #
-# Copyright (c) 2021-2023 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2021-2024 Hal Brodigan (postmodern.mod3 at gmail.com)
 #
 # ronin-repos is free software: you can redistribute it and/or modify
 # it under the terms of the GNU Lesser General Public License as published
@@ -122,17 +122,18 @@ module Ronin
         # @return [Array<String>]
         #
         def list_files
-          modules = Set.new(super)
+          paths   = Set.new(super)
           pattern = File.join(repo_class_dir,"{**/}*.rb")
 
           # the String#slice range to remove the repo_class_dir/ and .rb ext
           slice_range = (repo_class_dir.length + 1)...-3
 
           Repos.list_files(pattern).each do |path|
-            modules << path.slice(slice_range)
+            # NOTE: String#slice is faster than .delete_prefix + delete.suffix
+            paths << path.slice(slice_range)
           end
 
-          return modules.to_a
+          return paths.to_a
         end
 
         #

data/lib/ronin/repos/cli/command.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 #
-# Copyright (c) 2021-2023 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2021-2024 Hal Brodigan (postmodern.mod3 at gmail.com)
 #
 # ronin-repos is free software: you can redistribute it and/or modify
 # it under the terms of the GNU Lesser General Public License as published

data/lib/ronin/repos/cli/commands/completion.rb

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+#
+# Copyright (c) 2021-2024 Hal Brodigan (postmodern.mod3 at gmail.com)
+#
+# ronin-repos is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Lesser General Public License as published
+# by the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# ronin-repos 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 Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public License
+# along with ronin-repos.  If not, see <https://www.gnu.org/licenses/>.
+#
+
+require 'ronin/repos/root'
+require 'ronin/core/cli/completion_command'
+
+module Ronin
+  module Repos
+    class CLI
+      module Commands
+        #
+        # Manages the shell completion rules for `ronin-repos`.
+        #
+        # ## Usage
+        #
+        #     ronin-repos completion [options]
+        #
+        # ## Options
+        #
+        #         --print                      Prints the shell completion file
+        #         --install                    Installs the shell completion file
+        #         --uninstall                  Uninstalls the shell completion file
+        #     -h, --help                       Print help information
+        #
+        # ## Examples
+        #
+        #     ronin-repos completion --print
+        #     ronin-repos completion --install
+        #     ronin-repos completion --uninstall
+        #
+        # @since 0.2.0
+        #
+        class Completion < Core::CLI::CompletionCommand
+
+          completion_file File.join(ROOT,'data','completions','ronin-repos')
+
+          man_dir File.join(ROOT,'man')
+          man_page 'ronin-repos-completion.1'
+
+          description 'Manages the shell completion rules for ronin-repos'
+
+        end
+      end
+    end
+  end
+end

data/lib/ronin/repos/cli/commands/install.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 #
-# Copyright (c) 2021-2023 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2021-2024 Hal Brodigan (postmodern.mod3 at gmail.com)
 #
 # ronin-repos is free software: you can redistribute it and/or modify
 # it under the terms of the GNU Lesser General Public License as published
@@ -63,7 +63,7 @@ module Ronin
           def run(uri)
             log_info "Installing repository from #{uri} ..."
             cache_dir.install(uri)
-          rescue CommandFailed => error
+          rescue CommandNotInstalled, CommandFailed => error
             print_error(error.message)
             exit(-1)
           end

data/lib/ronin/repos/cli/commands/list.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 #
-# Copyright (c) 2021-2023 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2021-2024 Hal Brodigan (postmodern.mod3 at gmail.com)
 #
 # ronin-repos is free software: you can redistribute it and/or modify
 # it under the terms of the GNU Lesser General Public License as published
@@ -27,7 +27,7 @@ module Ronin
         #
         # ## Usage
         #
-        #     ronin-repos list [options] [REPO]
+        #     ronin-repos list [options] [NAME]
         #
         # ## Options
         #
@@ -36,15 +36,15 @@ module Ronin
         #
         # ## Arguments
         #
-        #     [REPO]                           Optional repository name to list
+        #     [NAME]                           Optional repository name(s) to list
         #
         class List < Command
 
-          usage '[options] [REPO]'
+          usage '[options] [NAME]'
 
           argument :name, required: false,
-                          usage:    'REPO',
-                          desc:     'Optional repository name to list'
+                          usage:    'NAME',
+                          desc:     'Optional repository name(s) to list'
 
           description 'Lists all repositories in the cache directory'
 
@@ -57,19 +57,16 @@ module Ronin
           #   The optional repo name to list.
           #
           def run(name=nil)
-            if name
-              begin
-                repo = cache_dir[name]
+            repos = if name
+                      cache_dir.select do |repo|
+                        repo.name.include?(name)
+                      end
+                    else
+                      cache_dir.each
+                    end
 
-                puts "  #{repo}"
-              rescue RepositoryNotFound => error
-                print_error(error.message)
-                exit(-1)
-              end
-            else
-              cache_dir.each do |repo|
-                puts "  #{repo}"
-              end
+            repos.each do |repo|
+              puts "  #{repo}"
             end
           end
 

data/lib/ronin/repos/cli/commands/new.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 #
-# Copyright (c) 2021-2023 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2021-2024 Hal Brodigan (postmodern.mod3 at gmail.com)
 #
 # ronin-repos is free software: you can redistribute it and/or modify
 # it under the terms of the GNU Lesser General Public License as published
@@ -54,7 +54,7 @@ module Ronin
 
           description 'Creates a new git repository'
 
-          man_page 'ronin-repos.1'
+          man_page 'ronin-repos-new.1'
 
           #
           # Runs the `ronin-repos new` command.
@@ -67,6 +67,10 @@ module Ronin
             @github_user = Core::Git.github_user || ENV['USER']
 
             mkdir path
+            mkdir File.join(path,'exploits')
+            mkdir File.join(path,'payloads')
+            mkdir File.join(path,'recon')
+            mkdir File.join(path,'brute')
             erb 'README.md.erb', File.join(path,'README.md')
 
             Dir.chdir(path) do

data/lib/ronin/repos/cli/commands/purge.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 #
-# Copyright (c) 2021-2023 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2021-2024 Hal Brodigan (postmodern.mod3 at gmail.com)
 #
 # ronin-repos is free software: you can redistribute it and/or modify
 # it under the terms of the GNU Lesser General Public License as published
@@ -38,7 +38,7 @@ module Ronin
 
           description 'Removes all git repository from the cache directory'
 
-          man_page 'ronin-repos-download.1'
+          man_page 'ronin-repos-purge.1'
 
           #
           # Runs the `ronin-repos purge` command.

data/lib/ronin/repos/cli/commands/remove.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 #
-# Copyright (c) 2021-2023 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2021-2024 Hal Brodigan (postmodern.mod3 at gmail.com)
 #
 # ronin-repos is free software: you can redistribute it and/or modify
 # it under the terms of the GNU Lesser General Public License as published