ilovetools 0.1.1__py3-none-any.whl

ilovetools/__init__.py

@@ -0,0 +1,40 @@
+"""
+ilovetools - A comprehensive Python utility library
+"""
+
+__version__ = "0.1.1"
+__author__ = "Ali Mehdi"
+__email__ = "ali.mehdi.dev579@gmail.com"
+
+# Import all modules for easy access
+from . import ai
+from . import data
+from . import files
+from . import text
+from . import image
+from . import audio
+from . import web
+from . import security
+from . import database
+from . import datetime
+from . import validation
+from . import conversion
+from . import automation
+from . import utils
+
+__all__ = [
+    "ai",
+    "data",
+    "files",
+    "text",
+    "image",
+    "audio",
+    "web",
+    "security",
+    "database",
+    "datetime",
+    "validation",
+    "conversion",
+    "automation",
+    "utils",
+]

ilovetools/ai/__init__.py

@@ -0,0 +1,11 @@
+"""
+AI & Machine Learning utilities module
+"""
+
+from .llm_helpers import token_counter
+from .embeddings import *
+from .inference import *
+
+__all__ = [
+    'token_counter',
+]

ilovetools/ai/embeddings.py

@@ -0,0 +1,5 @@
+"""
+Embedding utilities for text and vector operations
+"""
+
+__all__ = []

ilovetools/ai/inference.py

@@ -0,0 +1,5 @@
+"""
+Model inference optimization utilities
+"""
+
+__all__ = []

ilovetools/ai/llm_helpers.py

@@ -0,0 +1,141 @@
+"""
+LLM helper utilities for working with language models
+"""
+
+import re
+from typing import Union, List
+
+__all__ = ['token_counter']
+
+
+def token_counter(
+    text: Union[str, List[str]], 
+    model: str = "gpt-3.5-turbo",
+    detailed: bool = False
+) -> Union[int, dict]:
+    """
+    Estimate token count for text input across different LLM models.
+    
+    This function provides accurate token estimation for various language models
+    without requiring API calls. Essential for managing costs and staying within
+    context limits.
+    
+    Args:
+        text (str or list): Input text or list of texts to count tokens for
+        model (str): Model name for token estimation. Supported models:
+            - "gpt-3.5-turbo", "gpt-4", "gpt-4-turbo" (OpenAI)
+            - "claude-3", "claude-2" (Anthropic)
+            - "llama-2", "llama-3" (Meta)
+            - "gemini-pro" (Google)
+            Default: "gpt-3.5-turbo"
+        detailed (bool): If True, returns detailed breakdown. Default: False
+    
+    Returns:
+        int: Estimated token count (if detailed=False)
+        dict: Detailed breakdown with tokens, characters, words (if detailed=True)
+    
+    Examples:
+        >>> from ilovetools.ai import token_counter
+        
+        # Basic usage
+        >>> token_counter("Hello, how are you?")
+        6
+        
+        # With specific model
+        >>> token_counter("Hello, how are you?", model="gpt-4")
+        6
+        
+        # Detailed breakdown
+        >>> token_counter("Hello, how are you?", detailed=True)
+        {
+            'tokens': 6,
+            'characters': 19,
+            'words': 4,
+            'model': 'gpt-3.5-turbo',
+            'cost_estimate_1k': 0.0015
+        }
+        
+        # Multiple texts
+        >>> texts = ["First message", "Second message"]
+        >>> token_counter(texts)
+        8
+        
+        # Check if text fits in context window
+        >>> text = "Your long text here..."
+        >>> tokens = token_counter(text, model="gpt-3.5-turbo")
+        >>> if tokens > 4096:
+        ...     print("Text too long for model context!")
+    
+    Notes:
+        - Token estimation is approximate but typically within 5% accuracy
+        - Different models use different tokenization methods
+        - Useful for cost estimation and context window management
+        - No API calls required - works offline
+    
+    References:
+        - OpenAI Tokenization: https://platform.openai.com/tokenizer
+        - Token pricing: https://openai.com/pricing
+    """
+    
+    # Handle list input
+    if isinstance(text, list):
+        text = " ".join(text)
+    
+    # Model-specific token estimation ratios
+    # Based on empirical analysis of different tokenizers
+    model_ratios = {
+        "gpt-3.5-turbo": 0.75,  # ~4 chars per token
+        "gpt-4": 0.75,
+        "gpt-4-turbo": 0.75,
+        "claude-3": 0.72,       # Slightly more efficient
+        "claude-2": 0.72,
+        "llama-2": 0.78,        # Slightly less efficient
+        "llama-3": 0.76,
+        "gemini-pro": 0.74,
+    }
+    
+    # Cost per 1K tokens (USD) - approximate
+    model_costs = {
+        "gpt-3.5-turbo": 0.0015,
+        "gpt-4": 0.03,
+        "gpt-4-turbo": 0.01,
+        "claude-3": 0.015,
+        "claude-2": 0.008,
+        "llama-2": 0.0,  # Open source
+        "llama-3": 0.0,
+        "gemini-pro": 0.00025,
+    }
+    
+    # Get ratio for model (default to GPT-3.5)
+    ratio = model_ratios.get(model.lower(), 0.75)
+    
+    # Character count
+    char_count = len(text)
+    
+    # Word count (simple split)
+    word_count = len(text.split())
+    
+    # Token estimation
+    # Formula: (characters * ratio) with adjustments for spaces and punctuation
+    base_tokens = char_count * ratio
+    
+    # Adjust for spaces (spaces are often separate tokens)
+    space_count = text.count(' ')
+    
+    # Adjust for special characters and punctuation
+    special_chars = len(re.findall(r'[^\w\s]', text))
+    
+    # Final token estimate
+    estimated_tokens = int(base_tokens + (space_count * 0.3) + (special_chars * 0.5))
+    
+    if detailed:
+        return {
+            'tokens': estimated_tokens,
+            'characters': char_count,
+            'words': word_count,
+            'model': model,
+            'cost_estimate_1k': model_costs.get(model.lower(), 0.0),
+            'estimated_cost': (estimated_tokens / 1000) * model_costs.get(model.lower(), 0.0)
+        }
+    
+    return estimated_tokens

ilovetools/audio/__init__.py

@@ -0,0 +1,5 @@
+"""
+Audio processing utilities
+"""
+
+__all__ = []

ilovetools/automation/__init__.py

@@ -0,0 +1,5 @@
+"""
+Task automation utilities
+"""
+
+__all__ = []

ilovetools/conversion/__init__.py

@@ -0,0 +1,5 @@
+"""
+Format conversion utilities
+"""
+
+__all__ = []

ilovetools/data/__init__.py

@@ -0,0 +1,5 @@
+"""
+Data processing and manipulation utilities
+"""
+
+__all__ = []

ilovetools/database/__init__.py

@@ -0,0 +1,5 @@
+"""
+Database connection and query utilities
+"""
+
+__all__ = []

ilovetools/datetime/__init__.py

@@ -0,0 +1,5 @@
+"""
+Date and time utilities
+"""
+
+__all__ = []

ilovetools/files/__init__.py

@@ -0,0 +1,5 @@
+"""
+File operations and management utilities
+"""
+
+__all__ = []

ilovetools/image/__init__.py

@@ -0,0 +1,5 @@
+"""
+Image processing utilities
+"""
+
+__all__ = []

ilovetools/security/__init__.py

@@ -0,0 +1,5 @@
+"""
+Security and encryption utilities
+"""
+
+__all__ = []

ilovetools/text/__init__.py

@@ -0,0 +1,5 @@
+"""
+Text processing and NLP utilities
+"""
+
+__all__ = []

ilovetools/utils/__init__.py

@@ -0,0 +1,5 @@
+"""
+General utility functions
+"""
+
+__all__ = []

ilovetools/validation/__init__.py

@@ -0,0 +1,5 @@
+"""
+Data validation and sanitization utilities
+"""
+
+__all__ = []

ilovetools/web/__init__.py

@@ -0,0 +1,5 @@
+"""
+Web scraping and HTTP utilities
+"""
+
+__all__ = []

ilovetools-0.1.1.dist-info/METADATA

@@ -0,0 +1,143 @@
+Metadata-Version: 2.4
+Name: ilovetools
+Version: 0.1.1
+Summary: A comprehensive Python utility library with modular tools for AI/ML, data processing, and daily programming needs
+Home-page: https://github.com/AliMehdi512/ilovetools
+Author: Ali Mehdi
+Author-email: Ali Mehdi <ali.mehdi.dev579@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/AliMehdi512/ilovetools
+Project-URL: Repository, https://github.com/AliMehdi512/ilovetools
+Project-URL: Issues, https://github.com/AliMehdi512/ilovetools/issues
+Keywords: utilities,tools,ai,ml,data-processing,automation
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: author
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
+
+# 🛠️ ilovetools
+
+A comprehensive Python utility library with modular tools for AI/ML, data processing, file operations, and daily programming needs.
+
+[![Python Version](https://img.shields.io/badge/python-3.8%2B-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![PyPI version](https://badge.fury.io/py/ilovetools.svg)](https://badge.fury.io/py/ilovetools)
+
+## 📦 Installation
+
+```bash
+pip install ilovetools
+```
+
+## 🚀 Quick Start
+
+```python
+from ilovetools import ai, data, files, text
+
+# AI utilities
+embeddings = ai.quick_embed("Your text here")
+
+# Data processing
+cleaned_data = data.auto_clean(your_dataframe)
+
+# File operations
+files.smart_read("any_file.xyz")
+
+# Text processing
+emails = text.extract_emails("Contact us at hello@example.com")
+```
+
+## 📚 Modules
+
+### 🤖 AI & Machine Learning (`ilovetools.ai`)
+Advanced AI/ML utilities for modern development:
+- LLM helpers and prompt engineering
+- Model loading and inference optimization
+- Embeddings and vector operations
+- RAG pipeline tools
+- Fine-tuning utilities
+
+### 📊 Data Processing (`ilovetools.data`)
+Smart data manipulation and analysis tools
+
+### 📁 File Operations (`ilovetools.files`)
+Intelligent file handling and management
+
+### 📝 Text Processing (`ilovetools.text`)
+Advanced text manipulation and NLP utilities
+
+### 🖼️ Image Tools (`ilovetools.image`)
+Image processing and computer vision helpers
+
+### 🎵 Audio Tools (`ilovetools.audio`)
+Audio processing utilities
+
+### 🌐 Web Utilities (`ilovetools.web`)
+Web scraping and HTTP helpers
+
+### 🔐 Security (`ilovetools.security`)
+Encryption and security tools
+
+### 💾 Database (`ilovetools.database`)
+Database connection and query helpers
+
+### ⏰ DateTime (`ilovetools.datetime`)
+Advanced date and time utilities
+
+### ✅ Validation (`ilovetools.validation`)
+Data validation and sanitization
+
+### 🔄 Conversion (`ilovetools.conversion`)
+Format converters and transformers
+
+### 🤖 Automation (`ilovetools.automation`)
+Task automation helpers
+
+### 🔧 Utils (`ilovetools.utils`)
+General utility functions
+
+## 📖 Documentation
+
+Full documentation available at: [Coming Soon]
+
+## 🤝 Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## 📄 License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## 👨‍💻 Author
+
+**Ali Mehdi**
+- GitHub: [@AliMehdi512](https://github.com/AliMehdi512)
+- WhatsApp: https://wa.me/923264747914
+
+## 🌟 Support
+
+If you find this library useful, please give it a star ⭐️
+
+## 📝 Changelog
+
+### Version 0.1.0 (Initial Release)
+- Initial library structure
+- Core module setup
+- Basic utilities
+
+---
+
+Built with ❤️ for the Python community

ilovetools-0.1.1.dist-info/RECORD

@@ -0,0 +1,24 @@
+ilovetools/__init__.py,sha256=hm1B4leFU-c8B8IUTb28t58TjI9WE0meNqp63N49MS0,698
+ilovetools/ai/__init__.py,sha256=2Ozehn-E_YakbtdiK4gGRL-WqT-uZ_ayWvzhSBU_U7s,174
+ilovetools/ai/embeddings.py,sha256=VNr9PJdWZ4xGq3nz-SCe2wU6c0-NSpDdabSs6fmXG40,72
+ilovetools/ai/inference.py,sha256=lDuREwf04BkaHGmkKQwgy3wwZRVlNy8A607vzwL-oLE,60
+ilovetools/ai/llm_helpers.py,sha256=IgEGEF1s5VSZ2KndrdqXicH7M7n4PV9c2CdOAY-239s,4432
+ilovetools/audio/__init__.py,sha256=B7atdH2nayCangy6b5FolqWNX2vfjh-K2gLx9kMNGmw,48
+ilovetools/automation/__init__.py,sha256=sYuGw2tJBw8fgk8qhQNRyK-6XIqeLyoWo83QPT3fC7k,47
+ilovetools/conversion/__init__.py,sha256=8bs3-l10sx-_XCeYpjqjSzbpW0UuXJrz0-HBM_hrkIM,49
+ilovetools/data/__init__.py,sha256=bUNFEHvRugVDYkvg54MZHk3b_SanmeIZLZHF4UmYEJI,64
+ilovetools/database/__init__.py,sha256=ksuVyzDM5GdRSulLWghRy-MVGDFy8wbacLuV9DqHImQ,61
+ilovetools/datetime/__init__.py,sha256=znPdTvHcFRTXRgOH8VSGnFLJeNvd3_J1yKRmOq0hHOA,45
+ilovetools/files/__init__.py,sha256=OX27wVQYKB_oPxvL39kWhCDpu5Tt8jGH22MKtYEnK-c,62
+ilovetools/image/__init__.py,sha256=neiSIIZN7i_0CqR0y-neckF_1-45otKjw_dsDaE8gMo,48
+ilovetools/security/__init__.py,sha256=jQg05Gi5QOqFwNhj4kpaVB0rlQy2JvfwD9DHaeqR3iA,55
+ilovetools/text/__init__.py,sha256=tt5iXyHNCQYvomL9Z9ubro4HmckI8W-EKgdKEiTFuWA,55
+ilovetools/utils/__init__.py,sha256=nFtUxlJeWBFZRl7U2wz4REbrwoLjlKif3tYKdMgzn9s,47
+ilovetools/validation/__init__.py,sha256=gnYqT3k_2LYjM0jr-pSnnyMjCBvOrKmGhYS2RoL7Bu8,64
+ilovetools/web/__init__.py,sha256=7HNp0mfw8OVHqxFvJ_M-UfJraG2BX-g3vvOlcSNCQ5w,53
+ilovetools-0.1.1.dist-info/licenses/LICENSE,sha256=pFIsQeo2ZIARy0yDsoT-FYYHdiol7mGq1rtKPYIYn20,1065
+tests/__init__.py,sha256=hiWUFgSflKQWFZ6mOX9sNUbogc6-Vf6xGdY_8-Kk56w,33
+ilovetools-0.1.1.dist-info/METADATA,sha256=i397vdqWZjgQRjxoavtCrk1Wewcj9OFWwabgZPJvmjk,4088
+ilovetools-0.1.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+ilovetools-0.1.1.dist-info/top_level.txt,sha256=_JECI73sb4vs7YXZi9JjtIkpCd760dBOVm2ehxYoJIE,17
+ilovetools-0.1.1.dist-info/RECORD,,

ilovetools-0.1.1.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

ilovetools-0.1.1.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Ali Mehdi
+
+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.

ilovetools-0.1.1.dist-info/top_level.txt

@@ -0,0 +1,2 @@
+ilovetools
+tests

tests/__init__.py

@@ -0,0 +1,3 @@
+"""
+Test suite for ilovetools
+"""