octokitted 0.0.3 → 0.0.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 79ee296a98c30f97fd70b08cf0c5c4d907425bb03047c315796b48fc171f461f
-  data.tar.gz: 952ad085cde53de7abcae1be6292e2a4e3b9d72af876b772e67fa0013e37f734
+  metadata.gz: df4ab1cbb4cf7f9f197be6f48bf19eadfc34fabaae33433e376a21c4327df0e4
+  data.tar.gz: 04c286e8800c55ac4d55e71b3058e12733a498e91c1d4fb0bf9153bb39685bd5
 SHA512:
-  metadata.gz: 5e3e6310f04d682ffaeb5077e707cb11fd1c4a3ad691614798a775e09798cb52d6c42c99dd7577c6043593eb06e55ded2bfb0f1bb53421288000c63d2bf17609
-  data.tar.gz: 65780350c6e442466e07e83008b96a8ad49acea371c2de44b41a8a99b5dfce9c973febaecdf9a25fc057cc105c6d2a8d5d022cc31d978f31b371885369dd31f7
+  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.3"
+    VERSION = "0.0.4"
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: octokitted
 version: !ruby/object:Gem::Version
-  version: 0.0.3
+  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