basforge

Ищем по названиям, тексту и разборам «Если не работает».

    EN

    QR-код гостевой Wi-Fi: первый пакет из pip в виртуальном окружении

    Делаем картинку, которую гость сканирует камерой телефона и подключается к Wi-Fi без ввода пароля. Код рисует пакет qrcode — его нет в стандартной библиотеке, поэтому впервые ставим пакет: в виртуальное окружение папки, чтобы не смешивать с системным Python.

    Новое здесьПакеты: pipВиртуальное окружение

    Что получится

    wifi-qr\
      .venv\               окружение: свой python и пакеты qrcode, pillow
      wifi_qr.py           скрипт
      wifi-guest.png       картинка для печати или для экрана

    Скрипт печатает строку для QR-кода, рисует код прямо в терминале и сохраняет PNG.

    По шагам

    1. Создаём окружение

      mkdir wifi-qr
      cd wifi-qr
      python -m venv .venv

      В папке появилась .venv — копия интерпретатора со своим списком пакетов. Пакеты, поставленные сюда, не видны системному Python и другим проектам.

    2. Ставим пакет

      .venv\Scripts\python -m pip install "qrcode[pil]"
      # Successfully installed colorama-0.4.6 pillow-13.0.0 qrcode-8.2

      На Linux и macOS путь другой: .venv/bin/python. [pil] — ставим вместе с Pillow, без него PNG не сохранить.

    3. Пишем скрипт

      Файл wifi_qr.py в той же папке; имя сети и пароль — свои:

      import qrcode
      
      SSID = "Guest"
      PASSWORD = "tea-and-cookies-42"
      SECURITY = "WPA"  # WPA подходит и для WPA2, и для WPA3; сеть без пароля — "nopass"
      
      
      def escape(text):
          """Символы \\ ; , : " в формате WIFI: экранируются обратной косой чертой."""
          for char in '\\;,:"':
              text = text.replace(char, "\\" + char)
          return text
      
      
      data = f"WIFI:T:{SECURITY};S:{escape(SSID)};P:{escape(PASSWORD)};;"
      print(data)
      
      qr = qrcode.QRCode(border=2)
      qr.add_data(data)
      qr.print_ascii(invert=True)
      
      image = qr.make_image()
      image.save("wifi-guest.png")
      print("Сохранено: wifi-guest.png")
    4. Запускаем

      .venv\Scripts\python wifi_qr.py
      # WIFI:T:WPA;S:Guest;P:tea-and-cookies-42;;
      # …QR-код символами…
      # Сохранено: wifi-guest.png

      Наводим камеру телефона на код в терминале или на wifi-guest.png — телефон предлагает подключиться к Guest.

    Что здесь нового

    • Пакеты: pip. Всё, чего нет в стандартной библиотеке, ставят из каталога PyPI командой pip. Запускаем его как модуль нужного интерпретатора — python -m pip, — тогда пакет точно ляжет туда, откуда его будут импортировать. Голый pip может оказаться от другого Python.
    • Виртуальное окружение. python -m venv .venv делает папку с отдельным Python для проекта. Пакеты одного проекта не мешают другому, а лишнее удаляется вместе с папкой. Окружение не переносят: на другом компьютере его создают заново.

    Формат строки WIFI

    WIFI:T:WPA;S:Guest;P:пароль;; — тип защиты, имя сети, пароль, в конце две точки с запятой. Если в имени или пароле есть \, ;, ,, : или ", их нужно экранировать — это делает функция escape. Скрытая сеть — добавляем H:true; перед ;;.

    Пароль лежит в скрипте открытым текстом, поэтому QR-код — для гостевой сети, отделённой от домашних устройств («Гостевая сеть на MikroTik»).

    Если не работает

    ModuleNotFoundError: No module named 'qrcode'

    Причина
    Скрипт запущен системным python, а пакет стоит в .venv: у каждого окружения свои пакеты.
    Делаем
    Запускаем через окружение: .venv\Scripts\python wifi_qr.py (Linux, macOS — .venv/bin/python).

    ModuleNotFoundError: No module named 'PIL' на строке make_image

    Причина
    Поставлен qrcode без Pillow: код в терминал он печатает, а PNG рисует через Pillow.
    Делаем
    .venv\Scripts\python -m pip install "qrcode[pil]" — в квадратных скобках дополнительная часть пакета.

    Activate.ps1 cannot be loaded because running scripts is disabled on this system

    Причина
    PowerShell по умолчанию не запускает скрипты, а активация окружения — скрипт .ps1.
    Делаем
    Активация не обязательна: вызываем python окружения по пути, как в материале. Нужна — Set-ExecutionPolicy -Scope CurrentUser RemoteSigned.

    error: externally-managed-environment при pip install на Ubuntu

    Причина
    Ubuntu 23.04 и новее не дают ставить пакеты в системный Python (PEP 668).
    Делаем
    Ставим в окружение, как здесь: python3 -m venv .venv, потом .venv/bin/python -m pip install "qrcode[pil]".

    Камера видит код, но к сети не подключается

    Причина
    Опечатка в имени сети или пароле: регистр важен, Guest и guest — разные сети.
    Делаем
    Сверяем строку WIFI:…, которую скрипт печатает первой, с настройками роутера.

    Как проверить

    Телефон, который ещё не знает эту сеть, сканирует wifi-guest.png камерой и подключается без ввода пароля.