committer 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: bb99452bb04729fa6e0d6c2437222c3ef83ade61c7985b0bcef8ffb418f04166
+  data.tar.gz: 4f4f26950244b3ed7776e3764c8fb6a8b73c8178c4c03dad55357403a076875b
+SHA512:
+  metadata.gz: b707c336ca8247e1cf685d264958f83fff4cd93945bf85efb63e98f13855217d1bfe7df8acbd9562ec9ca2ac537a70c8a6d699ec89eff70cfc20e58dee6e7648
+  data.tar.gz: 96fe270231433a099e89cb59f63f2ff7accd752c808f0bce83535785a2e78d61744a43b36c442f225c8e819fd931991ff844f1efdb4eea26872c269c80a00c40

data/README.md

@@ -0,0 +1,84 @@
+# Committer
+
+An AI-powered git commit message generator using Claude.
+
+## Overview
+
+Committer uses Claude AI to analyze your staged git changes and generate conventional commit messages for you. It detects the type of changes (feature, fix, refactor, etc.) and creates a well-formatted commit message that follows best practices.
+
+## Installation
+
+### Install from RubyGems
+
+```bash
+gem install committer
+```
+
+### Manual Installation
+
+1. Install Bundler if you haven't already:
+
+   ```sh
+   gem install bundler
+   ```
+
+2. Install the project dependencies:
+   ```sh
+   bundle install
+   ```
+
+3. Link the executable:
+   ```bash
+   gem build committer.gemspec
+   gem install committer-0.1.0.gem
+   ```
+
+## Configuration
+
+Before using Committer, you need to set up your configuration file:
+
+```bash
+committer setup
+```
+
+This will create a template config file at `~/.committer/config.yml`.
+
+Next, edit this file to add your Anthropic API key and optionally change the model:
+
+```yaml
+api_key: your_anthropic_api_key_here
+model: claude-3-sonnet-20240229
+```
+
+You only need to do this setup once.
+
+## Usage
+
+When you have changes staged in git (after running `git add`), simply run:
+
+```bash
+committer
+```
+
+This will:
+1. Get the diff of your staged changes
+2. Send it to Claude for analysis
+3. Generate a commit message in conventional format
+4. Open your default git editor with the suggested message
+5. Allow you to edit the message if needed or simply save to confirm
+
+## Commands
+
+- `committer` - Generate commit message for staged changes
+- `committer setup` - Create the config file template
+- `committer help` - Display help information
+
+You can also run it directly through git:
+
+```bash
+git smart-commit
+```
+
+## License
+
+MIT

data/bin/committer

@@ -0,0 +1,98 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'bundler/setup'
+require 'open3'
+require 'httparty'
+require 'yaml'
+require_relative '../lib/committer/config'
+require_relative '../lib/clients/claude_client'
+
+# Handle command line arguments
+command = ARGV[0]
+
+case command
+when 'setup'
+  Committer::Config.setup
+  exit 0
+
+when 'help', '--help', '-h'
+  puts 'Committer - AI-powered git commit message generator'
+  puts
+  puts 'Commands:'
+  puts '  committer setup  - Create the config file template at ~/.committer/config.yml'
+  puts '  committer        - Generate commit message for staged changes'
+  puts
+  exit 0
+end
+
+# Default behavior: generate commit message
+def execute_git_diff_staged
+  stdout, stderr, status = Open3.capture3('git diff --staged')
+
+  if status.success?
+    if stdout.empty?
+      puts 'No changes are staged for commit.'
+      exit 0
+    else
+      begin
+        client = Clients::ClaudeClient.new
+        puts 'Sending diff to Claude...'
+
+        prompt = <<~PROMPT
+          Below is a git diff of staged changes. Please analyze it and create a commit message following the Conventional Commits format:
+
+          Format: <type>(<optional scope>): <description>
+
+          Types:
+          - feat: A new feature
+          - fix: A bug fix
+          - docs: Documentation only changes
+          - style: Changes that do not affect the meaning of the code
+          - refactor: A code change that neither fixes a bug nor adds a feature
+          - perf: A code change that improves performance
+          - test: Adding missing tests or correcting existing tests
+          - chore: Changes to the build process or auxiliary tools
+
+          Guidelines:
+          - Keep the first line under 70 characters
+          - Use imperative, present tense (e.g., "add" not "added" or "adds")
+          - Do not end with a period
+          - Be concise but descriptive
+
+          Git Diff:
+          ```
+          #{stdout}
+          ```
+
+          Respond ONLY with the commit message text, nothing else.
+        PROMPT
+
+        response = client.post(prompt)
+        commit_message = begin
+          response.dig('content', 0, 'text')
+        rescue StandardError
+          response.inspect
+        end
+
+        puts "\nOpening git commit with the suggested message..."
+
+        # Create git commit with the suggested message and open in editor
+        system('git', 'commit', '-m', commit_message, '-e')
+      rescue Clients::ClaudeClient::ConfigError => e
+        puts "Error: #{e.message}"
+        exit 1
+      rescue StandardError => e
+        puts "Error: #{e.message}"
+        exit 1
+      end
+    end
+  else
+    puts 'Error executing git diff --staged:'
+    puts stderr
+    exit 1
+  end
+end
+
+# Execute the function if no specific command was given
+execute_git_diff_staged

data/bin/git-smart-commit

@@ -0,0 +1,8 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# This is a git integration script that allows users to run:
+# git smart-commit
+# which will forward to the committer command
+
+require_relative 'committer'

data/lib/clients/claude_client.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+require 'json'
+require 'httparty'
+require_relative '../committer/config'
+
+module Clients
+  class ClaudeClient
+    class OverloadError < StandardError; end
+    class UnknownError < StandardError; end
+    class ConfigError < StandardError; end
+
+    def initialize
+      @config = Committer::Config.load
+
+      return unless @config['api_key'].nil? || @config['api_key'].empty?
+
+      raise ConfigError,
+            "API key not configured. Run 'committer setup' and edit ~/.committer/config.yml to add your API key."
+    end
+
+    def post(message)
+      body = {
+        'model': @config['model'],
+        'max_tokens': 4096,
+        'messages': [
+          { 'role': 'user', 'content': message }
+        ]
+      }
+      options = {
+        headers: {
+          'anthropic-version': '2023-06-01',
+          'content-type': 'application/json',
+          'x-api-key': @config['api_key']
+        },
+        body: body.to_json
+      }
+      response = HTTParty.post(
+        'https://api.anthropic.com/v1/messages', options
+      )
+      if response['type'] == 'error'
+        error = response['error']
+        raise OverloadError if error['type'] == 'overloaded_error'
+
+        puts response
+        raise UnknownError, "Claude API error: #{response.inspect}"
+      end
+      response
+    end
+  end
+end

data/lib/committer/config.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+require 'yaml'
+require 'fileutils'
+
+module Committer
+  class Config
+    CONFIG_DIR = File.join(Dir.home, '.committer')
+    CONFIG_FILE = File.join(CONFIG_DIR, 'config.yml')
+    DEFAULT_CONFIG = {
+      'api_key' => nil,
+      'model' => 'claude-3-sonnet-20240229'
+    }.freeze
+
+    def self.load
+      create_default_config unless File.exist?(CONFIG_FILE)
+      begin
+        YAML.load_file(CONFIG_FILE) || DEFAULT_CONFIG
+      rescue StandardError => e
+        puts "Error loading config: #{e.message}"
+        DEFAULT_CONFIG
+      end
+    end
+
+    def self.create_default_config
+      FileUtils.mkdir_p(CONFIG_DIR) unless Dir.exist?(CONFIG_DIR)
+      File.write(CONFIG_FILE, DEFAULT_CONFIG.to_yaml)
+    end
+
+    def self.setup
+      create_default_config
+      puts 'Created config file at:'
+      puts CONFIG_FILE
+      puts "\nPlease edit this file to add your Anthropic API key."
+      puts 'Example config format:'
+      puts '---'
+      puts 'api_key: your_api_key_here'
+      puts 'model: claude-3-sonnet-20240229'
+    end
+  end
+end

data/lib/committer/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Committer
+  VERSION = '0.1.0'
+end

metadata

@@ -0,0 +1,65 @@
+--- !ruby/object:Gem::Specification
+name: committer
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Sebastien Stettler
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2025-03-05 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: httparty
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.20'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.20'
+description: A tool that uses Claude API to generate conventional commit messages
+  based on staged changes
+email:
+- sebastien@managerbot.dev
+executables:
+- git-smart-commit
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- bin/committer
+- bin/git-smart-commit
+- lib/clients/claude_client.rb
+- lib/committer/config.rb
+- lib/committer/version.rb
+homepage: https://github.com/Hyper-Unearthing/committer
+licenses:
+- MIT
+metadata: {}
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.6.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.22
+signing_key:
+specification_version: 4
+summary: AI-powered git commit message generator using Claude
+test_files: []