hh-applicant-tool 0.2.1__tar.gz → 0.2.3__tar.gz

{hh_applicant_tool-0.2.1 → hh_applicant_tool-0.2.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: hh-applicant-tool
-Version: 0.2.1
+Version: 0.2.3
 Summary: 
 Author: Senior YAML Developer
 Author-email: yamldeveloper@proton.me
@@ -8,13 +8,21 @@ Requires-Python: >=3.10,<4.0
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
 Requires-Dist: prettytable (>=3.6.0,<4.0.0)
 Requires-Dist: requests (>=2.28.2,<3.0.0)
 Description-Content-Type: text/markdown
 
 # HH Applicant Tool
 
-![Publish to PyPI](https://github.com/s3rgeym/hh-applicant-tool/actions/workflows/publish.yml/badge.svg) [![PyPi Version](https://img.shields.io/pypi/v/hh-applicant-tool)](https://img.shields.io/pypi/v/hh-applicant-tool) [![Python Versions](https://img.shields.io/pypi/pyversions/hh-applicant-tool.svg)](https://img.shields.io/pypi/pyversions/hh-applicant-tool.svg) [![PyPI - Downloads](https://img.shields.io/pypi/dm/hh-applicant-tool)](https://img.shields.io/pypi/dm/hh-applicant-tool)
+> ! Наложен мораторий на доработки/переработки. Разработка будет возобновлена после 100 звезд 💫
+
+![Publish to PyPI](https://github.com/s3rgeym/hh-applicant-tool/actions/workflows/publish.yml/badge.svg) 
+[![PyPi Version](https://img.shields.io/pypi/v/hh-applicant-tool)]() 
+[![Python Versions](https://img.shields.io/pypi/pyversions/hh-applicant-tool.svg)]() 
+[![GitHub code size in bytes](https://img.shields.io/github/languages/code-size/s3rgeym/hh-applicant-tool)]()
+[![PyPI - Downloads](https://img.shields.io/pypi/dm/hh-applicant-tool)]()
+[![Total Downloads](https://static.pepy.tech/badge/hh-applicant-tool)]()
 
 Утилита для автоматизации действий на HH.RU таких как рассылка откликов на подходящие вакансии и обновление всех резюме.
 
@@ -23,13 +31,23 @@ Description-Content-Type: text/markdown
 - socat
 - python >= 3.10
 
-Нужную версию можно поставить через asdf/pyenv, а вот socat придется доставить.
+Нужную версию можно поставить через asdf/pyenv, а вот socat придется доставить. В Arch-based:
+
+```bash
+yay -S socat
+```
+
+Пример работы:
+
+![image](https://github.com/user-attachments/assets/4936a8dd-f671-4788-8106-0470d5ce1dd6)
+![image](https://github.com/user-attachments/assets/55ab24ba-5325-40b4-9bd9-69ebcbc011c4)
+
 
-Данная утилита не может работать от root. Я не планирую добавлять поддержку Windows, но никто не мешает вам ее реализовать.
+Данная утилита работает только в Linux. Для авторизации требуется наличие графического окружения (это не совсем верно, но мне лень расписывать...), после нее вы можете перенести `~/.config/hh-applicant-tool/config.json` на сервер и запускать утилиту через systemd или cron, либо же вообще делать это через **WSL**. Так же при наличии рутованного телефона можно вытащить `access` и `refresh` токены из официального приложения и добавить их в конфиг.
 
 Предыстория.
 
-Был один знакомый знакомого, который работал хером. Этот чувак не заморачивался с чтением резюме, а тупо скриптами рассылал предложения о работе... Бывают, конечно, филологини, которые не могут отлчить Java от JavaScript, но я думаю, что в значительном числе случаев, тут имеют место такие вот рассылки... И я перенял эту порочную практику. Мне уже просто лень читать весь этот бред, что пишут в описании вакансий. Там стандартное ООП, алгоритмы и прочая хуета... Вроде все подходят, а вроде хз — все не мое. Поэтому тупло спамлю в надежде на идеальную работу. Долгое время (пару недель в октябре 2022) я делал массовые заявки с помощью консоли браузера:
+Был один знакомый знакомого, который работал хрюшей. Этот чувак не заморачивался с чтением резюме, а тупо скриптами рассылал предложения о работе... Бывают, конечно, филологини, которые не могут отлчить Java от JavaScript, но я думаю, что в значительном числе случаев, тут имеют место такие вот рассылки... И я перенял эту порочную практику. Мне уже просто лень читать весь этот бред, что пишут в описании вакансий. Там стандартное ООП, алгоритмы и прочая хуета... Вроде все подходят, а вроде хз — все не мое. Поэтому тупло спамлю в надежде на идеальную работу. Долгое время (пару недель в октябре 2022) я делал массовые заявки с помощью консоли браузера:
 
 ```js
 $$('[data-qa="vacancy-serp__vacancy_response"]').forEach((el) => el.click());
@@ -71,9 +89,7 @@ $ hh-applicant-tool apply-similar
 # Поднимаем резюме
 $ hh-applicant-tool update-resumes
 
-# Чистим заявки и баним за отказы говноконторы, нанявших на работу филолохинь,
-# астралохинь и прочих 3.14дарасов по блату, считающих, что погроммистом может
-# быть только ДОЦЕНТ МАТЕМАТИЧЕСКИХ НАУК 🤡
+# Чистим заявки и баним за отказы говноконторы
 $ hh-applicant-tool clear-negotiations --blacklist-discard
 ```
 
@@ -119,7 +135,7 @@ https://hh.ru/employer/1918903
 | **update-resumes**     | Обновить все резюме. Аналогично нажатию кнопки «Обновить дату».                                     |
 | **apply-similar**      | Откликнуться на все подходящие вакансии. Лимит = 200 в день                                         |
 | **clear-negotiations** | Удаляет отказы и отменяет заявки, которые долго висят                                               |
-| **call-api**           | Вызов произвольного метода API с вводом результата.                                                 |
+| **call-api**           | Вызов произвольного метода API с выводом результата.                                                 |
 | **refresh-token**      | Обновляет access_token.                                                                             |
 
 Для начала нужно добавить обработчик протокола `hhandroid`, который используется Android-приложением для усложнения жизни честным автоматизаторам:

{hh_applicant_tool-0.2.1 → hh_applicant_tool-0.2.3}/README.md

@@ -1,6 +1,13 @@
 # HH Applicant Tool
 
-![Publish to PyPI](https://github.com/s3rgeym/hh-applicant-tool/actions/workflows/publish.yml/badge.svg) [![PyPi Version](https://img.shields.io/pypi/v/hh-applicant-tool)](https://img.shields.io/pypi/v/hh-applicant-tool) [![Python Versions](https://img.shields.io/pypi/pyversions/hh-applicant-tool.svg)](https://img.shields.io/pypi/pyversions/hh-applicant-tool.svg) [![PyPI - Downloads](https://img.shields.io/pypi/dm/hh-applicant-tool)](https://img.shields.io/pypi/dm/hh-applicant-tool)
+> ! Наложен мораторий на доработки/переработки. Разработка будет возобновлена после 100 звезд 💫
+
+![Publish to PyPI](https://github.com/s3rgeym/hh-applicant-tool/actions/workflows/publish.yml/badge.svg) 
+[![PyPi Version](https://img.shields.io/pypi/v/hh-applicant-tool)]() 
+[![Python Versions](https://img.shields.io/pypi/pyversions/hh-applicant-tool.svg)]() 
+[![GitHub code size in bytes](https://img.shields.io/github/languages/code-size/s3rgeym/hh-applicant-tool)]()
+[![PyPI - Downloads](https://img.shields.io/pypi/dm/hh-applicant-tool)]()
+[![Total Downloads](https://static.pepy.tech/badge/hh-applicant-tool)]()
 
 Утилита для автоматизации действий на HH.RU таких как рассылка откликов на подходящие вакансии и обновление всех резюме.
 
@@ -9,13 +16,23 @@
 - socat
 - python >= 3.10
 
-Нужную версию можно поставить через asdf/pyenv, а вот socat придется доставить.
+Нужную версию можно поставить через asdf/pyenv, а вот socat придется доставить. В Arch-based:
+
+```bash
+yay -S socat
+```
+
+Пример работы:
+
+![image](https://github.com/user-attachments/assets/4936a8dd-f671-4788-8106-0470d5ce1dd6)
+![image](https://github.com/user-attachments/assets/55ab24ba-5325-40b4-9bd9-69ebcbc011c4)
+
 
-Данная утилита не может работать от root. Я не планирую добавлять поддержку Windows, но никто не мешает вам ее реализовать.
+Данная утилита работает только в Linux. Для авторизации требуется наличие графического окружения (это не совсем верно, но мне лень расписывать...), после нее вы можете перенести `~/.config/hh-applicant-tool/config.json` на сервер и запускать утилиту через systemd или cron, либо же вообще делать это через **WSL**. Так же при наличии рутованного телефона можно вытащить `access` и `refresh` токены из официального приложения и добавить их в конфиг.
 
 Предыстория.
 
-Был один знакомый знакомого, который работал хером. Этот чувак не заморачивался с чтением резюме, а тупо скриптами рассылал предложения о работе... Бывают, конечно, филологини, которые не могут отлчить Java от JavaScript, но я думаю, что в значительном числе случаев, тут имеют место такие вот рассылки... И я перенял эту порочную практику. Мне уже просто лень читать весь этот бред, что пишут в описании вакансий. Там стандартное ООП, алгоритмы и прочая хуета... Вроде все подходят, а вроде хз — все не мое. Поэтому тупло спамлю в надежде на идеальную работу. Долгое время (пару недель в октябре 2022) я делал массовые заявки с помощью консоли браузера:
+Был один знакомый знакомого, который работал хрюшей. Этот чувак не заморачивался с чтением резюме, а тупо скриптами рассылал предложения о работе... Бывают, конечно, филологини, которые не могут отлчить Java от JavaScript, но я думаю, что в значительном числе случаев, тут имеют место такие вот рассылки... И я перенял эту порочную практику. Мне уже просто лень читать весь этот бред, что пишут в описании вакансий. Там стандартное ООП, алгоритмы и прочая хуета... Вроде все подходят, а вроде хз — все не мое. Поэтому тупло спамлю в надежде на идеальную работу. Долгое время (пару недель в октябре 2022) я делал массовые заявки с помощью консоли браузера:
 
 ```js
 $$('[data-qa="vacancy-serp__vacancy_response"]').forEach((el) => el.click());
@@ -57,9 +74,7 @@ $ hh-applicant-tool apply-similar
 # Поднимаем резюме
 $ hh-applicant-tool update-resumes
 
-# Чистим заявки и баним за отказы говноконторы, нанявших на работу филолохинь,
-# астралохинь и прочих 3.14дарасов по блату, считающих, что погроммистом может
-# быть только ДОЦЕНТ МАТЕМАТИЧЕСКИХ НАУК 🤡
+# Чистим заявки и баним за отказы говноконторы
 $ hh-applicant-tool clear-negotiations --blacklist-discard
 ```
 
@@ -105,7 +120,7 @@ https://hh.ru/employer/1918903
 | **update-resumes**     | Обновить все резюме. Аналогично нажатию кнопки «Обновить дату».                                     |
 | **apply-similar**      | Откликнуться на все подходящие вакансии. Лимит = 200 в день                                         |
 | **clear-negotiations** | Удаляет отказы и отменяет заявки, которые долго висят                                               |
-| **call-api**           | Вызов произвольного метода API с вводом результата.                                                 |
+| **call-api**           | Вызов произвольного метода API с выводом результата.                                                 |
 | **refresh-token**      | Обновляет access_token.                                                                             |
 
 Для начала нужно добавить обработчик протокола `hhandroid`, который используется Android-приложением для усложнения жизни честным автоматизаторам:

{hh_applicant_tool-0.2.1 → hh_applicant_tool-0.2.3}/hh_applicant_tool/api/errors.py

@@ -37,11 +37,11 @@ class ApiError(Exception):
     def response_headers(self) -> CaseInsensitiveDict:
         return self._response.headers
 
-    def __getattr__(self, name: str) -> Any:
-        try:
-            return self._raw[name]
-        except KeyError as ex:
-            raise AttributeError(name) from ex
+#     def __getattr__(self, name: str) -> Any:
+#         try:
+#             return self._raw[name]
+#         except KeyError as ex:
+#             raise AttributeError(name) from ex
 
     def __str__(self) -> str:
         return str(self._raw)
@@ -58,7 +58,7 @@ class ClientError(ApiError):
 class BadRequest(ClientError):
     @property
     def limit_exceeded(self) -> bool:
-        return any(x["value"] == "limit_exceeded" for x in self.errors)
+        return any(x["value"] == "limit_exceeded" for x in self._raw["errors"])
 
 
 class Forbidden(ClientError):

{hh_applicant_tool-0.2.1 → hh_applicant_tool-0.2.3}/hh_applicant_tool/constants.py

@@ -1,4 +1,4 @@
-DEFAULT_USER_AGENT = "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/110.0.0.0 Safari/537.36"
+DEFAULT_USER_AGENT = "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/126.0.0.0 Safari/537.36"
 ANDROID_CLIENT_ID = (
     "HIOMIAS39CA9DICTA7JIO64LQKQJF5AGIK74G9ITJKLNEDAOH5FHS5G1JI7FOEGD"
 )

{hh_applicant_tool-0.2.1 → hh_applicant_tool-0.2.3}/hh_applicant_tool/operations/add_handler.py

@@ -1,5 +1,6 @@
 import argparse
 import logging
+import os
 from pathlib import Path
 from subprocess import check_call
 
@@ -36,6 +37,12 @@ class Operation(BaseOperation):
         )
 
     def run(self, args: Namespace) -> None:
+        # Проверка, запущен ли скрипт в WSL
+        if self.is_wsl():
+            print_err("⚠️ Предупреждение: Скрипт запущен в WSL 💩. Функциональность может быть ограничена или не работать вовсе.")
+            print_err("Рекомендуется запуск на нативных Linux-системах.")
+            return 1
+
         # TODO: с root не будет работать
         desktop_path = Path(
             "~/.local/share/applications/hhandroid.desktop"
@@ -48,3 +55,7 @@ class Operation(BaseOperation):
         else:
             print_err("⛔ Обработчик уже существует!")
             return 1
+
+    def is_wsl(self) -> bool:
+        """Проверяет, запущен ли скрипт в WSL."""
+        return "WSL_DISTRO_NAME" in os.environ

{hh_applicant_tool-0.2.1 → hh_applicant_tool-0.2.3}/hh_applicant_tool/operations/apply_similar.py

@@ -1,8 +1,8 @@
-# Этот модуль можно использовать как образец для других
 import argparse
 import logging
 import random
-from typing import TextIO
+import time
+from typing import TextIO, Tuple
 
 from ..api import ApiClient, ApiError, BadRequest
 from ..main import BaseOperation
@@ -16,6 +16,9 @@ logger = logging.getLogger(__package__)
 class Namespace(BaseNamespace):
     resume_id: str | None
     message_list: TextIO
+    force_message: bool
+    apply_interval: Tuple[float, float]
+    page_interval: Tuple[float, float]
 
 
 class Operation(BaseOperation):
@@ -34,6 +37,27 @@ class Operation(BaseOperation):
             default=False,
             action=argparse.BooleanOptionalAction,
         )
+        parser.add_argument(
+            "--apply-interval",
+            help="Интервал между отправкой откликов в секундах (X, X-Y)",
+            default="1-5",
+            type=self._parse_interval,
+        )
+        parser.add_argument(
+            "--page-interval",
+            help="Интервал между получением следующей страницы рекомендованных вакансий в секундах (X, X-Y)",
+            default="1-3",
+            type=self._parse_interval,
+        )
+
+    @staticmethod
+    def _parse_interval(interval: str) -> Tuple[float, float]:
+        """Парсит строку интервала и возвращает кортеж с минимальным и максимальным значениями."""
+        if "-" in interval:
+            min_interval, max_interval = map(float, interval.split("-"))
+        else:
+            min_interval = max_interval = float(interval)
+        return min(min_interval, max_interval), max(min_interval, max_interval)
 
     def run(self, args: Namespace) -> None:
         assert args.config["token"]
@@ -45,8 +69,6 @@ class Operation(BaseOperation):
             resume_id := args.resume_id or args.config["default_resume_id"]
         ):
             resumes: ApiListResponse = api.get("/resumes/mine")
-            # Используем id первого резюме
-            # TODO: создать 10 резюме и рассылать по 2000 откликов в сутки
             resume_id = resumes["items"][0]["id"]
         if args.message_list:
             application_messages = list(
@@ -54,33 +76,41 @@ class Operation(BaseOperation):
             )
         else:
             application_messages = [
-                "Меня заинтересовала Ваша вакансия %(name)s",
-                "Прошу рассмотреть мою кандидатуру на вакансию %(name)s",
+                "Меня заинтересовала ваша вакансия %(name)s",
+                "Прошу рассмотреть мою жалкую кандидатуру на вакансию %(name)s",
+                "Ваша вакансия %(name)s соответствует моим навыкам и опыту",
+                "Хочу присоединиться к вашей успешной команде лидеров рынка в качестве %(name)s",
+                "Мое резюме содержит все баззворды, указанные в вашей вакансии %(name)s",
             ]
+
+        apply_min_interval, apply_max_interval = args.apply_interval
+        page_min_interval, page_max_interval = args.page_interval
+
         self._apply_similar(
-            api, resume_id, args.force_message, application_messages
+            api, resume_id, args.force_message, application_messages, apply_min_interval, apply_max_interval, page_min_interval, page_max_interval
         )
 
     def _get_vacancies(
-        self, api: ApiClient, resume_id: str
+        self, api: ApiClient, resume_id: str, page_min_interval: float, page_max_interval: float
     ) -> list[VacancyItem]:
         rv = []
-        # работает ограничение: глубина возвращаемых результатов не может быть больше 2000
-        # Номер страницы (считается от 0, по умолчанию - 0)
         per_page = 100
         for page in range(20):
             res: ApiListResponse = api.get(
                 f"/resumes/{resume_id}/similar_vacancies",
                 page=page,
                 per_page=per_page,
-                # Мне кажется, что так поисковая выдача можно забиться неадекватами, которые по полгода кого-то ищут
-                # Но так откликается на что-то уж совсем нерелевантное
-                # order_by="publication_time",
                 order_by="relevance",
             )
             rv.extend(res["items"])
             if page >= res["pages"] - 1:
                 break
+
+            # Задержка перед получением следующей страницы
+            if page > 0:
+                interval = random.uniform(page_min_interval, page_max_interval)
+                time.sleep(interval)
+
         return rv
 
     def _apply_similar(
@@ -89,15 +119,20 @@ class Operation(BaseOperation):
         resume_id: str,
         force_message: bool,
         application_messages: list[str],
+        apply_min_interval: float,
+        apply_max_interval: float,
+        page_min_interval: float,
+        page_max_interval: float,
     ) -> None:
-        # Получаем список рекомендованных вакансий и отправляем заявки
-        # Проблема тут в том, что вакансии на которые мы отклимкались должны исчезать из поиска, но ОНИ ТАМ ПРИСУТСТВУЮТ. Так же есть вакансии с ебучими тестами, которые всегда вверху. Вроде можно отсортировать по дате, а потом постепенно уменьшать диапазон, но он не точный и округляется до 5 минут, а потому там повторы
         item: VacancyItem
-        for item in self._get_vacancies(api, resume_id):
-            # В рот я ебал вас и ваши тесты, пидоры
+        for item in self._get_vacancies(api, resume_id, page_min_interval, page_max_interval):
             if item["has_test"]:
                 continue
-            # Откликаемся на ваканчию
+
+            # Задержка перед отправкой отклика
+            interval = random.uniform(apply_min_interval, apply_max_interval)
+            time.sleep(interval)
+
             params = {
                 "resume_id": resume_id,
                 "vacancy_id": item["id"],
@@ -121,4 +156,5 @@ class Operation(BaseOperation):
                 print_err("❗ Ошибка:", ex)
                 if isinstance(ex, BadRequest) and ex.limit_exceeded:
                     break
+
         print("📝 Отклики на вакансии разосланы!")

{hh_applicant_tool-0.2.1 → hh_applicant_tool-0.2.3}/hh_applicant_tool/operations/authorize.py

@@ -61,6 +61,17 @@ class Operation(BaseOperation):
         pass
 
     def run(self, args: Namespace) -> None:
+        # Проверяем, установлен ли socat
+        if not self.is_socat_installed():
+            print("⚠️ Предупреждение: socat не установлен. Для работы с unix-сокетами рекомендуется установить socat.")
+            print()
+            print("Вы можете установить socat с помощью вашего пакетного менеджера, например:")
+            print()
+            print("  - Debian/Ubuntu: sudo apt-get install socat")
+            print("  - Fedora: sudo dnf install socat")
+            print("  - Arch/Manjaro: sudo pacman -S socat")
+            print()
+
         oauth = OAuthClient(
             user_agent=(
                 args.config["oauth_user_agent"] or args.config["user_agent"]
@@ -76,3 +87,11 @@ class Operation(BaseOperation):
             HHANDROID_SOCKET_PATH, oauth_client=oauth, config=args.config
         )
         server.serve_forever()
+
+    def is_socat_installed(self) -> bool:
+        """Проверяет, установлен ли socat в системе."""
+        try:
+            subprocess.run(["socat", "-h"], stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL)
+            return True
+        except FileNotFoundError:
+            return False

{hh_applicant_tool-0.2.1 → hh_applicant_tool-0.2.3}/hh_applicant_tool/utils.py

@@ -7,7 +7,7 @@ from pathlib import Path
 from threading import Lock
 from typing import Any
 
-print_err = partial(print, file=sys.stderr)
+print_err = partial(print, file=sys.stderr, flush=True)
 
 
 class AttrDict(dict):

{hh_applicant_tool-0.2.1 → hh_applicant_tool-0.2.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "hh-applicant-tool"
-version = "0.2.1"
+version = "0.2.3"
 description = ""
 authors = ["Senior YAML Developer <yamldeveloper@proton.me>"]
 readme = "README.md"