dash-devtools 1.0.0__py3-none-any.whl

dash_devtools/validators/detector.py

@@ -0,0 +1,394 @@
+"""
+專案類型偵測器 v2.1
+
+自動偵測專案的技術堆疊：
+- 前端：Angular / Vue+Vite / React / Vanilla JS / GAS (Google Apps Script)
+- 後端：Node.js / Python (FastAPI/Flask/Django)
+- 部署：Vercel Serverless / Vercel Proxy / Render / GAS Web App
+
+新增功能：
+- 區分「Serverless API」與「純 Proxy 閘道」
+- 偵測 Vue 3 + DaisyUI 組合
+- 偵測 GAS 專案（appsscript.json）
+"""
+
+import json
+from pathlib import Path
+from typing import Set
+
+
+class ProjectDetector:
+    """專案類型偵測器"""
+
+    def __init__(self, project_path):
+        self.project_path = Path(project_path)
+        self.project_name = self.project_path.name
+
+    def detect(self) -> dict:
+        """偵測專案類型，回傳技術堆疊資訊"""
+        result = {
+            'name': self.project_name,
+            'types': set(),
+            'frontend': None,
+            'backend': None,
+            'ui_framework': None,
+            'deployment': None,
+            'details': {}
+        }
+
+        # 優先偵測 GAS 專案（有 appsscript.json）
+        gas = self._detect_gas()
+        if gas:
+            result['types'].add('gas')
+            result['frontend'] = gas['type']
+            result['ui_framework'] = gas.get('ui_framework')
+            result['deployment'] = {'type': 'gas-webapp', 'description': 'Google Apps Script Web App'}
+            result['details']['gas'] = gas
+            result['types'] = list(result['types'])
+            return result
+
+        # 偵測前端
+        frontend = self._detect_frontend()
+        if frontend:
+            result['types'].add('frontend')
+            result['frontend'] = frontend['type']
+            result['ui_framework'] = frontend.get('ui_framework')
+            result['details']['frontend'] = frontend
+
+        # 偵測後端
+        backend = self._detect_backend()
+        if backend:
+            result['types'].add('backend')
+            result['backend'] = backend['type']
+            result['details']['backend'] = backend
+
+        # 偵測部署模式
+        deployment = self._detect_deployment()
+        if deployment:
+            result['deployment'] = deployment
+            result['details']['deployment'] = deployment
+
+        # 轉換 set 為 list（JSON 序列化用）
+        result['types'] = list(result['types'])
+
+        return result
+
+    def _detect_frontend(self) -> dict | None:
+        """偵測前端技術"""
+        package_json = self.project_path / 'package.json'
+
+        if not package_json.exists():
+            return None
+
+        try:
+            pkg = json.loads(package_json.read_text(encoding='utf-8'))
+            deps = {**pkg.get('dependencies', {}), **pkg.get('devDependencies', {})}
+
+            # Angular 偵測
+            if '@angular/core' in deps:
+                ui_framework = None
+                if 'primeng' in deps:
+                    ui_framework = 'primeng'
+
+                return {
+                    'type': 'angular',
+                    'version': deps.get('@angular/core', 'unknown'),
+                    'ui_framework': ui_framework,
+                    'has_tailwind': 'tailwindcss' in deps
+                }
+
+            # Vue + Vite 偵測
+            if 'vue' in deps:
+                ui_framework = None
+                if 'daisyui' in deps:
+                    ui_framework = 'daisyui'
+                elif '@shoelace-style/shoelace' in deps:
+                    ui_framework = 'shoelace'
+
+                return {
+                    'type': 'vue-vite' if 'vite' in deps else 'vue',
+                    'version': deps.get('vue', 'unknown'),
+                    'ui_framework': ui_framework,
+                    'has_tailwind': 'tailwindcss' in deps or '@tailwindcss/vite' in deps,
+                    'has_typescript': 'typescript' in deps or 'vue-tsc' in deps
+                }
+
+            # Vite (非 Vue)
+            if 'vite' in deps:
+                ui_framework = None
+                if 'daisyui' in deps:
+                    ui_framework = 'daisyui'
+                elif '@shoelace-style/shoelace' in deps:
+                    ui_framework = 'shoelace'
+
+                return {
+                    'type': 'vite',
+                    'version': deps.get('vite', 'unknown'),
+                    'ui_framework': ui_framework,
+                    'has_tailwind': 'tailwindcss' in deps
+                }
+
+            # React 偵測
+            if 'react' in deps:
+                return {
+                    'type': 'react',
+                    'version': deps.get('react', 'unknown'),
+                    'ui_framework': self._detect_react_ui(deps)
+                }
+
+            # 原生 JS（有 package.json 但無框架）
+            return {
+                'type': 'vanilla',
+                'ui_framework': None
+            }
+
+        except Exception:
+            return None
+
+    def _detect_react_ui(self, deps: dict) -> str | None:
+        """偵測 React UI 框架"""
+        if '@mui/material' in deps:
+            return 'mui'
+        if 'antd' in deps:
+            return 'antd'
+        if '@chakra-ui/react' in deps:
+            return 'chakra'
+        return None
+
+    def _detect_gas(self) -> dict | None:
+        """偵測 Google Apps Script 專案"""
+        appsscript_json = self.project_path / 'appsscript.json'
+
+        if not appsscript_json.exists():
+            return None
+
+        try:
+            config = json.loads(appsscript_json.read_text(encoding='utf-8'))
+
+            # 偵測 UI 框架（從 HTML 檔案內容判斷）
+            ui_framework = None
+            html_files = list(self.project_path.glob('*.html'))
+
+            for html_file in html_files:
+                content = html_file.read_text(encoding='utf-8')
+                if 'shoelace' in content.lower() or 'sl-' in content:
+                    ui_framework = 'shoelace'
+                    break
+                elif 'daisyui' in content.lower():
+                    ui_framework = 'daisyui'
+                    break
+
+            # 檢查是否有 Vue
+            has_vue = any('vue' in f.read_text(encoding='utf-8').lower()
+                         for f in html_files if f.exists())
+
+            return {
+                'type': 'gas',
+                'runtime': config.get('runtimeVersion', 'V8'),
+                'webapp': config.get('webapp', {}),
+                'ui_framework': ui_framework,
+                'has_vue': has_vue,
+                'html_files': [f.name for f in html_files],
+                'js_files': [f.name for f in self.project_path.glob('*.js')]
+            }
+
+        except Exception:
+            return None
+
+    def _detect_backend(self) -> dict | None:
+        """偵測後端技術"""
+        # Python 後端偵測
+        python_result = self._detect_python_backend()
+        if python_result:
+            return python_result
+
+        # Node.js 後端偵測
+        nodejs_result = self._detect_nodejs_backend()
+        if nodejs_result:
+            return nodejs_result
+
+        return None
+
+    def _detect_python_backend(self) -> dict | None:
+        """偵測 Python 後端"""
+        requirements = self.project_path / 'requirements.txt'
+        pyproject = self.project_path / 'pyproject.toml'
+        setup_py = self.project_path / 'setup.py'
+
+        if not any(f.exists() for f in [requirements, pyproject, setup_py]):
+            return None
+
+        framework = None
+        deps_content = ''
+
+        if requirements.exists():
+            deps_content = requirements.read_text(encoding='utf-8').lower()
+        elif pyproject.exists():
+            deps_content = pyproject.read_text(encoding='utf-8').lower()
+
+        # 偵測框架
+        if 'fastapi' in deps_content:
+            framework = 'fastapi'
+        elif 'flask' in deps_content:
+            framework = 'flask'
+        elif 'django' in deps_content:
+            framework = 'django'
+        elif 'streamlit' in deps_content:
+            framework = 'streamlit'
+
+        return {
+            'type': 'python',
+            'framework': framework
+        }
+
+    def _detect_nodejs_backend(self) -> dict | None:
+        """偵測 Node.js 後端"""
+        package_json = self.project_path / 'package.json'
+
+        if not package_json.exists():
+            return None
+
+        try:
+            pkg = json.loads(package_json.read_text(encoding='utf-8'))
+            deps = {**pkg.get('dependencies', {}), **pkg.get('devDependencies', {})}
+
+            # Vercel Serverless 偵測（有 api/ 目錄且有函數檔案）
+            api_dir = self.project_path / 'api'
+            if api_dir.exists():
+                api_files = list(api_dir.rglob('*.js')) + list(api_dir.rglob('*.ts'))
+                if api_files:
+                    return {
+                        'type': 'nodejs',
+                        'framework': 'vercel-serverless'
+                    }
+
+            # Express 偵測
+            if 'express' in deps:
+                return {
+                    'type': 'nodejs',
+                    'framework': 'express'
+                }
+
+            # Fastify 偵測
+            if 'fastify' in deps:
+                return {
+                    'type': 'nodejs',
+                    'framework': 'fastify'
+                }
+
+            # NestJS 偵測
+            if '@nestjs/core' in deps:
+                return {
+                    'type': 'nodejs',
+                    'framework': 'nestjs'
+                }
+
+        except Exception:
+            pass
+
+        return None
+
+    def _detect_deployment(self) -> dict | None:
+        """偵測部署模式"""
+        vercel_json = self.project_path / 'vercel.json'
+
+        if not vercel_json.exists():
+            return None
+
+        try:
+            config = json.loads(vercel_json.read_text(encoding='utf-8'))
+            rewrites = config.get('rewrites', [])
+
+            # 檢查是否為純 Proxy 模式
+            is_proxy_only = False
+            proxy_target = None
+
+            for rewrite in rewrites:
+                dest = rewrite.get('destination', '')
+                source = rewrite.get('source', '')
+
+                # 如果 destination 是外部 URL，則是 Proxy
+                if dest.startswith('http://') or dest.startswith('https://'):
+                    is_proxy_only = True
+                    proxy_target = dest.split('/')[2]  # 取得域名
+
+            # 檢查是否有 api/ 目錄（Serverless）
+            api_dir = self.project_path / 'api'
+            has_api_functions = api_dir.exists() and any(api_dir.rglob('*.ts')) or any(api_dir.rglob('*.js'))
+
+            if is_proxy_only and not has_api_functions:
+                return {
+                    'type': 'vercel-proxy',
+                    'proxy_target': proxy_target,
+                    'description': '純前端 + API 代理'
+                }
+            elif has_api_functions:
+                return {
+                    'type': 'vercel-serverless',
+                    'has_proxy': is_proxy_only,
+                    'description': 'Serverless Functions' + (' + Proxy' if is_proxy_only else '')
+                }
+            else:
+                return {
+                    'type': 'vercel-static',
+                    'description': '純靜態網站'
+                }
+
+        except Exception:
+            pass
+
+        return None
+
+    def get_applicable_validators(self) -> Set[str]:
+        """取得適用的驗證器類型"""
+        info = self.detect()
+        validators = {'common'}  # 通用驗證器永遠適用
+
+        frontend_type = info['frontend']
+        if frontend_type == 'gas':
+            validators.add('frontend.gas')
+        elif frontend_type == 'angular':
+            validators.add('frontend.angular')
+        elif frontend_type in ['vite', 'vanilla', 'vue-vite', 'vue']:
+            validators.add('frontend.vite')
+        elif frontend_type == 'react':
+            validators.add('frontend.react')
+
+        backend_type = info['backend']
+        if backend_type == 'python':
+            validators.add('backend.python')
+        elif backend_type == 'nodejs':
+            validators.add('backend.nodejs')
+
+        return validators
+
+    def get_project_summary(self) -> str:
+        """取得專案摘要（供 CLI 顯示）"""
+        info = self.detect()
+
+        parts = []
+
+        # 前端
+        if info['frontend']:
+            frontend_str = info['frontend']
+            if info['ui_framework']:
+                frontend_str += f" + {info['ui_framework']}"
+            parts.append(f"Frontend: {frontend_str}")
+
+        # 後端
+        if info['backend']:
+            backend = info['details'].get('backend', {})
+            framework = backend.get('framework', '')
+            backend_str = f"{info['backend']}"
+            if framework:
+                backend_str += f" ({framework})"
+            parts.append(f"Backend: {backend_str}")
+
+        # 部署
+        if info['deployment']:
+            deploy = info['deployment']
+            parts.append(f"Deploy: {deploy.get('type', 'unknown')}")
+            if deploy.get('proxy_target'):
+                parts.append(f"Proxy: {deploy['proxy_target']}")
+
+        return ' | '.join(parts) if parts else 'Unknown project type'

dash_devtools/validators/frontend/__init__.py

@@ -0,0 +1,14 @@
+"""
+前端驗證器
+
+支援框架：
+- Vite + Tailwind + DaisyUI
+- Angular + PrimeNG
+- GAS (Google Apps Script) + Vue 3 + Shoelace/DaisyUI
+"""
+
+from .vite import ViteValidator
+from .angular import AngularValidator
+from .gas import GasValidator
+
+__all__ = ['ViteValidator', 'AngularValidator', 'GasValidator']

dash_devtools/validators/frontend/angular.py

@@ -0,0 +1,245 @@
+"""
+Angular 專案驗證器
+
+檢查項目：
+1. PrimeNG 設定
+2. 組件結構
+3. Service 注入
+4. 模組匯入
+5. 表單雙向綁定
+"""
+
+import re
+import json
+from pathlib import Path
+
+
+class AngularValidator:
+    """Angular 專案驗證器"""
+
+    name = 'angular'
+
+    # 忽略目錄
+    IGNORE_DIRS = [
+        'node_modules', '.git', 'dist', '.angular', '__pycache__'
+    ]
+
+    def __init__(self, project_path):
+        self.project_path = Path(project_path)
+        self.project_name = self.project_path.name
+        self.src_path = self.project_path / 'src'
+        self.result = {
+            'name': self.name,
+            'passed': True,
+            'errors': [],
+            'warnings': [],
+            'checks': {}
+        }
+
+    def run(self):
+        """執行所有驗證"""
+        if not self.project_path.exists():
+            self.result['passed'] = False
+            self.result['errors'].append(f'專案路徑不存在: {self.project_path}')
+            return self.result
+
+        self.check_primeng_config()
+        self.check_component_structure()
+        self.check_imports()
+        self.check_form_bindings()
+        self.check_service_injection()
+
+        return self.result
+
+    def check_primeng_config(self):
+        """檢查 PrimeNG 設定"""
+        app_config = self.src_path / 'app' / 'app.config.ts'
+
+        if not app_config.exists():
+            self.result['checks']['primeng_config'] = {'skipped': '無 app.config.ts'}
+            return
+
+        try:
+            content = app_config.read_text(encoding='utf-8')
+            has_provider = 'providePrimeNG' in content
+            has_theme = '@primeng/themes' in content
+
+            self.result['checks']['primeng_config'] = {
+                'has_provider': has_provider,
+                'has_theme': has_theme
+            }
+
+            if not has_provider:
+                self.result['warnings'].append('缺少 providePrimeNG 設定')
+            if not has_theme:
+                self.result['warnings'].append('缺少 PrimeNG 主題設定')
+        except Exception:
+            pass
+
+    def check_component_structure(self):
+        """檢查組件結構"""
+        issues = []
+
+        for file_path in self.src_path.rglob('*.component.ts'):
+            if self._should_skip(file_path):
+                continue
+            try:
+                content = file_path.read_text(encoding='utf-8')
+                rel_path = str(file_path.relative_to(self.project_path))
+                line_count = len(content.splitlines())
+
+                # 檢查組件大小
+                if line_count > 500:
+                    issues.append({
+                        'file': rel_path,
+                        'issue': f'組件過大 ({line_count} 行)',
+                        'severity': 'warning'
+                    })
+
+                # 檢查是否有 standalone
+                if 'standalone: true' not in content and '@Component' in content:
+                    issues.append({
+                        'file': rel_path,
+                        'issue': '建議使用 standalone component',
+                        'severity': 'info'
+                    })
+
+            except Exception:
+                pass
+
+        self.result['checks']['component_structure'] = {
+            'count': len(issues),
+            'issues': issues
+        }
+
+        for issue in issues:
+            if issue['severity'] == 'warning':
+                self.result['warnings'].append(f"{issue['file']}: {issue['issue']}")
+
+    def check_imports(self):
+        """檢查模組匯入"""
+        issues = []
+
+        # 檢查是否有遺漏的 PrimeNG 模組匯入
+        primeng_components = {
+            'p-table': 'TableModule',
+            'p-button': 'ButtonModule',
+            'p-dialog': 'DialogModule',
+            'p-drawer': 'DrawerModule',
+            'p-inputtext': 'InputTextModule',
+            'p-select': 'SelectModule',
+            'p-datepicker': 'DatePickerModule',
+            'p-inputnumber': 'InputNumberModule',
+            'p-tag': 'TagModule',
+            'p-tabs': 'TabsModule',
+            'pInputText': 'InputTextModule',
+        }
+
+        for file_path in self.src_path.rglob('*.component.ts'):
+            if self._should_skip(file_path):
+                continue
+            try:
+                content = file_path.read_text(encoding='utf-8')
+                rel_path = str(file_path.relative_to(self.project_path))
+
+                for component, module in primeng_components.items():
+                    if component in content and module not in content:
+                        issues.append({
+                            'file': rel_path,
+                            'component': component,
+                            'missing_module': module
+                        })
+            except Exception:
+                pass
+
+        self.result['checks']['imports'] = {
+            'count': len(issues),
+            'issues': issues
+        }
+
+        if issues:
+            for issue in issues[:5]:
+                self.result['errors'].append(
+                    f"{issue['file']}: 使用 {issue['component']} 但未匯入 {issue['missing_module']}"
+                )
+            self.result['passed'] = False
+
+    def check_form_bindings(self):
+        """檢查表單綁定"""
+        issues = []
+
+        for file_path in self.src_path.rglob('*.html'):
+            if self._should_skip(file_path):
+                continue
+            try:
+                content = file_path.read_text(encoding='utf-8')
+                rel_path = str(file_path.relative_to(self.project_path))
+
+                # 檢查是否有未綁定的 input
+                # 找出 <input> 但沒有 [(ngModel)] 或 [formControl]
+                inputs = re.findall(r'<input[^>]*>', content)
+                for inp in inputs:
+                    if 'ngModel' not in inp and 'formControl' not in inp and 'type="submit"' not in inp:
+                        # 可能是有意為之，只記錄警告
+                        pass
+
+                # 檢查 PrimeNG 組件綁定
+                primeng_inputs = re.findall(r'<p-(?:inputtext|inputnumber|select|datepicker)[^>]*>', content)
+                for pinput in primeng_inputs:
+                    if 'ngModel' not in pinput and 'formControl' not in pinput:
+                        issues.append({
+                            'file': rel_path,
+                            'issue': 'PrimeNG 輸入元件缺少資料綁定'
+                        })
+
+            except Exception:
+                pass
+
+        self.result['checks']['form_bindings'] = {
+            'count': len(issues),
+            'issues': issues
+        }
+
+        if issues:
+            for issue in issues[:3]:
+                self.result['warnings'].append(f"{issue['file']}: {issue['issue']}")
+
+    def check_service_injection(self):
+        """檢查 Service 注入"""
+        issues = []
+
+        for file_path in self.src_path.rglob('*.service.ts'):
+            if self._should_skip(file_path):
+                continue
+            try:
+                content = file_path.read_text(encoding='utf-8')
+                rel_path = str(file_path.relative_to(self.project_path))
+
+                # 檢查是否有 @Injectable
+                if 'class ' in content and '@Injectable' not in content:
+                    issues.append({
+                        'file': rel_path,
+                        'issue': '缺少 @Injectable 裝飾器'
+                    })
+
+                # 檢查是否使用 providedIn: 'root'
+                if '@Injectable' in content and "providedIn: 'root'" not in content:
+                    issues.append({
+                        'file': rel_path,
+                        'issue': "建議使用 providedIn: 'root'"
+                    })
+
+            except Exception:
+                pass
+
+        self.result['checks']['service_injection'] = {
+            'count': len(issues),
+            'issues': issues
+        }
+
+        for issue in issues:
+            self.result['warnings'].append(f"{issue['file']}: {issue['issue']}")
+
+    def _should_skip(self, file_path):
+        """檢查是否應該跳過該檔案"""
+        return any(ignore in str(file_path) for ignore in self.IGNORE_DIRS)