| |
| |
|
|
| |
| SHELL := /bin/bash |
| PYTHON := python3 |
| PIP := pip3 |
| VENV := venv |
| VENV_ACTIVATE := $(VENV)/bin/activate |
|
|
| |
| SRC := src |
| TESTS := tests |
| CONFIG := config |
| DOCS := docs |
| ASSETS := assets |
|
|
| |
| REQUIREMENTS := requirements.txt |
| README := README.md |
| DOCKER_COMPOSE := docker-compose.yml |
|
|
| |
| GREEN := \033[0;32m |
| BLUE := \033[0;34m |
| YELLOW := \033[1;33m |
| RED := \033[0;31m |
| NC := \033[0m |
|
|
| |
| define print_status |
| @echo -e "$(BLUE)[INFO]$(NC) $(1)" |
| endef |
|
|
| define print_success |
| @echo -e "$(GREEN)[SUCCESS]$(NC) $(1)" |
| endef |
|
|
| define print_warning |
| @echo -e "$(YELLOW)[WARNING]$(NC) $(1)" |
| endef |
|
|
| define print_error |
| @echo -e "$(RED)[ERROR]$(NC) $(1)" |
| endef |
|
|
| .PHONY: help install dev-install test test-cov lint format check clean clean-pyc clean-build clean-docker docker-build docker-run docker-stop docker-logs logs zip upload docs docs-serve |
|
|
| |
| |
| |
| help: |
| @echo "" |
| @echo -e "$(GREEN)╔════════════════════════════════════════════════════════════╗$(NC)" |
| @echo -e "$(GREEN)║ نظام الحارس التلقائي - أوامر التطوير ║$(NC)" |
| @echo -e "$(GREEN)╚════════════════════════════════════════════════════════════╝$(NC)" |
| @echo "" |
| @echo "الأوامر المتاحة:" |
| @echo "" |
| @echo " $(GREEN)التثبيت والإعداد$(NC)" |
| @echo " make install - تثبيت التبعيات الأساسية" |
| @echo " make dev-install - تثبيت التبعيات مع أدوات التطوير" |
| @echo " make update - تحديث التبعيات" |
| @echo "" |
| @echo " $(GREEN)الاختبارات$(NC)" |
| @echo " make test - تشغيل جميع الاختبارات" |
| @echo " make test-coverage - تشغيل الاختبارات مع تقرير التغطية" |
| @echo " make test-unit - تشغيل اختبارات الوحدة فقط" |
| @echo " make test-integration - تشغيل اختبارات التكامل" |
| @echo "" |
| @echo " $(GREEN)جودة الكود$(NC)" |
| @echo " make lint - فحص الكود باستخدام linters" |
| @echo " make format - تنسيق الكود تلقائياً" |
| @echo " make check - التحقق من جودة الكود" |
| @echo "" |
| @echo " $(GREEN)التنظيف$(NC)" |
| @echo " make clean - تنظيف ملفات البناء" |
| @echo " make clean-pyc - تنظيف ملفات Python المؤقتة" |
| @echo " clean-all - تنظيف كل شيء" |
| @echo "" |
| @echo " $(GREEN)Docker$(NC)" |
| @echo " make docker-build - بناء صورة Docker" |
| @echo " make docker-run - تشغيل الحاويات" |
| @echo " make docker-stop - إيقاف الحاويات" |
| @echo " make docker-logs - عرض سجلات Docker" |
| @echo "" |
| @echo " $(GREEN)النظام$(NC)" |
| @echo " make run - تشغيل النظام" |
| @echo " make logs - عرض سجلات النظام" |
| @echo "" |
| @echo " $(GREEN)الأرشفة$(NC)" |
| @echo " make zip - إنشاء ملف ZIP للمشروع" |
| @echo "" |
| @echo " $(GREEN)التوثيق$(NC)" |
| @echo " make docs - بناء التوثيق" |
| @echo " make docs-serve - عرض التوثيق محلياً" |
| @echo "" |
| @echo "للحصول على تفاصيل إضافية، راجع ملف CONTRIBUTING.md" |
| @echo "" |
|
|
| |
| |
| |
| install: |
| $(call print_status,"جاري تثبيت التبعيات...") |
| @if [ ! -f $(REQUIREMENTS) ]; then $(call print_error,"ملف requirements.txt غير موجود"); exit 1; fi |
| $(PIP) install -r $(REQUIREMENTS) |
| $(call print_success,"تم تثبيت التبعيات بنجاح") |
|
|
| dev-install: install |
| $(call print_status,"جاري تثبيت أدوات التطوير...") |
| $(PIP) install pytest pytest-cov pytest-mock pytest-cov coveralls |
| $(PIP) install black flake8 mypy isort pre-commit |
| $(PIP) install sphinx sphinx-rtd-theme |
| $(call print_success,"تم تثبيت أدوات التطوير") |
|
|
| update: |
| $(call print_status,"جاري تحديث التبعيات...") |
| $(PIP) install --upgrade -r $(REQUIREMENTS) |
| $(call print_success,"تم تحديث التبعيات") |
|
|
| |
| |
| |
| test: |
| $(call print_status,"جاري تشغيل الاختبارات...") |
| @if [ ! -d "$(TESTS)" ]; then $(call print_error,"مجلد الاختبارات غير موجود"); exit 1; fi |
| $(PYTHON) -m pytest $(TESTS) -v --tb=short |
| $(call print_success,"اكتمل تشغيل الاختبارات") |
|
|
| test-coverage: |
| $(call print_status,"جاري تشغيل الاختبارات مع التغطية...") |
| $(PYTHON) -m pytest $(TESTS) --cov=$(SRC) --cov-report=html --cov-report=term-missing |
| $(call print_success,"تم إنشاء تقرير التغطية في مجلد htmlcov/") |
|
|
| test-unit: |
| $(call print_status,"جاري تشغيل اختبارات الوحدة...") |
| $(PYTHON) -m pytest $(TESTS)/test_*.py -v |
|
|
| test-integration: |
| $(call print_status,"جاري تشغيل اختبارات التكامل...") |
| $(PYTHON) -m pytest $(TESTS)/test_*integration*.py -v -s |
|
|
| |
| |
| |
| lint: |
| $(call print_status,"جاري فحص الكود...") |
| @echo "--- Flake8 ---" |
| @flake8 $(SRC) --max-line-length=100 --extend-ignore=E203 |
| @echo "--- Mypy ---" |
| @mypy $(SRC) --ignore-missing-imports --strict-optional |
| $(call print_success,"اكتمل فحص الكود") |
|
|
| format: |
| $(call print_status,"جاري تنسيق الكود...") |
| @echo "--- Black ---" |
| @black $(SRC) $(TESTS) --line-length 100 |
| @echo "--- isort ---" |
| @isort $(SRC) $(TESTS) --profile black |
| $(call print_success,"تم تنسيق الكود") |
|
|
| check: |
| $(call print_status,"جاري التحقق من جودة الكود...") |
| @echo "--- التحقق من التنسيق ---" |
| @black --check $(SRC) $(TESTS) --line-length 100 |
| @echo "--- التحقق من الاستيرادات ---" |
| @isort --check-only $(SRC) $(TESTS) --profile black |
| @echo "--- Flake8 ---" |
| @flake8 $(SRC) --max-line-length=100 --extend-ignore=E203 |
| $(call print_success,"اجتاز جميع فحوصات الجودة") |
|
|
| |
| |
| |
| clean: |
| $(call print_status,"جاري تنظيف ملفات البناء...") |
| @rm -rf build/ dist/ *.egg-info/ |
| @rm -rf htmlcov/ .coverage .coverage.* |
| $(call print_success,"تم تنظيف ملفات البناء") |
|
|
| clean-pyc: |
| $(call print_status,"جاري تنظيف ملفات Python المؤقتة...") |
| @find . -type d -name __pycache__ -exec rm -rf {} + |
| @find . -type f -name "*.pyc" -delete |
| @find . -type f -name ".pyc" -delete |
| @rm -rf $(VENV) |
| $(call print_success,"تم تنظيف ملفات Python") |
|
|
| clean-all: clean clean-pyc |
| $(call print_status,"جاري تنظيف كل شيء...") |
| @rm -rf logs/*.log |
| @rm -rf .hypothesis/ |
| $(call print_success,"تم تنظيف كل شيء") |
|
|
| |
| |
| |
| docker-build: |
| $(call print_status,"جاري بناء صورة Docker...") |
| @if [ ! -f "Dockerfile" ]; then $(call print_error,"ملف Dockerfile غير موجود"); exit 1; fi |
| docker-compose build |
| $(call print_success,"تم بناء الصورة") |
|
|
| docker-run: |
| $(call print_status,"جاري تشغيل الحاويات...") |
| @if [ ! -f "$(DOCKER_COMPOSE)" ]; then $(call print_error,"ملف docker-compose.yml غير موجود"); exit 1; fi |
| docker-compose up -d |
| $(call print_success,"تم تشغيل الحاويات. الخدمات متاحة على:") |
| @echo " - النظام الرئيسي: http://localhost:8000" |
| @echo " - Prometheus: http://localhost:9090" |
| @echo " - Grafana: http://localhost:3000" |
|
|
| docker-stop: |
| $(call print_status,"جاري إيقاف الحاويات...") |
| docker-compose down |
| $(call print_success,"تم إيقاف الحاويات") |
|
|
| docker-logs: |
| $(call print_status,"جاري عرض السجلات...") |
| docker-compose logs -f auto-guardian |
|
|
| |
| |
| |
| run: |
| $(call print_status,"جاري تشغيل نظام الحارس التلقائي...") |
| $(PYTHON) -m $(SRC).main |
| $(call print_success,"تم تشغيل النظام") |
|
|
| logs: |
| $(call print_status,"جاري عرض سجلات النظام...") |
| @if [ -d "logs" ]; then tail -f logs/*.log; else $(call print_warning,"مجلد السجلات غير موجود"); fi |
|
|
| |
| |
| |
| zip: |
| $(call print_status,"جاري إنشاء ملف ZIP...") |
| @VERSION=$$(git describe --tags 2>/dev/null || echo "1.3.0"); \ |
| FILENAME="auto-guardian-system-$${VERSION}.zip"; \ |
| if [ -f "$$FILENAME" ]; then rm "$$FILENAME"; fi \ |
| zip -r "$$FILENAME" . \ |
| --exclude="*.git*" \ |
| --exclude="*.pyc" \ |
| --exclude="__pycache__/*" \ |
| --exclude="*.egg-info/*" \ |
| --exclude="build/*" \ |
| --exclude="dist/*" \ |
| --exclude="htmlcov/*" \ |
| --exclude=".hypothesis/*" \ |
| --exclude="venv/*" \ |
| --exclude="node_modules/*" \ |
| --exclude=".DS_Store" \ |
| --exclude="*.log" \ |
| --exclude="logs/*" \ |
| --exclude="backups/*" |
| $(call print_success,"تم إنشاء الملف: $$FILENAME") |
| @ls -lh "$$FILENAME" |
|
|
| |
| |
| |
| docs: |
| $(call print_status,"جاري بناء التوثيق...") |
| @if [ ! -d "$(DOCS)" ]; then $(call print_error,"مجلد التوثيق غير موجود"); exit 1; fi |
| $(PYTHON) -m sphinx -b html $(DOCS) $(DOCS)/_build/html |
| $(call print_success,"تم بناء التوثيق في $(DOCS)/_build/html/") |
|
|
| docs-serve: |
| $(call print_status,"جاري تشغيل خادم التوثيق...") |
| @if [ ! -d "$(DOCS)/_build/html" ]; then make docs; fi |
| $(PYTHON) -m http.server 8080 -d $(DOCS)/_build/html |
|
|
