gitt 3.12.0 → 4.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f1c6fdd2f657d51c18a3a0886351529fe259f36e6a75ed618b250bbe27a29715
-  data.tar.gz: f8ddf8f2f56d1aa092c25e00636b8ef6f3b767e2b4dc5d7df1ea1287e3d02a1f
+  metadata.gz: cf995a1e83d2a4b629d45413b6368c0597ee4860bea8116537114a93ee4dfbb4
+  data.tar.gz: b83e9922914f836999e24aecaa9204aa112e50fd9d8b3a44397b202b3e257ecb
 SHA512:
-  metadata.gz: 8246fdb37693e702974504a4fc3af1198b50b33299b34be52be26ebe0bcece7acbc802af5cc461a09184913dfaa5bba4b4b8fbfda1ae286fcb2670d5fd2c26ca
-  data.tar.gz: fa8dc14d97590cc2ef83ea0673599cf759413b3916272bb0fea6a6e2e8b6b84743614b5d45bc95901369bd595e93749380962cd8f0ba348a8a7c02d9fd419f6b
+  metadata.gz: af182dd15da70427375a655da1b74d74bb15fa3980bc954f931b591c84bf6cf0fb87aea892b42f65e70ea22b8680dfef2979ed96430f57b1d27fd20dc2af9954
+  data.tar.gz: b8f3056ba6fa218c79c663d0536404db6f4dd7d061f8c1b45ee3c67a6cf958e143c665c840b00d86d9e659b46643b74bb41a9ec419891eeff683072de008c597

data/README.adoc

@@ -8,13 +8,13 @@
 
 = Gitt
 
-Provides a monadic Object API to the {git_link} CLI. This project is also an extraction of work originally implemented within the following projects:
+Provides a monadic Object API around the {git_link} CLI with full access to all functionality found when using Git natively. This includes convenience methods for answering fully parsed and enhanced commits, tags, trailers, and so forth. This project is an extraction of work originally implemented within the following projects:
 
 * link:https://alchemists.io/projects/git-lint[Git Lint]
 * link:https://alchemists.io/projects/milestoner[Milestoner]
 * link:https://alchemists.io/projects/rubysmith[Rubysmith]
 
-This project doesn't try to encompass the vast feature set natively provided by {git_link} but only exposes the most used features, limited as this may be. Over time, more of the {git_link} feature set will be implemented but it'll most likely happen slowly and organically. If you are looking for alternatives to this gem, then you might find the following of interest:
+If you are looking for alternatives to this gem, then you might find the following of interest:
 
 * link:https://github.com/ruby-git/ruby-git[Ruby Git]
 * link:https://github.com/libgit2/rugged[Rugged]
@@ -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 link:https://alchemists.io/projects/transactable[pipe] together for more complex workflows.
+* Answers link:https://dry-rb.org/gems/dry-monads[monads] you can link:https://alchemists.io/articles/ruby_function_composition[pipe] together for more complex workflows.
 * Provides _optional_ {rspec_link} shared contexts that speed up the testing of your own Git related implementations.
 
 == Requirements
@@ -47,20 +47,22 @@ At a high level, this project provides a centralized Object API via a single obj
 
 [source,ruby]
 ----
-git = Gitt::Repository.new
+git = Gitt.new
 
 git.branch          # Equivalent to `git branch <arguments>`.
 git.branch_default  # Answers default branch.
 git.branch_name     # Answers current branch.
 git.call            # Allows you to run any Git command.
-git.commits         # Answers commit records.
+git.commits         # Answers enhanced commit records.
 git.config          # Equivalent to `git config <arguments>`.
 git.exist?          # Answers if current directory is a Git repository or not.
 git.get             # Equivalent to `git config get`.
+git.inspect         # Allows you to inspect the current instance.
 git.log             # Equivalent to `git log <arguments>`.
 git.origin?         # Answers if repository has an origin or not.
 git.set             # Equivalent to `get config set`.
 git.tag             # Equivalent to `git tag <arguments>`.
+git.tags            # Answers enhanced tag records.
 git.tag?            # Answers if local or remote tag exists.
 git.tag_create      # Create a new tag.
 git.tag_last        # Answers last tag created.
@@ -68,16 +70,14 @@ git.tag_local?      # Answers if local tag exists?
 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.
-
+git.uncommitted     # Parses `COMMIT_EDITMSG` file and answers the 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 specific commands which are enhanced further:
+Should you want to use individual commands instead of interacting with the `Gitt` object, you
+can leverage any of the objects in the `Commands` namespace which -- at a minimum -- use the link:https://alchemists.io/articles/command_pattern[Command Pattern]. Here are the specific commands which are enhanced further:
 
 ==== link:https://git-scm.com/docs/git-branch[Branch]
 
@@ -148,7 +148,7 @@ The second, is:
 commit log.uncommitted ".git/COMMIT_EDITMSG"
 ----
 
-The above will answer a single commit record. This is great for building a commit object from an unsaved commit message. The only disadvantage of this approach is that you will get template commits which are always stripped out by Git when processing a _saved_ commit.
+The above will answer a single commit record. This is great for building a commit object from an unsaved commit message. The only disadvantage to this approach is you will get template commits which are always stripped out by Git when processing a _saved_ commit.
 
 ==== link:https://git-scm.com/docs/git-tag[Tag]
 
@@ -168,6 +168,9 @@ 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"
 
+# Answers enhanced tag records. Can take any argument accepted with `--list`.
+tag.index
+
 # Answers last tag for git.
 tag.last
 
@@ -197,30 +200,30 @@ An instance of `Gitt::Models::Commit` is what is answered back to when using `Gi
 
 [source,ruby]
 ----
-# #<Struct:Gitt::Models::Commit:0x0001d4e8
-#   author_email = "demo@example.io",
+# #<Struct:Gitt::Models::Commit:0x00015c70
+#   author_email = "brooke@alchemists.io",
 #   author_name = "Brooke Kuhlmann",
-#   authored_at = "1720130186",
-#   authored_relative_at = "33 seconds ago",
+#   authored_at = "1731517717",
+#   authored_relative_at = "28 seconds ago",
 #   body = "",
 #   body_lines = [],
 #   body_paragraphs = [],
-#   committed_at = "1720130186",
-#   committed_relative_at = "33 seconds ago",
-#   committer_email = "demo@example.io",
+#   committed_at = "1731517717",
+#   committed_relative_at = "28 seconds ago",
+#   committer_email = "brooke@alchemists.io",
 #   committer_name = "Brooke Kuhlmann",
-#   deletions = 3,
+#   deletions = 11,
 #   encoding = "",
-#   files_changed = 3,
+#   files_changed = 1,
 #   fingerprint = "F2BC49BC4FFB9A48",
 #   fingerprint_key = "D1488588D2DEDF73E62F07A1F2BC49BC4FFB9A48",
-#   insertions = 9,
+#   insertions = 14,
 #   lines = [
 #     "Added version release notes"
 #   ],
 #   notes = "",
 #   raw = "Added version release notes\n",
-#   sha = "49e033d7020068630fd3823a29c2eb8a1ef01770",
+#   sha = "0f1e2387ed89d6dab95af384096c95bc04b28e9b",
 #   signature = "Good",
 #   subject = "Added version release notes",
 #   trailers = []
@@ -241,7 +244,7 @@ You get a {struct_link} with the following attributes:
 * `committer_email`: Stores the committer email.
 * `committer_name`: Stores the committer name.
 * `deletions`: Stores number of deleted lines.
-* `encoding`: Stored encoding. Blank if UTF-8 andf filled if otherwise.
+* `encoding`: Stored encoding. Blank if UTF-8 and filled if otherwise.
 * `files_changed`: Stores number of files changed.
 * `fingerprint`: Stores the fingerprint used when creating a secure commit.
 * `fingerprint_key`: Stores the fingerprint key used when creating a secure commit.
@@ -252,7 +255,7 @@ You get a {struct_link} with the following attributes:
 * `sha`: Stores the commit SHA.
 * `signature`: Stores the signature type and level of security.
 * `subject`: Stores the commit subject.
-* `trailers`: Stores any commit trailers as an array of `Gitt::Models::Trailer` records.
+* `trailers`: Stores trailers as an array of `Gitt::Models::Trailer` records.
 
 ==== Tag
 
@@ -260,21 +263,22 @@ An instance of `Gitt::Models::Tag` is what is answered back to when using `Gitt`
 
 [source,ruby]
 ----
-#<Struct:Gitt::Models::Tag:0x000314c0
-  author_email = "demo@example.io",
-  author_name = "Brooke Kuhlmann",
-  authored_at = "1671892451",
-  authored_relative_at = "1 year, 6 months ago",
-  body = "Example.\n\n-----BEGIN PGP SIGNATURE-----\n\niQIzBAABCAAdFiEE0UiFiNLe33PmLweh8rxJvE/Nii2FB9wo6oc\nhVJ+beT6vnmZHKsvrqkpb1BAE10/pS8RkXjjaBmYaUIBYmG6RQ/+yUvyNjldWLuO\nBkYyUawSBT94V/ve/oYxTdylCkWj1TGYG+iP4NNnhz64rMikckY=\n=ptac\n-----END PGP SIGNATURE-----\n",
-  committed_at = "1671997684",
-  committed_relative_at = "1 year, 6 months ago",
-  committer_email = "demo@example.io",
-  committer_name = "Brooke Kuhlmann",
-  sha = "662f32b2846c7bd4f153560478f035197f5279d5",
-  signature = "-----BEGIN PGP SIGNATURE-----\n\niQIzBAABCAAdFiEE0UiFiNLe33PmLweh8rxJvE/Nii2FB9wo6oc\nhVJ+beT6vnmZHKsvrqkpb1BAE10/pS8RkXjjaBmYaUIBYmG6RQ/+yUvyNjldWLuO\nBkYyUawSBT94V/ve/oYxTdylCkWj1TGYG+iP4NNnhz64rMikckY=\n=ptac\n-----END PGP SIGNATURE-----\n",
-  subject = "Version 1.0.0",
-  version = "1.0.0"
->
+# #<Struct:Gitt::Models::Tag:0x0003a5c0
+#   author_email = "brooke@alchemists.io",
+#   author_name = "Brooke Kuhlmann",
+#   authored_at = "1671892451",
+#   authored_relative_at = "1 year, 11 months ago",
+#   body = "* Added Dry Monads gem - Brooke Kuhlmann\n\n-----BEGIN PGP SIGNATURE-----\n",
+#   committed_at = "1671997684",
+#   committed_relative_at = "1 year, 11 months ago",
+#   committer_email = "brooke@alchemists.io",
+#   committer_name = "Brooke Kuhlmann",
+#   sha = "662f32b2846c7bd4f153560478f035197f5279d5",
+#   signature = "-----BEGIN PGP SIGNATURE-----\n",
+#   subject = "Version 1.0.0",
+#   trailers = [],
+#   version = "1.0.0"
+# >
 ----
 
 You get a {struct_link} with the following attributes:
@@ -291,6 +295,7 @@ You get a {struct_link} with the following attributes:
 *  `sha`: Stores the commit SHA for which this tag labels
 *  `signature`: Stores the signature when the tag was securely created.
 *  `subject`: Stores the subject.
+*  `trailers`: Stores trailers as an array of `Gitt::Models::Trailer` records.
 *  `version`: Stores the version.
 
 ==== Trailer

data/gitt.gemspec

@@ -2,7 +2,7 @@
 
 Gem::Specification.new do |spec|
   spec.name = "gitt"
-  spec.version = "3.12.0"
+  spec.version = "4.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.3", "<= 3.4"
-  spec.add_dependency "core", "~> 1.10"
+  spec.required_ruby_version = "~> 3.4"
+  spec.add_dependency "core", "~> 2.0"
   spec.add_dependency "dry-monads", "~> 1.6"
-  spec.add_dependency "refinements", "~> 12.10"
+  spec.add_dependency "refinements", "~> 13.0"
   spec.add_dependency "zeitwerk", "~> 2.7"
 
   spec.extra_rdoc_files = Dir["README*", "LICENSE*"]

data/lib/gitt/parsers/commit.rb

@@ -57,7 +57,7 @@ module Gitt
 
       # :reek:FeatureEnvy
       def process_statistics attributes
-        attributes.merge! statistic_sanitizer.call(attributes.delete(:statistics))
+        attributes.merge! statistics_sanitizer.call(attributes.delete(:statistics))
       end
 
       def lines_sanitizer = sanitizers.fetch :lines
@@ -66,7 +66,7 @@ module Gitt
 
       def scissors_sanitizer = sanitizers.fetch :scissors
 
-      def statistic_sanitizer = sanitizers.fetch :statistic
+      def statistics_sanitizer = sanitizers.fetch :statistics
 
       def signature_sanitizer = sanitizers.fetch :signature
 

data/lib/gitt/parsers/trailer.rb

@@ -5,12 +5,12 @@ module Gitt
     # Parses raw trailer data to produce a trailer record.
     class Trailer
       PATTERN = /
-        \A               # Start of line.
-        (?<key>.+)       # Key.
-        (?<delimiter>:)  # Colon delimiter.
-        (?<space>\s?)    # Space (optional).
-        (?<value>.*?)    # Value.
-        \Z               # End of line.
+        \A                   # Start of line.
+        (?<key>[a-zA-Z\-]+)  # Key.
+        (?<delimiter>:)      # Delimiter (colon).
+        (?<space>\s?)        # Space (optional).
+        (?<value>.*?)        # Value.
+        \Z                   # End of line.
       /x
 
       EMPTY = Models::Trailer[key: nil, value: nil]

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

@@ -24,6 +24,6 @@ RSpec.shared_context "with Git repository" do
 
     example.run
 
-    temp_dir.remove_tree
+    temp_dir.rmtree
   end
 end

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

@@ -1,13 +1,11 @@
 # frozen_string_literal: true
 
 RSpec.shared_context "with temporary directory" do
-  using Refinements::Pathname
-
   let(:temp_dir) { Bundler.root.join "tmp", "rspec" }
 
   around do |example|
-    temp_dir.make_path
+    temp_dir.mkpath
     example.run
-    temp_dir.remove_tree
+    temp_dir.rmtree
   end
 end

data/lib/gitt/sanitizers/container.rb

@@ -9,7 +9,7 @@ module Gitt
       paragraphs: Paragraphs.new,
       scissors: Scissors,
       signature: Signature,
-      statistic: Statistic.new,
+      statistics: Statistics.new,
       trailers: Trailers.new,
       version: Version
     }.freeze

data/lib/gitt/sanitizers/{statistic.rb → statistics.rb}

@@ -3,7 +3,7 @@
 module Gitt
   module Sanitizers
     # Converts raw text into a statistics hash.
-    class Statistic
+    class Statistics
       EMPTY = {files_changed: 0, insertions: 0, deletions: 0}.freeze
 
       PATTERN = /
@@ -12,7 +12,7 @@ module Gitt
         (?<kind>file|insertion|deletion)  # Kind capture group.
       /x
 
-      def self.update_stats attributes, kind, total
+      def self.update attributes, kind, total
         case kind
           when "file" then attributes[:files_changed] = total
           when "insertion" then attributes[:insertions] = total
@@ -21,22 +21,22 @@ module Gitt
         end
       end
 
-      def initialize empty: EMPTY, pattern: PATTERN
-        @empty = empty
+      def initialize attributes = EMPTY, pattern: PATTERN
+        @attributes = attributes
         @pattern = pattern
       end
 
       def call text
-        return empty unless text
+        return attributes unless text
 
-        text.scan(pattern).each.with_object(empty.dup) do |(number, kind), aggregate|
-          self.class.update_stats aggregate, kind, number.to_i
+        text.scan(pattern).each.with_object(attributes.dup) do |(number, kind), aggregate|
+          self.class.update aggregate, kind, number.to_i
         end
       end
 
       private
 
-      attr_reader :empty, :pattern
+      attr_reader :attributes, :pattern
     end
   end
 end

metadata

@@ -1,11 +1,10 @@
 --- !ruby/object:Gem::Specification
 name: gitt
 version: !ruby/object:Gem::Version
-  version: 3.12.0
+  version: 4.0.0
 platform: ruby
 authors:
 - Brooke Kuhlmann
-autorequire:
 bindir: bin
 cert_chain:
 - |
@@ -35,7 +34,7 @@ cert_chain:
   3n5C8/6Zh9DYTkpcwPSuIfAga6wf4nXc9m6JAw8AuMLaiWN/r/2s4zJsUHYERJEu
   gZGm4JqtuSg8pYjPeIJxS960owq+SfuC+jxqmRA54BisFCv/0VOJi7tiJVY=
   -----END CERTIFICATE-----
-date: 2024-11-09 00:00:00.000000000 Z
+date: 2024-12-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: core
@@ -43,14 +42,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.10'
+        version: '2.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.10'
+        version: '2.0'
 - !ruby/object:Gem::Dependency
   name: dry-monads
   requirement: !ruby/object:Gem::Requirement
@@ -71,14 +70,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '12.10'
+        version: '13.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '12.10'
+        version: '13.0'
 - !ruby/object:Gem::Dependency
   name: zeitwerk
   requirement: !ruby/object:Gem::Requirement
@@ -93,7 +92,6 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '2.7'
-description:
 email:
 - brooke@alchemists.io
 executables: []
@@ -131,7 +129,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/statistics.rb
 - lib/gitt/sanitizers/trailers.rb
 - lib/gitt/sanitizers/version.rb
 - lib/gitt/shell.rb
@@ -147,16 +145,12 @@ metadata:
   label: Gitt
   rubygems_mfa_required: 'true'
   source_code_uri: https://github.com/bkuhlmann/gitt
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">="
-    - !ruby/object:Gem::Version
-      version: '3.3'
-  - - "<="
+  - - "~>"
     - !ruby/object:Gem::Version
       version: '3.4'
 required_rubygems_version: !ruby/object:Gem::Requirement
@@ -165,8 +159,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.23
-signing_key:
+rubygems_version: 3.6.2
 specification_version: 4
 summary: A monadic Object API for the Git CLI.
 test_files: []