clapp-pm 1.0.18__py3-none-any.whl → 1.0.20__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. 

install_command.py

@@ -18,6 +18,7 @@ from pathlib import Path
 from typing import Tuple, Optional, Dict, Any
 
 from manifest_validator import validate_manifest_verbose
+from progress_utils import download_with_progress, extract_with_progress, show_success_message, show_error_message
 
 def get_apps_directory() -> str:
     """Uygulamaların kurulacağı dizini döndürür"""
@@ -91,21 +92,18 @@ def download_app_from_github(app_info: Dict[str, Any], temp_dir: str) -> Tuple[b
         else:
             return False, f"Desteklenmeyen repo URL: {repo_url}"
         
-        print(f"📥 İndiriliyor: {zip_url}")
+        # Progress bar ile indir
+        zip_path = os.path.join(temp_dir, "repo.zip")
+        success = download_with_progress(zip_url, zip_path, f"📦 {app_name} indiriliyor")
         
-        # Zip dosyasını indir
-        response = requests.get(zip_url, timeout=30)
-        if response.status_code != 200:
-            return False, f"İndirme hatası: {response.status_code}"
+        if not success:
+            return False, "İndirme başarısız"
         
-        # Zip dosyasını geçici klasöre kaydet
-        zip_path = os.path.join(temp_dir, "repo.zip")
-        with open(zip_path, 'wb') as f:
-            f.write(response.content)
+        # Progress bar ile çıkar
+        success = extract_with_progress(zip_path, temp_dir, f"📦 {app_name} çıkarılıyor")
         
-        # Zip'i aç
-        with zipfile.ZipFile(zip_path, 'r') as zip_ref:
-            zip_ref.extractall(temp_dir)
+        if not success:
+            return False, "Çıkarma başarısız"
         
         # Çıkarılan klasörü bul (genellikle repo-main formatında)
         extracted_folders = [d for d in os.listdir(temp_dir) if os.path.isdir(os.path.join(temp_dir, d))]
@@ -156,6 +154,8 @@ def install_app_locally(app_name: str, source_path: str) -> Tuple[bool, str]:
                 shutil.rmtree(target_path)
                 return False, f"Manifest doğrulama hatası: {errors}"
         
+        show_success_message(f"'{app_name}' başarıyla yüklendi!")
+        
         # Bağımlılık çözümleme entegrasyonu
         print("5️⃣ Bağımlılıklar kontrol ediliyor...")
         from dependency_resolver import check_and_install_python_dependencies, check_and_install_lua_dependencies, check_engine_availability

installer.py

@@ -6,6 +6,7 @@ import shutil
 import json
 from manifest_validator import validate_manifest_verbose
 from package_registry import app_exists
+from progress_utils import download_with_progress, extract_with_progress, copy_with_progress, show_success_message, show_error_message
 
 def find_app_folder(extract_path, app_name):
     """
@@ -81,6 +82,8 @@ def install_package(source, force=False):
         if os.path.exists(target_dir):
             shutil.rmtree(target_dir)
         shutil.copytree(app_real_folder, target_dir)
+        
+        show_success_message(f"'{app_name}' başarıyla yüklendi!")
         return True, f"✅ '{app_name}' başarıyla yüklendi!"
     except Exception as e:
         return False, f"Yükleme hatası: {e}"
@@ -100,8 +103,6 @@ def download_package(url, temp_dir):
         str or None: İndirilen dosyanın yolu veya None
     """
     try:
-        print(f"Paket indiriliyor: {url}")
-        
         # Dosya adını URL'den çıkar
         filename = os.path.basename(url)
         if not filename.endswith('.zip'):
@@ -109,14 +110,16 @@ def download_package(url, temp_dir):
         
         zip_path = os.path.join(temp_dir, filename)
         
-        # Dosyayı indir
-        urllib.request.urlretrieve(url, zip_path)
+        # Progress bar ile indir
+        success = download_with_progress(url, zip_path, f"📦 {filename} indiriliyor")
         
-        print(f"✅ İndirme tamamlandı: {filename}")
-        return zip_path
+        if success:
+            return zip_path
+        else:
+            return None
         
     except Exception as e:
-        print(f"❌ İndirme hatası: {e}")
+        show_error_message(f"İndirme hatası: {e}")
         return None
 
 def extract_package(zip_path, extract_path):
@@ -134,12 +137,14 @@ def extract_package(zip_path, extract_path):
         # Çıkarma dizinini oluştur
         os.makedirs(extract_path, exist_ok=True)
         
-        # Zip dosyasını aç ve çıkar
-        with zipfile.ZipFile(zip_path, 'r') as zip_ref:
-            zip_ref.extractall(extract_path)
+        # Progress bar ile çıkar
+        filename = os.path.basename(zip_path)
+        success = extract_with_progress(zip_path, extract_path, f"📦 {filename} çıkarılıyor")
         
-        print(f"✅ Paket çıkarıldı: {extract_path}")
-        return True, "Paket başarıyla çıkarıldı"
+        if success:
+            return True, "Paket başarıyla çıkarıldı"
+        else:
+            return False, "Çıkarma hatası"
         
     except zipfile.BadZipFile:
         return False, "Geçersiz zip dosyası"
@@ -259,6 +264,7 @@ def install_from_directory(source_dir, force=False):
         # Dosyaları kopyala
         shutil.copytree(source_dir, target_dir)
         
+        show_success_message(f"'{app_name}' başarıyla yüklendi!")
         return True, f"✅ '{app_name}' başarıyla yüklendi!"
         
     except Exception as e:

main.py

@@ -33,7 +33,7 @@ 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 sign_package_file, verify_package_file, check_package_security
+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
@@ -52,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"""
     
@@ -69,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
@@ -228,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()
     
@@ -376,22 +387,17 @@ def main():
                 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 == 'sign':
-                success, message = sign_package_file(args.package_path)
-                if success:
-                    print(f"✅ {message}")
-                else:
-                    print(f"❌ {message}")
-                    sys.exit(1)
-            
-            elif args.action == 'verify':
-                signature_path = args.signature or args.package_path.replace('.zip', '.sig')
-                success, message = verify_package_file(args.package_path, signature_path)
-                print(f"{'✅' if success else '❌'} {message}")
-                sys.exit(0 if success else 1)
-            
-            elif args.action == 'check':
+            if args.action == 'check':
                 results = check_package_security(args.package_path)
                 print("🔒 Paket Güvenlik Kontrolü")
                 print("=" * 40)
@@ -402,6 +408,9 @@ def main():
                     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':

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)")