devcommit 0.1.4.5__tar.gz → 0.1.4.7__tar.gz

{devcommit-0.1.4.5 → devcommit-0.1.4.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: devcommit
-Version: 0.1.4.5
+Version: 0.1.4.7
 Summary: AI-powered git commit message generator
 License: GNU GENERAL PUBLIC LICENSE
                                 Version 3, 29 June 2007
@@ -721,24 +721,27 @@ A command-line AI tool for autocommits.
 
 ## Installation
 
-1. **Install DevCommit**  
-   
+1. **Install DevCommit**
+
    **Option 1: Using pip (local installation)**
+
    ```bash
    pip install devcommit
    ```
-   
+
    **Option 2: Using pipx (global installation, recommended)**
+
    ```bash
    # Install pipx if you don't have it
    python3 -m pip install --user pipx
    python3 -m pipx ensurepath
-   
+
    # Install DevCommit globally
    pipx install devcommit
    ```
+
    > **💡 Why pipx?** pipx installs CLI tools in isolated environments, preventing dependency conflicts while making them globally available.
-   
+
    **All AI providers are included by default!** ✅ Gemini, OpenAI, Groq, Anthropic, Ollama, and Custom API support.
 
 2. **Set Up Configuration (Required: API Key)**  
@@ -747,31 +750,34 @@ A command-line AI tool for autocommits.
    **Priority Order:** `.dcommit` file → Environment Variables → Defaults
 
    ### Option 1: Environment Variables (Quickest)
+
    ```bash
    # Using Gemini (default)
    export GEMINI_API_KEY='your-api-key-here'
-   
+
    # Or using Groq (recommended for free tier)
    export AI_PROVIDER='groq'
    export GROQ_API_KEY='your-groq-key'
-   
+
    # Add to ~/.bashrc or ~/.zshrc for persistence
    echo "export GEMINI_API_KEY='your-key'" >> ~/.bashrc
    ```
 
    ### Option 2: .dcommit File (Home Directory)
+
    ```bash
    cat > ~/.dcommit << 'EOF'
    GEMINI_API_KEY = your-api-key-here
    LOCALE = en
    MAX_NO = 1
    COMMIT_TYPE = conventional
-   MODEL_NAME = gemini-1.5-flash
+   MODEL_NAME = gemini-2.5-flash
    COMMIT_MODE = auto
    EOF
    ```
 
    ### Option 3: .dcommit File (Virtual Environment)
+
    ```bash
    mkdir -p $VIRTUAL_ENV/config
    cat > $VIRTUAL_ENV/config/.dcommit << 'EOF'
@@ -779,7 +785,7 @@ A command-line AI tool for autocommits.
    LOCALE = en
    MAX_NO = 1
    COMMIT_TYPE = conventional
-   MODEL_NAME = gemini-1.5-flash
+   MODEL_NAME = gemini-2.0-flash-exp
    COMMIT_MODE = auto
    EOF
    ```
@@ -797,6 +803,7 @@ devcommit
 ### Basic Usage
 
 - **Stage all changes and commit:**
+
   ```bash
   devcommit --stageAll
   ```
@@ -823,6 +830,7 @@ You can set your preferred commit mode in the `.dcommit` configuration file usin
 #### Command-Line Usage
 
 - **Interactive mode (auto):** When you have changes in multiple directories, DevCommit will automatically ask if you want to:
+
   - Create one commit for all changes (global commit)
   - Create separate commits per directory
 
@@ -834,10 +842,40 @@ You can set your preferred commit mode in the `.dcommit` configuration file usin
   ```
 
 When using directory-based commits, you can:
+
 1. Select which directories to commit (use Space to select, Enter to confirm)
 2. For each selected directory, review and choose a commit message
 3. Each directory gets its own commit with AI-generated messages based on its changes
 
+### Commit Specific Files or Folders
+
+DevCommit allows you to commit specific files or folders. This is useful when you want to commit only certain changes without affecting other staged files.
+
+**Usage:**
+
+```bash
+# Commit specific files (must be staged first)
+git add file1.py file2.py
+devcommit --files file1.py file2.py
+
+# Stage and commit specific files in one command
+devcommit --stageAll --files file1.py file2.py
+
+# Commit specific folders (must be staged first)
+git add src/ tests/
+devcommit --files src/ tests/
+
+# Short form
+devcommit -s -f file1.py file2.py
+```
+
+When using `--files` or `-f`:
+
+- Without `--stageAll`: Only commits files that are already staged (filters staged files to match specified paths)
+- With `--stageAll`: Stages the specified files/folders and then commits them
+- AI generates commit messages based on changes in those files
+- Works with both individual files and entire directories
+
 ### Additional Options
 
 - `--excludeFiles` or `-e`: Exclude specific files from the diff
@@ -845,6 +883,8 @@ When using directory-based commits, you can:
 - `--commitType` or `-t`: Specify the type of commit (e.g., conventional)
 - `--stageAll` or `-s`: Stage all changes before committing
 - `--directory` or `-d`: Force directory-based commits
+- `--files` or `-f`: Stage and commit specific files or folders (can specify multiple)
+- `--push` or `-p`: Push commits to remote after committing
 
 ### Examples
 
@@ -857,24 +897,40 @@ devcommit --commitType conventional
 
 # Exclude lock files
 devcommit --excludeFiles package-lock.json yarn.lock
+
+# Stage and commit specific files
+devcommit --files file1.py file2.py
+
+# Stage and commit specific folders
+devcommit --files src/ tests/
+
+# Stage and commit multiple files and folders at once
+devcommit --files src/ file1.py tests/ config.json
+
+# Commit and push
+devcommit --push
+
+# Commit specific files and push
+devcommit --files file1.py file2.py --push
 ```
 
 ## AI Provider Support
 
 DevCommit now supports **multiple AI providers**! Choose from:
 
-| Provider | Free Tier | Speed | Quality | Get API Key |
-|----------|-----------|-------|---------|-------------|
-| 🆓 **Gemini** | 15 req/min, 1M/day | Fast | Good | [Get Key](https://aistudio.google.com/app/apikey) |
-| ⚡ **Groq** | Very generous | **Fastest** | Good | [Get Key](https://console.groq.com/keys) |
-| 🤖 **OpenAI** | $5 trial | Medium | **Best** | [Get Key](https://platform.openai.com/api-keys) |
-| 🧠 **Anthropic** | Limited trial | Medium | Excellent | [Get Key](https://console.anthropic.com/) |
-| 🏠 **Ollama** | **Unlimited** | Medium | Good | [Install](https://ollama.ai/) |
-| 🔧 **Custom** | Varies | Varies | Varies | Your server |
+| Provider         | Free Tier          | Speed       | Quality   | Get API Key                                       |
+| ---------------- | ------------------ | ----------- | --------- | ------------------------------------------------- |
+| 🆓 **Gemini**    | 15 req/min, 1M/day | Fast        | Good      | [Get Key](https://aistudio.google.com/app/apikey) |
+| ⚡ **Groq**      | Very generous      | **Fastest** | Good      | [Get Key](https://console.groq.com/keys)          |
+| 🤖 **OpenAI**    | $5 trial           | Medium      | **Best**  | [Get Key](https://platform.openai.com/api-keys)   |
+| 🧠 **Anthropic** | Limited trial      | Medium      | Excellent | [Get Key](https://console.anthropic.com/)         |
+| 🏠 **Ollama**    | **Unlimited**      | Medium      | Good      | [Install](https://ollama.ai/)                     |
+| 🔧 **Custom**    | Varies             | Varies      | Varies    | Your server                                       |
 
 ### Quick Setup Examples
 
 **Using Groq (Recommended for free tier):**
+
 ```bash
 export AI_PROVIDER=groq
 export GROQ_API_KEY='your-groq-api-key'
@@ -882,6 +938,7 @@ devcommit
 ```
 
 **Using Ollama (Local, no API key needed):**
+
 ```bash
 # Install Ollama: https://ollama.ai/
 ollama pull llama3
@@ -890,6 +947,7 @@ devcommit
 ```
 
 **Using Custom API:**
+
 ```bash
 export AI_PROVIDER=custom
 export CUSTOM_API_URL='http://localhost:8000/v1'
@@ -904,8 +962,8 @@ All configuration can be set via **environment variables** or **`.dcommit` file*
 
 ### AI Provider Settings
 
-| Variable | Description | Default | Options |
-|----------|-------------|---------|---------|
+| Variable      | Description             | Default  | Options                                                     |
+| ------------- | ----------------------- | -------- | ----------------------------------------------------------- |
 | `AI_PROVIDER` | Which AI service to use | `gemini` | `gemini`, `openai`, `groq`, `anthropic`, `ollama`, `custom` |
 
 ### Provider-Specific Settings
@@ -914,7 +972,7 @@ All configuration can be set via **environment variables** or **`.dcommit` file*
 | Variable | Description | Default |
 |----------|-------------|---------|
 | `GEMINI_API_KEY` | Google Gemini API key | - |
-| `GEMINI_MODEL` | Model name | `gemini-1.5-flash` |
+| `GEMINI_MODEL` | Model name | `gemini-2.0-flash-exp` |
 
 **OpenAI:**
 | Variable | Description | Default |
@@ -949,21 +1007,23 @@ All configuration can be set via **environment variables** or **`.dcommit` file*
 
 ### General Settings
 
-| Variable | Description | Default | Options |
-|----------|-------------|---------|---------|
-| `LOCALE` | Language for commit messages | `en-US` | Any locale code (e.g., `en`, `es`, `fr`) |
-| `MAX_NO` | Number of commit message suggestions | `1` | Any positive integer |
-| `COMMIT_TYPE` | Style of commit messages | `general` | `general`, `conventional`, etc. |
-| `COMMIT_MODE` | Default commit strategy | `auto` | `auto`, `directory`, `global` |
-| `EXCLUDE_FILES` | Files to exclude from diff | `package-lock.json, pnpm-lock.yaml, yarn.lock, *.lock` | Comma-separated file patterns |
-| `MAX_TOKENS` | Maximum tokens for AI response | `8192` | Any positive integer |
+| Variable        | Description                          | Default                                                | Options                                  |
+| --------------- | ------------------------------------ | ------------------------------------------------------ | ---------------------------------------- |
+| `LOCALE`        | Language for commit messages         | `en-US`                                                | Any locale code (e.g., `en`, `es`, `fr`) |
+| `MAX_NO`        | Number of commit message suggestions | `1`                                                    | Any positive integer                     |
+| `COMMIT_TYPE`   | Style of commit messages             | `general`                                              | `general`, `conventional`, etc.          |
+| `COMMIT_MODE`   | Default commit strategy              | `auto`                                                 | `auto`, `directory`, `global`            |
+| `EXCLUDE_FILES` | Files to exclude from diff           | `package-lock.json, pnpm-lock.yaml, yarn.lock, *.lock` | Comma-separated file patterns            |
+| `MAX_TOKENS`    | Maximum tokens for AI response       | `8192`                                                 | Any positive integer                     |
 
 ### Configuration Priority
+
 1. **`.dcommit` file** (highest priority)
 2. **Environment variables**
 3. **Built-in defaults** (lowest priority)
 
 ### Using Environment Variables
+
 ```bash
 # Basic setup with Gemini (default)
 export GEMINI_API_KEY='your-api-key-here'
@@ -978,6 +1038,7 @@ export GROQ_API_KEY='your-groq-key'
 ```
 
 ### Using .dcommit File
+
 See `.dcommit.example` for a complete configuration template with all providers.
 
 **Note:** The `.dcommit` file is **optional**. DevCommit will work with just environment variables!

{devcommit-0.1.4.5 → devcommit-0.1.4.7}/README.md

@@ -16,24 +16,27 @@ A command-line AI tool for autocommits.
 
 ## Installation
 
-1. **Install DevCommit**  
-   
+1. **Install DevCommit**
+
    **Option 1: Using pip (local installation)**
+
    ```bash
    pip install devcommit
    ```
-   
+
    **Option 2: Using pipx (global installation, recommended)**
+
    ```bash
    # Install pipx if you don't have it
    python3 -m pip install --user pipx
    python3 -m pipx ensurepath
-   
+
    # Install DevCommit globally
    pipx install devcommit
    ```
+
    > **💡 Why pipx?** pipx installs CLI tools in isolated environments, preventing dependency conflicts while making them globally available.
-   
+
    **All AI providers are included by default!** ✅ Gemini, OpenAI, Groq, Anthropic, Ollama, and Custom API support.
 
 2. **Set Up Configuration (Required: API Key)**  
@@ -42,31 +45,34 @@ A command-line AI tool for autocommits.
    **Priority Order:** `.dcommit` file → Environment Variables → Defaults
 
    ### Option 1: Environment Variables (Quickest)
+
    ```bash
    # Using Gemini (default)
    export GEMINI_API_KEY='your-api-key-here'
-   
+
    # Or using Groq (recommended for free tier)
    export AI_PROVIDER='groq'
    export GROQ_API_KEY='your-groq-key'
-   
+
    # Add to ~/.bashrc or ~/.zshrc for persistence
    echo "export GEMINI_API_KEY='your-key'" >> ~/.bashrc
    ```
 
    ### Option 2: .dcommit File (Home Directory)
+
    ```bash
    cat > ~/.dcommit << 'EOF'
    GEMINI_API_KEY = your-api-key-here
    LOCALE = en
    MAX_NO = 1
    COMMIT_TYPE = conventional
-   MODEL_NAME = gemini-1.5-flash
+   MODEL_NAME = gemini-2.5-flash
    COMMIT_MODE = auto
    EOF
    ```
 
    ### Option 3: .dcommit File (Virtual Environment)
+
    ```bash
    mkdir -p $VIRTUAL_ENV/config
    cat > $VIRTUAL_ENV/config/.dcommit << 'EOF'
@@ -74,7 +80,7 @@ A command-line AI tool for autocommits.
    LOCALE = en
    MAX_NO = 1
    COMMIT_TYPE = conventional
-   MODEL_NAME = gemini-1.5-flash
+   MODEL_NAME = gemini-2.0-flash-exp
    COMMIT_MODE = auto
    EOF
    ```
@@ -92,6 +98,7 @@ devcommit
 ### Basic Usage
 
 - **Stage all changes and commit:**
+
   ```bash
   devcommit --stageAll
   ```
@@ -118,6 +125,7 @@ You can set your preferred commit mode in the `.dcommit` configuration file usin
 #### Command-Line Usage
 
 - **Interactive mode (auto):** When you have changes in multiple directories, DevCommit will automatically ask if you want to:
+
   - Create one commit for all changes (global commit)
   - Create separate commits per directory
 
@@ -129,10 +137,40 @@ You can set your preferred commit mode in the `.dcommit` configuration file usin
   ```
 
 When using directory-based commits, you can:
+
 1. Select which directories to commit (use Space to select, Enter to confirm)
 2. For each selected directory, review and choose a commit message
 3. Each directory gets its own commit with AI-generated messages based on its changes
 
+### Commit Specific Files or Folders
+
+DevCommit allows you to commit specific files or folders. This is useful when you want to commit only certain changes without affecting other staged files.
+
+**Usage:**
+
+```bash
+# Commit specific files (must be staged first)
+git add file1.py file2.py
+devcommit --files file1.py file2.py
+
+# Stage and commit specific files in one command
+devcommit --stageAll --files file1.py file2.py
+
+# Commit specific folders (must be staged first)
+git add src/ tests/
+devcommit --files src/ tests/
+
+# Short form
+devcommit -s -f file1.py file2.py
+```
+
+When using `--files` or `-f`:
+
+- Without `--stageAll`: Only commits files that are already staged (filters staged files to match specified paths)
+- With `--stageAll`: Stages the specified files/folders and then commits them
+- AI generates commit messages based on changes in those files
+- Works with both individual files and entire directories
+
 ### Additional Options
 
 - `--excludeFiles` or `-e`: Exclude specific files from the diff
@@ -140,6 +178,8 @@ When using directory-based commits, you can:
 - `--commitType` or `-t`: Specify the type of commit (e.g., conventional)
 - `--stageAll` or `-s`: Stage all changes before committing
 - `--directory` or `-d`: Force directory-based commits
+- `--files` or `-f`: Stage and commit specific files or folders (can specify multiple)
+- `--push` or `-p`: Push commits to remote after committing
 
 ### Examples
 
@@ -152,24 +192,40 @@ devcommit --commitType conventional
 
 # Exclude lock files
 devcommit --excludeFiles package-lock.json yarn.lock
+
+# Stage and commit specific files
+devcommit --files file1.py file2.py
+
+# Stage and commit specific folders
+devcommit --files src/ tests/
+
+# Stage and commit multiple files and folders at once
+devcommit --files src/ file1.py tests/ config.json
+
+# Commit and push
+devcommit --push
+
+# Commit specific files and push
+devcommit --files file1.py file2.py --push
 ```
 
 ## AI Provider Support
 
 DevCommit now supports **multiple AI providers**! Choose from:
 
-| Provider | Free Tier | Speed | Quality | Get API Key |
-|----------|-----------|-------|---------|-------------|
-| 🆓 **Gemini** | 15 req/min, 1M/day | Fast | Good | [Get Key](https://aistudio.google.com/app/apikey) |
-| ⚡ **Groq** | Very generous | **Fastest** | Good | [Get Key](https://console.groq.com/keys) |
-| 🤖 **OpenAI** | $5 trial | Medium | **Best** | [Get Key](https://platform.openai.com/api-keys) |
-| 🧠 **Anthropic** | Limited trial | Medium | Excellent | [Get Key](https://console.anthropic.com/) |
-| 🏠 **Ollama** | **Unlimited** | Medium | Good | [Install](https://ollama.ai/) |
-| 🔧 **Custom** | Varies | Varies | Varies | Your server |
+| Provider         | Free Tier          | Speed       | Quality   | Get API Key                                       |
+| ---------------- | ------------------ | ----------- | --------- | ------------------------------------------------- |
+| 🆓 **Gemini**    | 15 req/min, 1M/day | Fast        | Good      | [Get Key](https://aistudio.google.com/app/apikey) |
+| ⚡ **Groq**      | Very generous      | **Fastest** | Good      | [Get Key](https://console.groq.com/keys)          |
+| 🤖 **OpenAI**    | $5 trial           | Medium      | **Best**  | [Get Key](https://platform.openai.com/api-keys)   |
+| 🧠 **Anthropic** | Limited trial      | Medium      | Excellent | [Get Key](https://console.anthropic.com/)         |
+| 🏠 **Ollama**    | **Unlimited**      | Medium      | Good      | [Install](https://ollama.ai/)                     |
+| 🔧 **Custom**    | Varies             | Varies      | Varies    | Your server                                       |
 
 ### Quick Setup Examples
 
 **Using Groq (Recommended for free tier):**
+
 ```bash
 export AI_PROVIDER=groq
 export GROQ_API_KEY='your-groq-api-key'
@@ -177,6 +233,7 @@ devcommit
 ```
 
 **Using Ollama (Local, no API key needed):**
+
 ```bash
 # Install Ollama: https://ollama.ai/
 ollama pull llama3
@@ -185,6 +242,7 @@ devcommit
 ```
 
 **Using Custom API:**
+
 ```bash
 export AI_PROVIDER=custom
 export CUSTOM_API_URL='http://localhost:8000/v1'
@@ -199,8 +257,8 @@ All configuration can be set via **environment variables** or **`.dcommit` file*
 
 ### AI Provider Settings
 
-| Variable | Description | Default | Options |
-|----------|-------------|---------|---------|
+| Variable      | Description             | Default  | Options                                                     |
+| ------------- | ----------------------- | -------- | ----------------------------------------------------------- |
 | `AI_PROVIDER` | Which AI service to use | `gemini` | `gemini`, `openai`, `groq`, `anthropic`, `ollama`, `custom` |
 
 ### Provider-Specific Settings
@@ -209,7 +267,7 @@ All configuration can be set via **environment variables** or **`.dcommit` file*
 | Variable | Description | Default |
 |----------|-------------|---------|
 | `GEMINI_API_KEY` | Google Gemini API key | - |
-| `GEMINI_MODEL` | Model name | `gemini-1.5-flash` |
+| `GEMINI_MODEL` | Model name | `gemini-2.0-flash-exp` |
 
 **OpenAI:**
 | Variable | Description | Default |
@@ -244,21 +302,23 @@ All configuration can be set via **environment variables** or **`.dcommit` file*
 
 ### General Settings
 
-| Variable | Description | Default | Options |
-|----------|-------------|---------|---------|
-| `LOCALE` | Language for commit messages | `en-US` | Any locale code (e.g., `en`, `es`, `fr`) |
-| `MAX_NO` | Number of commit message suggestions | `1` | Any positive integer |
-| `COMMIT_TYPE` | Style of commit messages | `general` | `general`, `conventional`, etc. |
-| `COMMIT_MODE` | Default commit strategy | `auto` | `auto`, `directory`, `global` |
-| `EXCLUDE_FILES` | Files to exclude from diff | `package-lock.json, pnpm-lock.yaml, yarn.lock, *.lock` | Comma-separated file patterns |
-| `MAX_TOKENS` | Maximum tokens for AI response | `8192` | Any positive integer |
+| Variable        | Description                          | Default                                                | Options                                  |
+| --------------- | ------------------------------------ | ------------------------------------------------------ | ---------------------------------------- |
+| `LOCALE`        | Language for commit messages         | `en-US`                                                | Any locale code (e.g., `en`, `es`, `fr`) |
+| `MAX_NO`        | Number of commit message suggestions | `1`                                                    | Any positive integer                     |
+| `COMMIT_TYPE`   | Style of commit messages             | `general`                                              | `general`, `conventional`, etc.          |
+| `COMMIT_MODE`   | Default commit strategy              | `auto`                                                 | `auto`, `directory`, `global`            |
+| `EXCLUDE_FILES` | Files to exclude from diff           | `package-lock.json, pnpm-lock.yaml, yarn.lock, *.lock` | Comma-separated file patterns            |
+| `MAX_TOKENS`    | Maximum tokens for AI response       | `8192`                                                 | Any positive integer                     |
 
 ### Configuration Priority
+
 1. **`.dcommit` file** (highest priority)
 2. **Environment variables**
 3. **Built-in defaults** (lowest priority)
 
 ### Using Environment Variables
+
 ```bash
 # Basic setup with Gemini (default)
 export GEMINI_API_KEY='your-api-key-here'
@@ -273,6 +333,7 @@ export GROQ_API_KEY='your-groq-key'
 ```
 
 ### Using .dcommit File
+
 See `.dcommit.example` for a complete configuration template with all providers.
 
 **Note:** The `.dcommit` file is **optional**. DevCommit will work with just environment variables!

{devcommit-0.1.4.5 → devcommit-0.1.4.7}/devcommit/app/ai_providers.py

@@ -47,7 +47,7 @@ class AIProvider(ABC):
 class GeminiProvider(AIProvider):
     """Google Gemini AI provider"""
     
-    def __init__(self, api_key: str, model: str = "gemini-1.5-flash"):
+    def __init__(self, api_key: str, model: str = "gemini-2.0-flash-exp"):
         if not genai:
             raise ImportError("google-generativeai not installed. Run: pip install google-generativeai")
         
@@ -235,7 +235,7 @@ def get_ai_provider(config) -> AIProvider:
         if not api_key:
             raise ValueError("GEMINI_API_KEY not set")
         # Support legacy MODEL_NAME for backward compatibility
-        model = config("GEMINI_MODEL", default=None) or config("MODEL_NAME", default="gemini-1.5-flash")
+        model = config("GEMINI_MODEL", default=None) or config("MODEL_NAME", default="gemini-2.0-flash-exp")
         return GeminiProvider(api_key, model)
     
     elif provider_name == "openai":

{devcommit-0.1.4.5 → devcommit-0.1.4.7}/devcommit/app/gemini_ai.py

@@ -61,7 +61,7 @@ def generateCommitMessage(diff: str) -> str:
         # Load Configuration Values
         max_no = config("MAX_NO", default=1, cast=int)
         locale = config("LOCALE", default="en-US")
-        commit_type = config("COMMIT_TYPE", default="general")
+        commit_type = config("COMMIT_TYPE", default="normal")
         max_tokens = config("MAX_TOKENS", default=8192, cast=int)
         
         # Generate prompt

{devcommit-0.1.4.5 → devcommit-0.1.4.7}/devcommit/app/prompt.py

@@ -46,10 +46,13 @@ commit_types: Dict[CommitType, str] = {
 
 def specify_commit_format(commit_type: CommitType) -> str:
     """Specify the commit format for the given commit type"""
+    
+    # Map "normal" to empty string format
+    format_key = "" if commit_type == "normal" else commit_type
 
     return (
         f"The output response must be in format:\n"
-        f"{commit_type_formats[commit_type]}"
+        f"{commit_type_formats[format_key]}"
     )