hh-applicant-tool 0.3.3__tar.gz → 0.3.5__tar.gz

{hh_applicant_tool-0.3.3 → hh_applicant_tool-0.3.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: hh-applicant-tool
-Version: 0.3.3
+Version: 0.3.5
 Summary: 
 Author: Senior YAML Developer
 Author-email: yamldeveloper@proton.me
@@ -37,7 +37,7 @@ Description-Content-Type: text/markdown
 Работает с Python >= 3.10. Нужную версию Python можно поставить через
 asdf/pyenv/conda и что-то еще...
 
-Данная утилита написана для Linux, но будет работать и на Ga..Mac OS, и в Windows, но с WSL не будет, так как для авторизации требуются оконный сервер X11 либо Wayland — только прямая установка пакета через pip в Windows. После авторизации вы можете перенести `~/.config/hh-applicant-tool/config.json` (я не знаю, где винда что хранит) на сервер и запускать утилиту через systemd или cron. Столь странный процесс связан с тем, что на странице авторизации запускается море скриптов, которые шифруют данные на клиенте перед отправкой на сервер, а так же выполняется куча запросов чтобы проверить не бот ли ты. Хорошо, что после авторизации никаких проверок по факту нет, даже айпи не проверяется на соответсвие тому с какого была авторизация. В этой лапше мне лень разбираться. Так же при наличии рутованного телефона можно вытащить `access` и `refresh` токены из официального приложения и добавить их в конфиг.
+Данная утилита написана для Linux, но будет работать и на Ga..Mac OS, и в Windows, но с WSL не будет, так как для авторизации требуются оконный сервер X11 либо Wayland — только прямая установка пакета через pip в Windows. После авторизации вы можете перенести `~/.config/hh-applicant-tool/config.json` (`C:\Users\%username%\AppData\Roaming\hh-applicant-tool\config.json` — в Windows) на сервер и запускать утилиту через systemd или cron. Столь странный процесс связан с тем, что на странице авторизации запускается море скриптов, которые шифруют данные на клиенте перед отправкой на сервер, а так же выполняется куча запросов чтобы проверить не бот ли ты. Хорошо, что после авторизации никаких проверок по факту нет, даже айпи не проверяется на соответсвие тому с какого была авторизация. В этой лапше мне лень разбираться. Так же при наличии рутованного телефона можно вытащить `access` и `refresh` токены из официального приложения и добавить их в конфиг.
 
 Пример работы:
 
@@ -67,9 +67,34 @@ $ pipx install 'hh-applicant-tool[qt]'
 $ pipx install git+https://github.com/s3rgeym/hh-applicant-tool
 
 # Для обновления до новой версии
-$ pipx upgrade 'hh-applicant-tool'
+$ pipx upgrade hh-applicant-tool
 ```
 
+Отдельно я распишу процесс установки в **Windows** в подробностях:
+
+* Для начала поставьте Python 3 любым удобным способом.
+* Запустите терминал/консоль от Администратора и выполните:
+  ```ps
+  Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy Unrestricted
+  ```
+  Без этой настройки не будут работать виртуальные окружения.
+* Создайте и активируйте виртуальное окружение:
+  ```ps
+  PS> python -m pip venv hh-applicant-venv
+  PS> .\hh-applicant-venv\Scripts\activate
+  ```
+* Поставьте все пакеты в виртуальное окружение `hh-applicant-tool`:
+  ```ps
+  (hh-applicant-venv) PS> pip install hh-applicant-tool[qt]
+  ```
+* Проверьте работает ли оно:
+  ```ps
+  (hh-applicant-venv) PS> hh-applicant-tool -h
+  ```
+* В случае неудачи, вернитесь к первому шагу. Для последующих запусков сперва активируйте виртуальное окружение.
+  
+
+
 Использование:
 
 ```bash
@@ -135,7 +160,7 @@ https://hh.ru/employer/1918903
 | **update-resumes**     | Обновить все резюме. Аналогично нажатию кнопки «Обновить дату».                                     |
 | **apply-similar**      | Откликнуться на все подходящие вакансии. Лимит = 200 в день                                         |
 | **clear-negotiations** | Удаляет отказы и отменяет заявки, которые долго висят                                               |
-| **call-api**           | Вызов произвольного метода API с выводом результата.                                                 |
+| **call-api**           | Вызов произвольного метода API с выводом результата.                                                |
 | **refresh-token**      | Обновляет access_token.                                                                             |
 
 Авторизуемся:
@@ -146,6 +171,10 @@ $ hh-applicant-tool -vv authorize
 
 ![image](https://github.com/user-attachments/assets/88961e31-4ea3-478f-8c43-914d6785bc3b)
 
+> В Windows не забудьте разрешить доступ к сети (Allow access) в всплывающем окне.
+
+
+
 В случае успешной авторизации токены будут сохранены в `~/.config/hh-applicant-tool/config.json`:
 
 ```json

{hh_applicant_tool-0.3.3 → hh_applicant_tool-0.3.5}/README.md

@@ -18,7 +18,7 @@
 Работает с Python >= 3.10. Нужную версию Python можно поставить через
 asdf/pyenv/conda и что-то еще...
 
-Данная утилита написана для Linux, но будет работать и на Ga..Mac OS, и в Windows, но с WSL не будет, так как для авторизации требуются оконный сервер X11 либо Wayland — только прямая установка пакета через pip в Windows. После авторизации вы можете перенести `~/.config/hh-applicant-tool/config.json` (я не знаю, где винда что хранит) на сервер и запускать утилиту через systemd или cron. Столь странный процесс связан с тем, что на странице авторизации запускается море скриптов, которые шифруют данные на клиенте перед отправкой на сервер, а так же выполняется куча запросов чтобы проверить не бот ли ты. Хорошо, что после авторизации никаких проверок по факту нет, даже айпи не проверяется на соответсвие тому с какого была авторизация. В этой лапше мне лень разбираться. Так же при наличии рутованного телефона можно вытащить `access` и `refresh` токены из официального приложения и добавить их в конфиг.
+Данная утилита написана для Linux, но будет работать и на Ga..Mac OS, и в Windows, но с WSL не будет, так как для авторизации требуются оконный сервер X11 либо Wayland — только прямая установка пакета через pip в Windows. После авторизации вы можете перенести `~/.config/hh-applicant-tool/config.json` (`C:\Users\%username%\AppData\Roaming\hh-applicant-tool\config.json` — в Windows) на сервер и запускать утилиту через systemd или cron. Столь странный процесс связан с тем, что на странице авторизации запускается море скриптов, которые шифруют данные на клиенте перед отправкой на сервер, а так же выполняется куча запросов чтобы проверить не бот ли ты. Хорошо, что после авторизации никаких проверок по факту нет, даже айпи не проверяется на соответсвие тому с какого была авторизация. В этой лапше мне лень разбираться. Так же при наличии рутованного телефона можно вытащить `access` и `refresh` токены из официального приложения и добавить их в конфиг.
 
 Пример работы:
 
@@ -48,9 +48,34 @@ $ pipx install 'hh-applicant-tool[qt]'
 $ pipx install git+https://github.com/s3rgeym/hh-applicant-tool
 
 # Для обновления до новой версии
-$ pipx upgrade 'hh-applicant-tool'
+$ pipx upgrade hh-applicant-tool
 ```
 
+Отдельно я распишу процесс установки в **Windows** в подробностях:
+
+* Для начала поставьте Python 3 любым удобным способом.
+* Запустите терминал/консоль от Администратора и выполните:
+  ```ps
+  Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy Unrestricted
+  ```
+  Без этой настройки не будут работать виртуальные окружения.
+* Создайте и активируйте виртуальное окружение:
+  ```ps
+  PS> python -m pip venv hh-applicant-venv
+  PS> .\hh-applicant-venv\Scripts\activate
+  ```
+* Поставьте все пакеты в виртуальное окружение `hh-applicant-tool`:
+  ```ps
+  (hh-applicant-venv) PS> pip install hh-applicant-tool[qt]
+  ```
+* Проверьте работает ли оно:
+  ```ps
+  (hh-applicant-venv) PS> hh-applicant-tool -h
+  ```
+* В случае неудачи, вернитесь к первому шагу. Для последующих запусков сперва активируйте виртуальное окружение.
+  
+
+
 Использование:
 
 ```bash
@@ -116,7 +141,7 @@ https://hh.ru/employer/1918903
 | **update-resumes**     | Обновить все резюме. Аналогично нажатию кнопки «Обновить дату».                                     |
 | **apply-similar**      | Откликнуться на все подходящие вакансии. Лимит = 200 в день                                         |
 | **clear-negotiations** | Удаляет отказы и отменяет заявки, которые долго висят                                               |
-| **call-api**           | Вызов произвольного метода API с выводом результата.                                                 |
+| **call-api**           | Вызов произвольного метода API с выводом результата.                                                |
 | **refresh-token**      | Обновляет access_token.                                                                             |
 
 Авторизуемся:
@@ -127,6 +152,10 @@ $ hh-applicant-tool -vv authorize
 
 ![image](https://github.com/user-attachments/assets/88961e31-4ea3-478f-8c43-914d6785bc3b)
 
+> В Windows не забудьте разрешить доступ к сети (Allow access) в всплывающем окне.
+
+
+
 В случае успешной авторизации токены будут сохранены в `~/.config/hh-applicant-tool/config.json`:
 
 ```json

{hh_applicant_tool-0.3.3 → hh_applicant_tool-0.3.5}/hh_applicant_tool/operations/apply_similar.py

@@ -25,8 +25,9 @@ class Namespace(BaseNamespace):
     page_interval: Tuple[float, float]
 
 
+# https://api.hh.ru/openapi/redoc
 class Operation(BaseOperation):
-    """Откликнуться на все подходящие вакансии"""
+    """Откликнуться на все подходящие вакансии. По умолчанию применяются значения, которые были отмечены галочками в форме для поиска на сайте"""
 
     def setup_parser(self, parser: argparse.ArgumentParser) -> None:
         parser.add_argument("--resume-id", help="Идентефикатор резюме")
@@ -53,6 +54,24 @@ class Operation(BaseOperation):
             default="1-3",
             type=self._parse_interval,
         )
+        parser.add_argument(
+            "--order-by",
+            help="Сортировка вакансий",
+            choices=[
+                "publication_time",
+                "salary_desc",
+                "salary_asc",
+                "relevance",
+                "distance",
+            ],
+            default="relevance",
+        )
+        parser.add_argument(
+            "--search",
+            help="Строка поиска для фильтрации вакансий, например, 'москва бухгалтер 100500', те можно и город указать, и ожидаемую зряплату",
+            type=str,
+            default=None,
+        )
 
     @staticmethod
     def _parse_interval(interval: str) -> Tuple[float, float]:
@@ -84,6 +103,8 @@ class Operation(BaseOperation):
             apply_max_interval,
             page_min_interval,
             page_max_interval,
+            args.order_by,
+            args.search,
         )
 
     def _get_resume_id(self, args: Namespace, api: ApiClient) -> str:
@@ -119,12 +140,20 @@ class Operation(BaseOperation):
         apply_max_interval: float,
         page_min_interval: float,
         page_max_interval: float,
+        order_by: str,
+        search: str | None = None,
     ) -> None:
         telemetry_client = get_telemetry_client()
         telemetry_data = defaultdict(dict)
 
         vacancies = self._get_vacancies(
-            api, resume_id, page_min_interval, page_max_interval, per_page=100
+            api,
+            resume_id,
+            page_min_interval,
+            page_max_interval,
+            per_page=100,
+            order_by=order_by,
+            search=search,
         )
 
         self._collect_vacancy_telemetry(telemetry_data, vacancies)
@@ -134,7 +163,7 @@ class Operation(BaseOperation):
                 if getenv("TEST_TELEMETRY"):
                     break
 
-                if vacancy["has_test"]:
+                if vacancy.get("has_test"):
                     print("🚫 Пропускаем тест", vacancy["alternate_url"])
                     continue
 
@@ -147,16 +176,23 @@ class Operation(BaseOperation):
                     )
                     continue
 
-                employer_id = vacancy["employer"]["id"]
-                employer = api.get(f"/employers/{employer_id}")
+                try:
+                    employer_id = vacancy["employer"]["id"]
+                except IndexError:
+                    logger.warning(
+                        f"Вакансия без работодателя: {vacancy['alternate_url']}"
+                    )
+                else:
+                    employer = api.get(f"/employers/{employer_id}")
+
+                    telemetry_data["employers"][employer_id] = {
+                        "name": employer.get("name"),
+                        "type": employer.get("type"),
+                        "description": employer.get("description"),
+                        "site_url": employer.get("site_url"),
+                        "area": employer.get("area", {}).get("name"),  # город
+                    }
 
-                telemetry_data["employers"][employer_id] = {
-                    "name": employer.get("name"),
-                    "type": employer.get("type"),
-                    "description": employer.get("description"),
-                    "site_url": employer.get("site_url"),
-                    "area": employer.get("area", {}).get("name"),  # город
-                }
                 # Задержка перед отправкой отклика
                 interval = random.uniform(
                     apply_min_interval, apply_max_interval
@@ -166,13 +202,23 @@ class Operation(BaseOperation):
                 params = {
                     "resume_id": resume_id,
                     "vacancy_id": vacancy["id"],
-                    "message": (
-                        random.choice(application_messages) % vacancy
-                        if force_message or vacancy["response_letter_required"]
-                        else ""
-                    ),
+                    "message": "",
                 }
 
+                if vacancy.get("response_letter_required"):
+                    message_template = random.choice(application_messages)
+
+                    try:
+                        params["message"] = template_message % vacancy
+                    except TypeError as ex:
+                        # TypeError: not enough arguments for format string
+                        # API HH все кривое, иногда нет идентификатора работодателя, иногда у вакансии нет названия.
+                        # И это типа рашн хайлоад, где из-за дрочки на аджайл слепили кривую говнину.
+                        logger.error(
+                            f"Ошибка форматирования шаблона сообщения {template_message!r} для {vacancy = }"
+                        )
+                        continue
+
                 res = api.post("/negotiations", params)
                 assert res == {}
                 print(
@@ -198,14 +244,20 @@ class Operation(BaseOperation):
         page_min_interval: float,
         page_max_interval: float,
         per_page: int,
+        order_by: str,
+        search: str | None = None,
     ) -> list[VacancyItem]:
         rv = []
         for page in range(20):
+            params = {
+                "page": page,
+                "per_page": per_page,
+                "order_by": order_by,
+            }
+            if search:
+                params["text"] = search
             res: ApiListResponse = api.get(
-                f"/resumes/{resume_id}/similar_vacancies",
-                page=page,
-                per_page=per_page,
-                order_by="relevance",
+                f"/resumes/{resume_id}/similar_vacancies", params
             )
             rv.extend(res["items"])
 
@@ -242,7 +294,11 @@ class Operation(BaseOperation):
                 "contacts": vacancy.get(
                     "contacts"
                 ),  # пиздорванки там телеграм для связи указывают
-                "employer_id": int(vacancy["employer"]["id"]),
+                # HH с точки зрения перфикциониста — кусок говна, где кривые
+                # форматы даты, у вакансий может не быть работодателя...
+                "employer_id": int(vacancy["employer"]["id"])
+                if "employer" in vacancy and "id" in vacancy["employer"]
+                else None,
                 # Остальное неинтересно
             }
 
@@ -250,7 +306,9 @@ class Operation(BaseOperation):
         self, telemetry_client, telemetry_data: defaultdict
     ) -> None:
         try:
-            res = telemetry_client.send_telemetry("/collect", dict(telemetry_data))
+            res = telemetry_client.send_telemetry(
+                "/collect", dict(telemetry_data)
+            )
             logger.debug(res)
         except TelemetryError as ex:
             logger.error(ex)

{hh_applicant_tool-0.3.3 → hh_applicant_tool-0.3.5}/pyproject.toml

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