contextly 0.1.0__py3-none-any.whl

contextly/parsers/python.py

@@ -0,0 +1,60 @@
+"""
+Parser for Python source code files.
+"""
+
+import ast
+from pathlib import Path
+from typing import Dict, Any, List
+from .base import BaseParser, ChunkMetadata
+
+class PythonParser(BaseParser):
+    """Parser for Python source code using AST."""
+    
+    def __init__(self):
+        super().__init__()
+        self.supported_extensions = ['.py']
+        
+    def parse(self, file_path: Path) -> Dict[str, Any]:
+        """Parse Python file and extract structure and symbols."""
+        with open(file_path, 'r') as f:
+            content = f.read()
+            
+        try:
+            tree = ast.parse(content)
+        except SyntaxError as e:
+            return {
+                'error': f'Syntax error in {file_path}: {str(e)}',
+                'content': content,
+                'chunks': []
+            }
+            
+        chunks: List[Dict[str, Any]] = []
+        symbols: List[str] = []
+        
+        # Extract classes and functions
+        for node in ast.walk(tree):
+            if isinstance(node, (ast.FunctionDef, ast.AsyncFunctionDef)):
+                chunks.append({
+                    'type': 'function',
+                    'name': node.name,
+                    'start_line': node.lineno,
+                    'end_line': node.end_lineno or node.lineno,
+                    'content': ast.get_source_segment(content, node),
+                })
+                symbols.append(node.name)
+            elif isinstance(node, ast.ClassDef):
+                chunks.append({
+                    'type': 'class',
+                    'name': node.name,
+                    'start_line': node.lineno,
+                    'end_line': node.end_lineno or node.lineno,
+                    'content': ast.get_source_segment(content, node),
+                })
+                symbols.append(node.name)
+                
+        return {
+            'file_type': 'python',
+            'content': content,
+            'chunks': chunks,
+            'symbols': symbols
+        }

contextly-0.1.0.dist-info/METADATA

@@ -0,0 +1,209 @@
+Metadata-Version: 2.4
+Name: contextly
+Version: 0.1.0
+Summary: AI Context Engine for Developers
+Project-URL: Homepage, https://github.com/contextly/contextly
+Project-URL: Repository, https://github.com/contextly/contextly
+Project-URL: Documentation, https://github.com/contextly/contextly#readme
+Project-URL: Bug Tracker, https://github.com/contextly/contextly/issues
+Author-email: Contextly Team <team@contextly.dev>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: ai,analysis,code,context,development,documentation,llm
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Topic :: Software Development :: Documentation
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.9
+Requires-Dist: aiohttp>=3.8.0
+Requires-Dist: aiosqlite>=0.19.0
+Requires-Dist: asyncio>=3.4.3
+Requires-Dist: cachetools>=5.3.2
+Requires-Dist: chromadb>=0.4.0
+Requires-Dist: colorama>=0.4.6
+Requires-Dist: huggingface-hub>=0.19.0
+Requires-Dist: openai>=1.0.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: pyyaml>=6.0.0
+Requires-Dist: requests>=2.31.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: sentence-transformers>=2.2.0
+Requires-Dist: tiktoken>=0.5.1
+Requires-Dist: tokenizers>=0.15.0
+Requires-Dist: toml>=0.10.2
+Requires-Dist: tqdm>=4.66.1
+Requires-Dist: transformers>=4.35.0
+Requires-Dist: typer>=0.9.0
+Provides-Extra: dev
+Requires-Dist: black>=23.0.0; extra == 'dev'
+Requires-Dist: isort>=5.12.0; extra == 'dev'
+Requires-Dist: mypy>=1.5.0; extra == 'dev'
+Requires-Dist: pre-commit>=3.3.0; extra == 'dev'
+Requires-Dist: ruff>=0.1.0; extra == 'dev'
+Provides-Extra: test
+Requires-Dist: black>=23.0.0; extra == 'test'
+Requires-Dist: isort>=5.12.0; extra == 'test'
+Requires-Dist: mypy>=1.5.0; extra == 'test'
+Requires-Dist: pytest-asyncio>=0.21.0; extra == 'test'
+Requires-Dist: pytest-cov>=4.0.0; extra == 'test'
+Requires-Dist: pytest>=7.0.0; extra == 'test'
+Requires-Dist: ruff>=0.1.0; extra == 'test'
+Description-Content-Type: text/markdown
+
+# 🧠 Contextly - The AI Context Engine for Developers
+
+> "Know your code. Know your configs. Instantly."
+
+Contextly is your terminal-native AI that helps you understand your codebase and configuration environment with natural-language queries and AI-powered explanations.
+
+## 🎯 Features
+
+- **Natural Language Queries**: Ask questions about your code in plain English
+- **Configuration Management**: Compare and analyze config files (env, json, yaml, etc.)
+- **Semantic Code Search**: Find relevant code snippets by describing what you're looking for
+- **Offline Support**: Built-in local LLM integration with Ollama
+- **Multi-Language Support**: Works with Python, JavaScript, TypeScript, and more
+- **Privacy-Focused**: Your code never leaves your machine (when using local LLMs)
+- **VSCode-Friendly**: All features work directly in your terminal or VS Code
+
+## ⚡ Quick Start
+
+1. **Installation**
+   ```bash
+   pip install contextly
+   ```
+
+2. **Setup (Optional)**
+   ```bash
+   # Configure local LLM (recommended)
+   brew install ollama
+   ollama pull codellama
+
+   # Or set up OpenAI (optional)
+   export OPENAI_API_KEY=your_api_key
+   ```
+
+3. **Initialize in Your Repo**
+   ```bash
+   cd your-project
+   contextly sync
+   ```
+
+## 💡 Usage
+
+### Ask Questions About Your Code
+
+```bash
+# General questions
+contextly ask "How is user authentication handled?"
+contextly ask "What's the database schema like?"
+
+# Specific file questions
+contextly ask "What does the login function in auth.py do?"
+
+# Architecture questions
+contextly ask "What's the overall project structure?"
+```
+
+### Search Code Semantically
+
+```bash
+# Find relevant code
+contextly search "password hashing implementation"
+contextly search "database connection setup"
+```
+
+### Analyze Specific Code
+
+```bash
+# Get explanation for code at a specific line
+contextly explain src/auth.py:42
+
+# Understand a function or class
+contextly explain src/models.py:15
+```
+
+### Compare Config Files
+
+```bash
+# Compare different environment files
+contextly diff .env.dev .env.prod
+
+# Compare any config files
+contextly diff config/local.yml config/prod.yml
+```
+
+## ⚙️ Configuration
+
+Contextly can be configured via environment variables or a `contextly.yml` file in your project root:
+
+```yaml
+# contextly.yml
+llm:
+  provider: ollama  # or 'openai'
+  model: codellama  # or 'gpt-4' for OpenAI
+  temperature: 0.2
+
+embedding:
+  model: all-MiniLM-L6-v2  # Default embedding model
+  cache_dir: .contextly    # Where to store the vector index
+
+parsers:
+  python:
+    enabled: true
+  javascript:
+    enabled: true
+  config:
+    enabled: true
+    extensions: ['.json', '.yml', '.yaml', '.env', '.toml']
+```
+
+### Environment Variables
+
+- `CONTEXTLY_LLM_PROVIDER`: 'ollama' or 'openai'
+- `CONTEXTLY_MODEL`: LLM model to use
+- `OPENAI_API_KEY`: Required if using OpenAI
+- `CONTEXTLY_CACHE_DIR`: Where to store the vector index
+
+## �️ How It Works
+
+Contextly works by:
+
+1. **Parsing**: Analyzes your code and config files using language-specific parsers
+2. **Embedding**: Creates vector embeddings of your code using SentenceTransformers
+3. **Indexing**: Stores embeddings in a local ChromaDB for fast retrieval
+4. **Reasoning**: Uses local or cloud LLMs to understand and explain code
+
+## 🤝 Contributing
+
+Contributions are welcome! Please read our [Contributing Guide](CONTRIBUTING.md) for:
+
+- Setting up the development environment
+- Running tests
+- Code style guidelines
+- Pull request process
+
+## 📝 License
+
+MIT License - see [LICENSE](LICENSE) for details.
+
+## 🙋 FAQ
+
+**Q: How does offline mode work?**  
+A: When using Ollama as the LLM provider, all processing happens locally. Your code never leaves your machine.
+
+**Q: What languages are supported?**  
+A: Currently Python, JavaScript, TypeScript, and various config formats (JSON, YAML, TOML, ENV). More coming soon!
+
+**Q: How can I customize the LLM responses?**  
+A: Adjust the `temperature` setting in your config. Lower values (0.1-0.3) give more precise answers, higher values more creative ones.
+
+**Q: Where is data stored?**  
+A: By default, the vector index is stored in `.contextly/` in your project root. This can be configured via `CONTEXTLY_CACHE_DIR`.

contextly-0.1.0.dist-info/RECORD

@@ -0,0 +1,20 @@
+contextly/__init__.py,sha256=3U7qro-M8x-nW90ysD04EFdcNZsFPBY0iMtAB00L028,79
+contextly/app.py,sha256=_xVXMyvSFAkcwBlra_IskvqUaAKPdzvJpIux9PHOefI,3006
+contextly/cli.py,sha256=t80ANTvbTFe2p-GmtFjJw4fcsS9L8Wvt7NnakcQ1fRc,6066
+contextly/core/analyzer.py,sha256=nffNP8csKcJTcizRHagkG-wGZAFzv8GaQhpkth3VYn0,3699
+contextly/core/embeddings.py,sha256=-53_8Eu31y1r2_3UAW11QuuLvxh6W40JtgVwuKQaZuc,3656
+contextly/core/sync.py,sha256=Au6TSX7pHEObdCegBzbyLcRnHSuU1fnd_0Iq1xCQviE,2166
+contextly/llm/base.py,sha256=aC719bIqiNDJoVO3PVseX63kog0J-UQaGQ53I-ABNS4,469
+contextly/llm/manager.py,sha256=uBclknaDYIdLxG5dXWnaJIFap3bL-9GLDYyN8dtXSUs,4585
+contextly/llm/models.py,sha256=3YKu8P0L-kCN_09nd6GFAFfSb6bWAZy1nn-loe9Qcsc,7560
+contextly/llm/ollama.py,sha256=-j2iaIkTxUFu1oUviD4mkBfjQsI_XaitB1gorHQs2AI,2727
+contextly/llm/openai.py,sha256=LixoxqMkIpyYaNIwLWtY0N9WRqt01CJw7RxxDBpbfC0,1301
+contextly/parsers/base.py,sha256=UPik21ZWA6I78ba9ZIaAH_Z-QfTx7YiQTqbWVPoJ-bY,1090
+contextly/parsers/config.py,sha256=U_QEK5RlcoubPNzZ2mhXpUJY_fwi66t7k0XEHhl12_I,2911
+contextly/parsers/javascript.py,sha256=o6ljpJsrgaczs4adc1h-4zN8HVzcbUrc2H3wWmDzDG0,4602
+contextly/parsers/python.py,sha256=K-Nrix2JIAY2EerZD5jduiBatLUt5i0oMiN522_LXmQ,1981
+contextly-0.1.0.dist-info/METADATA,sha256=AwKUyX09uG0r03J_CyKXX_2g_wNsFYkBwGIr-UIneSk,6538
+contextly-0.1.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+contextly-0.1.0.dist-info/entry_points.txt,sha256=JdeabARo3koshWmxzfNW0NuKPcVoL9voKhKI7PCUL4A,48
+contextly-0.1.0.dist-info/licenses/LICENSE,sha256=70w0CZaboyv7Ppz4U0Ltgcn-PN1TMlc5WIhCJu3ySD4,1070
+contextly-0.1.0.dist-info/RECORD,,

contextly-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.27.0
+Root-Is-Purelib: true
+Tag: py3-none-any

contextly-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+contextly = contextly.cli:app

contextly-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Contextly Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.