janito 0.11.0__py3-none-any.whl → 0.12.0__py3-none-any.whl

janito-0.12.0.dist-info/METADATA

@@ -0,0 +1,203 @@
+Metadata-Version: 2.4
+Name: janito
+Version: 0.12.0
+Summary: Janito CLI tool
+Project-URL: Homepage, https://github.com/joaompinto/janito
+Author-email: João Pinto <lamego.pinto@gmail.com>
+License-File: LICENSE
+Requires-Python: >=3.8
+Requires-Dist: anthropic>=0.5.0
+Requires-Dist: beautifulsoup4>=4.13.0
+Requires-Dist: claudine>=0.1.0
+Requires-Dist: jinja2>=3.0.0
+Requires-Dist: lxml-html-clean>=0.4.1
+Requires-Dist: newspaper3k>=0.2.8
+Requires-Dist: requests>=2.32.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: trafilatura>=1.6.0
+Requires-Dist: typer>=0.9.0
+Description-Content-Type: text/markdown
+
+# 🤖 Janito
+
+Janito is a powerful AI-assisted command-line interface (CLI) tool built with Python, leveraging Anthropic's Claude for intelligent code and file management.
+
+[![GitHub Repository](https://img.shields.io/badge/GitHub-Repository-blue?logo=github)](https://github.com/joaompinto/janito)
+
+## ✨ Features
+
+- 🧠 Intelligent AI assistant powered by Claude
+- 📁 File management capabilities with real-time output
+- 🔍 Smart code search and editing
+- 💻 Interactive terminal interface with rich formatting
+- 📊 Detailed token usage tracking and cost reporting with cache savings analysis
+- 🛑 Token and tool usage reporting even when interrupted with Ctrl+C
+- 🌐 Web page fetching with content extraction capabilities
+- 🔄 Parameter profiles for optimizing Claude's behavior for different tasks
+- 📋 Line delta tracking to monitor net changes in files
+
+## 🛠️ System Requirements
+
+- **Python 3.8+** - Janito requires Python 3.8 or higher
+- **Operating Systems**:
+  - Linux/macOS: Native support
+  - Windows: Requires Git Bash for proper operation of CLI tools
+- **Anthropic API Key** - Required for Claude AI integration
+
+## 🛠️ Installation
+
+```bash
+# Install directly from PyPI
+pip install janito
+```
+
+### Setting up your API Key
+
+Janito requires an Anthropic API key to function. You can:
+1. Set the API key: `janito --set-api-key your_api_key`
+
+For development or installation from source, please see [README_DEV.md](README_DEV.md).
+
+## 🚀 Usage Tutorial
+
+After installation, you can start using Janito right away. Let's walk through a simple tutorial:
+
+### Getting Started
+
+First, let's check that everything is working:
+
+```bash
+# Get help and see available commands
+janito --help
+```
+
+### Tutorial: Creating a Simple Project
+
+Let's create a simple HTML project with Janito's help:
+
+After installing Janito, using your prefered editor and/or terminal, go to a new empty folder.
+
+Use the janito command to create a new project.
+
+```bash
+# Step 1: Create a new project structure
+janito "Create a simple HTML page with a calculator and 3 columns with text for the 3 main activities of the Kazakh culture"
+```
+Browse the resulting html page.
+
+### Tutorial: Adding Features
+
+Now, let's enhance our example
+
+```bash
+# Step 2: Add multiplication and division features
+janito "Add some svg icons and remove the calculator"
+
+```
+
+Refresh the page
+
+### Exploring More Features
+
+Janito offers many more capabilities:
+
+```bash
+# Show detailed token usage and cost information
+janito --show-tokens "Explain what is in the project"
+
+# Use a specific parameter profile for creative tasks
+janito --profile creative "Write a fun description for our project"
+
+# Continue previous conversation
+janito --continue "Plese add one more line"
+
+# Show current configuration and available profiles
+janito --show-config
+
+# You can press Ctrl+C at any time to interrupt a query
+# Janito will still display token and tool usage information
+```
+
+## 🔧 Available Tools
+
+Janito comes with several built-in tools:
+- 📄 `str_replace_editor` - View, create, and edit files
+- 🔎 `find_files` - Find files matching patterns
+- 🗑️ `delete_file` - Delete files
+- 🔍 `search_text` - Search for text patterns in files
+- 🌐 `fetch_webpage` - Fetch and extract content from web pages
+- 📋 `move_file` - Move files from one location to another
+- 💻 `bash` - Execute bash commands with real-time output display
+
+## 📊 Usage Tracking
+
+Janito includes a comprehensive token usage tracking system that helps you monitor API costs:
+
+- **Basic tracking**: By default, Janito displays a summary of token usage and cost after each query
+- **Detailed reporting**: Use the `--show-tokens` or `-t` flag to see detailed breakdowns including:
+  - Input and output token counts
+  - Per-tool token usage statistics
+  - Precise cost calculations
+  - Cache performance metrics with savings analysis
+  - Line delta tracking for file modifications
+
+```bash
+# Show detailed token usage and cost information
+janito --show-tokens "Write a Python function to sort a list"
+
+# Basic usage (shows simplified token usage summary)
+janito "Explain Docker containers"
+```
+
+The usage tracker automatically calculates cache savings, showing you how much you're saving by reusing previous responses.
+
+## 📋 Parameter Profiles
+
+Janito offers predefined parameter profiles to optimize Claude's behavior for different tasks:
+
+- **precise**: Factual answers, documentation, structured data (temperature: 0.2)
+- **balanced**: Professional writing, summarization, everyday tasks (temperature: 0.5)
+- **conversational**: Natural dialogue, educational content (temperature: 0.7)
+- **creative**: Storytelling, brainstorming, marketing copy (temperature: 0.9)
+- **technical**: Code generation, debugging, technical problem-solving (temperature: 0.3)
+
+```bash
+# Use a specific profile
+janito --profile creative "Write a poem about coding"
+
+# View available profiles
+janito --show-config
+```
+
+## ⚙️ Dependencies
+
+Janito automatically installs the following dependencies:
+- typer (>=0.9.0) - For CLI interface
+- rich (>=13.0.0) - For rich text formatting
+- claudine - For Claude AI integration
+- Additional packages for file handling and web content extraction
+
+## 🔑 API Key Configuration
+
+You can configure your Anthropic API key in several ways:
+
+```bash
+# Option 1: Set as environment variable
+export ANTHROPIC_API_KEY=your_api_key
+
+# Option 2: Configure globally within Janito
+janito --set-api-key your_api_key
+
+# Option 3: Let Janito prompt you on first use
+janito "Hello, I'm new to Janito!"
+```
+
+Your API key is securely stored and used for all future sessions.
+
+## 💻 Development
+
+For development instructions, please refer to [README_DEV.md](README_DEV.md).
+
+## 📜 License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

janito-0.12.0.dist-info/RECORD

@@ -0,0 +1,47 @@
+janito/__init__.py,sha256=UhMcaPInS2sBvYxOLldeLu7sKy-ZZxndtrf6NPqQBgI,53
+janito/__main__.py,sha256=Oy-Nc1tZkpyvTKuq1R8oHSuJTkvptN6H93kIHBu7DKY,107
+janito/callbacks.py,sha256=E1FPXYHZUgiEGMabYuf999PSf_Su4ByHOWlc1-hMqWE,915
+janito/config.py,sha256=haIErp8tVL6e_5h4fsgLqFib2aCAZZ3sIXa8wStn_yo,12424
+janito/test_file.py,sha256=c6GWGdTYG3z-Y5XBao9Tmhmq3G-v0L37OfwLgBo8zIU,126
+janito/token_report.py,sha256=Mks7o2yTxPChgQyBJNoQ5eMmrhSgEM4LKCKi2tHJbVo,9580
+janito/cli/__init__.py,sha256=dVi9l3E86YyukjxQ-XSUnMZkghnNasXex-X5XAOBiwk,85
+janito/cli/agent.py,sha256=AYJhSqPbz1Ywz_RBzHxfXIK6x-aZrqA8-C2QzmxZ3J8,10533
+janito/cli/app.py,sha256=RghsHSmvnECGWzoAeQOJdxHTZM_Xcw6Y4jgbJ5I6-5M,4131
+janito/cli/commands.py,sha256=c1EHJ_VZR_3aA3zRvCLaBn9yfdj5emQpTI0Z_bXcIyc,12664
+janito/cli/output.py,sha256=mo3hUokhrD4SWexUjCbLGGQeCDUf0369DA_i9BW7HjU,933
+janito/cli/utils.py,sha256=gO4NtCNwtEzYDsQesrFlqB5FtYuw87yGwo4iG3nINgw,661
+janito/data/instructions_template.txt,sha256=oXmjVEajwLuTjcyXyD123CGSjNG1QLbfzbw9iEq-w5w,1411
+janito/tools/__init__.py,sha256=hio75FRkxLSQB13We-SCCM7Qa9lMqWCfWhEonHlTr8M,1405
+janito/tools/decorators.py,sha256=Tp48n5y4LKsjyV3HeOA9wk2dV413RrEG-23kRyQVlKs,2522
+janito/tools/delete_file.py,sha256=UrZ5q59SIxWfuJcqgol6yPBqL-RhO9lFCF4MqAc6o00,2252
+janito/tools/find_files.py,sha256=c_N9ETcRPprQeuZYanwFnl-9E05ZqUYhNVoCRS5uqQg,8300
+janito/tools/move_file.py,sha256=FCs1ghalfHlXmcbAA_IlLcUll9hTOU1MMFGrTWopXvM,2741
+janito/tools/prompt_user.py,sha256=OnTiWVBCbL_2MYu7oThlKr8X_pnYdG-dzxXSOgJF41c,1942
+janito/tools/replace_file.py,sha256=i4GoLtS14eKSU5lYI18mJ96S0_ekeHMwlQfazg-fxrM,2296
+janito/tools/rich_console.py,sha256=VyLStA7fCgMGp9KZ0TYHAC3FOOAWKKHx1XTWWWF2ISI,4560
+janito/tools/search_text.py,sha256=hZLgKlF_cC5JRQ2XsussndSZMmptwr8d0tTKCyCXFwg,9755
+janito/tools/usage_tracker.py,sha256=IE7GVBDYsX2EDLjsVaVqTeAnT2SAYfcOJvBaH__wHdU,4613
+janito/tools/bash/bash.py,sha256=gOYhp2CexuEjSSpHGhVQLr-Ooc67Etl7Br1TbRtY6vc,3577
+janito/tools/bash/unix_persistent_bash.py,sha256=tFFhbG9rk1KcONmG0j6SZHrqYxCXELhzobRSTEHPFm0,6868
+janito/tools/bash/win_persistent_bash.py,sha256=mMgAdRi7jlznq7ssNmgiSMEqzEI-rIV0kgYpndcum6U,12758
+janito/tools/fetch_webpage/__init__.py,sha256=0RG0ev-yrfo8gPzt-36WMpVdY2qtMhk2Z-mVpq-7m1o,1076
+janito/tools/fetch_webpage/chunking.py,sha256=mMtrZeirZ_GnKOOzeG8BijLVpSUI0-TA5Ioqi2HKb1A,2971
+janito/tools/fetch_webpage/core.py,sha256=3XDvYnC_UbQUNumwWw32hfJhjJUEaPzzoF2yhxhwxos,7764
+janito/tools/fetch_webpage/extractors.py,sha256=-jrLDRWfWyF2SNOATdRWrqETqnnDLbe2JUWtuyHKFOU,12043
+janito/tools/fetch_webpage/news.py,sha256=Hp0uNTnRzTa-4hyegQbHSmLeSbkiSpx4cP2oP_hKLEQ,5378
+janito/tools/fetch_webpage/utils.py,sha256=mkfwefD7U9HOktIwo1eP63v7dpVY-q06COUjaqnTT5M,3412
+janito/tools/str_replace_editor/__init__.py,sha256=kYmscmQgft3Jzt3oCNz7k2FiRbJvku6OFDDC3Q_zoAA,144
+janito/tools/str_replace_editor/editor.py,sha256=BckYfiMRUYDfDrbu871qMt2AfZexth_02QhwYYOd53g,2489
+janito/tools/str_replace_editor/utils.py,sha256=akiPqCHjky_RwL9OitHJJ7uQ-3fNaA8wt_K_YO1EP6I,954
+janito/tools/str_replace_editor/handlers/__init__.py,sha256=RP6JCeDRIL4R-lTpGowIoOAi64gg6VxZvJGp8Q2UOVU,373
+janito/tools/str_replace_editor/handlers/create.py,sha256=s8RQE04kDAL7OLZA8WxJkDqTmJlGmCNiit4tIHnmNMo,2470
+janito/tools/str_replace_editor/handlers/insert.py,sha256=eKHodm2ozKUlRMxWMLAsu9ca6unUo1jfXWwHSld-pSU,4061
+janito/tools/str_replace_editor/handlers/str_replace.py,sha256=quHQ1vOqvXCPaC14W5iub01kKB4XNMqwh1odnXnhhxY,4459
+janito/tools/str_replace_editor/handlers/undo.py,sha256=3OIdAWkpXC2iDe94_sfx_WxEFh3a1cRzoP0NtPXq1Ks,2491
+janito/tools/str_replace_editor/handlers/view.py,sha256=ZWcx7r5VwxWG3ImQxK2lzONL9xlqctM-hy2kMF-huT0,6616
+janito/data/instructions_template.txt,sha256=oXmjVEajwLuTjcyXyD123CGSjNG1QLbfzbw9iEq-w5w,1411
+janito-0.12.0.dist-info/METADATA,sha256=oR3nvTukvj3uPVcZ2LbAA4lx46W08elLhWphDWXpAAs,6458
+janito-0.12.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+janito-0.12.0.dist-info/entry_points.txt,sha256=JMbF_1jg-xQddidpAYkzjOKdw70fy_ymJfcmerY2wIY,47
+janito-0.12.0.dist-info/licenses/LICENSE,sha256=6-H8LXExbBIAuT4cyiE-Qy8Bad1K4pagQRVTWr6wkhk,1096
+janito-0.12.0.dist-info/RECORD,,

janito/chat_history.py

@@ -1,117 +0,0 @@
-"""
-Chat history module for Janito.
-Handles storing and loading chat history.
-"""
-import os
-import json
-import datetime
-from pathlib import Path
-from typing import List, Dict, Any, Optional
-from janito.config import get_config
-
-def ensure_chat_history_dir() -> Path:
-    """
-    Ensure the chat history directory exists.
-    
-    Returns:
-        Path: Path to the chat history directory
-    """
-    workspace_dir = get_config().workspace_dir
-    chat_history_dir = Path(workspace_dir) / ".janito" / "chat_history"
-    chat_history_dir.mkdir(parents=True, exist_ok=True)
-    return chat_history_dir
-
-
-
-def store_conversation(query: str, response: str, agent=None) -> None:
-    """
-    Store a conversation in the chat history.
-    
-    Args:
-        query: The user's query
-        response: The agent's response
-        agent: Optional agent instance for using get_messages method
-    """
-    chat_history_dir = ensure_chat_history_dir()
-    timestamp = datetime.datetime.now().strftime("%Y%m%d_%H%M%S")
-    filename = f"{timestamp}.json"
-    
-    # Create the conversation data
-    conversation = {
-        "timestamp": timestamp,
-        "query": query,
-        "response": response
-    }
-    
-    # Write to file
-    with open(chat_history_dir / filename, "w", encoding="utf-8") as f:
-        json.dump(conversation, f, ensure_ascii=False, indent=2)
-
-def load_recent_conversations(count: int = 5) -> List[Dict[str, str]]:
-    """
-    Load the most recent conversations from the chat history.
-    
-    Args:
-        count: Number of conversations to load
-        
-    Returns:
-        List[Dict[str, str]]: List of conversations
-    """
-    chat_history_dir = ensure_chat_history_dir()
-    
-    # Get all JSON files in the chat history directory
-    history_files = list(chat_history_dir.glob("*.json"))
-    
-    # Sort by filename (which includes timestamp)
-    history_files.sort(reverse=True)
-    
-    # Load the most recent conversations
-    conversations = []
-    for file_path in history_files[:count]:
-        try:
-            with open(file_path, "r", encoding="utf-8") as f:
-                conversation = json.load(f)
-                conversations.append(conversation)
-        except Exception as e:
-            print(f"Error loading chat history file {file_path}: {e}")
-    
-    return conversations
-
-def format_conversation_for_context(conversation: Dict[str, str]) -> str:
-    """
-    Format a conversation for inclusion in the context.
-    
-    Args:
-        conversation: The conversation to format
-        
-    Returns:
-        str: The formatted conversation
-    """
-    timestamp = conversation.get("timestamp", "Unknown time")
-    query = conversation.get("query", "")
-    response = conversation.get("response", "")
-    
-    formatted_time = datetime.datetime.strptime(timestamp, "%Y%m%d_%H%M%S").strftime("%Y-%m-%d %H:%M:%S")
-    
-    return f"--- Conversation from {formatted_time} ---\nUser: {query}\n\nAssistant: {response}\n\n"
-
-def get_chat_history_context(count: int = 5) -> str:
-    """
-    Get the chat history formatted for inclusion in the agent's context.
-    
-    Args:
-        count: Number of conversations to include
-        
-    Returns:
-        str: The formatted chat history
-    """
-    conversations = load_recent_conversations(count)
-    
-    if not conversations:
-        return ""
-    
-    context = "# Previous conversations:\n\n"
-    for conversation in conversations:
-        context += format_conversation_for_context(conversation)
-    
-    return context

janito/data/instructions.txt

@@ -1,4 +0,0 @@
-You are an expert software engineer, working in a project.
-When using str_replace_editor be aware that our files starting path is "." .
-
-If creating or editing files with a large number of lines, organize them into smaller files.

janito/tools/bash.py

@@ -1,22 +0,0 @@
-from typing import Optional
-from typing import Tuple
-
-
-def bash_tool(command: str, restart: Optional[bool] = False) -> Tuple[str, bool]:
-    """
-    A simple bash tool implementation that just prints the command and restart flag.
-    
-    Args:
-        command: The bash command to execute
-        restart: Whether to restart the process
-        
-    Returns:
-        A tuple containing (output message, is_error flag)
-    """
-    # In a real implementation, this would execute the command
-    # Here we just print what would be executed
-    output = f"Would execute bash command: '{command}'\n"
-    output += f"Restart flag is set to: {restart}"
-
-    # Return the output with is_error=False
-    return output, False