commitmessagegenerator 2.2.0__tar.gz → 2.5.1__tar.gz

{commitmessagegenerator-2.2.0 → commitmessagegenerator-2.5.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: commitmessagegenerator
-Version: 2.2.0
+Version: 2.5.1
 Summary: Generate commit messages with AI (Google Gemini) automatically using `git diff`.
 Author-email: Gabriel Terceiro <gcarolinoterceiro@gmail.com>
 License: MIT
@@ -35,6 +35,14 @@ pip install commitmessagegenerator
 commitgen -cf
 ```
 
+You can explicitly choose where configuration is written:
+
+```bash
+commitgen -cf --config-scope auto    # default behavior
+commitgen -cf --config-scope local   # always write .env in current directory
+commitgen -cf --config-scope global  # always write ~/.commitgen/.env
+```
+
 This opens an interactive configuration menu where you can:
 
 1. Set or update your Gemini API key
@@ -53,10 +61,18 @@ Create a `.env` file in the directory where you will run commitgen (usually the
 
 ```
 GEMINI_API_KEY=your-gemini-api-key
-AI_MODEL=gemini-2.0-flash
+AI_MODEL=gemini-2.5-flash
 AUTO_ADD_ALL=true
 ```
 
+Config discovery order:
+
+1. `.env` in current directory
+2. `.env` in parent directories (useful when running from subfolders)
+3. Global config in `~/.commitgen/.env` (created automatically by `commitgen -cf --config-scope auto` when no local `.env` exists)
+
+Environment variables already set in your shell (e.g. `GEMINI_API_KEY`) are also respected.
+
 ## 🚀 Usage
 
 With the terminal, inside any Git repository with pending changes, run:
@@ -77,18 +93,19 @@ The command will:
 - `commitgen -c` - Generate and commit with the message
 - `commitgen -cp` - Generate, commit, and push
 - `commitgen -cf` - Configure API key, model, and file staging behavior
+- `commitgen -cf --config-scope [auto|local|global]` - Choose where `.env` is created/updated
 - `commitgen -s` - Show current configuration status
 
 ### Available Models
 
 When configuring with `-cf`, you can choose from:
 
-1. **gemini-2.0-flash** (default) - Fast and efficient
-2. **gemini-1.5-flash** - Good balance of speed and quality
-3. **gemini-1.5-pro** - Highest quality, slower
-4. **gemini-2.0-flash-exp** - Experimental version
-5. **gemini-2.5-flash** - Latest version, fast and efficient
-6. **gemini-2.5-pro** - Latest version, highest quality
+1. **gemini-2.5-flash** (default) - Fast and efficient, best price-performance
+2. **gemini-2.5-flash-lite** - Fastest and most economical
+3. **gemini-2.5-pro** - Advanced reasoning and coding
+4. **gemini-3-flash** - Frontier performance (preview)
+5. **gemini-3.5-flash** - Latest stable model, best for coding
+6. **gemini-3.1-pro** - Highest quality (preview)
 
 ### File Staging Behavior
 

{commitmessagegenerator-2.2.0 → commitmessagegenerator-2.5.1}/README.md

@@ -1,103 +1,120 @@
-# commitmessagegenerator
-
-Generate objective and technical commit messages with AI (Google Gemini) automatically using your `git diff`.
-
-## 📦 Install
-
-```bash
-pip install commitmessagegenerator
-```
-
-Or, if you're using a `venv`:
-
-```bash
-python -m venv venv
-source venv/bin/activate  # or .\venv\Scripts\activate in Windows
-pip install commitmessagegenerator
-```
-
-## ⚙️ Configuring
-
-```bash
-commitgen -cf
-```
-
-This opens an interactive configuration menu where you can:
-
-1. Set or update your Gemini API key
-2. Change the AI model
-3. Configure file staging behavior
-
-Each option can be configured independently, and you can exit at any time without saving changes.
-
-## Run this and type you API key to the terminal so the package creates the .env file and automatically adds it to the .gitignore
-
-Or do it manually:
-
-## IMPORTANT - BEFORE CREATING THIS FILE ADD '.venv' TO YOUR .gitignore SO YOUR API KEY ISN'T EXPOSED
-
-Create a `.env` file in the directory where you will run commitgen (usually the root of your Git project):
-
-```
-GEMINI_API_KEY=your-gemini-api-key
-AI_MODEL=gemini-2.0-flash
-AUTO_ADD_ALL=true
-```
-
-## 🚀 Usage
-
-With the terminal, inside any Git repository with pending changes, run:
-
-```bash
-commitgen (-c/-cp)
-```
-
-The command will:
-
-- Read the git diff;
-- Send it to the Google Gemini API using your configured model;
-- Return a commit message suggestion directly in your terminal.
-
-### Available Commands
-
-- `commitgen` - Generate commit message only
-- `commitgen -c` - Generate and commit with the message
-- `commitgen -cp` - Generate, commit, and push
-- `commitgen -cf` - Configure API key, model, and file staging behavior
-- `commitgen -s` - Show current configuration status
-
-### Available Models
-
-When configuring with `-cf`, you can choose from:
-
-1. **gemini-2.0-flash** (default) - Fast and efficient
-2. **gemini-1.5-flash** - Good balance of speed and quality
-3. **gemini-1.5-pro** - Highest quality, slower
-4. **gemini-2.0-flash-exp** - Experimental version
-5. **gemini-2.5-flash** - Latest version, fast and efficient
-6. **gemini-2.5-pro** - Latest version, highest quality
-
-### File Staging Behavior
-
-When configuring with `-cf`, you can choose how files are staged:
-
-1. **Auto-add all files** (default) - Automatically runs `git add --all` before generating the commit message
-2. **Staged only** - Only reads the diff from files you've already staged with `git add`
-
-The "staged only" option gives you more control over which changes are included in the commit message.
-
-## 🧩 Requisites
-
-- Python 3.8 or higher
-- Gemini API Key (Google Generative AI, free at: https://aistudio.google.com/app/apikey)
-- Initialized Git repository
-- Python dependencies (Automatically installed with the package):
-  - `GitPython`
-  - `google-generativeai`
-  - `python-dotenv`
-
-## 📄 License
-
-```
-MIT License
-```
+# commitmessagegenerator
+
+Generate objective and technical commit messages with AI (Google Gemini) automatically using your `git diff`.
+
+## 📦 Install
+
+```bash
+pip install commitmessagegenerator
+```
+
+Or, if you're using a `venv`:
+
+```bash
+python -m venv venv
+source venv/bin/activate  # or .\venv\Scripts\activate in Windows
+pip install commitmessagegenerator
+```
+
+## ⚙️ Configuring
+
+```bash
+commitgen -cf
+```
+
+You can explicitly choose where configuration is written:
+
+```bash
+commitgen -cf --config-scope auto    # default behavior
+commitgen -cf --config-scope local   # always write .env in current directory
+commitgen -cf --config-scope global  # always write ~/.commitgen/.env
+```
+
+This opens an interactive configuration menu where you can:
+
+1. Set or update your Gemini API key
+2. Change the AI model
+3. Configure file staging behavior
+
+Each option can be configured independently, and you can exit at any time without saving changes.
+
+## Run this and type you API key to the terminal so the package creates the .env file and automatically adds it to the .gitignore
+
+Or do it manually:
+
+## IMPORTANT - BEFORE CREATING THIS FILE ADD '.venv' TO YOUR .gitignore SO YOUR API KEY ISN'T EXPOSED
+
+Create a `.env` file in the directory where you will run commitgen (usually the root of your Git project):
+
+```
+GEMINI_API_KEY=your-gemini-api-key
+AI_MODEL=gemini-2.5-flash
+AUTO_ADD_ALL=true
+```
+
+Config discovery order:
+
+1. `.env` in current directory
+2. `.env` in parent directories (useful when running from subfolders)
+3. Global config in `~/.commitgen/.env` (created automatically by `commitgen -cf --config-scope auto` when no local `.env` exists)
+
+Environment variables already set in your shell (e.g. `GEMINI_API_KEY`) are also respected.
+
+## 🚀 Usage
+
+With the terminal, inside any Git repository with pending changes, run:
+
+```bash
+commitgen (-c/-cp)
+```
+
+The command will:
+
+- Read the git diff;
+- Send it to the Google Gemini API using your configured model;
+- Return a commit message suggestion directly in your terminal.
+
+### Available Commands
+
+- `commitgen` - Generate commit message only
+- `commitgen -c` - Generate and commit with the message
+- `commitgen -cp` - Generate, commit, and push
+- `commitgen -cf` - Configure API key, model, and file staging behavior
+- `commitgen -cf --config-scope [auto|local|global]` - Choose where `.env` is created/updated
+- `commitgen -s` - Show current configuration status
+
+### Available Models
+
+When configuring with `-cf`, you can choose from:
+
+1. **gemini-2.5-flash** (default) - Fast and efficient, best price-performance
+2. **gemini-2.5-flash-lite** - Fastest and most economical
+3. **gemini-2.5-pro** - Advanced reasoning and coding
+4. **gemini-3-flash** - Frontier performance (preview)
+5. **gemini-3.5-flash** - Latest stable model, best for coding
+6. **gemini-3.1-pro** - Highest quality (preview)
+
+### File Staging Behavior
+
+When configuring with `-cf`, you can choose how files are staged:
+
+1. **Auto-add all files** (default) - Automatically runs `git add --all` before generating the commit message
+2. **Staged only** - Only reads the diff from files you've already staged with `git add`
+
+The "staged only" option gives you more control over which changes are included in the commit message.
+
+## 🧩 Requisites
+
+- Python 3.8 or higher
+- Gemini API Key (Google Generative AI, free at: https://aistudio.google.com/app/apikey)
+- Initialized Git repository
+- Python dependencies (Automatically installed with the package):
+  - `GitPython`
+  - `google-generativeai`
+  - `python-dotenv`
+
+## 📄 License
+
+```
+MIT License
+```

{commitmessagegenerator-2.2.0 → commitmessagegenerator-2.5.1}/commitmessagegenerator/cli.py

@@ -1,21 +1,34 @@
 import argparse
 import subprocess
 from .generator import gerar_mensagem_commit
-from .configure import api_key, get_configured_model, get_auto_add_setting, update_setting, get_api_key_status
+from .configure import (
+    api_key,
+    get_configured_model,
+    get_auto_add_setting,
+    update_setting,
+    get_api_key_status,
+    load_config_env,
+    resolve_env_path,
+)
 import sys
 import getpass
 
 MODEL_MAP = {
-    "1": "gemini-2.0-flash",
-    "2": "gemini-1.5-flash", 
-    "3": "gemini-1.5-pro",
-    "4": "gemini-2.0-flash-exp",
-    "5": "gemini-2.5-flash",
-    "6": "gemini-2.5-pro"
+    "1": "gemini-2.5-flash",
+    "2": "gemini-2.5-flash-lite",
+    "3": "gemini-2.5-pro",
+    "4": "gemini-3-flash",
+    "5": "gemini-3.5-flash",
+    "6": "gemini-3.1-pro",
 }
 
 def configure_menu():
     """Interactive configuration menu"""
+    configure_menu_with_scope("auto")
+
+
+def configure_menu_with_scope(config_scope):
+    """Interactive configuration menu with target scope."""
     while True:
         # Get current settings
         api_set = get_api_key_status()
@@ -37,15 +50,15 @@ def configure_menu():
             print("\nExiting configuration.\n")
             break
         elif choice == "1":
-            configure_api_key()
+            configure_api_key(config_scope)
         elif choice == "2":
-            configure_model()
+            configure_model(config_scope)
         elif choice == "3":
-            configure_staging()
+            configure_staging(config_scope)
         else:
             print("\nInvalid option. Please try again.")
 
-def configure_api_key():
+def configure_api_key(config_scope):
     """Configure the API key"""
     print("\n" + "-"*40)
     print("API KEY CONFIGURATION")
@@ -59,10 +72,10 @@ def configure_api_key():
         print("\nNo changes made.")
         return
     
-    update_setting("GEMINI_API_KEY", key)
+    update_setting("GEMINI_API_KEY", key, scope=config_scope)
     print("\n✓ API Key saved successfully!")
 
-def configure_model():
+def configure_model(config_scope):
     """Configure the AI model"""
     current_model = get_configured_model()
     
@@ -71,12 +84,12 @@ def configure_model():
     print("-"*40)
     print(f"Current model: {current_model}\n")
     print("Available models:")
-    print("1. gemini-2.0-flash (fast and efficient)")
-    print("2. gemini-1.5-flash (good balance)")
-    print("3. gemini-1.5-pro (highest quality, slower)")
-    print("4. gemini-2.0-flash-exp (experimental)")
-    print("5. gemini-2.5-flash (latest, fast)")
-    print("6. gemini-2.5-pro (latest, highest quality)")
+    print("1. gemini-2.5-flash (default, fast and efficient)")
+    print("2. gemini-2.5-flash-lite (fastest, most economical)")
+    print("3. gemini-2.5-pro (advanced reasoning and coding)")
+    print("4. gemini-3-flash (frontier performance, preview)")
+    print("5. gemini-3.5-flash (latest stable, best for coding)")
+    print("6. gemini-3.1-pro (highest quality, preview)")
     print("\n0. Cancel")
     
     choice = input("\nSelect model (0-6): ").strip()
@@ -87,12 +100,12 @@ def configure_model():
     
     if choice in MODEL_MAP:
         selected_model = MODEL_MAP[choice]
-        update_setting("AI_MODEL", selected_model)
+        update_setting("AI_MODEL", selected_model, scope=config_scope)
         print(f"\n✓ Model changed to: {selected_model}")
     else:
         print("\nInvalid option. No changes made.")
 
-def configure_staging():
+def configure_staging(config_scope):
     """Configure file staging behavior"""
     auto_add = get_auto_add_setting()
     
@@ -111,10 +124,10 @@ def configure_staging():
         return
     
     if choice == "1":
-        update_setting("AUTO_ADD_ALL", "true")
+        update_setting("AUTO_ADD_ALL", "true", scope=config_scope)
         print("\n✓ Set to: Auto-add all files")
     elif choice == "2":
-        update_setting("AUTO_ADD_ALL", "false")
+        update_setting("AUTO_ADD_ALL", "false", scope=config_scope)
         print("\n✓ Set to: Staged only")
     else:
         print("\nInvalid option. No changes made.")
@@ -125,14 +138,18 @@ def main():
     parser.add_argument("-cp", "--commitpush",  action="store_true", help="Commits and pushes with the generated message")
     parser.add_argument("-cf", "--configure", action="store_true", help="Configures the GEMINI_API_KEY environment variable")
     parser.add_argument("-s", "--status", action="store_true", help="Shows current configuration status")
+    parser.add_argument(
+        "--config-scope",
+        choices=["auto", "local", "global"],
+        default="auto",
+        help="Where -cf writes configuration (.env): auto, local, or global",
+    )
     args = parser.parse_args()
 
     if args.status:
-        from .configure import get_configured_model, get_auto_add_setting
         import os
-        from dotenv import load_dotenv
-        
-        load_dotenv()
+
+        env_path = load_config_env()
         key = os.getenv("GEMINI_API_KEY")
         model = get_configured_model()
         auto_add = get_auto_add_setting()
@@ -141,6 +158,10 @@ def main():
         print(f"API Key: {'✓ Set' if key else '✗ Not set'}")
         print(f"Model: {model}")
         print(f"Auto-add all files: {'✓ Yes' if auto_add else '✗ No (staged only)'}")
+        if env_path is not None:
+            print(f"Config file: {env_path}")
+        else:
+            print("Config file: not found (.env not discovered)")
         return
 
     if not args.configure:
@@ -161,7 +182,10 @@ def main():
         subprocess.run(["git", "push"])
     
     if args.configure:
-        configure_menu()
+        configure_menu_with_scope(args.config_scope)
+        configured_path = resolve_env_path()
+        if configured_path is not None:
+            print(f"\nConfiguration file in use: {configured_path}")
     
     if len(sys.argv) == 1:
         print("\nRemoving staged changes (git reset)...")

commitmessagegenerator-2.5.1/commitmessagegenerator/configure.py

@@ -0,0 +1,196 @@
+import os
+from pathlib import Path
+from dotenv import load_dotenv
+
+
+GLOBAL_ENV_PATH = Path.home() / ".commitgen" / ".env"
+CONFIG_SCOPES = {"auto", "local", "global"}
+
+
+def _iter_local_env_candidates():
+    """Yield .env paths from cwd up to filesystem root."""
+    current = Path.cwd().resolve()
+    for directory in (current, *current.parents):
+        yield directory / ".env"
+
+
+def resolve_local_env_path():
+    """Resolve an existing local .env from cwd up to filesystem root."""
+    for candidate in _iter_local_env_candidates():
+        if candidate.exists():
+            return candidate
+    return None
+
+
+def resolve_env_path():
+    """Resolve the best available config file path."""
+    local_path = resolve_local_env_path()
+    if local_path is not None:
+        return local_path
+    if GLOBAL_ENV_PATH.exists():
+        return GLOBAL_ENV_PATH
+    return None
+
+
+def resolve_writable_env_path(scope="auto"):
+    """
+    Resolve where settings should be written.
+
+    scope:
+    - auto: existing local .env, then existing global .env, else new global .env
+    - local: .env in current working directory
+    - global: ~/.commitgen/.env
+    """
+    if scope not in CONFIG_SCOPES:
+        raise ValueError(f"Invalid config scope: {scope}")
+
+    if scope == "local":
+        return Path.cwd().resolve() / ".env"
+
+    if scope == "global":
+        return GLOBAL_ENV_PATH
+
+    existing_path = resolve_env_path()
+    if existing_path is not None:
+        return existing_path
+    return GLOBAL_ENV_PATH
+
+
+def load_config_env():
+    """
+    Load configuration from the resolved .env path (if found).
+    Returns the loaded path or None.
+    """
+    env_path = resolve_env_path()
+    if env_path is not None:
+        load_dotenv(dotenv_path=env_path, override=False)
+        return env_path
+    load_dotenv(override=False)
+    return None
+
+def update_setting(setting_name, value, scope="auto"):
+    """Update a single setting in the .env file"""
+    env_path = resolve_writable_env_path(scope=scope)
+    env_path.parent.mkdir(parents=True, exist_ok=True)
+
+    if env_path.exists():
+        with open(env_path, "r", encoding="utf-8") as f:
+            lines = f.readlines()
+        
+        found = False
+        new_lines = []
+        for line in lines:
+            key_name = line.split("=")[0] if "=" in line else None
+            if key_name == setting_name:
+                new_lines.append(f"{setting_name}={value}\n")
+                found = True
+            else:
+                new_lines.append(line)
+        
+        if not found:
+            new_lines.append(f"{setting_name}={value}\n")
+        
+        with open(env_path, "w", encoding="utf-8") as f:
+            f.writelines(new_lines)
+    else:
+        with open(env_path, "w", encoding="utf-8") as f:
+            f.write(f"{setting_name}={value}\n")
+    
+    _ensure_gitignore(env_path)
+
+def _ensure_gitignore(env_path):
+    """Ensure .env is in .gitignore for local (non-global) config files."""
+    if env_path == GLOBAL_ENV_PATH:
+        return
+
+    gitignore_path = env_path.parent / ".gitignore"
+    if gitignore_path.exists():
+        with open(gitignore_path, "r+", encoding="utf-8") as outfile:
+            lines = outfile.readlines()
+            env_in_gitignore = next((line for line in lines if line.strip() == ".env"), None)
+            if not env_in_gitignore:
+                outfile.write("\n.env")
+
+def api_key(key, model="gemini-2.5-flash", auto_add_all=True, scope="auto"):
+    """Set all configuration at once (legacy function)"""
+    config = {
+        "GEMINI_API_KEY": key,
+        "AI_MODEL": model,
+        "AUTO_ADD_ALL": str(auto_add_all).lower()
+    }
+
+    env_path = resolve_writable_env_path(scope=scope)
+    env_path.parent.mkdir(parents=True, exist_ok=True)
+
+    if env_path.exists():
+        with open(env_path, "r", encoding="utf-8") as f:
+            lines = f.readlines()
+        
+        existing_keys = set()
+        new_lines = []
+        for line in lines:
+            key_name = line.split("=")[0] if "=" in line else None
+            if key_name in config:
+                new_lines.append(f"{key_name}={config[key_name]}\n")
+                existing_keys.add(key_name)
+            else:
+                new_lines.append(line)
+        
+        for key_name, value in config.items():
+            if key_name not in existing_keys:
+                new_lines.append(f"{key_name}={value}\n")
+        
+        with open(env_path, "w", encoding="utf-8") as f:
+            f.writelines(new_lines)
+    else:
+        with open(env_path, "w", encoding="utf-8") as f:
+            for key_name, value in config.items():
+                f.write(f"{key_name}={value}\n")
+
+    _ensure_gitignore(env_path)
+
+def get_api_key_status():
+    """Check if API key is set"""
+    env_key = os.getenv("GEMINI_API_KEY")
+    if env_key:
+        return True
+
+    env_path = resolve_env_path()
+    if env_path is not None:
+        with open(env_path, "r", encoding="utf-8") as f:
+            lines = f.readlines()
+            api_line = next((line for line in lines if line.startswith("GEMINI_API_KEY=")), None)
+            if api_line:
+                value = api_line.split("=", 1)[1].strip()
+                return bool(value)
+    return False
+
+def get_configured_model():
+    """Get the currently configured AI model from .env file"""
+    env_model = os.getenv("AI_MODEL")
+    if env_model:
+        return env_model
+
+    env_path = resolve_env_path()
+    if env_path is not None:
+        with open(env_path, "r", encoding="utf-8") as outfile:
+            lines = outfile.readlines()
+            model_line = next((line for line in lines if line.startswith("AI_MODEL=")), None)
+            if model_line:
+                return model_line.split("=", 1)[1].strip()
+    return "gemini-2.5-flash"  # Default fallback
+
+def get_auto_add_setting():
+    """Get the auto-add all files setting from .env file"""
+    env_auto_add = os.getenv("AUTO_ADD_ALL")
+    if env_auto_add is not None:
+        return env_auto_add.strip().lower() == "true"
+
+    env_path = resolve_env_path()
+    if env_path is not None:
+        with open(env_path, "r", encoding="utf-8") as outfile:
+            lines = outfile.readlines()
+            auto_add_line = next((line for line in lines if line.startswith("AUTO_ADD_ALL=")), None)
+            if auto_add_line:
+                return auto_add_line.split("=", 1)[1].strip().lower() == "true"
+    return True  # Default: auto-add all files (current behavior)

{commitmessagegenerator-2.2.0 → commitmessagegenerator-2.5.1}/commitmessagegenerator/generator.py

@@ -1,11 +1,10 @@
 import os
-from dotenv import load_dotenv
 from google import genai
 from git import Repo
-from .configure import get_configured_model, get_auto_add_setting
+from .configure import get_configured_model, get_auto_add_setting, load_config_env
 
 def gerar_mensagem_commit():
-    load_dotenv()
+    load_config_env()
     key = os.getenv("GEMINI_API_KEY")
     if not key:
         raise RuntimeError("The GEMINI_API_KEY environment variable is not set.")

{commitmessagegenerator-2.2.0 → commitmessagegenerator-2.5.1}/commitmessagegenerator.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: commitmessagegenerator
-Version: 2.2.0
+Version: 2.5.1
 Summary: Generate commit messages with AI (Google Gemini) automatically using `git diff`.
 Author-email: Gabriel Terceiro <gcarolinoterceiro@gmail.com>
 License: MIT
@@ -35,6 +35,14 @@ pip install commitmessagegenerator
 commitgen -cf
 ```
 
+You can explicitly choose where configuration is written:
+
+```bash
+commitgen -cf --config-scope auto    # default behavior
+commitgen -cf --config-scope local   # always write .env in current directory
+commitgen -cf --config-scope global  # always write ~/.commitgen/.env
+```
+
 This opens an interactive configuration menu where you can:
 
 1. Set or update your Gemini API key
@@ -53,10 +61,18 @@ Create a `.env` file in the directory where you will run commitgen (usually the
 
 ```
 GEMINI_API_KEY=your-gemini-api-key
-AI_MODEL=gemini-2.0-flash
+AI_MODEL=gemini-2.5-flash
 AUTO_ADD_ALL=true
 ```
 
+Config discovery order:
+
+1. `.env` in current directory
+2. `.env` in parent directories (useful when running from subfolders)
+3. Global config in `~/.commitgen/.env` (created automatically by `commitgen -cf --config-scope auto` when no local `.env` exists)
+
+Environment variables already set in your shell (e.g. `GEMINI_API_KEY`) are also respected.
+
 ## 🚀 Usage
 
 With the terminal, inside any Git repository with pending changes, run:
@@ -77,18 +93,19 @@ The command will:
 - `commitgen -c` - Generate and commit with the message
 - `commitgen -cp` - Generate, commit, and push
 - `commitgen -cf` - Configure API key, model, and file staging behavior
+- `commitgen -cf --config-scope [auto|local|global]` - Choose where `.env` is created/updated
 - `commitgen -s` - Show current configuration status
 
 ### Available Models
 
 When configuring with `-cf`, you can choose from:
 
-1. **gemini-2.0-flash** (default) - Fast and efficient
-2. **gemini-1.5-flash** - Good balance of speed and quality
-3. **gemini-1.5-pro** - Highest quality, slower
-4. **gemini-2.0-flash-exp** - Experimental version
-5. **gemini-2.5-flash** - Latest version, fast and efficient
-6. **gemini-2.5-pro** - Latest version, highest quality
+1. **gemini-2.5-flash** (default) - Fast and efficient, best price-performance
+2. **gemini-2.5-flash-lite** - Fastest and most economical
+3. **gemini-2.5-pro** - Advanced reasoning and coding
+4. **gemini-3-flash** - Frontier performance (preview)
+5. **gemini-3.5-flash** - Latest stable model, best for coding
+6. **gemini-3.1-pro** - Highest quality (preview)
 
 ### File Staging Behavior
 

{commitmessagegenerator-2.2.0 → commitmessagegenerator-2.5.1}/pyproject.toml

@@ -1,21 +1,21 @@
-[build-system]
-requires = ["setuptools>=61.0"]
-build-backend = "setuptools.build_meta"
-
-[project]
-name = "commitmessagegenerator"
-version = "2.2.0"
-description = "Generate commit messages with AI (Google Gemini) automatically using `git diff`."
-readme = "README.md"
-license = {text = "MIT"}
-authors = [
-  {name = "Gabriel Terceiro", email = "gcarolinoterceiro@gmail.com"}
-]
-dependencies = [
-    "google-genai==1.20.0",
-    "GitPython==3.1.44",
-    "python-dotenv==1.1.0"
-]
-
-[project.scripts]
-commitgen = "commitmessagegenerator.cli:main"
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "commitmessagegenerator"
+version = "2.5.1"
+description = "Generate commit messages with AI (Google Gemini) automatically using `git diff`."
+readme = "README.md"
+license = {text = "MIT"}
+authors = [
+  {name = "Gabriel Terceiro", email = "gcarolinoterceiro@gmail.com"}
+]
+dependencies = [
+    "google-genai==1.20.0",
+    "GitPython==3.1.44",
+    "python-dotenv==1.1.0"
+]
+
+[project.scripts]
+commitgen = "commitmessagegenerator.cli:main"

commitmessagegenerator-2.2.0/commitmessagegenerator/configure.py

@@ -1,103 +0,0 @@
-import os
-
-def update_setting(setting_name, value):
-    """Update a single setting in the .env file"""
-    if os.path.exists(".env"):
-        with open(".env", "r") as f:
-            lines = f.readlines()
-        
-        found = False
-        new_lines = []
-        for line in lines:
-            key_name = line.split("=")[0] if "=" in line else None
-            if key_name == setting_name:
-                new_lines.append(f"{setting_name}={value}\n")
-                found = True
-            else:
-                new_lines.append(line)
-        
-        if not found:
-            new_lines.append(f"{setting_name}={value}\n")
-        
-        with open(".env", "w") as f:
-            f.writelines(new_lines)
-    else:
-        with open(".env", "w") as f:
-            f.write(f"{setting_name}={value}\n")
-    
-    _ensure_gitignore()
-
-def _ensure_gitignore():
-    """Ensure .env is in .gitignore"""
-    if os.path.exists(".gitignore"):
-        with open(".gitignore", "r+") as outfile:
-            lines = outfile.readlines()
-            env_in_gitignore = next((line for line in lines if line.strip() == ".env"), None)
-            if not env_in_gitignore:
-                outfile.write("\n.env")
-
-def api_key(key, model="gemini-2.0-flash", auto_add_all=True):
-    """Set all configuration at once (legacy function)"""
-    config = {
-        "GEMINI_API_KEY": key,
-        "AI_MODEL": model,
-        "AUTO_ADD_ALL": str(auto_add_all).lower()
-    }
-    
-    if os.path.exists(".env"):
-        with open(".env", "r") as f:
-            lines = f.readlines()
-        
-        existing_keys = set()
-        new_lines = []
-        for line in lines:
-            key_name = line.split("=")[0] if "=" in line else None
-            if key_name in config:
-                new_lines.append(f"{key_name}={config[key_name]}\n")
-                existing_keys.add(key_name)
-            else:
-                new_lines.append(line)
-        
-        for key_name, value in config.items():
-            if key_name not in existing_keys:
-                new_lines.append(f"{key_name}={value}\n")
-        
-        with open(".env", "w") as f:
-            f.writelines(new_lines)
-    else:
-        with open(".env", "w") as f:
-            for key_name, value in config.items():
-                f.write(f"{key_name}={value}\n")
-
-    _ensure_gitignore()
-
-def get_api_key_status():
-    """Check if API key is set"""
-    if os.path.exists(".env"):
-        with open(".env", "r") as f:
-            lines = f.readlines()
-            api_line = next((line for line in lines if line.startswith("GEMINI_API_KEY=")), None)
-            if api_line:
-                value = api_line.split("=", 1)[1].strip()
-                return bool(value)
-    return False
-
-def get_configured_model():
-    """Get the currently configured AI model from .env file"""
-    if os.path.exists(".env"):
-        with open(".env", "r") as outfile:
-            lines = outfile.readlines()
-            model_line = next((line for line in lines if line.startswith("AI_MODEL=")), None)
-            if model_line:
-                return model_line.split("=", 1)[1].strip()
-    return "gemini-2.0-flash"  # Default fallback
-
-def get_auto_add_setting():
-    """Get the auto-add all files setting from .env file"""
-    if os.path.exists(".env"):
-        with open(".env", "r") as outfile:
-            lines = outfile.readlines()
-            auto_add_line = next((line for line in lines if line.startswith("AUTO_ADD_ALL=")), None)
-            if auto_add_line:
-                return auto_add_line.split("=", 1)[1].strip().lower() == "true"
-    return True  # Default: auto-add all files (current behavior)