Skip to content

Commit

Permalink
feat: Add README.ru.md with Russian translation
Browse files Browse the repository at this point in the history
  • Loading branch information
neiromaster committed Jan 15, 2025
1 parent f500394 commit d5ace01
Showing 1 changed file with 77 additions and 0 deletions.
77 changes: 77 additions & 0 deletions docs/README.ru.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,77 @@
# Сборщик доменов

Этот скрипт позволяет извлекать уникальные домены, посещенные при просмотре заданного URL в браузере. Он использует Playwright для открытия браузера, обеспечивает взаимодействие с пользователем, а затем сохраняет посещенные домены в файл.

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

- Открывает URL в браузере.
- Обеспечивает взаимодействие пользователя с браузером.
- Извлекает все уникальные домены, посещенные во время сеанса просмотра.
- Сохраняет список уникальных доменов в текстовый файл.

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

Для использования скрипта необходимо установить `uv`.

1. **Установите uv:**

Следуйте инструкциям для вашей системы по адресу: https://docs.astral.sh/uv/getting-started/installation/

2. **Установите Playwright и Chromium:**

```bash
uvx playwright install chromium
```

3. **Запустите скрипт:**

```bash
uvx domain-collector <URL>
```

Замените `<URL>` на URL, который вы хотите открыть в браузере. Например:

```bash
uvx domain-collector https://ya.ru
```

Вы также можете указать URL без схемы (например, `ya.ru`), и скрипт автоматически добавит `https://`.

4. **Взаимодействуйте с браузером:**

Скрипт откроет окно браузера. Вы можете взаимодействовать со страницей как обычно.

5. **Закройте браузер:**

После завершения просмотра нажмите `Enter` в терминале, чтобы закрыть браузер и сохранить домены.

6. **Вывод:**

Скрипт сохранит уникальные домены в файл с именем `<domain>_domains.txt` (например, `ya_ru_domains.txt`) в том же каталоге, где вы запустили скрипт. Если файл уже существует, новые домены будут добавлены к существующему списку, избегая дубликатов.

## Пример

```bash
uvx domain-collector https://www.wikipedia.org
```

Это откроет домашнюю страницу Википедии в браузере. После того, как вы взаимодействуете со страницей и закроете браузер, скрипт сохранит посещенные домены в файл с именем `wikipedia_org_domains.txt`.

## Очистка

Для удаления всех артефактов можно использовать следующие команды:

```bash
uvx playwright uninstall --all
uv cache clean # Используйте с осторожностью, это удалит весь кэш uv
```

## Зависимости

- Python 3.7+
- Playwright
- argparse

## Лицензия

Этот проект лицензируется в соответствии с лицензией MIT - см. файл [LICENSE](LICENSE) для получения подробной информации.

0 comments on commit d5ace01

Please sign in to comment.