gitt 2.1.1 → 3.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3127915892090cd6023f6ff8ad9e3a221352fc4d9cfd3dd8ac4a82392ae7b22b
-  data.tar.gz: 3c724f8d0e0befa772bfb549ccc99a1d61e42fa527a4305d05c8acd3181d9925
+  metadata.gz: 2a62c7af41ef6056ceb816436a8c80f1d2ee3fd792fbbcadadbc82a2b5eba97d
+  data.tar.gz: bc3d13fbd0296b5ca483f02033446fc79fbbd46617d0fd2b06cf07477ba06d3e
 SHA512:
-  metadata.gz: 74a64c4b46f502ecf9193c4b31fbefd301d2b92d2a94b074819a44ceb559717003ba15fb6ee1aaf3c39b03da2027d33ebed7309131556b0ba1ba8aa9c9b2d147
-  data.tar.gz: 2afce970af961e6ecf28a8c8e88b71d5d2405f53f249d2f875cf73bd5d87ccdc55f6eadb4ad5e8f159a06f20c9764dad6d979110aad8e7d5d8a2548b1f55b704
+  metadata.gz: df96432454f47a6d4fd57c741949dabd088f61c1a62af03b25fac1860a766b52ecf19e7bd3973b29ee617e1c015588953ba34ca17fd56201f894ec9279819f80
+  data.tar.gz: da01de46bb99ad4c59a328101772184703da241949ba9678dfb19c71c2e616a7fd6ab4d422035592ffe15473d33663e4e07e73fa9dede99c5e06660940d9ecdb

data/README.adoc

@@ -24,7 +24,7 @@ toc::[]
 == Features
 
 * Wraps a subset of native {git_link} commands with additional enhancements to improve your working experience.
-* Answers link:https://dry-rb.org/gems/dry-monads[monads] you can pipe together -- or link:https://alchemists.io/projects/transactable[transact] -- for more powerful and complex workflows.
+* Answers link:https://dry-rb.org/gems/dry-monads[monads] you can link:https://alchemists.io/projects/transactable[pipe] together for more complex workflows.
 * Provides _optional_ {rspec_link} shared contexts that speed up the testing of your own Git related implementations.
 
 == Requirements
@@ -65,17 +65,19 @@ git.tag?            # Answers if local or remote tag exists.
 git.tag_create      # Create a new tag.
 git.tag_last        # Answers last tag created.
 git.tag_local?      # Answers if local tag exists?
-git.tag_parse       # Parses and answers a tag record.
 git.tag_remote?     # Answers if remote tag exists?
+git.tag_show        # Answers information about a single tag.
 git.tagged?         # Answers if the repository has any tags.
+git.tags            # Answers all tags.
 git.tags_push       # Pushes local tags to remote git.
 git.uncommitted     # Parses a file and answers an unsaved commit message.
+
 ----
 
 === Commands
 
 Should you want to use individual commands instead of interacting with the `Repository` object, you
-can leverage any of the objects in the `Commands` namespace which -- at a minimum -- use the link:https://alchemists.io/articles/interactor_pattern[Command Pattern]. Here are the _select_ commands which are enhanced further:
+can leverage any of the objects in the `Commands` namespace which -- at a minimum -- use the link:https://alchemists.io/articles/interactor_pattern[Command Pattern]. Here are the specific commands which are enhanced further:
 
 ==== link:https://git-scm.com/docs/git-branch[Branch]
 
@@ -85,9 +87,12 @@ Handles branches.
 ----
 branch = Gitt::Commands::Branch.new
 
-# Answers branch default (via Git `init.defaultBranch` configuration).
+# Answers branch default (via Git `init.defaultBranch` configuration) of if blank.
 branch.default  # Success "main"
 
+# Answers branch default fallback if unset or error is detected.
+branch.default "source"  # Success "source"
+
 # Accepts any argument you'd send to `git branch`. Example:
 branch.call "--list"  # Success "  main\n"
 
@@ -157,6 +162,9 @@ tag = Gitt::Commands::Tag.new
 # Example: tag.call "--list"
 stdout, stderr, status = tag.call
 
+# Creates a new tag.
+tag.create "0.0.0", "Version 0.0.0"
+
 # Answers true or false base on whether local and remote tag exist.
 tag.exist? "0.1.0"
 
@@ -172,6 +180,9 @@ tag.push
 # Answers if remote tag exists.
 tag.remote? "0.1.0"
 
+# Answers details about a specific tag.
+tag.show "1.0.0"
+
 # Answers true or false based on whether repository is tagged.
 tag.tagged?
 ----
@@ -221,21 +232,31 @@ An instance of `Gitt::Models::Tag` is what is answered back to when using `Gitt:
 [source,ruby]
 ----
 # #<struct Gitt::Models::Tag
-#  author_date="Tue Dec 29 17:33:01 2020 -0700",
 #  author_email="demo@example.com",
-#  author_name="Demo User",
-#  body="- Added gem skeleton\n- Added RSpec dependency",
-#  sha="d041d07c29f97b5b06b3b2fd05fa1dd018c7da7c",
-#  subject="Version 0.1.0",
-#  version="0.1.0">
+#  author_name="Brooke Kuhlmann",
+#  authored_at="1671892451",
+#  authored_relative_at="1 year ago",
+#  body="A demo body.",
+#  committed_at="1671997684",
+#  committed_relative_at="1 year ago",
+#  committer_email="demo@example.com",
+#  committer_name="Brooke Kuhlmann",
+#  sha="662f32b2846c7bd4f153560478f035197f5279d5",
+#  subject="Version 1.0.0",
+#  version="1.0.0">
 ----
 
 You get a {struct_link} with the following attributes:
 
-*  `author_date`: Stores author creation date.
 *  `author_email`: Stores author email.
 *  `author_name`: Store author name.
+*  `authored_at`: Stores author creation date.
+*  `authored_relative_at`: Stores author creation date relative to current time.
 *  `body`: Stores body of tag which can be sentences, multiple paragraphs, and/or signature information.
+*  `committer_email`: Stores committer email.
+*  `committer_name`: Store committer name.
+*  `committed_at`: Stores committer creation date.
+*  `committed_relative_at`: Stores committer creation date relative to current time.
 *  `sha`: Stores the commit SHA for which this tag labels
 *  `subject`: Stores the subject.
 *  `version`: Stores the version.
@@ -280,12 +301,12 @@ Provides a simple Git repository with a single commit for testing purposes. This
 [source,ruby]
 ----
 require "gitt/rspec/shared_contexts/git_repo"
-require "refinements/pathnames"
+require "refinements/pathname"
 
 describe Demo do
   include_context "with Git repository"
 
-  using Refinements::Pathnames
+  using Refinements::Pathname
 
   it "is a demo" do
     git_repo_dir.change_dir { # Your expectation goes here. }
@@ -300,12 +321,12 @@ Provides a temporary directory (i.e. `tmp/rspec`) for creating directories and o
 [source,ruby]
 ----
 require "gitt/rspec/shared_contexts/temp_dir"
-require "refinements/pathnames"
+require "refinements/pathname"
 
 describe Demo do
   include_context "with temporary directory"
 
-  using Refinements::Pathnames
+  using Refinements::Pathname
 
   it "is a demo" do
     temp_dir.change_dir { # Your expectation goes here. }

data/gitt.gemspec

@@ -2,7 +2,7 @@
 
 Gem::Specification.new do |spec|
   spec.name = "gitt"
-  spec.version = "2.1.1"
+  spec.version = "3.0.0"
   spec.authors = ["Brooke Kuhlmann"]
   spec.email = ["brooke@alchemists.io"]
   spec.homepage = "https://alchemists.io/projects/gitt"
@@ -22,10 +22,10 @@ Gem::Specification.new do |spec|
   spec.signing_key = Gem.default_key_path
   spec.cert_chain = [Gem.default_cert_path]
 
-  spec.required_ruby_version = [">= 3.2", "<= 3.3"]
-  spec.add_dependency "core", "~> 0.1"
+  spec.required_ruby_version = "~> 3.3"
+  spec.add_dependency "core", "~> 1.0"
   spec.add_dependency "dry-monads", "~> 1.6"
-  spec.add_dependency "refinements", "~> 11.0"
+  spec.add_dependency "refinements", "~> 12.0"
   spec.add_dependency "zeitwerk", "~> 2.6"
 
   spec.extra_rdoc_files = Dir["README*", "LICENSE*"]

data/lib/gitt/commands/branch.rb

@@ -1,20 +1,25 @@
 # frozen_string_literal: true
 
+require "dry/monads"
+
 module Gitt
   module Commands
     # A Git branch command wrapper.
     class Branch
+      include Dry::Monads[:result]
+
       def initialize shell: SHELL
         @shell = shell
       end
 
-      def default
+      def default fallback = "main"
         shell.call("config", "init.defaultBranch")
              .fmap(&:chomp)
-             .fmap { |name| name.empty? ? "main" : name }
+             .fmap { |name| name.empty? ? fallback : name }
+             .or(Success(fallback))
       end
 
-      def call(*arguments) = shell.call "branch", *arguments
+      def call(*) = shell.call("branch", *)
 
       def name = shell.call("rev-parse", "--abbrev-ref", "HEAD").fmap(&:chomp)
 

data/lib/gitt/commands/config.rb

@@ -13,18 +13,16 @@ module Gitt
         @shell = shell
       end
 
-      def call(*arguments) = shell.call "config", *arguments
+      def call(*) = shell.call("config", *)
 
-      def get key, fallback = Core::EMPTY_STRING, *arguments
-        call(*arguments, "--get", key).fmap(&:chomp)
-                                      .or do |error|
-                                        block_given? ? yield(error) : Success(fallback)
-                                      end
+      def get(key, fallback = Core::EMPTY_STRING, *)
+        call(*, "--get", key).fmap(&:chomp)
+                             .or { |error| block_given? ? yield(error) : Success(fallback) }
       end
 
       def origin? = !get("remote.origin.url").value_or(Core::EMPTY_STRING).empty?
 
-      def set(key, value, *arguments) = call(*arguments, "--add", key, value).fmap { value }
+      def set(key, value, *) = call(*, "--add", key, value).fmap { value }
 
       private
 

data/lib/gitt/commands/log.rb

@@ -18,6 +18,8 @@ module Gitt
         committed_relative_at: "%cr",
         committer_email: "%ce",
         committer_name: "%cn",
+        encoding: "%e",
+        notes: "%N",
         raw: "%B",
         sha: "%H",
         signature: "%G?",
@@ -25,18 +27,18 @@ module Gitt
         trailers: "%(trailers)"
       }.freeze
 
-      def initialize shell: SHELL, key_map: KEY_MAP, parser: Parsers::Commit
+      def initialize shell: SHELL, key_map: KEY_MAP, parser: Parsers::Commit.new
         @shell = shell
         @key_map = key_map
         @parser = parser
       end
 
-      def call(*arguments) = shell.call "log", *arguments
+      def call(*) = shell.call("log", *)
 
       def index *arguments
-        arguments.prepend(pretty_format)
+        arguments.prepend("--shortstat", pretty_format)
                  .then { |pretty_format| call(*pretty_format) }
-                 .fmap { |content| String(content).scrub("?").split %("\n") }
+                 .fmap { |content| String(content).scrub("?") }
                  .fmap { |entries| build_records entries }
       end
 
@@ -58,7 +60,24 @@ module Gitt
                .then { |structure| %(--pretty=format:"#{structure}") }
       end
 
-      def build_records(entries) = entries.map { |entry| parser.call(entry) }
+      def build_records entries
+        wrap_statistics entries
+        add_empty_statistics entries
+        entries.split("<break/>").map { |entry| parser.call entry }
+      end
+
+      # :reek:UtilityFunction
+      def wrap_statistics entries
+        entries.gsub!(/\d+\sfile.+\d+\s(insertion|deletion).+\n/) do |match|
+          "<statistics>#{match}</statistics><break/>"
+        end
+      end
+
+      # :reek:UtilityFunction
+      def add_empty_statistics entries
+        entries.gsub! %(</trailers>\n"\n"<author_email>),
+                      "</trailers>\n<statistics></statistics>\n<author_email>"
+      end
     end
   end
 end

data/lib/gitt/commands/tag.rb

@@ -31,7 +31,7 @@ module Gitt
         @parser = parser
       end
 
-      def call(*arguments) = shell.call "tag", *arguments
+      def call(*) = shell.call("tag", *)
 
       def create version, body = Core::EMPTY_STRING, *flags
         return Failure "Unable to create Git tag without version." unless version
@@ -53,9 +53,15 @@ module Gitt
       end
 
       def last
-        shell.call("describe", "--abbrev=0", "--tags", "--always")
+        shell.call("describe", "--abbrev=0", "--tags")
              .fmap(&:strip)
-             .or { |error| Failure error.delete_prefix("fatal: ").chomp }
+             .or do |error|
+               if error.match?(/no names found/i)
+                 Failure "No tags found."
+               else
+                 Failure error.delete_prefix("fatal: ").chomp
+               end
+             end
       end
 
       def local? version

data/lib/gitt/directable.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Gitt
+  # Provides shared behavior for objects that can act like a commit.
+  module Directable
+    def directive? = amend? || fixup? || squash?
+
+    def amend? = subject.match?(/\Aamend!\s/)
+
+    def fixup? = subject.match?(/\Afixup!\s/)
+
+    def squash? = subject.match?(/\Asquash!\s/)
+
+    def prefix = subject[/\A[\w\!]+/]
+  end
+end

data/lib/gitt/models/commit.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require "dry/monads"
+
 module Gitt
   module Models
     # Represents commit details.
@@ -15,25 +17,43 @@ module Gitt
       :committed_relative_at,
       :committer_email,
       :committer_name,
+      :deletions,
+      :encoding,
+      :files_changed,
+      :insertions,
       :lines,
+      :notes,
       :raw,
       :sha,
       :signature,
       :subject,
       :trailers
     ) do
+      include Directable
+      include Dry::Monads[:result]
+
       def initialize(**)
         super
         freeze
       end
 
-      def amend? = subject.match?(/\Aamend!\s/)
+      def find_trailer key
+        trailers.find { |trailer| trailer.key == key }
+                .then do |trailer|
+                  return Success trailer if trailer
 
-      def fixup? = subject.match?(/\Afixup!\s/)
+                  Failure "Unable to find trailer for key: #{key.inspect}."
+                end
+      end
+
+      def find_trailers key
+        trailers.select { |trailer| trailer.key == key }
+                .then { |trailers| Success trailers }
+      end
 
-      def squash? = subject.match?(/\Asquash!\s/)
+      def trailer_value_for(key) = find_trailer(key).fmap(&:value)
 
-      def prefix? = amend? || fixup? || squash?
+      def trailer_values_for(key) = find_trailers(key).fmap { |trailers| trailers.map(&:value) }
     end
   end
 end

data/lib/gitt/models/person.rb

@@ -1,17 +1,25 @@
 # frozen_string_literal: true
 
+require "core"
+
 module Gitt
   module Models
     # Represents a person within a repository.
-    Person = Struct.new :name, :delimiter, :email do
+    Person = Data.define :name, :delimiter, :email do
       def self.for(string, parser: Parsers::Person.new) = parser.call string
 
-      def initialize(**)
+      def initialize name: nil, delimiter: " ", email: nil
         super
-        freeze
       end
 
-      def to_s = values.join
+      def to_s
+        case self
+          in String, String, String then "#{name}#{delimiter}<#{email}>"
+          in String, String, nil then name
+          in nil, String, String then "<#{email}>"
+          else Core::EMPTY_STRING
+        end
+      end
     end
   end
 end

data/lib/gitt/models/trailer.rb

@@ -3,15 +3,14 @@
 module Gitt
   module Models
     # Represents commit trailer details.
-    Trailer = Struct.new :key, :delimiter, :space, :value, keyword_init: true do
+    Trailer = Data.define :key, :delimiter, :space, :value do
       def self.for(string, parser: Parsers::Trailer.new) = parser.call string
 
-      def initialize(**)
+      def initialize key:, value:, delimiter: ":", space: " "
         super
-        freeze
       end
 
-      def to_s = values.join
+      def to_s = to_h.values.join
     end
   end
 end

data/lib/gitt/parsers/attributer.rb

@@ -6,23 +6,25 @@ module Gitt
   module Parsers
     # Extracts attributes from XML formatted content.
     class Attributer
-      def self.with(...) = new(...)
-
       def initialize keys = Core::EMPTY_ARRAY
         @keys = keys
       end
 
       def call content
-        scrub = String(content).scrub "?"
-
-        keys.reduce({}) do |attributes, key|
-          attributes.merge key => scrub[%r(<#{key}>(?<value>.*?)</#{key}>)m, :value]
-        end
+        build String(content)
+      rescue ArgumentError => error
+        error.message.include?("invalid byte") ? build(content.scrub("?")) : raise
       end
 
       private
 
       attr_reader :keys
+
+      def build content
+        keys.each.with_object({}) do |key, attributes|
+          attributes[key] = content[%r(<#{key}>(?<value>.*?)</#{key}>)m, :value]
+        end
+      end
     end
   end
 end

data/lib/gitt/parsers/commit.rb

@@ -1,16 +1,14 @@
 # frozen_string_literal: true
 
-require "refinements/hashes"
+require "refinements/hash"
 
 module Gitt
   module Parsers
     # Parses raw commit information to produce a commit record.
     class Commit
-      using Refinements::Hashes
+      using Refinements::Hash
 
-      def self.call(...) = new.call(...)
-
-      def initialize attributer: Attributer.with(Commands::Log::KEY_MAP.keys),
+      def initialize attributer: Attributer.new(Commands::Log::KEY_MAP.keys.append(:statistics)),
                      sanitizers: Sanitizers::CONTAINER,
                      model: Models::Commit
         @attributer = attributer
@@ -18,11 +16,14 @@ module Gitt
         @model = model
       end
 
+      # rubocop:todo Layout/LineLength
       def call content
         attributer.call(content)
                   .then { |attributes| process attributes }
+                  .then { |attributes| attributes.merge! statistic_sanitizer.call(attributes.delete(:statistics)) }
                   .then { |attributes| model[**attributes] }
       end
+      # rubocop:enable Layout/LineLength
 
       private
 
@@ -64,6 +65,8 @@ module Gitt
 
       def scissors_sanitizer = sanitizers.fetch :scissors
 
+      def statistic_sanitizer = sanitizers.fetch :statistic
+
       def signature_sanitizer = sanitizers.fetch :signature
 
       def trailers_sanitizer = sanitizers.fetch :trailers

data/lib/gitt/parsers/person.rb

@@ -2,26 +2,28 @@
 
 module Gitt
   module Parsers
-    # Parses raw trailer data to produce a trailer record.
+    # Parses trailer to produce a person.
     class Person
-      PATTERN = /
-        \A                 # Start of line.
-        (?<name>.*?)       # Name (smallest possible).
-        (?<delimiter>\s?)  # Space delimiter (optional).
-        (?<email><.+>)?    # Collaborator email (optional).
-        \Z                 # End of line.
-      /x
-
-      def initialize model: Models::Person, pattern: PATTERN
-        @pattern = pattern
+      def initialize email_start: "<", email_end: ">", model: Models::Person
+        @email_start = email_start
+        @email_end = email_end
         @model = model
       end
 
-      def call(content) = model[**content.match(pattern).named_captures]
+      def call content
+        if content.start_with? email_start
+          model[email: content.delete_prefix(email_start).delete_suffix(email_end)]
+        else
+          name, email = content.split " #{email_start}"
+          email.delete_suffix! email_end if email
+
+          model[name:, email:]
+        end
+      end
 
       private
 
-      attr_reader :pattern, :model
+      attr_reader :email_start, :email_end, :model
     end
   end
 end

data/lib/gitt/parsers/tag.rb

@@ -1,14 +1,14 @@
 # frozen_string_literal: true
 
-require "refinements/hashes"
+require "refinements/hash"
 
 module Gitt
   module Parsers
     # Parses raw tag information to produce a tag record.
     class Tag
-      using Refinements::Hashes
+      using Refinements::Hash
 
-      def initialize attributer: Attributer.with(Commands::Tag::KEY_MAP.keys),
+      def initialize attributer: Attributer.new(Commands::Tag::KEY_MAP.keys),
                      sanitizers: Sanitizers::CONTAINER,
                      model: Models::Tag
         @attributer = attributer

data/lib/gitt/parsers/trailer.rb

@@ -12,20 +12,21 @@ module Gitt
         \Z                   # End of line.
       /x
 
-      def initialize model: Models::Trailer, pattern: PATTERN
+      def initialize pattern: PATTERN, model: Models::Trailer
         @pattern = pattern
         @model = model
+        @empty = model[key: nil, value: nil].to_h
       end
 
       def call content
         content.match(pattern)
-               .then { |data| data ? data.named_captures : {} }
+               .then { |data| data ? data.named_captures(symbolize_names: true) : empty }
                .then { |attributes| model[**attributes] }
       end
 
       private
 
-      attr_reader :pattern, :model
+      attr_reader :pattern, :model, :empty
     end
   end
 end

data/lib/gitt/repository.rb

@@ -20,7 +20,7 @@ module Gitt
 
     def branch(...) = commands.fetch(__method__).call(...)
 
-    def branch_default = commands.fetch(:branch).default
+    def branch_default(...) = commands.fetch(:branch).default(...)
 
     def branch_name = commands.fetch(:branch).name
 

data/lib/gitt/rspec/shared_contexts/git_repo.rb

@@ -3,7 +3,7 @@
 RSpec.shared_context "with Git repository" do
   include_context "with temporary directory"
 
-  using Refinements::Pathnames
+  using Refinements::Pathname
 
   let(:git_repo_dir) { temp_dir.join "test" }
 

data/lib/gitt/rspec/shared_contexts/temp_dir.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 RSpec.shared_context "with temporary directory" do
-  using Refinements::Pathnames
+  using Refinements::Pathname
 
   let(:temp_dir) { Bundler.root.join "tmp", "rspec" }
 

data/lib/gitt/sanitizers/container.rb

@@ -9,6 +9,7 @@ module Gitt
       paragraphs: Paragraphs,
       scissors: Scissors,
       signature: Signature,
+      statistic: Statistic.new,
       trailers: Trailers.new
     }.freeze
   end

data/lib/gitt/sanitizers/date.rb

@@ -1,7 +1,9 @@
 # frozen_string_literal: true
 
+require "core"
+
 module Gitt
   module Sanitizers
-    Date = -> value { value.sub(/\s.+\Z/, "") if value }
+    Date = -> value { value.sub(/\s.+\Z/, Core::EMPTY_STRING) if value }
   end
 end

data/lib/gitt/sanitizers/email.rb

@@ -1,7 +1,9 @@
 # frozen_string_literal: true
 
+require "core"
+
 module Gitt
   module Sanitizers
-    Email = -> value { value.tr "<>", "" if value }
+    Email = -> value { value.tr "<>", Core::EMPTY_STRING if value }
   end
 end

data/lib/gitt/sanitizers/scissors.rb

@@ -1,7 +1,9 @@
 # frozen_string_literal: true
 
+require "core"
+
 module Gitt
   module Sanitizers
-    Scissors = -> value { value.sub(/^#\s-.+\s>8\s-.+/m, "") if value }
+    Scissors = -> value { value.sub(/^#\s-.+\s>8\s-.+/m, Core::EMPTY_STRING) if value }
   end
 end

data/lib/gitt/sanitizers/statistic.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+module Gitt
+  module Sanitizers
+    # Converts raw text into a statistics hash.
+    class Statistic
+      EMPTY = {files_changed: 0, insertions: 0, deletions: 0}.freeze
+
+      PATTERN = /
+        (?<total>\d+)                     # Total capture group.
+        \s                                # Space delimiter.
+        (?<kind>file|insertion|deletion)  # Kind capture group.
+      /x
+
+      def initialize empty: EMPTY, pattern: PATTERN
+        @empty = empty
+        @pattern = pattern
+      end
+
+      # :reek:TooManyStatements
+      def call text
+        return empty unless text
+
+        text.scan(pattern).each.with_object(empty.dup) do |(number, kind), stats|
+          total = number.to_i
+
+          case kind
+            when "file" then stats[:files_changed] = total
+            when "insertion" then stats[:insertions] = total
+            when "deletion" then stats[:deletions] = total
+            # :nocov:
+          end
+        end
+      end
+
+      private
+
+      attr_reader :empty, :pattern
+    end
+  end
+end

data/lib/gitt/shell.rb

@@ -12,8 +12,8 @@ module Gitt
       @client = client
     end
 
-    def call(...)
-      client.capture3("git", ...).then do |stdout, stderr, status|
+    def call(*, **)
+      client.capture3("git", *, **).then do |stdout, stderr, status|
         status.success? ? Success(stdout) : Failure(stderr)
       end
     end

data/lib/gitt.rb

@@ -17,4 +17,6 @@ module Gitt
   def self.loader registry = Zeitwerk::Registry
     @loader ||= registry.loaders.find { |loader| loader.tag == File.basename(__FILE__, ".rb") }
   end
+
+  def self.new(...) = Repository.new(...)
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: gitt
 version: !ruby/object:Gem::Version
-  version: 2.1.1
+  version: 3.0.0
 platform: ruby
 authors:
 - Brooke Kuhlmann
@@ -35,7 +35,7 @@ cert_chain:
   3n5C8/6Zh9DYTkpcwPSuIfAga6wf4nXc9m6JAw8AuMLaiWN/r/2s4zJsUHYERJEu
   gZGm4JqtuSg8pYjPeIJxS960owq+SfuC+jxqmRA54BisFCv/0VOJi7tiJVY=
   -----END CERTIFICATE-----
-date: 2023-11-16 00:00:00.000000000 Z
+date: 2024-01-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: core
@@ -43,14 +43,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.1'
+        version: '1.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.1'
+        version: '1.0'
 - !ruby/object:Gem::Dependency
   name: dry-monads
   requirement: !ruby/object:Gem::Requirement
@@ -71,14 +71,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '11.0'
+        version: '12.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '11.0'
+        version: '12.0'
 - !ruby/object:Gem::Dependency
   name: zeitwerk
   requirement: !ruby/object:Gem::Requirement
@@ -110,6 +110,7 @@ files:
 - lib/gitt/commands/config.rb
 - lib/gitt/commands/log.rb
 - lib/gitt/commands/tag.rb
+- lib/gitt/directable.rb
 - lib/gitt/models/commit.rb
 - lib/gitt/models/person.rb
 - lib/gitt/models/tag.rb
@@ -130,6 +131,7 @@ files:
 - lib/gitt/sanitizers/paragraphs.rb
 - lib/gitt/sanitizers/scissors.rb
 - lib/gitt/sanitizers/signature.rb
+- lib/gitt/sanitizers/statistic.rb
 - lib/gitt/sanitizers/trailers.rb
 - lib/gitt/shell.rb
 homepage: https://alchemists.io/projects/gitt
@@ -149,10 +151,7 @@ require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">="
-    - !ruby/object:Gem::Version
-      version: '3.2'
-  - - "<="
+  - - "~>"
     - !ruby/object:Gem::Version
       version: '3.3'
 required_rubygems_version: !ruby/object:Gem::Requirement
@@ -161,7 +160,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.22
+rubygems_version: 3.5.3
 signing_key:
 specification_version: 4
 summary: A monadic Object API for the Git CLI.