octokitted 0.0.2 → 0.0.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3328c9396d35d1150fb91b1c3b54cff09abed713d2f3e131593e421ecd21855d
-  data.tar.gz: e58aa59c1c25cd6da6659602240761ae174633d4d56b460ca8c2838dc664a0d3
+  metadata.gz: df4ab1cbb4cf7f9f197be6f48bf19eadfc34fabaae33433e376a21c4327df0e4
+  data.tar.gz: 04c286e8800c55ac4d55e71b3058e12733a498e91c1d4fb0bf9153bb39685bd5
 SHA512:
-  metadata.gz: 4bd0054595b6120ccc757665ffe2462f55d94cb1d8c9c987c38dc1ca10c1f56894b043e938223b6b78c526131e3946de48692807bb99f9aac24781601dcd62de
-  data.tar.gz: ee47262226720898b8b37a925e71e054bc37fddcd627f9ce16415794a4cbd0afd3d5b5fdb7c5d4fe12b47b8b8a36d483195772920b361792fe7c169a1325ccc5
+  metadata.gz: cd75ef4dbe2385bc1324a9b5762e0a542a5981f0195704a0a5b21a5d602b022ac61721e86d462540c464a7b193b3600b57579b8cfe0dde46e3dcbe1a78a14ad0
+  data.tar.gz: 933e1cc9a5c42a650c3849ace20e8bea0cdc3e0a1855d5bb0eb2bc3b2c409da6041297441d70477fd78dab6b814dfe76d5f4fcd11552f50dd161a0784b37e84f

data/lib/octokitted/git_plugin.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+require "git"
+
+class GitPlugin
+  attr_reader :login
+
+  # Initialize the class
+  def initialize(logger:, login:, token:)
+    @log = logger
+    @login = login
+    @token = token
+  end
+
+  # Removes / cleans up all repos that this class has cloned
+  # :param cloned_repos: An array of paths to cloned repos to remove
+  def remove_all_clones!(cloned_repos)
+    @log.debug("removing all cloned repos")
+    cloned_repos.each do |path|
+      @log.debug("removing cloned repo: #{path}")
+      FileUtils.rm_r(path)
+    end
+  end
+
+  # Removes a single cloned repo
+  # :param path: The path to the cloned repo to remove (String)
+  def remove_clone!(path)
+    @log.debug("removing cloned repo: #{path}")
+    FileUtils.rm_r(path)
+  end
+
+  # Clone a repository
+  # :param path: The relative path to clone the repo to - (default: ".")
+  # :param options: The options to pass to the Git.clone method (default: {} - https://rubydoc.info/gems/git/Git#clone-class_method)
+  # :return: Hash of the Git Object, and the path to the cloned repo
+  def clone(org:, repo:, path: ".", options: {})
+    @log.debug("cloning #{org}/#{repo}")
+    git_object = Git.clone("https://#{@token}@github.com/#{org}/#{repo}.git", repo, path:, log: @log, **options)
+
+    # configure the git environment
+    git_object.config("user.name", @login)
+    git_object.config("user.email", "#{@login}@github.com")
+
+    repo_path = File.join(path, repo)
+    return { git_object:, path: repo_path }
+  rescue StandardError => e
+    # Remove token from error to prevent token leak
+    raise e, e.message.gsub(@token, "REDACTED_TOKEN")
+  end
+end

data/lib/octokitted.rb

@@ -3,9 +3,11 @@
 require "octokit"
 require "logger"
 
+require_relative "octokitted/git_plugin"
+
 class Octokitted
   # A Octokitted class to interact with the GitHub API
-  attr_reader :login, :org, :repo, :org_and_repo, :client
+  attr_reader :login, :org, :repo, :org_and_repo, :octokit, :cloned_repos
 
   # Initialize the class
   # :param login: The login to use for GitHubAPI interactions (defaults to the owner of the token)
@@ -14,19 +16,22 @@ class Octokitted
   # :param token: The token to use to authenticate with the GitHub API
   # :param logger: The logger to use for logging
   def initialize(login: nil, org: nil, repo: nil, token: nil, logger: nil)
+    @cloned_repos = []
     org_and_repo_hash = fetch_org_and_repo
     @login = login
     @org = org || org_and_repo_hash[:org]
     @repo = repo || org_and_repo_hash[:repo]
     @token = token || fetch_token
-    @client = setup_client
+    @octokit = setup_octokit_client
     @log = logger || setup_logger
     @org_and_repo = org_and_repo_hash[:org_and_repo]
+    @login = @octokit.login if @login.nil? # reset the login to the owner of the token if not provided
 
-    @login = @client.login if @login.nil? # reset the login to the owner of the token if not provided
+    # setup the git plugin
+    @git = GitPlugin.new(logger: @log, login: @login, token: @token)
 
     @log.debug("Octokitted initialized")
-    @log.debug("login: #{@client.login}")
+    @log.debug("login: #{@octokit.login}")
     @log.debug("org: #{@org}")
     @log.debug("repo: #{@repo}")
   end
@@ -51,6 +56,26 @@ class Octokitted
     @log.debug("updated org/repo: #{@org_and_repo}")
   end
 
+  # Clone the currently set owner/repo repository
+  # :param path: The relative path to clone the repo to - (default: ".")
+  # :param options: The options to pass (default: {} - https://rubydoc.info/gems/git/Git#clone-class_method)
+  # :return: The Git object to operate with
+  def clone(path: ".", options: {})
+    result = @git.clone(org: @org, repo: @repo, path:, options:)
+    @cloned_repos << result[:path]
+    return result[:git_object]
+  end
+
+  def remove_clone!(path)
+    @git.remove_clone!(path)
+    @cloned_repos.delete(path)
+  end
+
+  def remove_all_clones!
+    @git.remove_all_clones!(@cloned_repos)
+    @cloned_repos = []
+  end
+
   private
 
   # construct a logger for the class
@@ -88,7 +113,7 @@ class Octokitted
 
   # Setup an Octokit client
   # :return: An Octokit client
-  def setup_client
+  def setup_octokit_client
     Octokit::Client.new(
       access_token: @token,
       login: @login,

data/lib/version.rb

@@ -2,6 +2,6 @@
 
 module Octokitted
   module Version
-    VERSION = "0.0.2"
+    VERSION = "0.0.4"
   end
 end

data/octokitted.gemspec

@@ -21,6 +21,8 @@ Gem::Specification.new do |spec|
     "bug_tracker_uri" => "https://github.com/grantbirki/octokitted/issues"
   }
 
+  spec.add_dependency "contracts", "~> 0.17"
+  spec.add_dependency "faraday-retry", "~> 2.2"
   spec.add_dependency "git", "~> 1.18"
   spec.add_dependency "octokit", "~> 7.1"
 

metadata

@@ -1,15 +1,43 @@
 --- !ruby/object:Gem::Specification
 name: octokitted
 version: !ruby/object:Gem::Version
-  version: 0.0.2
+  version: 0.0.4
 platform: ruby
 authors:
 - Grant Birkinbine
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-09-15 00:00:00.000000000 Z
+date: 2023-09-16 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: contracts
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.17'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.17'
+- !ruby/object:Gem::Dependency
+  name: faraday-retry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.2'
 - !ruby/object:Gem::Dependency
   name: git
   requirement: !ruby/object:Gem::Requirement