ngpt 1.1.3__tar.gz → 1.1.4__tar.gz

ngpt-1.1.4/COMMIT_GUIDELINES.md

@@ -0,0 +1,116 @@
+# Commit Message Guidelines
+
+## Introduction
+
+Consistent and well-formatted commit messages provide a better project history, make it easier to understand changes, facilitate automatic changelog generation, and help identify bugs. These guidelines ensure that our commit messages remain uniform, descriptive, and useful to all project contributors.
+
+## Message Format
+
+```
+type: <brief summary (max 50 chars)>
+
+- [type] key change 1 (max 60 chars per line)
+- [type] key change 2
+- [type] key change N (include all significant changes)
+```
+
+## Best Practices
+
+- Use the imperative mood in the subject line (e.g., "Add feature" not "Added feature")
+- Don't end the subject line with a period
+- Start with a capital letter
+- Separate subject from body with a blank line
+- Wrap body text at 72 characters
+- Use the body to explain what and why vs. how
+
+## Atomic Commits
+
+Each commit should represent a single logical change:
+- Make focused commits that address a single concern
+- Split work into multiple commits when appropriate
+- Avoid mixing unrelated changes in the same commit
+
+## Issue References
+
+Link to issues in your commit messages:
+- Use "Fixes #123" to automatically close an issue
+- Use "Relates to #123" for changes related to but not resolving an issue
+- Always include issue numbers for bug fixes
+
+## Valid Types
+
+Choose the most specific type for your changes:
+
+- `feat`: New user features (not for new files without user features)
+- `fix`: Bug fixes/corrections to errors
+- `refactor`: Restructured code (no behavior change) 
+- `style`: Formatting/whitespace changes
+- `docs`: Documentation only
+- `test`: Test-related changes
+- `perf`: Performance improvements
+- `build`: Build system changes
+- `ci`: CI pipeline changes
+- `chore`: Routine maintenance tasks
+- `revert`: Reverting previous changes
+- `add`: New files/resources with no user-facing features
+- `remove`: Removing files/code
+- `update`: Changes to existing functionality
+- `security`: Security-related changes
+- `i18n`: Internationalization
+- `a11y`: Accessibility improvements
+- `api`: API-related changes
+- `ui`: User interface changes
+- `data`: Database changes
+- `config`: Configuration changes
+- `init`: Initial commit/project setup
+
+## Examples
+
+### Good Examples
+
+#### Bug Fix:
+```
+fix: Address memory leak in data processing pipeline
+
+- [fix] Release resources in DataProcessor.cleanUp()
+- [fix] Add null checks to prevent NPE in edge cases
+- [perf] Optimize large dataset handling
+
+Fixes #456
+```
+
+#### New Feature:
+```
+feat: Add user profile export functionality
+
+- [feat] Create export button in profile settings
+- [feat] Implement JSON and CSV export options
+- [security] Apply rate limiting to prevent abuse
+
+Relates to #789
+```
+
+#### Refactoring:
+```
+refactor: Simplify authentication flow
+
+- [refactor] Extract login logic to separate service
+- [refactor] Reduce complexity in AuthManager
+- [test] Add unit tests for new service
+
+Part of #234
+```
+
+### Poor Example:
+```
+Made some changes to fix stuff
+
+Changed a bunch of files to make the login work better.
+Also fixed that other bug people were complaining about.
+```
+
+## Additional Resources
+
+- [Conventional Commits](https://www.conventionalcommits.org/)
+- [How to Write a Git Commit Message](https://chris.beams.io/posts/git-commit/)
+- [A Note About Git Commit Messages](https://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html)

ngpt-1.1.4/CONTRIBUTING.md

@@ -0,0 +1,90 @@
+# Contributing to NGPT
+
+Thank you for your interest in contributing to NGPT! This document provides guidelines and instructions for contributing to this project.
+
+## Development Setup
+
+1. Fork the repository
+2. Clone your fork: `git clone https://github.com/YOUR_USERNAME/ngpt.git`
+3. Navigate to the project directory: `cd ngpt`
+4. Set up Python environment:
+   - It's recommended to use a virtual environment
+   - Create a virtual environment: `python -m venv .venv`
+   - Activate the virtual environment:
+     - Windows: `.venv\Scripts\activate`
+     - Unix/MacOS: `source .venv/bin/activate`
+5. Install dependencies: `pip install -e .` 
+6. Open the project in your preferred code editor
+
+## Code Structure
+
+- `ngpt/` - Main package directory
+  - `__init__.py` - Package initialization
+  - `cli.py` - Command-line interface implementation
+  - `config.py` - Configuration management
+  - `client.py` - Client implementation
+- `.github/` - GitHub workflows and templates
+- `pyproject.toml` - Project configuration and dependencies
+
+## Code Style Guidelines
+
+- Follow PEP 8 style guidelines for Python code
+- Use consistent indentation (4 spaces)
+- Write descriptive docstrings for functions and classes
+- Add type hints where appropriate
+- Add comments for complex logic
+
+## Pull Request Guidelines
+
+Before submitting a pull request, please make sure that:
+  
+- Your code follows the project's coding conventions
+- You have tested your changes thoroughly
+- All existing tests pass (if applicable)
+- The commit messages are clear and follow conventional commit guidelines as specified in [COMMIT_GUIDELINES.md](COMMIT_GUIDELINES.md)
+- You have provided a detailed explanation of the changes in the pull request description
+
+## Submitting Changes
+
+1. Create a new branch: `git checkout -b feature/your-feature-name`
+2. Make your changes
+3. Test thoroughly
+4. Commit with clear messages: `git commit -m "feat: description"`
+5. Push to your fork: `git push origin feature/your-feature-name`
+6. Open a Pull Request against the main repository
+
+## Testing
+
+Before submitting your changes, please test:
+
+- Basic functionality
+- Any new features you've added
+- Any components you've modified
+- Ensure all tests pass if there's a test suite
+
+## Issue Reporting
+
+When opening an issue, please:
+
+- Use a clear and descriptive title
+- Provide a detailed description of the issue, including the environment and steps to reproduce
+- Include any relevant logs or code snippets
+- Specify your Python version and operating system
+- Search the repository for similar issues before creating a new one
+
+## Feature Requests
+
+Feature requests are welcome! To submit a feature request:
+
+- Use a clear and descriptive title
+- Provide a detailed description of the proposed feature
+- Explain why this feature would be useful to NGPT users
+- If possible, suggest how it might be implemented
+
+## Questions and Discussions
+
+For questions about the project that aren't bugs or feature requests, please use GitHub Discussions instead of opening an issue. This helps keep the issue tracker focused on bugs and features.
+
+## License
+
+By contributing to this project, you agree that your contributions will be licensed under the same [LICENSE](LICENSE) as the project.

{ngpt-1.1.3 → ngpt-1.1.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ngpt
-Version: 1.1.3
+Version: 1.1.4
 Summary: A lightweight Python CLI and library for interacting with OpenAI-compatible APIs, supporting both official and self-hosted LLM endpoints.
 Project-URL: Homepage, https://github.com/nazdridoy/ngpt
 Project-URL: Repository, https://github.com/nazdridoy/ngpt
@@ -48,8 +48,10 @@ A lightweight Python CLI and library for interacting with OpenAI-compatible APIs
   - [Python Library](#as-a-library)
 - [Configuration](#configuration)
   - [Command Line Options](#command-line-options)
+  - [Interactive Configuration](#interactive-configuration)
   - [Configuration File](#configuration-file)
   - [Configuration Priority](#configuration-priority)
+- [Contributing](#contributing)
 - [License](#license)
 
 ## Quick Start
@@ -191,7 +193,7 @@ You can configure the client using the following options:
 | `--base-url` | Base URL for the API |
 | `--model` | Model to use |
 | `--web-search` | Enable web search capability |
-| `--config` | Path to a custom configuration file |
+| `--config` | Path to a custom configuration file or, when used without a value, enters interactive configuration mode |
 | `--config-index` | Index of the configuration to use (default: 0) |
 | `--show-config` | Show configuration details and exit |
 | `--all` | Used with `--show-config` to display all configurations |
@@ -199,6 +201,23 @@ You can configure the client using the following options:
 | `-c, --code` | Generate clean code output |
 | `-v, --version` | Show version information |
 
+### Interactive Configuration
+
+The `--config` option without arguments enters interactive configuration mode, allowing you to add or edit configurations:
+
+```bash
+# Add a new configuration
+ngpt --config
+
+# Edit an existing configuration at index 1
+ngpt --config --config-index 1
+```
+
+In interactive mode:
+- When editing an existing configuration, press Enter to keep the current values
+- When creating a new configuration, press Enter to use default values
+- For security, your API key is not displayed when editing configurations
+
 ### Configuration File
 
 nGPT uses a configuration file stored in the standard user config directory for your operating system:
@@ -242,6 +261,20 @@ nGPT determines configuration values in the following order (highest priority fi
 3. Configuration file (selected by `--config-index`, defaults to index 0)
 4. Default values
 
+## Contributing
+
+We welcome contributions to nGPT! Whether it's bug fixes, feature additions, or documentation improvements, your help is appreciated.
+
+To contribute:
+
+1. Fork the repository
+2. Create a feature branch: `git checkout -b feature/your-feature-name`
+3. Make your changes
+4. Commit with clear messages following conventional commit guidelines
+5. Push to your fork and submit a pull request
+
+Please check the [CONTRIBUTING.md](CONTRIBUTING.md) file for detailed guidelines on code style, pull request process, and development setup.
+
 ## License
 
 This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.

{ngpt-1.1.3 → ngpt-1.1.4}/README.md

@@ -15,8 +15,10 @@ A lightweight Python CLI and library for interacting with OpenAI-compatible APIs
   - [Python Library](#as-a-library)
 - [Configuration](#configuration)
   - [Command Line Options](#command-line-options)
+  - [Interactive Configuration](#interactive-configuration)
   - [Configuration File](#configuration-file)
   - [Configuration Priority](#configuration-priority)
+- [Contributing](#contributing)
 - [License](#license)
 
 ## Quick Start
@@ -158,7 +160,7 @@ You can configure the client using the following options:
 | `--base-url` | Base URL for the API |
 | `--model` | Model to use |
 | `--web-search` | Enable web search capability |
-| `--config` | Path to a custom configuration file |
+| `--config` | Path to a custom configuration file or, when used without a value, enters interactive configuration mode |
 | `--config-index` | Index of the configuration to use (default: 0) |
 | `--show-config` | Show configuration details and exit |
 | `--all` | Used with `--show-config` to display all configurations |
@@ -166,6 +168,23 @@ You can configure the client using the following options:
 | `-c, --code` | Generate clean code output |
 | `-v, --version` | Show version information |
 
+### Interactive Configuration
+
+The `--config` option without arguments enters interactive configuration mode, allowing you to add or edit configurations:
+
+```bash
+# Add a new configuration
+ngpt --config
+
+# Edit an existing configuration at index 1
+ngpt --config --config-index 1
+```
+
+In interactive mode:
+- When editing an existing configuration, press Enter to keep the current values
+- When creating a new configuration, press Enter to use default values
+- For security, your API key is not displayed when editing configurations
+
 ### Configuration File
 
 nGPT uses a configuration file stored in the standard user config directory for your operating system:
@@ -209,6 +228,20 @@ nGPT determines configuration values in the following order (highest priority fi
 3. Configuration file (selected by `--config-index`, defaults to index 0)
 4. Default values
 
+## Contributing
+
+We welcome contributions to nGPT! Whether it's bug fixes, feature additions, or documentation improvements, your help is appreciated.
+
+To contribute:
+
+1. Fork the repository
+2. Create a feature branch: `git checkout -b feature/your-feature-name`
+3. Make your changes
+4. Commit with clear messages following conventional commit guidelines
+5. Push to your fork and submit a pull request
+
+Please check the [CONTRIBUTING.md](CONTRIBUTING.md) file for detailed guidelines on code style, pull request process, and development setup.
+
 ## License
 
 This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.

{ngpt-1.1.3 → ngpt-1.1.4}/ngpt/client.py

@@ -10,7 +10,7 @@ class NGPTClient:
         self,
         api_key: str = "",
         base_url: str = "https://api.openai.com/v1/",
-        provider: str = "OpenAI",  # Provider is now just a label, kept for potential future use/logging
+        provider: str = "OpenAI",
         model: str = "gpt-3.5-turbo"
     ):
         self.api_key = api_key

{ngpt-1.1.3 → ngpt-1.1.4}/ngpt/config.py

@@ -51,23 +51,44 @@ def add_config_entry(config_path: Path, config_index: Optional[int] = None) -> N
     """Add a new configuration entry or update existing one at the specified index."""
     configs = load_configs(custom_path=str(config_path))
     
-    # Create a new entry based on the default
-    new_entry = DEFAULT_CONFIG_ENTRY.copy()
+    # Determine if we're editing an existing config or creating a new one
+    is_existing_config = config_index is not None and config_index < len(configs)
+    
+    # Set up entry based on whether we're editing or creating
+    if is_existing_config:
+        # Use existing config as the base when editing
+        entry = configs[config_index].copy()
+        print("Enter configuration details (press Enter to keep current values):")
+    else:
+        # Use default config as the base when creating new
+        entry = DEFAULT_CONFIG_ENTRY.copy()
+        print("Enter configuration details (press Enter to use default values):")
     
-    # Interactive configuration
-    print("Enter configuration details (press Enter to use default values):")
     try:
-        new_entry["api_key"] = input(f"API Key: ") or new_entry["api_key"]
-        new_entry["base_url"] = input(f"Base URL [{new_entry['base_url']}]: ") or new_entry["base_url"]
-        new_entry["provider"] = input(f"Provider [{new_entry['provider']}]: ") or new_entry["provider"]
-        new_entry["model"] = input(f"Model [{new_entry['model']}]: ") or new_entry["model"]
+        # For API key, just show the prompt without the current value for security
+        user_input = input(f"API Key: ")
+        if user_input:
+            entry["api_key"] = user_input
+        
+        # For other fields, show current/default value and keep it if Enter is pressed
+        user_input = input(f"Base URL [{entry['base_url']}]: ")
+        if user_input:
+            entry["base_url"] = user_input
+        
+        user_input = input(f"Provider [{entry['provider']}]: ")
+        if user_input:
+            entry["provider"] = user_input
+        
+        user_input = input(f"Model [{entry['model']}]: ")
+        if user_input:
+            entry["model"] = user_input
         
         # Add or update the entry
-        if config_index is not None and config_index < len(configs):
-            configs[config_index] = new_entry
+        if is_existing_config:
+            configs[config_index] = entry
             print(f"Updated configuration at index {config_index}")
         else:
-            configs.append(new_entry)
+            configs.append(entry)
             print(f"Added new configuration at index {len(configs)-1}")
         
         # Save the updated configs
@@ -128,8 +149,7 @@ def load_config(custom_path: Optional[str] = None, config_index: int = 0) -> Dic
     # Override with environment variables if they exist
     env_mapping = {
         "OPENAI_API_KEY": "api_key",
-        "OPENAI_BASE_URL": "base_url",
-        "OPENAI_PROVIDER": "provider", 
+        "OPENAI_BASE_URL": "base_url", 
         "OPENAI_MODEL": "model"
     }
     

{ngpt-1.1.3 → ngpt-1.1.4}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "ngpt"
-version = "1.1.3"
+version = "1.1.4"
 description = "A lightweight Python CLI and library for interacting with OpenAI-compatible APIs, supporting both official and self-hosted LLM endpoints."
 authors = [
     {name = "nazDridoy", email = "nazdridoy399@gmail.com"},