PySnoop

Современное приложение на Python для чтения, записи и анализа данных с магнитных полос карт. Этот проект является продолжением оригинального проекта StripeSnoop, переработанным с использованием современных технологий Python и удобного пользовательского интерфейса.

✨ Возможности

• Чтение карт: Чтение магнитных полос карт с использованием совместимых считывателей
• Управление базой данных: Безопасное хранение и управление данными карт
• Поддержка форматов: Импорт/экспорт данных карт в различных форматах
• Современный интерфейс: Удобный пользовательский интерфейс с поддержкой тем
• Кросс-платформенность: Работает на Windows, macOS и Linux
• Автономный исполняемый файл: Сборка в виде одного исполняемого файла для простого распространения
• Отладочные сборки: Специальная конфигурация для отладки
• Безопасность: Защищенное хранение конфиденциальных данных карт
• Проверка: Встроенная проверка номеров карт (C10/Luhn)
• Документация: Подробная документация и примеры

🚀 Установка

Предварительные требования

• Python 3.7 или новее
• pip (менеджер пакетов Python)
• Git (опционально, для разработки)

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

1. Клонируйте репозиторий:

   git clone https://github.com/Nsfr750/PySnoop.git
   cd PySnoop
   

2. Создайте и активируйте виртуальное окружение:

   # Windows
   python -m venv venv
   .\venv\Scripts\activate
      
   # macOS/Linux
   python3 -m venv venv
   source venv/bin/activate
   

3. Установите зависимости:

   pip install -r requirements.txt
   

🏗️ Сборка приложения

PySnoop может быть собран в автономный исполняемый файл с помощью Nuitka. Мы предоставляем два сценария сборки:

Отладочная сборка

.\snoop_debug.bat

Создает отладочную версию приложения с включенным консольным окном для устранения неполадок.

Релизная сборка

.\snoop.bat

Создает оптимизированную релизную версию приложения.

Результаты сборки

• Отладочная сборка: build\PySnoop_debug.exe
• Релизная сборка: build\PySnoop.exe

🛠️ Разработка

   pip install -r requirements.txt

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

Графический интерфейс (рекомендуется)

python pysnoop_gui.py

Командная строка

python pysnoop.py [опции]

Доступные опции

-h, --help      Показать справку и выйти
-v, --verbose   Включить подробный вывод
--version       Показать информацию о версии

🔌 Поддерживаемые устройства

• Считыватель/записыватель магнитных карт MSR605
• Другие HID-совместимые считыватели карт (экспериментально)

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

Подробная документация, включая справочник по API и примеры использования, доступна в документации.

🤝 Участие в разработке

Вклад приветствуется! Пожалуйста, ознакомьтесь с нашими рекомендациями по участию, чтобы начать работу.

📄 Лицензия

Этот проект распространяется под лицензией GPLv3 - см. файл LICENSE для получения подробной информации.

🙏 Поддержка

Если вы находите этот проект полезным, рассмотрите возможность поддержки его разработки:

📧 Контакты

По вопросам или для получения поддержки, пожалуйста, откройте issue или свяжитесь с Nsfr750.

Благодарности

• Основано на оригинальном проекте StripeSnoop (http://stripesnoop.sourceforge.net)

Участие в разработке

Вклад приветствуется! Пожалуйста, не стесняйтесь присылать Pull Request.