clapp-pm 1.0.17__py3-none-any.whl → 1.0.19__py3-none-any.whl

docs/developer_guide.md

@@ -0,0 +1,361 @@
+# clapp Geliştirici Rehberi
+
+Bu rehber, clapp için uygulama geliştirmek isteyen geliştiriciler için hazırlanmıştır.
+
+## 📋 İçindekiler
+
+1. [Başlangıç](#başlangıç)
+2. [Manifest Dosyası](#manifest-dosyası)
+3. [Desteklenen Diller](#desteklenen-diller)
+4. [Uygulama Yapısı](#uygulama-yapısı)
+5. [Bağımlılık Yönetimi](#bağımlılık-yönetimi)
+6. [Test ve Doğrulama](#test-ve-doğrulama)
+7. [Yayınlama](#yayınlama)
+8. [En İyi Uygulamalar](#en-iyi-uygulamalar)
+
+## 🚀 Başlangıç
+
+### Yeni Uygulama Oluşturma
+
+Yeni bir clapp uygulaması oluşturmak için:
+
+```bash
+# Python uygulaması oluştur
+clapp new python my-app
+
+# Lua uygulaması oluştur
+clapp new lua my-lua-app
+
+# Diğer diller için
+clapp new dart my-dart-app
+clapp new go my-go-app
+clapp new rust my-rust-app
+```
+
+### Manuel Oluşturma
+
+Eğer `clapp new` komutu henüz mevcut değilse, manuel olarak oluşturabilirsiniz:
+
+1. Yeni bir klasör oluşturun
+2. `manifest.json` dosyası ekleyin
+3. Giriş dosyanızı oluşturun
+4. Gerekli dosyaları ekleyin
+
+## 📄 Manifest Dosyası
+
+Her clapp uygulaması bir `manifest.json` dosyasına sahip olmalıdır.
+
+### Zorunlu Alanlar
+
+```json
+{
+  "name": "my-app",
+  "version": "1.0.0",
+  "language": "python",
+  "entry": "main.py"
+}
+```
+
+### Opsiyonel Alanlar
+
+```json
+{
+  "name": "my-app",
+  "version": "1.0.0",
+  "language": "python",
+  "entry": "main.py",
+  "description": "Uygulama açıklaması",
+  "author": "Geliştirici Adı",
+  "license": "MIT",
+  "dependencies": ["other-app"],
+  "tags": ["utility", "tool"],
+  "category": "productivity"
+}
+```
+
+### Alan Açıklamaları
+
+- **name**: Uygulama adı (benzersiz olmalı)
+- **version**: Sürüm numarası (semantic versioning önerilir)
+- **language**: Programlama dili (python, lua, dart, go, rust, vb.)
+- **entry**: Giriş dosyası (uygulamanın başlangıç noktası)
+- **description**: Uygulama açıklaması
+- **author**: Geliştirici bilgisi
+- **license**: Lisans bilgisi
+- **dependencies**: Bağımlılık listesi (diğer clapp uygulamaları)
+- **tags**: Etiketler (arama için)
+- **category**: Kategori (store, productivity, game, vb.)
+
+## 🌐 Desteklenen Diller
+
+### Python
+- **Dosya uzantısı**: `.py`
+- **Giriş noktası**: `python main.py`
+- **Örnek**: `main.py`
+
+### Lua
+- **Dosya uzantısı**: `.lua`
+- **Giriş noktası**: `lua main.lua`
+- **Örnek**: `main.lua`
+
+### Dart
+- **Dosya uzantısı**: `.dart`
+- **Giriş noktası**: `dart main.dart`
+- **Örnek**: `main.dart`
+
+### Go
+- **Dosya uzantısı**: `.go`
+- **Giriş noktası**: `go run main.go`
+- **Örnek**: `main.go`
+
+### Rust
+- **Dosya uzantısı**: `.rs`
+- **Giriş noktası**: `cargo run`
+- **Örnek**: `Cargo.toml` + `src/main.rs`
+
+### Node.js
+- **Dosya uzantısı**: `.js`
+- **Giriş noktası**: `node main.js`
+- **Örnek**: `main.js`
+
+### Bash
+- **Dosya uzantısı**: `.sh`
+- **Giriş noktası**: `bash main.sh`
+- **Örnek**: `main.sh`
+
+### Perl
+- **Dosya uzantısı**: `.pl`
+- **Giriş noktası**: `perl main.pl`
+- **Örnek**: `main.pl`
+
+### Ruby
+- **Dosya uzantısı**: `.rb`
+- **Giriş noktası**: `ruby main.rb`
+- **Örnek**: `main.rb`
+
+### PHP
+- **Dosya uzantısı**: `.php`
+- **Giriş noktası**: `php main.php`
+- **Örnek**: `main.php`
+
+## 📁 Uygulama Yapısı
+
+### Temel Yapı
+
+```
+my-app/
+├── manifest.json      # Zorunlu
+├── main.py           # Giriş dosyası (manifest'te belirtilen)
+├── README.md         # Opsiyonel
+├── requirements.txt  # Python bağımlılıkları (opsiyonel)
+└── assets/           # Statik dosyalar (opsiyonel)
+    ├── images/
+    └── data/
+```
+
+### Örnek Python Uygulaması
+
+**manifest.json:**
+```json
+{
+  "name": "hello-world",
+  "version": "1.0.0",
+  "language": "python",
+  "entry": "main.py",
+  "description": "Basit bir Hello World uygulaması",
+  "author": "Geliştirici",
+  "tags": ["example", "hello"]
+}
+```
+
+**main.py:**
+```python
+#!/usr/bin/env python3
+
+def main():
+    print("Merhaba Dünya!")
+    print("Bu bir clapp uygulamasıdır.")
+
+if __name__ == "__main__":
+    main()
+```
+
+### Örnek Lua Uygulaması
+
+**manifest.json:**
+```json
+{
+  "name": "lua-calculator",
+  "version": "1.0.0",
+  "language": "lua",
+  "entry": "main.lua",
+  "description": "Basit hesap makinesi",
+  "tags": ["calculator", "math"]
+}
+```
+
+**main.lua:**
+```lua
+#!/usr/bin/env lua
+
+function main()
+    print("Lua Hesap Makinesi")
+    print("2 + 2 = " .. (2 + 2))
+end
+
+main()
+```
+
+## 🔗 Bağımlılık Yönetimi
+
+### clapp Bağımlılıkları
+
+Manifest dosyasında diğer clapp uygulamalarını bağımlılık olarak belirtebilirsiniz:
+
+```json
+{
+  "name": "my-app",
+  "version": "1.0.0",
+  "language": "python",
+  "entry": "main.py",
+  "dependencies": ["database-app", "auth-app"]
+}
+```
+
+### Sistem Bağımlılıkları
+
+Her dil için sistem bağımlılıkları farklı şekilde yönetilir:
+
+#### Python
+- `requirements.txt` dosyası kullanın
+- `pip install -r requirements.txt` otomatik çalışır
+
+#### Node.js
+- `package.json` dosyası kullanın
+- `npm install` otomatik çalışır
+
+#### Rust
+- `Cargo.toml` dosyası kullanın
+- `cargo build` otomatik çalışır
+
+### Bağımlılık Kontrolü
+
+```bash
+# Uygulama bağımlılıklarını kontrol et
+clapp dependency check my-app
+
+# Bağımlılık ağacını göster
+clapp dependency tree my-app
+```
+
+## 🧪 Test ve Doğrulama
+
+### Uygulama Doğrulama
+
+```bash
+# Uygulama klasörünü doğrula
+clapp validate ./my-app
+```
+
+### Test Çalıştırma
+
+```bash
+# Uygulamayı test et
+clapp run my-app
+```
+
+### Bağımlılık Testi
+
+```bash
+# Bağımlılıkları test et
+clapp dependency check my-app
+```
+
+## 📦 Yayınlama
+
+### Yerel Test
+
+```bash
+# Uygulamayı yerel olarak test et
+clapp install ./my-app
+clapp run my-app
+```
+
+### Paket Oluşturma
+
+```bash
+# Paket oluştur
+clapp publish ./my-app
+```
+
+### GitHub'a Yükleme
+
+```bash
+# GitHub'a otomatik yükle
+clapp publish ./my-app --push
+```
+
+## ✅ En İyi Uygulamalar
+
+### 1. İsimlendirme
+- Uygulama adları küçük harf ve tire kullanın: `my-app`
+- Açıklayıcı isimler seçin
+- Benzersiz isimler kullanın
+
+### 2. Sürüm Yönetimi
+- Semantic versioning kullanın: `1.0.0`
+- Her değişiklikte sürüm artırın
+- CHANGELOG.md dosyası ekleyin
+
+### 3. Dokümantasyon
+- README.md dosyası ekleyin
+- Kullanım örnekleri verin
+- API dokümantasyonu ekleyin
+
+### 4. Hata Yönetimi
+- Uygun hata mesajları verin
+- Graceful degradation sağlayın
+- Log dosyaları kullanın
+
+### 5. Güvenlik
+- Hassas bilgileri kodlamayın
+- Input validation yapın
+- Güvenli dosya işlemleri kullanın
+
+### 6. Performans
+- Gereksiz bağımlılıklardan kaçının
+- Hızlı başlangıç sağlayın
+- Bellek kullanımını optimize edin
+
+## 🆘 Yardım
+
+### Hata Ayıklama
+
+```bash
+# Sistem durumunu kontrol et
+clapp doctor
+
+# Ortam kontrolü
+clapp check-env
+
+# Uygulama konumunu bul
+clapp where my-app
+```
+
+### Destek
+
+- GitHub Issues: [clapp repository](https://github.com/mburakmmm/clapp)
+- Dokümantasyon: Bu rehber
+- Örnekler: `templates/` klasörü
+
+## 📝 Örnekler
+
+Daha fazla örnek için `templates/` klasörünü inceleyin:
+
+- `templates/python/` - Python örnekleri
+- `templates/lua/` - Lua örnekleri
+- `templates/dart/` - Dart örnekleri
+- `templates/go/` - Go örnekleri
+- `templates/rust/` - Rust örnekleri
+
+Her örnek tam çalışan bir uygulama içerir ve kopyalanıp değiştirilebilir. 

main.py

@@ -32,6 +32,12 @@ from clean_command import run_clean
 from where_command import locate_app_path, list_all_app_locations
 from version_command import print_version, print_detailed_version
 
+# Yeni güvenlik ve performans modülleri
+from package_signing import check_package_security
+from version_manager import check_app_updates, get_app_latest_version, increment_app_version
+from cache_manager import get_cache_stats, clear_all_caches, download_packages_parallel
+from smart_search import search_packages, get_search_suggestions, get_search_analytics, clear_search_history
+
 # Yeni publish.cursorrules komutları
 from publish_command import publish_app
 from install_command import install_app
@@ -46,6 +52,9 @@ from dependency_resolver import (
     handle_dependency_tree
 )
 
+# Yeni uygulama oluşturma komutu
+from new_command import handle_new_command
+
 def main():
     """Ana CLI fonksiyonu"""
     
@@ -63,6 +72,7 @@ def main():
   clapp list                    # Yüklü uygulamaları listele
   clapp run hello-python        # hello-python uygulamasını çalıştır
   clapp info hello-python       # Uygulama bilgilerini göster
+  clapp new python my-app       # Yeni Python uygulaması oluştur
 
 🔧 Yönetim Komutları:
   clapp install app.zip         # ZIP dosyasından uygulama yükle
@@ -173,6 +183,34 @@ def main():
     version_parser.add_argument('--json', action='store_true', help='JSON formatında')
     version_parser.add_argument('--detailed', action='store_true', help='Detaylı bilgi')
     
+    # Güvenlik komutları
+    security_parser = subparsers.add_parser('security', help='Paket güvenlik işlemleri')
+    security_parser.add_argument('action', choices=['sign', 'verify', 'check'], help='Güvenlik işlemi')
+    security_parser.add_argument('package_path', help='Paket dosyası yolu')
+    security_parser.add_argument('--signature', help='İmza dosyası yolu (verify için)')
+    
+    # Versiyon yönetimi komutları
+    update_parser = subparsers.add_parser('update', help='Versiyon yönetimi')
+    update_parser.add_argument('action', choices=['check', 'increment'], help='İşlem türü')
+    update_parser.add_argument('--app', help='Uygulama adı')
+    update_parser.add_argument('--type', choices=['major', 'minor', 'patch'], default='patch', help='Artırma tipi')
+    
+    # Cache yönetimi komutları
+    cache_parser = subparsers.add_parser('cache', help='Cache yönetimi')
+    cache_parser.add_argument('action', choices=['stats', 'clear', 'download'], help='Cache işlemi')
+    cache_parser.add_argument('--urls', nargs='+', help='İndirilecek URL\'ler (download için)')
+    cache_parser.add_argument('--dest', help='Hedef dizin (download için)')
+    
+    # Akıllı arama komutları
+    search_parser = subparsers.add_parser('search', help='Akıllı arama')
+    search_parser.add_argument('query', nargs='?', help='Arama sorgusu')
+    search_parser.add_argument('--suggestions', action='store_true', help='Arama önerileri')
+    search_parser.add_argument('--analytics', action='store_true', help='Arama analitikleri')
+    search_parser.add_argument('--clear-history', action='store_true', help='Arama geçmişini temizle')
+    search_parser.add_argument('--language', help='Dil filtresi')
+    search_parser.add_argument('--category', help='Kategori filtresi')
+    search_parser.add_argument('--sort', choices=['relevance', 'name', 'version', 'language'], default='relevance', help='Sıralama')
+    
     # dependency komutu (yeni)
     dependency_parser = subparsers.add_parser('dependency', help='Bağımlılık yönetimi')
     dependency_subparsers = dependency_parser.add_subparsers(dest='dependency_command', help='Bağımlılık alt komutları')
@@ -194,6 +232,13 @@ def main():
     dep_tree_parser = dependency_subparsers.add_parser('tree', help='Bağımlılık ağacı')
     dep_tree_parser.add_argument('app_name', help='Uygulama adı')
     
+    # new komutu (yeni)
+    new_parser = subparsers.add_parser('new', help='Yeni uygulama oluştur')
+    new_parser.add_argument('language', nargs='?', help='Programlama dili')
+    new_parser.add_argument('app_name', nargs='?', help='Uygulama adı')
+    new_parser.add_argument('--list', action='store_true', help='Mevcut şablonları listele')
+    new_parser.add_argument('--target-dir', help='Hedef dizin (opsiyonel)')
+    
     # Argümanları parse et
     args = parser.parse_args()
     
@@ -341,6 +386,153 @@ def main():
             else:
                 print("❌ Geçersiz dependency komutu")
                 sys.exit(1)
+        
+        elif args.command == 'new':
+            # Yeni uygulama oluşturma komutu
+            success, message = handle_new_command(args)
+            if success:
+                print(message)
+            else:
+                print(f"❌ {message}")
+                sys.exit(1)
+        
+        elif args.command == 'security':
+            if args.action == 'check':
+                results = check_package_security(args.package_path)
+                print("🔒 Paket Güvenlik Kontrolü")
+                print("=" * 40)
+                print(f"Bütünlük: {'✅' if results['integrity'] else '❌'}")
+                print(f"İmza: {'✅' if results['signature'] else '❌'}")
+                print(f"Checksum: {results['checksum']}")
+                if results['warnings']:
+                    print("\n⚠️  Uyarılar:")
+                    for warning in results['warnings']:
+                        print(f"  - {warning}")
+            else:
+                print("❌ İmzalama özelliği geçici olarak devre dışı")
+                sys.exit(1)
+        
+        elif args.command == 'update':
+            if args.action == 'check':
+                if not args.app:
+                    print("❌ --app parametresi gerekli")
+                    sys.exit(1)
+                
+                from package_registry import get_manifest
+                manifest = get_manifest(args.app)
+                if not manifest:
+                    print(f"❌ {args.app} uygulaması bulunamadı")
+                    sys.exit(1)
+                
+                current_version = manifest.get('version', '0.0.0')
+                update_info = check_app_updates(args.app, current_version)
+                
+                print(f"📦 {args.app} Güncelleme Kontrolü")
+                print("=" * 40)
+                print(f"Mevcut: {update_info['current_version']}")
+                print(f"En son: {update_info['latest_version'] or 'Bilinmiyor'}")
+                print(f"Durum: {update_info['message']}")
+                
+                if update_info['has_update']:
+                    print(f"Güncelleme tipi: {update_info['update_type']}")
+            
+            elif args.action == 'increment':
+                if not args.app:
+                    print("❌ --app parametresi gerekli")
+                    sys.exit(1)
+                
+                from package_registry import get_manifest
+                manifest = get_manifest(args.app)
+                if not manifest:
+                    print(f"❌ {args.app} uygulaması bulunamadı")
+                    sys.exit(1)
+                
+                current_version = manifest.get('version', '0.0.0')
+                new_version = increment_app_version(current_version, args.type)
+                print(f"📦 {args.app} versiyonu artırıldı")
+                print(f"Eski: {current_version} → Yeni: {new_version}")
+        
+        elif args.command == 'cache':
+            if args.action == 'stats':
+                stats = get_cache_stats()
+                print("📊 Cache İstatistikleri")
+                print("=" * 30)
+                print(f"Hit: {stats['hits']}")
+                print(f"Miss: {stats['misses']}")
+                print(f"Hit Rate: {stats['hit_rate']}%")
+                print(f"Boyut: {stats['size_mb']} MB")
+            
+            elif args.action == 'clear':
+                deleted_count = clear_all_caches()
+                print(f"✅ {deleted_count} cache dosyası silindi")
+            
+            elif args.action == 'download':
+                if not args.urls or not args.dest:
+                    print("❌ --urls ve --dest parametreleri gerekli")
+                    sys.exit(1)
+                
+                os.makedirs(args.dest, exist_ok=True)
+                results = download_packages_parallel(args.urls, args.dest)
+                
+                print("📥 Paralel İndirme Sonuçları")
+                print("=" * 40)
+                for success, message in results:
+                    print(f"{'✅' if success else '❌'} {message}")
+        
+        elif args.command == 'search':
+            if args.suggestions:
+                from package_registry import list_packages
+                packages = list_packages()
+                suggestions = get_search_suggestions(args.query or "", packages)
+                print("💡 Arama Önerileri")
+                print("=" * 20)
+                for suggestion in suggestions:
+                    print(f"  • {suggestion}")
+            
+            elif args.analytics:
+                analytics = get_search_analytics()
+                print("📈 Arama Analitikleri")
+                print("=" * 25)
+                print(f"Toplam arama: {analytics['total_searches']}")
+                print(f"Benzersiz sorgu: {analytics['unique_queries']}")
+                print(f"Hit rate: {round(analytics['total_searches'] / max(1, analytics['unique_queries']) * 100, 1)}%")
+                
+                if analytics['most_popular']:
+                    print("\n🔥 Popüler Aramalar:")
+                    for query, count in analytics['most_popular']:
+                        print(f"  • {query} ({count} kez)")
+            
+            elif args.clear_history:
+                clear_search_history()
+            
+            elif args.query:
+                from package_registry import list_packages
+                packages = list_packages()
+                
+                filters = {}
+                if args.language:
+                    filters['language'] = args.language
+                if args.category:
+                    filters['category'] = args.category
+                if args.sort:
+                    filters['sort_by'] = args.sort
+                
+                results = search_packages(args.query, packages, filters)
+                
+                print(f"🔍 '{args.query}' için {len(results)} sonuç bulundu")
+                print("=" * 50)
+                
+                for package in results:
+                    score = package.get('search_score', 0)
+                    print(f"📦 {package['name']} v{package['version']} ({package['language']})")
+                    print(f"   {package['description']}")
+                    if score > 0:
+                        print(f"   Skor: {score:.2f}")
+                    print()
+            
+            else:
+                print("❌ Arama sorgusu gerekli veya --suggestions/--analytics kullanın")
+                sys.exit(1)
     
     except KeyboardInterrupt:
         print("\n❌ İşlem iptal edildi")

manifest_schema.py

@@ -42,7 +42,11 @@ def validate_manifest(manifest):
     # Opsiyonel alanlar
     optional_fields = {
         'description': str,
-        'dependencies': list
+        'dependencies': list,
+        'author': str,
+        'license': str,
+        'tags': list,
+        'category': str
     }
     
     # Gerekli alanları kontrol et
@@ -52,9 +56,16 @@ def validate_manifest(manifest):
         if not isinstance(manifest[field], expected_type):
             return False
     
-    # Dil kontrolü
-    if manifest['language'] not in ['python', 'lua']:
-        return False
+    # Dil kontrolü - package_runner'dan desteklenen dilleri al
+    try:
+        from package_runner import get_supported_languages
+        supported_languages = get_supported_languages()
+        if manifest['language'] not in supported_languages:
+            return False
+    except ImportError:
+        # Fallback: Temel diller
+        if manifest['language'] not in ['python', 'lua', 'dart', 'go', 'rust', 'node', 'bash', 'perl', 'ruby', 'php']:
+            return False
     
     # Opsiyonel alanları kontrol et (varsa)
     for field, expected_type in optional_fields.items():
@@ -79,6 +90,10 @@ def get_schema():
         },
         "optional_fields": {
             "description": "string",
-            "dependencies": "list"
+            "dependencies": "list",
+            "author": "string",
+            "license": "string",
+            "tags": "list",
+            "category": "string"
         }
     } 

manifest_validator.py

@@ -39,8 +39,8 @@ def validate_manifest_verbose(manifest):
         elif field == "language":
             if not isinstance(value, str):
                 errors.append(f"'{field}' alanı string olmalı")
-            elif value.lower() not in ["python", "lua"]:
-                errors.append(f"'{field}' alanı 'python' veya 'lua' olmalı, '{value}' geçersiz")
+            elif value.lower() not in ["python", "lua", "dart", "go", "rust", "node", "bash", "perl", "ruby", "php"]:
+                errors.append(f"'{field}' alanı desteklenen bir dil olmalı, '{value}' geçersiz")
         elif field == "entry":
             if not isinstance(value, str) or not value.strip():
                 errors.append(f"'{field}' alanı boş olmayan bir string olmalı")
@@ -61,7 +61,7 @@ def validate_manifest_verbose(manifest):
                     errors.append(f"'dependencies[{i}]' boş olmayan bir string olmalı")
     
     # Bilinmeyen alanları kontrol et
-    known_fields = set(required_fields.keys()) | {"description", "dependencies"}
+    known_fields = set(required_fields.keys()) | {"description", "dependencies", "author", "license", "tags", "category"}
     for field in manifest.keys():
         if field not in known_fields:
             errors.append(f"Bilinmeyen alan: '{field}' (göz ardı edilecek)")