# slimcontext
**slimcontext** is a Python package that transforms a Git repository into contextual information suitable for Large Language Models (LLMs). It extracts comprehensive information from Python source files, generates structured context for LLMs, and provides utilities for token counting and logging.
## Features
- **Context Extraction:** Extracts either full or slim textual contexts based on the repository content, tailored for effective LLM interactions.
- **Token Counting:** Integrates with `tiktoken` to count tokens, ensuring compatibility with various LLM models.
- **Command-Line Interface (CLI):** User-friendly CLI built with `Click` for easy interaction and automation.
- **Git Integration:** Manages and interacts with Git repositories, handling file extraction and repository structure efficiently.
## Installation
You can install the package via PyPI:
```bash
pip install slimcontext
```
Or install directly from GitLab:
```bash
pip install git+https://gitlab.com/notorious-community/slimcontext.git
```
## Usage
### Command-Line Interface (CLI)
The package provides a CLI tool for easy interaction. Below are the available commands and options.
#### Basic Usage
```bash
slimcontext main --path /path/to/your/git/repo
```
#### Options
- `--path`: Path to the Git repository (required).
- `--context-level`: Level of context generation (`full` or `slim`). Defaults to `slim`.
- `--output`: Path to the output file. If not specified, outputs to stdout.
- `--token-model`: Specify the model for token counting (e.g., `gpt-4`). Set to `None` to skip token counting.
- `--verbose`: Logging level (e.g., `DEBUG`, `INFO`, `WARNING`, `ERROR`, `CRITICAL`). Defaults to `WARNING`.
#### Examples
```bash
slimcontext main \
--path /path/to/your/git/repo \
--context-level full \
--output /path/to/output/context.txt \
--token-model gpt-4 \
--verbose 0
```
or
```bash
slimcontext main \
-p /path/to/your/git/repo \
-c full \
-o /path/to/output/context.txt \
-t gpt-4 \
-v
```
### Python API
```python
from slimcontext import (
ProjectParser,
initialize_git_repo,
generate_context,
count_tokens,
write_output,
setup_logger
)
from pathlib import Path
# Initialize logger
logger = setup_logger(__name__)
# Initialize Git repository
repo_path = Path('/path/to/your/git/repo')
git_repo = initialize_git_repo(repo_dir=repo_path)
files = git_repo.get_abolute_file_paths()
# Initialize Python parser
parser = ProjectParser(root_dir=git_repo.get_git_root())
# Generate context
context = generate_context(parser=parser, files=files, context_level='slim')
# Count tokens
token_count = count_tokens(context=context)
print(f"Total tokens: {token_count}")
# Write output
output_path = Path('/path/to/output/context.txt')
write_output(context=context, output_path=output_path)
```
## Development
### Setting Up the Development Environment
1. **Clone the Repository:**
```bash
git clone https://gitlab.com/notorious-community/slimcontext.git
cd slimcontext
```
2. **Install Dependencies:**
Ensure you have `poetry` installed. Then run:
```bash
poetry install
```
### Running Tests
The package includes a comprehensive test suite using `pytest`.
```bash
poetry run pytest
```
### Linting and Formatting
Ensure code quality and consistency with `ruff`.
```bash
poetry run ruff check .
```
### Running Nox Sessions
Automate development tasks across multiple Python environments using `nox`.
```bash
nox -s tests
```
## Project Structure
```
slimcontext/
├── slimcontext/
│ ├── main.py
│ ├── managers/ # Houses various managers for languages.
│ ├── parsers/ # Houses the code to parse and extract key context by language.
│ └── utils/ # Various utilities used across code base.
├── tests/
├── gitlab-ci.yml
├── CHANGELOG
├── LICENSE
├── noxfile.py
├── pyproject.toml
└── README.md
```
## Contributing
Contributions are welcome! Whether it's reporting bugs, suggesting features, or submitting pull requests, your help is appreciated. Please follow these steps to contribute:
1. **Fork the Repository:**
Click the "Fork" button at the top right of the repository page.
2. **Clone Your Fork:**
```bash
git clone https://gitlab.com/your-username/slimcontext.git
cd slimcontext
```
3. **Create a New Branch:**
```bash
git checkout -b feature/your-feature-name
```
4. **Make Your Changes:**
Implement your feature or bug fix.
5. **Commit Your Changes:**
```bash
git commit -m "Title of your changes" -m "Describe **Why** you made this change."
```
6. **Push to Your Fork:**
```bash
git push origin feature/your-feature-name
```
7. **Create a Merge Request:**
Go to the original repository and create a merge request from your fork.
Please ensure all tests pass and adhere to the project's coding standards before submitting your merge request.
## License
This project is licensed under the [MIT License](LICENSE). See the [LICENSE](LICENSE) file for details.
---
**Copyright (c) 2024 Neil Schneider**
Raw data
{
"_id": null,
"home_page": "https://gitlab.com/notorious-community/slimcontext",
"name": "slimcontext",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": "LLM, Git, Context, Tool, ChatBot",
"author": "Neil Schneider",
"author_email": "schneider.neil@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/b4/82/f0c420968bc2f827c5e9f5045d45bd577656d801234fa24f00571a13881d/slimcontext-0.4.0.tar.gz",
"platform": null,
"description": "# slimcontext\n\n**slimcontext** is a Python package that transforms a Git repository into contextual information suitable for Large Language Models (LLMs). It extracts comprehensive information from Python source files, generates structured context for LLMs, and provides utilities for token counting and logging.\n\n## Features\n\n- **Context Extraction:** Extracts either full or slim textual contexts based on the repository content, tailored for effective LLM interactions.\n- **Token Counting:** Integrates with `tiktoken` to count tokens, ensuring compatibility with various LLM models.\n- **Command-Line Interface (CLI):** User-friendly CLI built with `Click` for easy interaction and automation.\n- **Git Integration:** Manages and interacts with Git repositories, handling file extraction and repository structure efficiently.\n\n## Installation\n\nYou can install the package via PyPI:\n\n```bash\npip install slimcontext\n```\n\nOr install directly from GitLab:\n\n```bash\npip install git+https://gitlab.com/notorious-community/slimcontext.git\n```\n\n## Usage\n\n### Command-Line Interface (CLI)\n\nThe package provides a CLI tool for easy interaction. Below are the available commands and options.\n\n#### Basic Usage\n\n```bash\nslimcontext main --path /path/to/your/git/repo\n```\n\n#### Options\n\n- `--path`: Path to the Git repository (required).\n- `--context-level`: Level of context generation (`full` or `slim`). Defaults to `slim`.\n- `--output`: Path to the output file. If not specified, outputs to stdout.\n- `--token-model`: Specify the model for token counting (e.g., `gpt-4`). Set to `None` to skip token counting.\n- `--verbose`: Logging level (e.g., `DEBUG`, `INFO`, `WARNING`, `ERROR`, `CRITICAL`). Defaults to `WARNING`.\n\n#### Examples\n\n```bash\nslimcontext main \\\n --path /path/to/your/git/repo \\\n --context-level full \\\n --output /path/to/output/context.txt \\\n --token-model gpt-4 \\\n --verbose 0\n```\n\nor\n\n```bash\nslimcontext main \\\n -p /path/to/your/git/repo \\\n -c full \\\n -o /path/to/output/context.txt \\\n -t gpt-4 \\\n -v\n```\n\n### Python API\n\n```python\nfrom slimcontext import (\n ProjectParser,\n initialize_git_repo,\n generate_context,\n count_tokens,\n write_output,\n setup_logger\n)\nfrom pathlib import Path\n\n# Initialize logger\nlogger = setup_logger(__name__)\n\n# Initialize Git repository\nrepo_path = Path('/path/to/your/git/repo')\ngit_repo = initialize_git_repo(repo_dir=repo_path)\nfiles = git_repo.get_abolute_file_paths()\n\n# Initialize Python parser\nparser = ProjectParser(root_dir=git_repo.get_git_root())\n\n# Generate context\ncontext = generate_context(parser=parser, files=files, context_level='slim')\n\n# Count tokens\ntoken_count = count_tokens(context=context)\nprint(f\"Total tokens: {token_count}\")\n\n# Write output\noutput_path = Path('/path/to/output/context.txt')\nwrite_output(context=context, output_path=output_path)\n```\n\n## Development\n\n### Setting Up the Development Environment\n\n1. **Clone the Repository:**\n\n ```bash\n git clone https://gitlab.com/notorious-community/slimcontext.git\n cd slimcontext\n ```\n\n2. **Install Dependencies:**\n\n Ensure you have `poetry` installed. Then run:\n\n ```bash\n poetry install\n ```\n\n### Running Tests\n\nThe package includes a comprehensive test suite using `pytest`.\n\n```bash\npoetry run pytest\n```\n\n### Linting and Formatting\n\nEnsure code quality and consistency with `ruff`.\n\n```bash\npoetry run ruff check .\n```\n\n### Running Nox Sessions\n\nAutomate development tasks across multiple Python environments using `nox`.\n\n```bash\nnox -s tests\n```\n\n## Project Structure\n\n```\nslimcontext/\n\u251c\u2500\u2500 slimcontext/\n\u2502 \u251c\u2500\u2500 main.py\n\u2502 \u251c\u2500\u2500 managers/ # Houses various managers for languages.\n\u2502 \u251c\u2500\u2500 parsers/ # Houses the code to parse and extract key context by language.\n\u2502 \u2514\u2500\u2500 utils/ # Various utilities used across code base.\n\u251c\u2500\u2500 tests/ \n\u251c\u2500\u2500 gitlab-ci.yml\n\u251c\u2500\u2500 CHANGELOG\n\u251c\u2500\u2500 LICENSE\n\u251c\u2500\u2500 noxfile.py\n\u251c\u2500\u2500 pyproject.toml\n\u2514\u2500\u2500 README.md\n```\n\n## Contributing\n\nContributions are welcome! Whether it's reporting bugs, suggesting features, or submitting pull requests, your help is appreciated. Please follow these steps to contribute:\n\n1. **Fork the Repository:**\n\n Click the \"Fork\" button at the top right of the repository page.\n\n2. **Clone Your Fork:**\n\n ```bash\n git clone https://gitlab.com/your-username/slimcontext.git\n cd slimcontext\n ```\n\n3. **Create a New Branch:**\n\n ```bash\n git checkout -b feature/your-feature-name\n ```\n\n4. **Make Your Changes:**\n\n Implement your feature or bug fix.\n\n5. **Commit Your Changes:**\n\n ```bash\n git commit -m \"Title of your changes\" -m \"Describe **Why** you made this change.\"\n ```\n\n6. **Push to Your Fork:**\n\n ```bash\n git push origin feature/your-feature-name\n ```\n\n7. **Create a Merge Request:**\n\n Go to the original repository and create a merge request from your fork.\n\nPlease ensure all tests pass and adhere to the project's coding standards before submitting your merge request.\n\n## License\n\nThis project is licensed under the [MIT License](LICENSE). See the [LICENSE](LICENSE) file for details.\n\n---\n\n**Copyright (c) 2024 Neil Schneider**",
"bugtrack_url": null,
"license": "MIT",
"summary": "A tool to turn a git repository into context for LLMs.",
"version": "0.4.0",
"project_urls": {
"Homepage": "https://gitlab.com/notorious-community/slimcontext"
},
"split_keywords": [
"llm",
" git",
" context",
" tool",
" chatbot"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "c5311c533a6bd285cab1dd8b959388d3c18b14ea1af90bc18d0f8bc415ce150a",
"md5": "cd9f65ab580794d49efdf36294816979",
"sha256": "26fcfd2bcc6f5d3f9f35318d800ab6d85718d3a3eac1c3bced0ef6f689f06a3b"
},
"downloads": -1,
"filename": "slimcontext-0.4.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "cd9f65ab580794d49efdf36294816979",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 31083,
"upload_time": "2025-01-15T05:00:23",
"upload_time_iso_8601": "2025-01-15T05:00:23.169075Z",
"url": "https://files.pythonhosted.org/packages/c5/31/1c533a6bd285cab1dd8b959388d3c18b14ea1af90bc18d0f8bc415ce150a/slimcontext-0.4.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "b482f0c420968bc2f827c5e9f5045d45bd577656d801234fa24f00571a13881d",
"md5": "993636b7b736eaf5e06207254fe49573",
"sha256": "c10f994564ef3aa37923f50c47bbf57ede0f96f93f8d2678f25ec42696ec7f94"
},
"downloads": -1,
"filename": "slimcontext-0.4.0.tar.gz",
"has_sig": false,
"md5_digest": "993636b7b736eaf5e06207254fe49573",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 21667,
"upload_time": "2025-01-15T05:00:25",
"upload_time_iso_8601": "2025-01-15T05:00:25.314378Z",
"url": "https://files.pythonhosted.org/packages/b4/82/f0c420968bc2f827c5e9f5045d45bd577656d801234fa24f00571a13881d/slimcontext-0.4.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-01-15 05:00:25",
"github": false,
"gitlab": true,
"bitbucket": false,
"codeberg": false,
"gitlab_user": "notorious-community",
"gitlab_project": "slimcontext",
"lcname": "slimcontext"
}
JSON