u-transkript 1.0.0__tar.gz

u_transkript-1.0.0/MANIFEST.in

@@ -0,0 +1,13 @@
+include README.md
+include LICENSE
+include requirements.txt
+include example.md
+
+include *.py
+
+global-exclude __pycache__
+global-exclude *.py[co]
+global-exclude .DS_Store
+global-exclude *.so
+global-exclude .git*
+prune tests

u_transkript-1.0.0/PKG-INFO

@@ -0,0 +1,284 @@
+Metadata-Version: 2.4
+Name: u-transkript
+Version: 1.0.0
+Summary: YouTube videolarını otomatik olarak çıkarıp AI ile çeviren güçlü Python kütüphanesi
+Home-page: https://github.com/U-C4N/u-transkript
+Author: U-C4N
+Author-email: noreply@deuz.ai
+License: MIT
+Project-URL: Documentation, https://github.com/U-C4N/u-transkript/blob/main/README.md
+Project-URL: Source, https://github.com/U-C4N/u-transkript/
+Project-URL: Tracker, https://github.com/U-C4N/u-transkript/issues
+Keywords: youtube,transcript,translation,ai,gemini,subtitle,video,nlp,machine-learning,automation
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Education
+Classifier: Intended Audience :: Science/Research
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.7
+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
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Multimedia :: Video
+Classifier: Topic :: Text Processing :: Linguistic
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.25.1
+Requires-Dist: lxml>=4.6.0
+Provides-Extra: dev
+Requires-Dist: pytest>=6.0; extra == "dev"
+Requires-Dist: pytest-cov>=2.0; extra == "dev"
+Requires-Dist: black>=21.0; extra == "dev"
+Requires-Dist: flake8>=3.8; extra == "dev"
+Requires-Dist: mypy>=0.800; extra == "dev"
+Provides-Extra: docs
+Requires-Dist: sphinx>=4.0; extra == "docs"
+Requires-Dist: sphinx-rtd-theme>=1.0; extra == "docs"
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license
+Dynamic: project-url
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# 🎬 U-Transkript
+
+[![Python](https://img.shields.io/badge/Python-3.7+-blue.svg)](https://python.org)
+[![License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
+[![PyPI](https://img.shields.io/badge/PyPI-u--transkript-orange.svg)](https://pypi.org/project/u-transkript/)
+[![AI Powered](https://img.shields.io/badge/AI-Gemini%20Powered-purple.svg)](https://ai.google.dev/)
+
+**Powerful Python library to automatically extract and translate YouTube videos with AI**
+
+U-Transkript is a modern and user-friendly Python package that extracts transcripts (subtitles) from YouTube videos and translates them into your desired language using Google Gemini AI. It offers an excellent solution for education, research, content creation, and much more.
+
+## ✨ Features
+
+🤖 **AI-Powered Translation** - High-quality translations with Google Gemini AI
+🌍 **Multi-Language Support** - Ability to translate into 50+ languages
+📊 **Flexible Output Formats** - Get results in TXT, JSON, XML formats
+🔗 **Method Chaining** - Easy to use with chained function calls
+⚡ **Fast and Efficient** - Optimized performance
+🛡️ **Secure** - Error handling and secure API calls
+📝 **Detailed Documentation** - Comprehensive user guide
+
+## 🚀 Quick Start
+
+### Installation
+
+```bash
+pip install u-transkript
+```
+
+### Basic Usage
+
+```python
+from u_transkript import AITranscriptTranslator
+
+# Create Translator
+translator = AITranscriptTranslator("YOUR_GEMINI_API_KEY")
+
+# Translate Video
+result = translator.set_lang("English").translate_transcript("dQw4w9WgXcQ")
+print(result)
+```
+
+### Advanced Usage with Method Chaining
+
+```python
+# Set all settings at once
+result = (translator
+    .set_model("gemini-2.5-flash")
+    .set_lang("English") 
+    .set_type("json")
+    .translate_transcript("VIDEO_ID"))
+```
+
+## 📖 Detailed Documentation
+
+### Main Functions
+
+| Function | Description | Example |
+|-----------|----------|-------|
+| `set_model(model)` | Set the Gemini model | `translator.set_model("gemini-2.5-flash")` |
+| `set_api(api_key)` | Set the API key | `translator.set_api("YOUR_API_KEY")` |
+| `set_lang(language)` | Set the target language | `translator.set_lang("English")` |
+| `set_type(format)` | Set the output format | `translator.set_type("json")` |
+| `translate_transcript(video_id)` | Main translation function | `translator.translate_transcript("VIDEO_ID")` |
+
+### Supported Output Formats
+
+#### 📄 TXT Format
+```python
+translator.set_type("txt")
+# Output: "Hello, this is an example translation..."
+```
+
+#### 📋 JSON Format
+```python
+translator.set_type("json")
+# Output: Structured JSON data (with metadata)
+```
+
+#### 🏷️ XML Format
+```python
+translator.set_type("xml")
+# Output: Full data structure in XML format
+```
+
+### Supported Languages
+
+🇹🇷 Turkish • 🇺🇸 English • 🇪🇸 Spanish • 🇫🇷 French • 🇩🇪 German • 🇮🇹 Italian • 🇵🇹 Portuguese • 🇷🇺 Russian • 🇯🇵 Japanese • 🇰🇷 Korean • 🇨🇳 Chinese • 🇸🇦 Arabic
+
+## 💡 Use Cases
+
+### 📰 News Content
+```python
+# Translating news videos
+result = translator.set_lang("English").translate_transcript("NEWS_VIDEO_ID")
+```
+
+### 💼 Business Presentations
+```python
+# Translating technical presentations
+result = translator.set_type("json").translate_transcript("PRESENTATION_ID")
+```
+
+### 🎬 Content Creation
+```python
+# Translating YouTube content into different languages
+video_ids = ["VIDEO1", "VIDEO2", "VIDEO3"]
+for video_id in video_ids:
+    result = translator.set_lang("English").translate_transcript(video_id)
+    with open(f"{video_id}_en.txt", "w") as f:
+        f.write(result)
+```
+
+## 🔧 Advanced Features
+
+### Custom Prompt Usage
+```python
+custom_prompt = """
+Please translate this text into {language}:
+- Preserve technical terms
+- Use natural language
+- Maintain context
+
+Text: {text}
+"""
+
+result = translator.translate_transcript(
+    "VIDEO_ID",
+    custom_prompt=custom_prompt
+)
+```
+
+### Batch Processing
+```python
+videos = ["VIDEO1", "VIDEO2", "VIDEO3"]
+results = []
+
+for video in videos:
+    try:
+        result = translator.set_lang("English").translate_transcript(video)
+        results.append({"video": video, "translation": result})
+    except Exception as e:
+        results.append({"video": video, "error": str(e)})
+```
+
+### Saving to File
+```python
+# Saving in JSON format
+result = translator.set_type("json").translate_transcript("VIDEO_ID")
+with open("translation.json", "w", encoding="utf-8") as f:
+    f.write(result)
+```
+
+
+## 📊 Performance
+
+| Model | Speed | Quality | Usage |
+|-------|-----|--------|----------|
+| `gemini-2.0-flash-exp` | ⚡⚡⚡ | ⭐⭐⭐ | Fast translations |
+| `gemini-2.5-flash` | ⚡⚡ | ⭐⭐⭐⭐ | Balanced performance |
+| `gemini-pro` | ⚡ | ⭐⭐⭐⭐⭐ | Highest quality |
+
+## 🔍 Troubleshooting
+
+### Common Errors
+
+**API Key Error**
+```python
+# ❌ Incorrect
+translator = AITranscriptTranslator("")
+
+# ✅ Correct  
+translator = AITranscriptTranslator("VALID_API_KEY")
+```
+
+**Video Not Found**
+```python
+# Ensure the Video ID is correct
+video_id = "dQw4w9WgXcQ"  # 11 characters
+```
+
+**Language Error**
+```python
+# ❌ Incorrect
+translator.set_lang("en")
+
+# ✅ Correct
+translator.set_lang("English")
+```
+
+### Debug Mode
+```python
+import logging
+logging.basicConfig(level=logging.DEBUG)
+
+try:
+    result = translator.translate_transcript("VIDEO_ID")
+except Exception as e:
+    print(f"Error: {e}")
+```
+
+## 📈 Roadmap
+
+- [ ] **v1.1.0** - Batch processing support
+- [ ] **v1.2.0** - Caching system
+- [ ] **v1.3.0** - CLI interface
+- [ ] **v1.4.0** - Web interface
+- [ ] **v1.5.0** - Support for more AI models
+
+## 🤝 Contributing
+
+We welcome your contributions! 
+
+1. Fork it
+2. Create your feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit your changes (`git commit -m 'Add amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing-feature`)
+5. Open a Pull Request
+
+## 📄 License
+
+This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
+
+
+## 📞 Contact
+
+- **GitHub**: [u-transkript](https://github.com/U-C4N/u-transkript)
+- **PyPI**: [u-transkript](https://pypi.org/project/u-transkript/)
+- **Documentation**: [example.md](example.md)

u_transkript-1.0.0/README.md

@@ -0,0 +1,229 @@
+# 🎬 U-Transkript
+
+[![Python](https://img.shields.io/badge/Python-3.7+-blue.svg)](https://python.org)
+[![License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
+[![PyPI](https://img.shields.io/badge/PyPI-u--transkript-orange.svg)](https://pypi.org/project/u-transkript/)
+[![AI Powered](https://img.shields.io/badge/AI-Gemini%20Powered-purple.svg)](https://ai.google.dev/)
+
+**Powerful Python library to automatically extract and translate YouTube videos with AI**
+
+U-Transkript is a modern and user-friendly Python package that extracts transcripts (subtitles) from YouTube videos and translates them into your desired language using Google Gemini AI. It offers an excellent solution for education, research, content creation, and much more.
+
+## ✨ Features
+
+🤖 **AI-Powered Translation** - High-quality translations with Google Gemini AI
+🌍 **Multi-Language Support** - Ability to translate into 50+ languages
+📊 **Flexible Output Formats** - Get results in TXT, JSON, XML formats
+🔗 **Method Chaining** - Easy to use with chained function calls
+⚡ **Fast and Efficient** - Optimized performance
+🛡️ **Secure** - Error handling and secure API calls
+📝 **Detailed Documentation** - Comprehensive user guide
+
+## 🚀 Quick Start
+
+### Installation
+
+```bash
+pip install u-transkript
+```
+
+### Basic Usage
+
+```python
+from u_transkript import AITranscriptTranslator
+
+# Create Translator
+translator = AITranscriptTranslator("YOUR_GEMINI_API_KEY")
+
+# Translate Video
+result = translator.set_lang("English").translate_transcript("dQw4w9WgXcQ")
+print(result)
+```
+
+### Advanced Usage with Method Chaining
+
+```python
+# Set all settings at once
+result = (translator
+    .set_model("gemini-2.5-flash")
+    .set_lang("English") 
+    .set_type("json")
+    .translate_transcript("VIDEO_ID"))
+```
+
+## 📖 Detailed Documentation
+
+### Main Functions
+
+| Function | Description | Example |
+|-----------|----------|-------|
+| `set_model(model)` | Set the Gemini model | `translator.set_model("gemini-2.5-flash")` |
+| `set_api(api_key)` | Set the API key | `translator.set_api("YOUR_API_KEY")` |
+| `set_lang(language)` | Set the target language | `translator.set_lang("English")` |
+| `set_type(format)` | Set the output format | `translator.set_type("json")` |
+| `translate_transcript(video_id)` | Main translation function | `translator.translate_transcript("VIDEO_ID")` |
+
+### Supported Output Formats
+
+#### 📄 TXT Format
+```python
+translator.set_type("txt")
+# Output: "Hello, this is an example translation..."
+```
+
+#### 📋 JSON Format
+```python
+translator.set_type("json")
+# Output: Structured JSON data (with metadata)
+```
+
+#### 🏷️ XML Format
+```python
+translator.set_type("xml")
+# Output: Full data structure in XML format
+```
+
+### Supported Languages
+
+🇹🇷 Turkish • 🇺🇸 English • 🇪🇸 Spanish • 🇫🇷 French • 🇩🇪 German • 🇮🇹 Italian • 🇵🇹 Portuguese • 🇷🇺 Russian • 🇯🇵 Japanese • 🇰🇷 Korean • 🇨🇳 Chinese • 🇸🇦 Arabic
+
+## 💡 Use Cases
+
+### 📰 News Content
+```python
+# Translating news videos
+result = translator.set_lang("English").translate_transcript("NEWS_VIDEO_ID")
+```
+
+### 💼 Business Presentations
+```python
+# Translating technical presentations
+result = translator.set_type("json").translate_transcript("PRESENTATION_ID")
+```
+
+### 🎬 Content Creation
+```python
+# Translating YouTube content into different languages
+video_ids = ["VIDEO1", "VIDEO2", "VIDEO3"]
+for video_id in video_ids:
+    result = translator.set_lang("English").translate_transcript(video_id)
+    with open(f"{video_id}_en.txt", "w") as f:
+        f.write(result)
+```
+
+## 🔧 Advanced Features
+
+### Custom Prompt Usage
+```python
+custom_prompt = """
+Please translate this text into {language}:
+- Preserve technical terms
+- Use natural language
+- Maintain context
+
+Text: {text}
+"""
+
+result = translator.translate_transcript(
+    "VIDEO_ID",
+    custom_prompt=custom_prompt
+)
+```
+
+### Batch Processing
+```python
+videos = ["VIDEO1", "VIDEO2", "VIDEO3"]
+results = []
+
+for video in videos:
+    try:
+        result = translator.set_lang("English").translate_transcript(video)
+        results.append({"video": video, "translation": result})
+    except Exception as e:
+        results.append({"video": video, "error": str(e)})
+```
+
+### Saving to File
+```python
+# Saving in JSON format
+result = translator.set_type("json").translate_transcript("VIDEO_ID")
+with open("translation.json", "w", encoding="utf-8") as f:
+    f.write(result)
+```
+
+
+## 📊 Performance
+
+| Model | Speed | Quality | Usage |
+|-------|-----|--------|----------|
+| `gemini-2.0-flash-exp` | ⚡⚡⚡ | ⭐⭐⭐ | Fast translations |
+| `gemini-2.5-flash` | ⚡⚡ | ⭐⭐⭐⭐ | Balanced performance |
+| `gemini-pro` | ⚡ | ⭐⭐⭐⭐⭐ | Highest quality |
+
+## 🔍 Troubleshooting
+
+### Common Errors
+
+**API Key Error**
+```python
+# ❌ Incorrect
+translator = AITranscriptTranslator("")
+
+# ✅ Correct  
+translator = AITranscriptTranslator("VALID_API_KEY")
+```
+
+**Video Not Found**
+```python
+# Ensure the Video ID is correct
+video_id = "dQw4w9WgXcQ"  # 11 characters
+```
+
+**Language Error**
+```python
+# ❌ Incorrect
+translator.set_lang("en")
+
+# ✅ Correct
+translator.set_lang("English")
+```
+
+### Debug Mode
+```python
+import logging
+logging.basicConfig(level=logging.DEBUG)
+
+try:
+    result = translator.translate_transcript("VIDEO_ID")
+except Exception as e:
+    print(f"Error: {e}")
+```
+
+## 📈 Roadmap
+
+- [ ] **v1.1.0** - Batch processing support
+- [ ] **v1.2.0** - Caching system
+- [ ] **v1.3.0** - CLI interface
+- [ ] **v1.4.0** - Web interface
+- [ ] **v1.5.0** - Support for more AI models
+
+## 🤝 Contributing
+
+We welcome your contributions! 
+
+1. Fork it
+2. Create your feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit your changes (`git commit -m 'Add amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing-feature`)
+5. Open a Pull Request
+
+## 📄 License
+
+This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
+
+
+## 📞 Contact
+
+- **GitHub**: [u-transkript](https://github.com/U-C4N/u-transkript)
+- **PyPI**: [u-transkript](https://pypi.org/project/u-transkript/)
+- **Documentation**: [example.md](example.md)

u_transkript-1.0.0/__init__.py

@@ -0,0 +1,145 @@
+"""
+U-Transkript - YouTube videolarını AI ile çeviren Python paketi
+
+Bu paket, YouTube videolarından transcript çıkararak Google Gemini AI ile 
+istediğiniz dile çeviren modern ve kullanıcı dostu bir çözüm sunar.
+
+Temel Kullanım:
+    from u_transkript import AITranscriptTranslator
+    
+    translator = AITranscriptTranslator("YOUR_GEMINI_API_KEY")
+    result = translator.set_lang("Turkish").translate_transcript("VIDEO_ID")
+
+Özellikler:
+    - AI destekli çeviri (Google Gemini)
+    - 50+ dil desteği
+    - TXT, JSON, XML çıktı formatları
+    - Method chaining desteği
+    - Hata yönetimi
+    - Yüksek performans
+"""
+
+from .youtube_transcript import YouTubeTranscriptApi
+from .transcript_list import TranscriptList
+from .fetched_transcript import FetchedTranscript
+from .ai_translator import AITranscriptTranslator
+from .exceptions import (
+    TranscriptRetrievalError,
+    VideoUnavailable,
+    TranscriptNotFound,
+    TranscriptDisabled,
+    NoTranscriptFound,
+    NotTranslatable,
+    TranslationLanguageNotAvailable,
+    CookiePathInvalid,
+    CookiesInvalid,
+    FailedToCreateConsentCookie,
+    NoTranscriptAvailable,
+    TooManyRequests
+)
+from .formatters import (
+    Formatter,
+    PrettyPrintFormatter,
+    JSONFormatter,
+    TextFormatter,
+    SRTFormatter,
+    VTTFormatter
+)
+
+__version__ = "1.0.0"
+__author__ = "U-Transkript Team"
+__email__ = "contact@u-transkript.com"
+__description__ = "YouTube videolarını otomatik olarak çıkarıp AI ile çeviren güçlü Python kütüphanesi"
+__url__ = "https://github.com/username/u-transkript"
+
+# Ana sınıf ve fonksiyonları dışa aktar
+__all__ = [
+    # Ana AI çeviri sınıfı
+    'AITranscriptTranslator',
+    
+    # YouTube transcript API sınıfları
+    'YouTubeTranscriptApi',
+    'TranscriptList',
+    'FetchedTranscript',
+    
+    # Hata sınıfları
+    'TranscriptRetrievalError',
+    'VideoUnavailable',
+    'TranscriptNotFound',
+    'TranscriptDisabled',
+    'NoTranscriptFound',
+    'NotTranslatable',
+    'TranslationLanguageNotAvailable',
+    'CookiePathInvalid',
+    'CookiesInvalid',
+    'FailedToCreateConsentCookie',
+    'NoTranscriptAvailable',
+    'TooManyRequests',
+    
+    # Formatter sınıfları
+    'Formatter',
+    'PrettyPrintFormatter',
+    'JSONFormatter',
+    'TextFormatter',
+    'SRTFormatter',
+    'VTTFormatter'
+]
+
+# Paket bilgileri
+__package_info__ = {
+    "name": "u-transkript",
+    "version": __version__,
+    "description": __description__,
+    "author": __author__,
+    "email": __email__,
+    "url": __url__,
+    "license": "MIT",
+    "python_requires": ">=3.7",
+    "keywords": [
+        "youtube", "transcript", "translation", "ai", "gemini",
+        "subtitle", "video", "nlp", "machine-learning", "automation"
+    ]
+}
+
+def get_version():
+    """Paket versiyonunu döndür."""
+    return __version__
+
+def get_info():
+    """Paket bilgilerini döndür."""
+    return __package_info__
+
+# Hızlı başlangıç fonksiyonu
+def quick_translate(video_id: str, api_key: str, target_language: str = "Turkish", output_type: str = "txt"):
+    """
+    Hızlı çeviri fonksiyonu.
+    
+    Args:
+        video_id: YouTube video ID
+        api_key: Google Gemini API anahtarı
+        target_language: Hedef dil (varsayılan: "Turkish")
+        output_type: Çıktı formatı (varsayılan: "txt")
+    
+    Returns:
+        Çevrilmiş transcript
+    
+    Example:
+        result = quick_translate("dQw4w9WgXcQ", "YOUR_API_KEY", "Turkish")
+    """
+    translator = AITranscriptTranslator(api_key)
+    return translator.set_lang(target_language).set_type(output_type).translate_transcript(video_id)
+
+# Paket yüklendiğinde bilgi mesajı (opsiyonel)
+def _show_welcome_message():
+    """Paket yüklendiğinde hoş geldin mesajı göster."""
+    try:
+        import sys
+        if hasattr(sys, 'ps1'):  # Etkileşimli modda çalışıyorsa
+            print(f"🎬 U-Transkript v{__version__} yüklendi!")
+            print("📖 Kullanım: from u_transkript import AITranscriptTranslator")
+            print("🔗 Dokümantasyon: https://github.com/username/u-transkript")
+    except:
+        pass  # Hata durumunda sessizce geç
+
+# Paket import edildiğinde hoş geldin mesajını göster (opsiyonel)
+# _show_welcome_message()