Skip to content

Latest commit

 

History

History
200 lines (144 loc) · 6.49 KB

README.md

File metadata and controls

200 lines (144 loc) · 6.49 KB

🚀 VW2PX

Конвертер размеров из VW в PX для проектов Vue, React, Next.js и других веб-проектов.

PyPI version License: MIT Python 3.7+

Простой и эффективный инструмент для конвертации VW единиц в PX в веб-проектах

🚀 Быстрый старт

# Установка
pip install vw2px

# Использование
vw2px --path ./my-project --dry-run
vw2px --path ./my-project --viewport 1920

Возможности

  • 🔍 Автоматический поиск всех VW значений в проекте
  • 🖥️ Конвертация с настраиваемым viewport (1920, 1440, 720, 440 и другие)
  • 📁 Поддержка множества форматов файлов (JS, TS, Vue, CSS, SCSS и др.)
  • 🔒 Безопасный режим предварительного просмотра
  • 📊 Подробная статистика обработки
  • 🎨 Цветной вывод в терминале

Установка

Через pip (рекомендуется)

pip install vw2px

Из исходного кода

  1. Клонируйте репозиторий или скачайте файлы
  2. Установите зависимости:
pip install -r requirements.txt

Использование

Базовое использование

vw2px --path /путь/к/вашему/проекту

С настройкой viewport

vw2px --path /путь/к/проекту --viewport 1440

Предварительный просмотр (без внесения изменений)

vw2px --path /путь/к/проекту --dry-run

Полный пример

vw2px \
  --path ./my-react-project \
  --viewport 1920 \
  --type vw-to-px \
  --dry-run

Параметры

Параметр Сокращение Описание По умолчанию
--path -p Путь к проекту Обязательный
--viewport -v Ширина viewport для конвертации 1920
--dry-run -d Только предварительный просмотр False
--type -t Тип конвертации (vw-to-px/px-to-vw) vw-to-px

Поддерживаемые форматы файлов

  • JavaScript: .js, .jsx
  • TypeScript: .ts, .tsx
  • Vue: .vue
  • HTML: .html
  • CSS: .css, .scss, .sass, .less, .styl
  • JSON: .json
  • Markdown: .md
  • Текстовые файлы: .txt

Исключаемые директории

Автоматически исключаются следующие директории:

  • node_modules
  • .git
  • .next
  • dist
  • build
  • .nuxt
  • .cache
  • coverage
  • .vscode
  • .idea

Примеры конвертации

VW в PX (viewport 1920px)

VW PX
1vw 19.2px
10vw 192px
50vw 960px
100vw 1920px

VW в PX (viewport 1440px)

VW PX
1vw 14.4px
10vw 144px
50vw 720px
100vw 1440px

Пример вывода

🚀 vw2px Converter
==================================================
📁 Проект: ./my-project
🖥️  Viewport: 1920px
🔄 Тип конвертации: vw-to-px
🔍 Режим: Предварительный просмотр
==================================================
🔍 Поиск VW значений в проекте: ./my-project
✅ Найдено 15 VW значений
[ПРЕДПРОСМОТР] ./src/components/Header.vue:25 | 10vw → 192px
[ПРЕДПРОСМОТР] ./src/styles/main.css:12 | 5.5vw → 105.6px
[ПРЕДПРОСМОТР] ./src/components/Button.jsx:8 | 2vw → 38.4px

📋 Предварительный просмотр завершен. Найдено 15 замен в 3 файлах.

📊 Статистика:
   📁 Файлов обработано: 0
   🔄 Замен выполнено: 0
   ❌ Ошибок: 0

💡 Для выполнения замен запустите команду без флага --dry-run

Безопасность

  • Всегда используйте --dry-run для предварительного просмотра
  • Создайте резервную копию проекта перед выполнением конвертации
  • Программа автоматически исключает системные директории

Поддерживаемые паттерны

Программа ищет VW значения в следующих форматах:

  • 10vw
  • 5.5vw
  • 100vw
  • 0.5vw

Ограничения

  • Пока поддерживается только конвертация VW в PX
  • Конвертация PX в VW будет добавлена в будущих версиях
  • Программа не обрабатывает сложные CSS-выражения

📚 Документация

🤝 Вклад в проект

  1. Форкните репозиторий
  2. Создайте ветку для новой функции (git checkout -b feature/amazing-feature)
  3. Зафиксируйте изменения (git commit -m 'Add amazing feature')
  4. Отправьте в ветку (git push origin feature/amazing-feature)
  5. Откройте Pull Request

📄 Лицензия

Этот проект лицензирован под MIT License - см. файл LICENSE для подробностей.

👨‍💻 Автор

Bluesuma - v1tuze@yandex.ru

Проект: https://github.com/Bluesuma/vw2px