hh-applicant-tool 0.4.0__tar.gz → 0.4.1__tar.gz

{hh_applicant_tool-0.4.0 → hh_applicant_tool-0.4.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: hh-applicant-tool
-Version: 0.4.0
+Version: 0.4.1
 Summary: 
 Author: Senior YAML Developer
 Author-email: yamldeveloper@proton.me
@@ -240,6 +240,7 @@ https://hh.ru/employer/1918903
 | **list-resumes**       | Список резюме                                                                                       |
 | **update-resumes**     | Обновить все резюме. Аналогично нажатию кнопки «Обновить дату».                                     |
 | **apply-similar**      | Откликнуться на все подходящие вакансии. Лимит = 200 в день. На HH есть спам-фильтры, так что лучше не рассылайте отклики со ссылками. |
+| **reply-employers** | Ответить во все чаты с работодателями, где нет ответа либо не прочитали ваш предыдущий ответ |
 | **clear-negotiations** | Удаляет отказы и отменяет заявки, которые долго висят                                               |
 | **call-api**           | Вызов произвольного метода API с выводом результата.                                                |
 | **refresh-token**      | Обновляет access_token.                                                                             |
@@ -282,11 +283,17 @@ https://hh.ru/employer/1918903
 
 Отдельные замечания у меня к API HH. Оно пиздец какое кривое. Например, при создании заявки возвращается пустой ответ либо редирект, хотя по логике должен возвраться созданный объект. Так же в ответах сервера нет `Content-Length`. Из-за этого нельзя узнать есть тело у ответа сервера нужно его пробовать прочитать. Я так понял там какой-то прокси оборачивает все запросы и отдает всегда `Transfer-Encoding: Chunked`. А еще он возвращает 502 ошибку, когда бекенд на Java падает либо долго отвечает (таймаут)? А вот [язык запросов](https://hh.ru/article/1175) мне понравился. Можно что-то типа этого использовать `NOT (!ID:123 OR !ID:456 OR !ID:789)` что бы отсеить какие-то вакансии.
 
+Для создания своих плагинов прочитайте документацию:
+
+* [HH.RU OpenAPI](https://api.hh.ru/openapi/redoc)
+
+Для тестирования запросов к API используйте команду `call-api` и `jq` для вывода JSON в удобочитаемом формате.
+
 ### Сбор данных
 
-> Данный функционал можно отключить с помощью специльного флага, но ради котят и из-за ненависти к херкам не делайте этого!
+Сбор и передачу данных о вакансиях и работодателях можно отключить, но так никакие персональные данные пользователя не передаются, то можно ничего не менять. Так как утилита бесплатна, то передачу вышеуказанной телеметрии можете рассматривать как плату за пользование.
 
-Утилита собирает и передает на сервер разработчика следующую информацию:
+Утилита по умолчанию собирает и передает на сервер разработчика следующие данные:
 
 1. Название вакансии.
 1. Тип вакансии (открытая/закрытая).
@@ -295,13 +302,11 @@ https://hh.ru/employer/1918903
 1. Прямая ссылка на вакансию.
 1. Дата создания вакансии.
 1. Дата публикации вакансии.
-1. Контактная информация работодателя, которую он или его сотрудники сами выложили в общественный доступ, которая в дальнейшем _может_ храниться в строго обезличенной форме с соблюдением законов РФ, GDPR и американского экспортного контроля. Данная информация может быть удалена при письменном запросе в утвержденной Законом форме с оригинальными печатями фирмы и подписью генерального директора и/или по требованию РКН, прокуратуры или лично Адама Кадырова.
+1. Контактная информация работодателя, указанная в вакансии с целью сохранения email, телефона и юзернейма аккаунта Telegram. Все эти данные вместе и каждое в частности не являются персональными данными на что есть [определение Верховного Суда](https://base.garant.ru/407421338/), так что я не вижу препятствий для того чтобы в дальнейшем утилита любому желающему давала возможность получить контакты любого работодателя, например, email и телегу. Тем более желающих послать нахуй тупую пизду, выкатившую немотивированный отказ, всегда будет предостаточно. 
 1. Название компании.
 1. Тип компании.
 1. Описание компании.
 1. Ссылка на сайт компании. 
 1. Город, в котором находится компания.
 
-**УТИЛИТА НЕ ПЕРЕДАЕТ НИКАКИХ ПЕРСОНАЛЬНЫХ ДАННЫХ ПОЛЬЗОВАТЕЛЕЙ — ТОЛЬКО ДАННЫЕ ВСЯКИХ РАБОТАДАТЕЛЕЙ И ИХ ОВЧАРОК. СЕРВЕР НЕ ХРАНИТ IP ОТПРАВИТЕЛЯ. ЛОГИ НА СЕРВЕРЕ НЕ ВЕДУТСЯ. ТАК ЖЕ Я ОБЕЩАЮ, ЧТО УТИЛИТА ВСЕГДА БУДЕТ БЕСПЛАТНОЙ, ВСЕ КТО ЕЮ ПЫТАЮТСЯ ТОРГОВАТЬ — УЕБКИ, И У НИХ ПОЧЕРНЕЕТ И ОТВАЛИТСЯ ХУЙ. ЕДИНСТВЕННАЯ ПЛАТА ЗА ЕЕ ИСПОЛЬЗОВАНИЕ — ЭТО ПОМОЩЬ В ПАРСИНГЕ САЙТА HEADHUNTER (МЕНЯ ИНТЕРЕСУЕТ ЕГО БАЗА КОМПАНИЙ).**
-
 

{hh_applicant_tool-0.4.0 → hh_applicant_tool-0.4.1}/README.md

@@ -221,6 +221,7 @@ https://hh.ru/employer/1918903
 | **list-resumes**       | Список резюме                                                                                       |
 | **update-resumes**     | Обновить все резюме. Аналогично нажатию кнопки «Обновить дату».                                     |
 | **apply-similar**      | Откликнуться на все подходящие вакансии. Лимит = 200 в день. На HH есть спам-фильтры, так что лучше не рассылайте отклики со ссылками. |
+| **reply-employers** | Ответить во все чаты с работодателями, где нет ответа либо не прочитали ваш предыдущий ответ |
 | **clear-negotiations** | Удаляет отказы и отменяет заявки, которые долго висят                                               |
 | **call-api**           | Вызов произвольного метода API с выводом результата.                                                |
 | **refresh-token**      | Обновляет access_token.                                                                             |
@@ -263,11 +264,17 @@ https://hh.ru/employer/1918903
 
 Отдельные замечания у меня к API HH. Оно пиздец какое кривое. Например, при создании заявки возвращается пустой ответ либо редирект, хотя по логике должен возвраться созданный объект. Так же в ответах сервера нет `Content-Length`. Из-за этого нельзя узнать есть тело у ответа сервера нужно его пробовать прочитать. Я так понял там какой-то прокси оборачивает все запросы и отдает всегда `Transfer-Encoding: Chunked`. А еще он возвращает 502 ошибку, когда бекенд на Java падает либо долго отвечает (таймаут)? А вот [язык запросов](https://hh.ru/article/1175) мне понравился. Можно что-то типа этого использовать `NOT (!ID:123 OR !ID:456 OR !ID:789)` что бы отсеить какие-то вакансии.
 
+Для создания своих плагинов прочитайте документацию:
+
+* [HH.RU OpenAPI](https://api.hh.ru/openapi/redoc)
+
+Для тестирования запросов к API используйте команду `call-api` и `jq` для вывода JSON в удобочитаемом формате.
+
 ### Сбор данных
 
-> Данный функционал можно отключить с помощью специльного флага, но ради котят и из-за ненависти к херкам не делайте этого!
+Сбор и передачу данных о вакансиях и работодателях можно отключить, но так никакие персональные данные пользователя не передаются, то можно ничего не менять. Так как утилита бесплатна, то передачу вышеуказанной телеметрии можете рассматривать как плату за пользование.
 
-Утилита собирает и передает на сервер разработчика следующую информацию:
+Утилита по умолчанию собирает и передает на сервер разработчика следующие данные:
 
 1. Название вакансии.
 1. Тип вакансии (открытая/закрытая).
@@ -276,12 +283,10 @@ https://hh.ru/employer/1918903
 1. Прямая ссылка на вакансию.
 1. Дата создания вакансии.
 1. Дата публикации вакансии.
-1. Контактная информация работодателя, которую он или его сотрудники сами выложили в общественный доступ, которая в дальнейшем _может_ храниться в строго обезличенной форме с соблюдением законов РФ, GDPR и американского экспортного контроля. Данная информация может быть удалена при письменном запросе в утвержденной Законом форме с оригинальными печатями фирмы и подписью генерального директора и/или по требованию РКН, прокуратуры или лично Адама Кадырова.
+1. Контактная информация работодателя, указанная в вакансии с целью сохранения email, телефона и юзернейма аккаунта Telegram. Все эти данные вместе и каждое в частности не являются персональными данными на что есть [определение Верховного Суда](https://base.garant.ru/407421338/), так что я не вижу препятствий для того чтобы в дальнейшем утилита любому желающему давала возможность получить контакты любого работодателя, например, email и телегу. Тем более желающих послать нахуй тупую пизду, выкатившую немотивированный отказ, всегда будет предостаточно. 
 1. Название компании.
 1. Тип компании.
 1. Описание компании.
 1. Ссылка на сайт компании. 
 1. Город, в котором находится компания.
 
-**УТИЛИТА НЕ ПЕРЕДАЕТ НИКАКИХ ПЕРСОНАЛЬНЫХ ДАННЫХ ПОЛЬЗОВАТЕЛЕЙ — ТОЛЬКО ДАННЫЕ ВСЯКИХ РАБОТАДАТЕЛЕЙ И ИХ ОВЧАРОК. СЕРВЕР НЕ ХРАНИТ IP ОТПРАВИТЕЛЯ. ЛОГИ НА СЕРВЕРЕ НЕ ВЕДУТСЯ. ТАК ЖЕ Я ОБЕЩАЮ, ЧТО УТИЛИТА ВСЕГДА БУДЕТ БЕСПЛАТНОЙ, ВСЕ КТО ЕЮ ПЫТАЮТСЯ ТОРГОВАТЬ — УЕБКИ, И У НИХ ПОЧЕРНЕЕТ И ОТВАЛИТСЯ ХУЙ. ЕДИНСТВЕННАЯ ПЛАТА ЗА ЕЕ ИСПОЛЬЗОВАНИЕ — ЭТО ПОМОЩЬ В ПАРСИНГЕ САЙТА HEADHUNTER (МЕНЯ ИНТЕРЕСУЕТ ЕГО БАЗА КОМПАНИЙ).**
-

{hh_applicant_tool-0.4.0 → hh_applicant_tool-0.4.1}/hh_applicant_tool/main.py

@@ -3,7 +3,6 @@ from __future__ import annotations
 import argparse
 import logging
 import sys
-from abc import ABCMeta, abstractmethod
 from importlib import import_module
 from pathlib import Path
 from pkgutil import iter_modules
@@ -14,17 +13,17 @@ from .utils import Config, get_config_path
 from os import getenv
 
 DEFAULT_CONFIG_PATH = (
-    get_config_path() / __package__.replace("_", "-") / "config.json"
+    get_config_path() / (__package__ or '').replace("_", "-") / "config.json"
 )
 
 logger = logging.getLogger(__package__)
 
 
-class BaseOperation(metaclass=ABCMeta):
+class BaseOperation:
     def setup_parser(self, parser: argparse.ArgumentParser) -> None: ...
 
-    @abstractmethod
-    def run(self, args: argparse.Namespace) -> None | int: ...
+    def run(self, args: argparse.Namespace) -> None | int:
+        raise NotImplementedError()
 
 
 OPERATIONS = "operations"

hh_applicant_tool-0.4.1/hh_applicant_tool/mixins.py

@@ -0,0 +1,13 @@
+from .api import ApiError
+from .types import ApiListResponse
+
+
+class GetResumeIdMixin:
+    def _get_resume_id(self) -> str:
+        try:
+            resumes: ApiListResponse = self.api.get("/resumes/mine")
+            return resumes["items"][0]["id"]
+        except (ApiError, KeyError, IndexError) as ex:
+            raise Exception("Не могу получить идентификатор резюме") from ex
+
+

hh_applicant_tool-0.4.1/hh_applicant_tool/operations/apply_similar.py

@@ -0,0 +1,296 @@
+import argparse
+import logging
+import random
+import time
+from collections import defaultdict
+from typing import TextIO, Tuple
+
+from ..api import ApiError, BadRequest
+from ..main import BaseOperation
+from ..main import Namespace as BaseNamespace, get_api
+from ..telemetry_client import TelemetryClient, TelemetryError
+from ..types import ApiListResponse, VacancyItem
+from ..utils import fix_datetime, truncate_string, random_text, parse_interval
+from ..mixins import GetResumeIdMixin
+
+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]
+    order_by: str
+    search: str
+    dry_run: bool
+
+
+class Operation(BaseOperation, GetResumeIdMixin):
+    """Откликнуться на все подходящие вакансии."""
+
+    def setup_parser(self, parser: argparse.ArgumentParser) -> None:
+        parser.add_argument("--resume-id", help="Идентефикатор резюме")
+        parser.add_argument(
+            "--message-list",
+            help="Путь до файла, где хранятся сообщения для отклика на вакансии. Каждое сообщение — с новой строки.",
+            type=argparse.FileType(),
+        )
+        parser.add_argument(
+            "--force-message",
+            help="Всегда отправлять сообщение при отклике",
+            default=False,
+            action=argparse.BooleanOptionalAction,
+        )
+        parser.add_argument(
+            "--apply-interval",
+            help="Интервал перед отправкой откликов в секундах (X, X-Y)",
+            default="1-5",
+            type=parse_interval,
+        )
+        parser.add_argument(
+            "--page-interval",
+            help="Интервал перед получением следующей страницы рекомендованных вакансий в секундах (X, X-Y)",
+            default="1-3",
+            type=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,
+        )
+        parser.add_argument(
+            "--dry-run",
+            help="Не отправлять отклики, а только выводить параметры запроса",
+            default=False,
+            action=argparse.BooleanOptionalAction,
+        )
+
+    def run(self, args: Namespace) -> None:
+        self.enable_telemetry = True
+        if args.disable_telemetry:
+            print(
+                "👁️ Телеметрия используется только для сбора данных о работодателях и их вакансиях, персональные данные пользователей не передаются на сервер."
+            )
+            if (
+                input("Вы действительно хотите отключить телеметрию (д/Н)? ")
+                .lower()
+                .startswith(("д", "y"))
+            ):
+                self.enable_telemetry = False
+                logger.info("Телеметрия отключена.")
+            else:
+                logger.info("Спасибо за то что оставили телеметрию включенной!")
+        
+        self.api = get_api(args)
+        self.resume_id = args.resume_id or self._get_resume_id()
+        self.application_messages = self._get_application_messages(args.message_list)
+
+        self.apply_min_interval, self.apply_max_interval = args.apply_interval
+        self.page_min_interval, self.page_max_interval = args.page_interval
+
+        self.force_message = args.force_message
+        self.order_by = args.order_by
+        self.search = args.search
+        self.dry_run = args.dry_run
+        self._apply_similar()
+
+    def _get_application_messages(self, message_list: TextIO | None) -> list[str]:
+        if message_list:
+            application_messages = list(
+                filter(None, map(str.strip, message_list))
+            )
+        else:
+            application_messages = [
+                "{Меня заинтересовала|Мне понравилась} ваша вакансия %(vacancy_name)s",
+                "{Прошу рассмотреть|Предлагаю рассмотреть} {мою кандидатуру|мое резюме} на вакансию %(vacancy_name)s",
+            ]
+        return application_messages
+
+    def _apply_similar(self) -> None:
+        telemetry_client = TelemetryClient(proxies=self.api.proxies)
+        telemetry_data = defaultdict(dict)
+
+        vacancies = self._get_vacancies()
+
+        if self.enable_telemetry:
+            for vacancy in vacancies:
+                vacancy_id = vacancy["id"]
+                telemetry_data["vacancies"][vacancy_id] = {
+                    "name": vacancy.get("name"),
+                    "type": vacancy.get("type", {}).get("id"),  # open/closed
+                    "area": vacancy.get("area", {}).get("name"),  # город
+                    "salary": vacancy.get("salary"),  # from, to, currency, gross
+                    "direct_url": vacancy.get(
+                        "alternate_url"
+                    ),  # ссылка на вакансию
+                    "created_at": fix_datetime(
+                        vacancy.get("created_at")
+                    ),  # будем вычислять говно-вакансии, которые по полгода висят
+                    "published_at": fix_datetime(vacancy.get("published_at")),
+                    "contacts": vacancy.get(
+                        "contacts"
+                    ),  # пиздорванки там телеграм для связи указывают
+                    # HH с точки зрения перфикциониста — кусок говна, где кривые
+                    # форматы даты, у вакансий может не быть работодателя...
+                    "employer_id": int(vacancy["employer"]["id"])
+                    if "employer" in vacancy and "id" in vacancy["employer"]
+                    else None,
+                    # Остальное неинтересно
+                }
+
+        me = self.api.get("/me")
+
+        basic_message_placeholders = {
+            "first_name": me.get("first_name", ""),
+            "last_name": me.get("last_name", ""),
+            "email": me.get("email", ""),
+            "phone": me.get("phone", ""),
+        }
+
+        for vacancy in vacancies:
+            try:
+                message_placeholders = {
+                    "vacancy_name": vacancy.get("name", ""),
+                    "employer_name": vacancy.get("employer", {}).get(
+                        "name", ""
+                    ),
+                    **basic_message_placeholders,
+                }
+
+                logger.debug(
+                    "Вакансия %(vacancy_name)s от %(employer_name)s"
+                    % message_placeholders
+                )
+
+                if vacancy.get("has_test"):
+                    print("🚫 Пропускаем тест", vacancy["alternate_url"])
+                    continue
+
+                if vacancy.get("archived"):
+                    print(
+                        "🚫 Пропускаем вакансию в архиве",
+                        vacancy["alternate_url"],
+                    )
+                    continue
+
+                relations = vacancy.get("relations", [])
+
+                if relations:
+                    print(
+                        "🚫 Пропускаем вакансию с",
+                        ["откликом или приглашением", "отказом"]["got_rejection" in relations],
+                        vacancy["alternate_url"],
+                    )
+                    continue
+
+                employer_id = vacancy.get("employer", {}).get("id")
+
+                if (
+                    self.enable_telemetry
+                    and employer_id
+                    and employer_id not in telemetry_data["employers"]
+                ):
+                    employer = self.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"),  # город
+                    }
+
+                params = {
+                    "resume_id": self.resume_id,
+                    "vacancy_id": vacancy["id"],
+                    "message": "",
+                }
+
+                if self.force_message or vacancy.get("response_letter_required"):
+                    msg = params["message"] = (
+                        random_text(random.choice(self.application_messages))
+                        % message_placeholders
+                    )
+                    logger.debug(msg)
+
+                if self.dry_run:
+                    logger.info(
+                            "Dry Run: Отправка отклика на вакансию %s с параметрами: %s",
+                        vacancy["alternate_url"],
+                        params,
+                    )
+                    continue
+
+                # Задержка перед отправкой отклика
+                interval = random.uniform(
+                    self.apply_min_interval, self.apply_max_interval
+                )
+                time.sleep(interval)
+
+                res = self.api.post("/negotiations", params)
+                assert res == {}
+                print(
+                    "📨 Отправили отклик",
+                    vacancy["alternate_url"],
+                    "(",
+                    truncate_string(vacancy["name"]),
+                    ")",
+                )
+            except ApiError as ex:
+                logger.error(ex)
+                if isinstance(ex, BadRequest) and ex.limit_exceeded:
+                    break
+
+        print("📝 Отклики на вакансии разосланы!")
+
+        if self.enable_telemetry:
+            if self.dry_run:
+                # С --dry-run можно посмотреть что отправляется
+                logger.info('Dry Run: Данные телеметрии для отправки на сервер: %r', telemetry_data)
+                return
+
+            try:
+                telemetry_client.send_telemetry("/collect", dict(telemetry_data))
+            except TelemetryError as ex:
+                logger.error(ex)
+                
+    def _get_vacancies(
+            self, per_page: int = 100
+    ) -> list[VacancyItem]:
+        rv = []
+        for page in range(20):
+            params = {
+                "page": page,
+                "per_page": per_page,
+                "order_by": self.order_by,
+            }
+            if self.search:
+                params["text"] = self.search
+            res: ApiListResponse = self.api.get(
+                f"/resumes/{self.resume_id}/similar_vacancies", params
+            )
+            rv.extend(res["items"])
+            if page >= res["pages"] - 1:
+                break
+
+            # Задержка перед получением следующей страницы
+            if page > 0:
+                interval = random.uniform(self.page_min_interval, self.page_max_interval)
+                time.sleep(interval)
+
+        return rv
+

hh_applicant_tool-0.4.1/hh_applicant_tool/operations/reply_employers.py

@@ -0,0 +1,154 @@
+import argparse
+import logging
+import random
+import time
+from typing import Tuple
+
+from ..api import ApiError
+from ..main import BaseOperation
+from ..main import Namespace as BaseNamespace, get_api
+from ..utils import parse_interval, random_text
+from ..mixins import GetResumeIdMixin
+
+logger = logging.getLogger(__package__)
+
+
+class Namespace(BaseNamespace):
+    reply_message: str
+    reply_interval: Tuple[float, float]
+    max_pages: int
+    dry_run: bool
+
+
+class Operation(BaseOperation, GetResumeIdMixin):
+    """Ответ всем работодателям."""
+
+    def setup_parser(self, parser: argparse.ArgumentParser) -> None:
+        parser.add_argument(
+            "reply_message",
+            help="Сообщение для отправки во все чаты с работодателями, где ожидают ответа либо не прочитали ответ",
+        )
+        parser.add_argument('--resume-id', help="Идентификатор резюме")
+        parser.add_argument(
+            "--reply-interval",
+            help="Интервал перед отправкой сообщения в секундах (X, X-Y)",
+            default="5-10",
+            type=parse_interval,
+        )
+        parser.add_argument(
+            "--reply-message",
+            "--reply",
+            help="Отправить сообщение во все чаты, где ожидают ответа либо не прочитали ответ",
+        )
+        parser.add_argument('--max-pages', type=int, default=25, help='Максимальное количество страниц для проверки')
+        parser.add_argument(
+            "--dry-run",
+            help="Не отправлять сообщения, а только выводить параметры запроса",
+            default=False,
+            action=argparse.BooleanOptionalAction,
+        )
+
+    def run(self, args: Namespace) -> None:
+        self.api = get_api(args)
+        self.resume_id = self._get_resume_id()
+        self.reply_min_interval, self.reply_max_interval = args.reply_interval
+        self.reply_message = args.reply_message
+        self.max_pages = args.max_pages
+        self.dry_run = args.dry_run
+        logger.debug(f'{self.reply_message = }')
+        self._reply_chats()
+
+    def _reply_chats(self) -> None:
+        me =self.me= self.api.get("/me")
+
+        basic_message_placeholders = {
+            "first_name": me.get("first_name", ""),
+            "last_name": me.get("last_name", ""),
+            "email": me.get("email", ""),
+            "phone": me.get("phone", ""),
+        }
+
+        for negotiation in self._get_negotiations():
+            try:
+                # Пропускаем другие резюме
+                if self.resume_id != negotiation['resume']['id']:
+                    continue
+
+                nid = negotiation["id"]
+                vacancy = negotiation["vacancy"]
+
+                message_placeholders = {
+                    "vacancy_name": vacancy.get("name", ""),
+                    "employer_name": vacancy.get("employer", {}).get(
+                        "name", ""
+                    ),
+                    **basic_message_placeholders,
+                }
+
+                logger.debug(
+                    "Вакансия %(vacancy_name)s от %(employer_name)s"
+                    % message_placeholders
+                )
+
+                page: int = 0
+                last_message: dict | None = None
+                while True:
+                    messages_res = self.api.get(
+                        f"/negotiations/{nid}/messages", page=page
+                    )
+                    last_message = messages_res["items"][-1]
+                    if page + 1 >= messages_res["pages"]:
+                        break
+
+                    page = messages_res["pages"] - 1
+
+                logger.debug(last_message["text"])
+
+                if last_message["author"][
+                    "participant_type"
+                ] == "employer" or not negotiation.get(
+                    "viewed_by_opponent"
+                ):
+                    message = (
+                        random_text(self.reply_message)
+                        % message_placeholders
+                    )
+                    logger.debug(message)
+
+                    if self.dry_run:
+                        logger.info(
+                            "Dry Run: Отправка сообщения в чат по вакансии %s: %s",
+                            vacancy["alternate_url"],
+                            message,
+                        )
+                        continue
+
+                    time.sleep(
+                        random.uniform(
+                            self.reply_min_interval,
+                            self.reply_max_interval,
+                        )
+                    )
+                    self.api.post(
+                        f"/negotiations/{nid}/messages",
+                        message=message,
+                    )
+                    print(
+                        "📨 Отправили сообщение для",
+                        vacancy["alternate_url"],
+                    )
+            except ApiError as ex:
+                logger.error(ex)
+
+        print("📝 Сообщения разосланы!")
+
+    def _get_negotiations(self) -> list[dict]:
+        rv = []
+        for page in range(self.max_pages):
+            res = self.api.get("/negotiations", page=page, status='active')
+            rv.extend(res["items"])
+            if page >= res["pages"] - 1:
+                break
+            page += 1
+
+        return rv

{hh_applicant_tool-0.4.0 → hh_applicant_tool-0.4.1}/hh_applicant_tool/utils.py

@@ -88,3 +88,11 @@ def random_text(s: str) -> str:
     ) != s:
         s = s1
     return s
+
+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)

{hh_applicant_tool-0.4.0 → hh_applicant_tool-0.4.1}/pyproject.toml

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

hh_applicant_tool-0.4.0/hh_applicant_tool/operations/apply_similar.py

@@ -1,443 +0,0 @@
-import argparse
-import logging
-import random
-import time
-from collections import defaultdict
-from os import getenv
-from typing import TextIO, Tuple
-
-from ..api import ApiClient, ApiError, BadRequest
-from ..main import BaseOperation
-from ..main import Namespace as BaseNamespace, get_api
-from ..telemetry_client import TelemetryClient, TelemetryError
-from ..types import ApiListResponse, VacancyItem
-from ..utils import fix_datetime, truncate_string, random_text
-from requests import Session
-
-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]
-    message_interval: Tuple[float, float]
-    order_by: str
-    search: str
-    reply_message: str
-
-
-# gx для открытия (никак не запомню в виме)
-# https://api.hh.ru/openapi/redoc
-class Operation(BaseOperation):
-    """Откликнуться на все подходящие вакансии. По умолчанию применяются значения, которые были отмечены галочками в форме для поиска на сайте"""
-
-    def setup_parser(self, parser: argparse.ArgumentParser) -> None:
-        parser.add_argument("--resume-id", help="Идентефикатор резюме")
-        parser.add_argument(
-            "--message-list",
-            help="Путь до файла, где хранятся сообщения для отклика на вакансии. Каждое сообщение — с новой строки. В сообщения можно использовать плейсхолдеры типа %%(vacabcy_name)s",
-            type=argparse.FileType(),
-        )
-        parser.add_argument(
-            "--force-message",
-            help="Всегда отправлять сообщение при отклике",
-            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,
-        )
-        parser.add_argument(
-            "--message-interval",
-            help="Интервал перед отправкой сообщения в секундах (X, X-Y)",
-            default="5-10",
-            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,
-        )
-        parser.add_argument(
-            "--reply-message",
-            "--reply",
-            help="Отправить сообщение во все чаты, где ожидают ответа либо не прочитали ответ",
-        )
-
-    @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:
-        self.enable_telemetry = True
-        if args.disable_telemetry:
-            print(
-                "👁️ Телеметрия используется только для сбора данных о работодателях и их вакансиях, персональные данные пользователей не передаются на сервер."
-            )
-            if (
-                input("Вы действительно хотите отключить телеметрию (д/Н)? ")
-                .lower()
-                .startswith(("д", "y"))
-            ):
-                self.enable_telemetry = False
-                logger.info("Телеметрия отключена")
-            else:
-                logger.info("Телеметрия включена")
-        api = get_api(args)
-        resume_id = self._get_resume_id(args, api)
-        application_messages = self._get_application_messages(args)
-
-        apply_min_interval, apply_max_interval = args.apply_interval
-        page_min_interval, page_max_interval = args.page_interval
-        message_min_interval, message_max_interval = args.message_interval
-
-        self._apply_similar(
-            api,
-            resume_id,
-            args.force_message,
-            application_messages,
-            apply_min_interval,
-            apply_max_interval,
-            page_min_interval,
-            page_max_interval,
-            message_min_interval,
-            message_max_interval,
-            args.order_by,
-            args.search,
-            args.reply_message or args.config["reply_message"],
-        )
-
-    def _get_resume_id(self, args: Namespace, api: ApiClient) -> str:
-        if not (
-            resume_id := args.resume_id or args.config["default_resume_id"]
-        ):
-            resumes: ApiListResponse = api.get("/resumes/mine")
-            resume_id = resumes["items"][0]["id"]
-        return resume_id
-
-    def _get_application_messages(self, args: Namespace) -> list[str]:
-        if args.message_list:
-            application_messages = list(
-                filter(None, map(str.strip, args.message_list))
-            )
-        else:
-            application_messages = [
-                "{Меня заинтересовала|Мне понравилась} ваша вакансия %(vacancy_name)s",
-                "{Прошу рассмотреть|Предлагаю рассмотреть} {мою кандидатуру|мое резюме} на вакансию %(vacancy_name)s",
-            ]
-        return application_messages
-
-    def _apply_similar(
-        self,
-        api: ApiClient,
-        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,
-        message_min_interval: float,
-        message_max_interval: float,
-        order_by: str,
-        search: str | None,
-        reply_message: str | None,
-    ) -> None:
-        telemetry_client = TelemetryClient(proxies=api.proxies)
-        telemetry_data = defaultdict(dict)
-
-        vacancies = self._get_vacancies(
-            api,
-            resume_id,
-            page_min_interval,
-            page_max_interval,
-            per_page=100,
-            order_by=order_by,
-            search=search,
-        )
-
-        if self.enable_telemetry:
-            self._collect_vacancy_telemetry(telemetry_data, vacancies)
-
-        me = api.get("/me")
-
-        basic_message_placeholders = {
-            "first_name": me.get("first_name", ""),
-            "last_name": me.get("last_name", ""),
-            "email": me.get("email", ""),
-            "phone": me.get("phone", ""),
-        }
-
-        do_apply = True
-
-        for vacancy in vacancies:
-            try:
-                if getenv("TEST_TELEMETRY"):
-                    break
-
-                message_placeholders = {
-                    "vacancy_name": vacancy.get("name", ""),
-                    "employer_name": vacancy.get("employer", {}).get(
-                        "name", ""
-                    ),
-                    **basic_message_placeholders,
-                }
-
-                logger.debug(
-                    "Вакансия %(vacancy_name)s от %(employer_name)s"
-                    % message_placeholders
-                )
-
-                if vacancy.get("has_test"):
-                    print("🚫 Пропускаем тест", vacancy["alternate_url"])
-                    continue
-
-                if vacancy.get("archived"):
-                    print(
-                        "🚫 Пропускаем вакансию в архиве",
-                        vacancy["alternate_url"],
-                    )
-
-                    continue
-
-                relations = vacancy.get("relations", [])
-
-                if relations:
-                    if "got_rejection" in relations:
-                        print(
-                            "🚫 Пропускаем отказ на вакансию",
-                            vacancy["alternate_url"],
-                        )
-                        continue
-
-                    if reply_message:
-                        r = api.get("/negotiations", vacancy_id=vacancy["id"])
-
-                        if len(r["items"]) == 1:
-                            neg = r["items"][0]
-                            nid = neg["id"]
-
-                            page: int = 0
-                            last_message: dict | None = None
-                            while True:
-                                r2 = api.get(
-                                    f"/negotiations/{nid}/messages", page=page
-                                )
-                                last_message = r2["items"][-1]
-                                if page + 1 >= r2["pages"]:
-                                    break
-
-                                page = r2["pages"] - 1
-
-                            logger.debug(last_message["text"])
-
-                            if last_message["author"][
-                                "participant_type"
-                            ] == "employer" or not neg.get(
-                                "viewed_by_opponent"
-                            ):
-                                message = (
-                                    random_text(reply_message)
-                                    % message_placeholders
-                                )
-                                logger.debug(message)
-
-                                time.sleep(
-                                    random.uniform(
-                                        message_min_interval,
-                                        message_max_interval,
-                                    )
-                                )
-                                api.post(
-                                    f"/negotiations/{nid}/messages",
-                                    message=message,
-                                )
-                                print(
-                                    "📨 Отправили сообщение для привлечения внимания",
-                                    vacancy["alternate_url"],
-                                )
-                            continue
-                        else:
-                            logger.warning(
-                                "Приглашение без чата для вакансии: %s",
-                                vacancy["alternate_url"],
-                            )
-
-                    print(
-                        "🚫 Пропускаем вакансию с откликом",
-                        vacancy["alternate_url"],
-                    )
-                    continue
-
-                employer_id = vacancy.get("employer", {}).get("id")
-
-                if (
-                    self.enable_telemetry
-                    and employer_id
-                    and employer_id not in telemetry_data["employers"]
-                    and 200 > len(telemetry_data["employers"])
-                ):
-                    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"),  # город
-                    }
-
-                if not do_apply:
-                    logger.debug("skip apply similar")
-                    continue
-
-                params = {
-                    "resume_id": resume_id,
-                    "vacancy_id": vacancy["id"],
-                    "message": "",
-                }
-
-                if force_message or vacancy.get("response_letter_required"):
-                    msg = params["message"] = (
-                        random_text(random.choice(application_messages))
-                        % message_placeholders
-                    )
-                    logger.debug(msg)
-
-                # Задержка перед отправкой отклика
-                interval = random.uniform(
-                    max(apply_min_interval, message_min_interval)
-                    if params["message"]
-                    else apply_min_interval,
-                    max(apply_max_interval, message_max_interval)
-                    if params["message"]
-                    else apply_max_interval,
-                )
-                time.sleep(interval)
-
-                res = api.post("/negotiations", params)
-                assert res == {}
-                print(
-                    "📨 Отправили отклик",
-                    vacancy["alternate_url"],
-                    "(",
-                    truncate_string(vacancy["name"]),
-                    ")",
-                )
-            except ApiError as ex:
-                logger.error(ex)
-                if isinstance(ex, BadRequest) and ex.limit_exceeded:
-                    if not reply_message:
-                        break
-                    do_apply = False
-
-        print("📝 Отклики на вакансии разосланы!")
-
-        if self.enable_telemetry:
-            # Я собираюсь выложить контакты херок в общественный доступ
-            self._send_telemetry(telemetry_client, telemetry_data)
-
-    def _get_vacancies(
-        self,
-        api: ApiClient,
-        resume_id: str,
-        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", params
-            )
-            rv.extend(res["items"])
-
-            if getenv("TEST_TELEMETRY"):
-                break
-
-            if page >= res["pages"] - 1:
-                break
-
-            # Задержка перед получением следующей страницы
-            if page > 0:
-                interval = random.uniform(page_min_interval, page_max_interval)
-                time.sleep(interval)
-
-        return rv
-
-    def _collect_vacancy_telemetry(
-        self, telemetry_data: defaultdict, vacancies: list[VacancyItem]
-    ) -> None:
-        for vacancy in vacancies:
-            vacancy_id = vacancy["id"]
-            telemetry_data["vacancies"][vacancy_id] = {
-                "name": vacancy.get("name"),
-                "type": vacancy.get("type", {}).get("id"),  # open/closed
-                "area": vacancy.get("area", {}).get("name"),  # город
-                "salary": vacancy.get("salary"),  # from, to, currency, gross
-                "direct_url": vacancy.get(
-                    "alternate_url"
-                ),  # ссылка на вакансию
-                "created_at": fix_datetime(
-                    vacancy.get("created_at")
-                ),  # будем вычислять говно-вакансии, которые по полгода висят
-                "published_at": fix_datetime(vacancy.get("published_at")),
-                "contacts": vacancy.get(
-                    "contacts"
-                ),  # пиздорванки там телеграм для связи указывают
-                # HH с точки зрения перфикциониста — кусок говна, где кривые
-                # форматы даты, у вакансий может не быть работодателя...
-                "employer_id": int(vacancy["employer"]["id"])
-                if "employer" in vacancy and "id" in vacancy["employer"]
-                else None,
-                # Остальное неинтересно
-            }
-
-    def _send_telemetry(
-        self, telemetry_client, telemetry_data: defaultdict
-    ) -> None:
-        try:
-            res = telemetry_client.send_telemetry(
-                "/collect", dict(telemetry_data)
-            )
-            logger.debug(res)
-        except TelemetryError as ex:
-            logger.error(ex)