hh-applicant-tool 0.5.8__tar.gz → 0.6.0__tar.gz

{hh_applicant_tool-0.5.8 → hh_applicant_tool-0.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: hh-applicant-tool
-Version: 0.5.8
+Version: 0.6.0
 Summary: 
 Author: Senior YAML Developer
 Author-email: yamldeveloper@proton.me
@@ -30,16 +30,11 @@ Description-Content-Type: text/markdown
   <img src="https://github.com/user-attachments/assets/29d91490-2c83-4e3f-a573-c7a6182a4044" width="500">
 </div>
 
-### Внимание!!!
-
-Если для Вас проблема установить данную утилиту, лень разбираться с ее настройкой, то Вы можете установить мое приложение под **Android** [HH Resume Automate](https://github.com/s3rgeym/hh-resume-automate/).
-
-
 ### Описание
 
 > Утилита для генерации сопроводительного письма может использовать AI
 
-Утилита для успешных волчат и старых волков с опытом, служащая для автоматизации действий на HH.RU таких как рассылка откликов на подходящие вакансии и обновление всех резюме (бесплатный аналог услуги на HH). Утилита позволяет получить контактные данные работодателя, даже если тот не присылал приглашения, для этого должна быть включена телеметрия, те общедоступные данные работодателей собирают сами пользователи, данные же пользователей не хранятся ни в каком виде. У утилиты есть группа: [HH Resume Automate](https://t.me/hh_resume_automate).
+Утилита для успешных волчат и старых волков с опытом, служащая для автоматизации действий на HH.RU таких как рассылка откликов на подходящие вакансии и обновление всех резюме (бесплатный аналог услуги на HH). Утилита сохраняет контактные данные, всех кто вам писал, и позволяет вам по ним проводить поиск (название компании, сайт и тп). Это удобно, так как контакт сохранится даже, если вышлют отказ в дальнейшем. У утилиты есть группа: [HH Resume Automate](https://t.me/hh_resume_automate).
 
 Работает с Python >= 3.10. Нужную версию Python можно поставить через
 asdf/pyenv/conda и что-то еще. В школотронской Manjaro и даже в последних Ubuntu
@@ -53,6 +48,10 @@ asdf/pyenv/conda и что-то еще. В школотронской Manjaro и
 
 > Если в веб-интерфейсе выставить фильтры, то они будут применяться в скрипте при отклике на подходящие
 
+### Внимание!!!
+
+Если для Вас проблема установить данную утилиту, лень разбираться с ее настройкой, то Вы можете установить мое приложение под **Android** [HH Resume Automate](https://github.com/s3rgeym/hh-resume-automate/). Оно обладает минимальным функционалом: обновление резюме (одного) и рассылка откликов (чистить их и тп нельзя).
+
 ### Предыстория
 
 Долгое время я делал массовые заявки с помощью консоли браузера:
@@ -184,7 +183,7 @@ hh-applicant-tool config -p
 
 | Имя атрибута | Описание |
 | --- | --- |
-| `user_agent` | Кастомный юзерагент, передаваемый при кажом запросе, например, `Mozilla/5.0 YablanBrowser` |
+| `user_agent` | Кастомный юзерагент, передаваемый при кажом запросе. |
 | `proxy_url` | Прокси, используемый для всех запросов, например, `socks5h://127.0.0.1:9050` |
 | `reply_message` | Сообщение для ответа работодателю при отклике на вакансии, см. формат сообщений |
 
@@ -257,7 +256,8 @@ https://hh.ru/employer/1918903
 | **call-api**           | Вызов произвольного метода API с выводом результата.                                                |
 | **refresh-token**      | Обновляет access_token.                                                                             |
 | **config**      | Редактировать конфигурационный файл. |
-| **get-employer-contacts** | Получить список контактов работодателя, даже если тот не высылал приглашения. |
+| **get-employer-contacts** | Получить список полученных вами контактов работодателей. Поддерживается так же экспорт в html/jsonl. Если хотите собирать контакты с нескольких акков, то укажите им одинаковый `client_telemetry_id` в конфигах. |
+| **delete-telemetry** | Удадяет телеметрию, если та была включена. |
 
 ### Формат текста сообщений
 

{hh_applicant_tool-0.5.8 → hh_applicant_tool-0.6.0}/README.md

@@ -11,16 +11,11 @@
   <img src="https://github.com/user-attachments/assets/29d91490-2c83-4e3f-a573-c7a6182a4044" width="500">
 </div>
 
-### Внимание!!!
-
-Если для Вас проблема установить данную утилиту, лень разбираться с ее настройкой, то Вы можете установить мое приложение под **Android** [HH Resume Automate](https://github.com/s3rgeym/hh-resume-automate/).
-
-
 ### Описание
 
 > Утилита для генерации сопроводительного письма может использовать AI
 
-Утилита для успешных волчат и старых волков с опытом, служащая для автоматизации действий на HH.RU таких как рассылка откликов на подходящие вакансии и обновление всех резюме (бесплатный аналог услуги на HH). Утилита позволяет получить контактные данные работодателя, даже если тот не присылал приглашения, для этого должна быть включена телеметрия, те общедоступные данные работодателей собирают сами пользователи, данные же пользователей не хранятся ни в каком виде. У утилиты есть группа: [HH Resume Automate](https://t.me/hh_resume_automate).
+Утилита для успешных волчат и старых волков с опытом, служащая для автоматизации действий на HH.RU таких как рассылка откликов на подходящие вакансии и обновление всех резюме (бесплатный аналог услуги на HH). Утилита сохраняет контактные данные, всех кто вам писал, и позволяет вам по ним проводить поиск (название компании, сайт и тп). Это удобно, так как контакт сохранится даже, если вышлют отказ в дальнейшем. У утилиты есть группа: [HH Resume Automate](https://t.me/hh_resume_automate).
 
 Работает с Python >= 3.10. Нужную версию Python можно поставить через
 asdf/pyenv/conda и что-то еще. В школотронской Manjaro и даже в последних Ubuntu
@@ -34,6 +29,10 @@ asdf/pyenv/conda и что-то еще. В школотронской Manjaro и
 
 > Если в веб-интерфейсе выставить фильтры, то они будут применяться в скрипте при отклике на подходящие
 
+### Внимание!!!
+
+Если для Вас проблема установить данную утилиту, лень разбираться с ее настройкой, то Вы можете установить мое приложение под **Android** [HH Resume Automate](https://github.com/s3rgeym/hh-resume-automate/). Оно обладает минимальным функционалом: обновление резюме (одного) и рассылка откликов (чистить их и тп нельзя).
+
 ### Предыстория
 
 Долгое время я делал массовые заявки с помощью консоли браузера:
@@ -165,7 +164,7 @@ hh-applicant-tool config -p
 
 | Имя атрибута | Описание |
 | --- | --- |
-| `user_agent` | Кастомный юзерагент, передаваемый при кажом запросе, например, `Mozilla/5.0 YablanBrowser` |
+| `user_agent` | Кастомный юзерагент, передаваемый при кажом запросе. |
 | `proxy_url` | Прокси, используемый для всех запросов, например, `socks5h://127.0.0.1:9050` |
 | `reply_message` | Сообщение для ответа работодателю при отклике на вакансии, см. формат сообщений |
 
@@ -238,7 +237,8 @@ https://hh.ru/employer/1918903
 | **call-api**           | Вызов произвольного метода API с выводом результата.                                                |
 | **refresh-token**      | Обновляет access_token.                                                                             |
 | **config**      | Редактировать конфигурационный файл. |
-| **get-employer-contacts** | Получить список контактов работодателя, даже если тот не высылал приглашения. |
+| **get-employer-contacts** | Получить список полученных вами контактов работодателей. Поддерживается так же экспорт в html/jsonl. Если хотите собирать контакты с нескольких акков, то укажите им одинаковый `client_telemetry_id` в конфигах. |
+| **delete-telemetry** | Удадяет телеметрию, если та была включена. |
 
 ### Формат текста сообщений
 

{hh_applicant_tool-0.5.8 → hh_applicant_tool-0.6.0}/hh_applicant_tool/api/client.py

@@ -124,10 +124,17 @@ class BaseClient:
         assert 300 > response.status_code >= 200
         return rv
 
-    get = partialmethod(request, "GET")
-    post = partialmethod(request, "POST")
-    put = partialmethod(request, "PUT")
-    delete = partialmethod(request, "DELETE")
+    def get(self, *args, **kwargs):
+        return self.request("GET", *args, **kwargs)
+
+    def post(self, *args, **kwargs):
+        return self.request("POST", *args, **kwargs)
+
+    def put(self, *args, **kwargs):
+        return self.request("PUT", *args, **kwargs)
+
+    def delete(self, *args, **kwargs):
+        return self.request("DELETE", *args, **kwargs)
 
     def resolve_url(self, url: str) -> str:
         return url if "://" in url else f"{self.base_url.rstrip('/')}/{url.lstrip('/')}"
@@ -194,7 +201,7 @@ class OAuthClient(BaseClient):
         }
         return self.request_access_token("/token", params)
 
-    def refresh_access(self, refresh_token: str) -> AccessToken:
+    def refresh_access_token(self, refresh_token: str) -> AccessToken:
         # refresh_token можно использовать только один раз и только по истечению срока действия access_token.
         return self.request_access_token(
             "/token", grant_type="refresh_token", refresh_token=refresh_token
@@ -243,25 +250,30 @@ class ApiClient(BaseClient):
         **kwargs: Any,
     ) -> dict:
         def do_request():
-            return super().request(method, endpoint, params, delay, **kwargs)
+            return BaseClient.request(self, method, endpoint, params, delay, **kwargs)
 
         try:
             return do_request()
         # TODO: добавить класс для ошибок типа AccessTokenExpired
-        except errors.ApiError as ex:
-            if not self.is_access_expired:
+        except errors.Forbidden as ex:
+            if not self.is_access_expired or not self.refresh_token:
                 raise ex
             logger.info("try refresh access_token")
             # Пробуем обновить токен
-            token = self.oauth_client.refresh_access(self.refresh_token)
-            self.handle_access_token(token)
+            self.refresh_access_token()
             # И повторно отправляем запрос
             return do_request()
 
     def handle_access_token(self, token: AccessToken) -> None:
-        for k in ["access_token", "refresh_token", "access_expires_at"]:
-            if k in token:
-                setattr(self, k, token[k])
+        for field in ["access_token", "refresh_token", "access_expires_at"]:
+            if field in token and hasattr(self, field):
+                setattr(self, field, token[field])
+
+    def refresh_access_token(self) -> None:
+        if not self.refresh_token:
+            raise ValueError("Refresh token required.")
+        token = self.oauth_client.refresh_access_token(self.refresh_token)
+        self.handle_access_token(token)
 
     def get_access_token(self) -> AccessToken:
         return {

{hh_applicant_tool-0.5.8 → hh_applicant_tool-0.6.0}/hh_applicant_tool/main.py

@@ -11,6 +11,7 @@ from typing import Literal, Sequence
 
 from .api import ApiClient
 from .color_log import ColorHandler
+from .telemetry_client import TelemetryClient
 from .utils import Config, get_config_path
 
 DEFAULT_CONFIG_PATH = (
@@ -46,11 +47,12 @@ def get_proxies(args: Namespace) -> dict[Literal["http", "https"], str | None]:
     }
 
 
-def get_api(args: Namespace) -> ApiClient:
+def get_api_client(args: Namespace) -> ApiClient:
     token = args.config.get("token", {})
     api = ApiClient(
         access_token=token.get("access_token"),
         refresh_token=token.get("refresh_token"),
+        access_expires_at=token.get("access_expires_at"),
         delay=args.delay,
         user_agent=args.config["user_agent"],
         proxies=get_proxies(args),
@@ -134,10 +136,19 @@ class HHApplicantTool:
         logger.addHandler(handler)
         if args.run:
             try:
-                api = get_api(args)
-                if not (res := args.run(api, args)):
-                    # 0 or None = success
-                    args.config.save(token=api.get_access_token())
+                if not args.config["telemetry_client_id"]:
+                    import uuid
+
+                    args.config.save(telemetry_client_id=str(uuid.uuid4()))
+                api_client = get_api_client(args)
+                telemetry_client = TelemetryClient(
+                    telemetry_client_id=args.config["telemetry_client_id"],
+                    proxies=api_client.proxies.copy(),
+                )
+                # 0 or None = success
+                res = args.run(args, api_client, telemetry_client)
+                if (token := api_client.get_access_token()) != args.config["token"]:
+                    args.config.save(token=token)
                 return res
             except Exception as e:
                 logger.exception(e)

{hh_applicant_tool-0.5.8 → hh_applicant_tool-0.6.0}/hh_applicant_tool/mixins.py

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

{hh_applicant_tool-0.5.8 → hh_applicant_tool-0.6.0}/hh_applicant_tool/operations/apply_similar.py

@@ -6,13 +6,11 @@ from collections import defaultdict
 from datetime import datetime, timedelta, timezone
 from typing import TextIO
 
-from hh_applicant_tool.api.errors import LimitExceeded
-
+from ..api.errors import LimitExceeded
 from ..ai.blackbox import BlackboxChat, BlackboxError
 from ..api import ApiError, ApiClient
 from ..main import BaseOperation
 from ..main import Namespace as BaseNamespace
-from ..main import get_api
 from ..mixins import GetResumeIdMixin
 from ..telemetry_client import TelemetryClient, TelemetryError
 from ..types import ApiListResponse, VacancyItem
@@ -109,7 +107,9 @@ class Operation(BaseOperation, GetResumeIdMixin):
             action=argparse.BooleanOptionalAction,
         )
 
-    def run(self, api: ApiClient, args: Namespace) -> None:
+    def run(
+        self, args: Namespace, api_client: ApiClient, telemetry_client: TelemetryClient
+    ) -> None:
         self.enable_telemetry = True
         if args.disable_telemetry:
             # print(
@@ -126,7 +126,8 @@ class Operation(BaseOperation, GetResumeIdMixin):
             #     logger.info("Спасибо за то что оставили телеметрию включенной!")
             self.enable_telemetry = False
 
-        self.api = api
+        self.api_client = api_client
+        self.telemetry_client = telemetry_client
         self.resume_id = args.resume_id or self._get_resume_id()
         self.application_messages = self._get_application_messages(args.message_list)
         self.chat = None
@@ -135,7 +136,7 @@ class Operation(BaseOperation, GetResumeIdMixin):
             self.chat = BlackboxChat(
                 session_id=config["session_id"],
                 chat_payload=config["chat_payload"],
-                proxies=self.api.proxies or {},
+                proxies=self.api_client.proxies or {},
             )
 
         self.pre_prompt = args.pre_prompt
@@ -160,7 +161,7 @@ class Operation(BaseOperation, GetResumeIdMixin):
         return application_messages
 
     def _apply_similar(self) -> None:
-        telemetry_client = TelemetryClient(proxies=self.api.proxies)
+        telemetry_client = self.telemetry_client
         telemetry_data = defaultdict(dict)
 
         vacancies = self._get_vacancies()
@@ -190,7 +191,7 @@ class Operation(BaseOperation, GetResumeIdMixin):
                     # Остальное неинтересно
                 }
 
-        me = self.api.get("/me")
+        me = self.api_client.get("/me")
 
         basic_message_placeholders = {
             "first_name": me.get("first_name", ""),
@@ -244,7 +245,7 @@ class Operation(BaseOperation, GetResumeIdMixin):
                         > datetime.now(tz=timezone.utc)
                     )
                 ):
-                    employer = self.api.get(f"/employers/{employer_id}")
+                    employer = self.api_client.get(f"/employers/{employer_id}")
 
                     employer_data = {
                         "name": employer.get("name"),
@@ -269,9 +270,10 @@ class Operation(BaseOperation, GetResumeIdMixin):
                                     response["topic_url"],
                                 )
                             else:
-                                print(
-                                    "Создание темы для обсуждения работодателя добавлено в очередь..."
-                                )
+                                # print(
+                                #     "Создание темы для обсуждения работодателя добавлено в очередь..."
+                                # )
+                                ...
                             complained_employers.add(employer_id)
                         except TelemetryError as ex:
                             logger.error(ex)
@@ -331,7 +333,7 @@ class Operation(BaseOperation, GetResumeIdMixin):
                 )
                 time.sleep(interval)
 
-                res = self.api.post("/negotiations", params)
+                res = self.api_client.post("/negotiations", params)
                 assert res == {}
                 print(
                     "📨 Отправили отклик",
@@ -375,7 +377,7 @@ class Operation(BaseOperation, GetResumeIdMixin):
             }
             if self.search:
                 params["text"] = self.search
-            res: ApiListResponse = self.api.get(
+            res: ApiListResponse = self.api_client.get(
                 f"/resumes/{self.resume_id}/similar_vacancies", params
             )
             rv.extend(res["items"])

{hh_applicant_tool-0.5.8 → hh_applicant_tool-0.6.0}/hh_applicant_tool/operations/authorize.py

@@ -1,6 +1,5 @@
 import argparse
 import logging
-import time
 from urllib.parse import parse_qs, urlsplit
 import sys
 from typing import Any
@@ -35,9 +34,8 @@ except ImportError:
         pass
 
 
-from ..api import ApiClient, OAuthClient
-from ..main import BaseOperation, Namespace
-from ..utils import Config
+from ..api import ApiClient  # noqa: E402
+from ..main import BaseOperation, Namespace  # noqa: E402
 
 logger = logging.getLogger(__package__)
 
@@ -86,7 +84,7 @@ class Operation(BaseOperation):
     def setup_parser(self, parser: argparse.ArgumentParser) -> None:
         pass
 
-    def run(self, api_client: ApiClient, args: Namespace) -> None:
+    def run(self, args: Namespace, api_client: ApiClient, *_) -> None:
         if not QT_IMPORTED:
             print_err(
                 "❗Критиническая Ошибка: PyQt6 не был импортирован, возможно, вы долбоеб и забыли его установить, либо же криворукие разрабы этой либы опять все сломали..."

{hh_applicant_tool-0.5.8 → hh_applicant_tool-0.6.0}/hh_applicant_tool/operations/call_api.py

@@ -22,22 +22,22 @@ class Operation(BaseOperation):
     """Вызвать произвольный метод API <https://github.com/hhru/api>."""
 
     def setup_parser(self, parser: argparse.ArgumentParser) -> None:
-        parser.add_argument("endpoint")
+        parser.add_argument("endpoint", help="Путь до эндпоинта API")
         parser.add_argument(
             "param",
             nargs="*",
-            help="PARAM=VALUE",
+            help="Параметры указываются в виде PARAM=VALUE",
             default=[],
         )
         parser.add_argument(
             "-m", "--method", "--meth", default="GET", help="HTTP Метод"
         )
 
-    def run(self, api: ApiClient, args: Namespace) -> None:
+    def run(self, args: Namespace, api_client: ApiClient, *_) -> None:
         params = dict(x.split("=", 1) for x in args.param)
         try:
-            result = api.request(args.method, args.endpoint, params=params)
-            print(json.dumps(result, ensure_ascii=True))
+            result = api_client.request(args.method, args.endpoint, params=params)
+            print(json.dumps(result, ensure_ascii=False))
         except ApiError as ex:
-            json.dump(ex.data, sys.stderr, ensure_ascii=True)
+            json.dump(ex.data, sys.stderr, ensure_ascii=False)
             return 1

{hh_applicant_tool-0.5.8 → hh_applicant_tool-0.6.0}/hh_applicant_tool/operations/clear_negotiations.py

@@ -43,12 +43,12 @@ class Operation(BaseOperation):
             action=argparse.BooleanOptionalAction,
         )
 
-    def _get_active_negotiations(self, api: ApiClient) -> list[dict]:
+    def _get_active_negotiations(self, api_client: ApiClient) -> list[dict]:
         rv = []
         page = 0
         per_page = 100
         while True:
-            r: ApiListResponse = api.get(
+            r: ApiListResponse = api_client.get(
                 "/negotiations", page=page, per_page=per_page, status="active"
             )
             rv.extend(r["items"])
@@ -57,8 +57,8 @@ class Operation(BaseOperation):
                 break
         return rv
 
-    def run(self, api: ApiClient, args: Namespace) -> None:
-        negotiations = self._get_active_negotiations(api)
+    def run(self, args: Namespace, api_client: ApiClient, *_) -> None:
+        negotiations = self._get_active_negotiations(api_client)
         print("Всего активных:", len(negotiations))
         for item in negotiations:
             state = item["state"]
@@ -78,7 +78,7 @@ class Operation(BaseOperation):
                 )
             ):
                 decline_allowed = item.get("decline_allowed") or False
-                r = api.delete(
+                r = api_client.delete(
                     f"/negotiations/active/{item['id']}",
                     with_decline_message=decline_allowed,
                 )
@@ -95,7 +95,7 @@ class Operation(BaseOperation):
                 if is_discard and args.blacklist_discard:
                     employer = vacancy["employer"]
                     try:
-                        r = api.put(f"/employers/blacklisted/{employer['id']}")
+                        r = api_client.put(f"/employers/blacklisted/{employer['id']}")
                         assert not r
                         print(
                             "🚫 Заблокировали",

hh_applicant_tool-0.6.0/hh_applicant_tool/operations/config.py

@@ -0,0 +1,51 @@
+import argparse
+import logging
+import os
+import subprocess
+from typing import Any
+
+from ..main import BaseOperation
+from ..main import Namespace as BaseNamespace
+
+logger = logging.getLogger(__package__)
+
+EDITOR = os.getenv("EDITOR", "nano")
+
+
+class Namespace(BaseNamespace):
+    show_path: bool
+    key: str
+
+
+def get_value(data: dict[str, Any], path: str) -> Any:
+    for key in path.split("."):
+        if key not in data:
+            return None
+        data = data[key]
+    return data
+
+
+class Operation(BaseOperation):
+    """Операции с конфигурационным файлом"""
+
+    def setup_parser(self, parser: argparse.ArgumentParser) -> None:
+        parser.add_argument(
+            "-p",
+            "--show-path",
+            "--path",
+            type=bool,
+            default=False,
+            action=argparse.BooleanOptionalAction,
+            help="Вывести полный путь к конфигу",
+        )
+        parser.add_argument("-k", "--key", help="Вывести отдельное значение из конфига")
+
+    def run(self, args: Namespace, *_) -> None:
+        if args.key:
+            print(get_value(args.config, args.key))
+            return
+        config_path = str(args.config._config_path)
+        if args.show_path:
+            print(config_path)
+        else:
+            subprocess.call([EDITOR, config_path])

hh_applicant_tool-0.6.0/hh_applicant_tool/operations/delete_telemetry.py

@@ -0,0 +1,30 @@
+# Этот модуль можно использовать как образец для других
+import argparse
+import logging
+
+from ..telemetry_client import TelemetryClient, TelemetryError
+
+from ..main import BaseOperation
+from ..main import Namespace as BaseNamespace
+from ..utils import print_err
+
+logger = logging.getLogger(__package__)
+
+
+class Namespace(BaseNamespace):
+    pass
+
+
+class Operation(BaseOperation):
+    """Удалить всю телеметрию, сохраненную на сервере."""
+
+    def setup_parser(self, parser: argparse.ArgumentParser) -> None:
+        pass
+
+    def run(self, a, b, telemetry_client: TelemetryClient) -> None:
+        try:
+            telemetry_client.send_telemetry("/delete")
+            print("✅ Вся телеметрия, сохраненная на сервере, была успешно удалена!")
+        except TelemetryError as ex:
+            print_err("❗ Ошибка:", ex)
+            return 1

hh_applicant_tool-0.6.0/hh_applicant_tool/operations/get_employer_contacts.py

@@ -0,0 +1,294 @@
+import argparse
+import logging
+from os import getenv
+import pathlib
+from ..main import BaseOperation
+from ..main import Namespace as BaseNamespace
+from ..telemetry_client import TelemetryClient
+
+logger = logging.getLogger(__package__)
+
+
+class Namespace(BaseNamespace):
+    username: str | None
+    password: str | None
+    search: str | None
+    export: bool
+
+
+class Operation(BaseOperation):
+    """Выведет контакты работодателей, которые высылали вам приглашения"""
+
+    def setup_parser(self, parser: argparse.ArgumentParser) -> None:
+        # parser.add_argument(
+        #     "-u",
+        #     "--username",
+        #     type=str,
+        #     help="Имя пользователя для аутентификации",
+        #     default=getenv("AUTH_USERNAME"),
+        # )
+        # parser.add_argument(
+        #     "-P",
+        #     "--password",
+        #     type=str,
+        #     help="Пароль для аутентификации",
+        #     default=getenv("AUTH_PASSWORD"),
+        # )
+        parser.add_argument(
+            "-s",
+            "--search",
+            type=str,
+            default="",
+            help="Строка поиска контактов работодателя (email, имя, название компании)",
+        )
+        parser.add_argument(
+            "-p",
+            "--page",
+            default=1,
+            help="Номер страницы в выдаче. Игнорируется при экспорте.",
+        )
+        parser.add_argument(
+            "--export",
+            action=argparse.BooleanOptionalAction,
+            default=False,
+            help="Экспортировать контакты работодателей.",
+        )
+        parser.add_argument(
+            "-f",
+            "--format",
+            default="html",
+            choices=["html", "jsonl"],
+            help="Формат вывода",
+        )
+
+    def run(self, args: Namespace, _, telemetry_client: TelemetryClient) -> None:
+        if args.export:
+            contact_persons = []
+            page = 1
+            per_page = 100
+            while True:
+                res = telemetry_client.get_telemetry(
+                    "/contact/persons",
+                    {"search": args.search, "per_page": per_page, "page": page},
+                )
+                assert "contact_persons" in res
+                contact_persons += res["contact_persons"]
+                if per_page * page >= res["total"]:
+                    break
+                page += 1
+            if args.format == "jsonl":
+                import json, sys
+
+                for contact in contact_persons:
+                    json.dump(contact, sys.stdout, ensure_ascii=False)
+                    sys.stdout.write("\n")
+                    sys.stdout.flush()
+            else:
+                print(generate_html_report(contact_persons))
+            return
+
+        res = telemetry_client.get_telemetry(
+            "/contact/persons",
+            {"search": args.search, "per_page": 10, "page": args.page},
+        )
+        if "contact_persons" not in res:
+            print("❌", res)
+            return 1
+
+        print(
+            "Тут отображаются только данные, собранные с вашего telemetry_client_id. Вы так же можете их удалить с помощью команды delete-telemetry."
+        )
+        print()
+
+        print_contacts(res)
+
+
+def generate_html_report(data: list[dict]) -> str:
+    """
+    Генерирует HTML-отчет на основе предоставленных данных.
+    """
+    html_content = """
+    <!DOCTYPE html>
+    <html lang="ru">
+    <head>
+        <meta charset="UTF-8">
+        <meta name="viewport" content="width=device-width, initial-scale=1.0">
+        <title>Отчет о сотрудниках и компаниях</title>
+        <style>
+            body {
+                font-family: 'Segoe UI', Tahoma, Geneva, Verdana, sans-serif;
+                margin: 20px;
+                background-color: #f4f7f6;
+                color: #333;
+            }
+            .container {
+                max-width: 900px;
+                margin: 20px auto;
+                background-color: #ffffff;
+                padding: 30px;
+                border-radius: 10px;
+                box-shadow: 0 4px 15px rgba(0, 0, 0, 0.1);
+            }
+            h1 {
+                color: #0056b3;
+                text-align: center;
+                margin-bottom: 30px;
+            }
+            .person-card {
+                background-color: #e9f0f8;
+                border: 1px solid #cce5ff;
+                border-radius: 8px;
+                padding: 20px;
+                margin-bottom: 25px;
+                transition: transform 0.2s ease-in-out;
+            }
+            .person-card:hover {
+                transform: translateY(-5px);
+            }
+            .person-card h2 {
+                color: #004085;
+                margin-top: 0;
+                margin-bottom: 10px;
+                border-bottom: 2px solid #0056b3;
+                padding-bottom: 5px;
+            }
+            .person-card p {
+                margin: 5px 0;
+            }
+            .person-card strong {
+                color: #004085;
+            }
+            .employer-info {
+                background-color: #d1ecf1;
+                border-left: 5px solid #007bff;
+                padding: 15px;
+                margin-top: 15px;
+                border-radius: 5px;
+            }
+            .employer-info h3 {
+                color: #0056b3;
+                margin-top: 0;
+                margin-bottom: 10px;
+            }
+            ul {
+                list-style-type: none;
+                padding: 0;
+            }
+            ul li {
+                background-color: #f8fafd;
+                padding: 8px 12px;
+                margin-bottom: 5px;
+                border-radius: 4px;
+                border: 1px solid #e0e9f1;
+            }
+            a {
+                color: #007bff;
+                text-decoration: none;
+            }
+            a:hover {
+                text-decoration: underline;
+            }
+            .no-data {
+                color: #6c757d;
+                font-style: italic;
+            }
+        </style>
+    </head>
+    <body>
+        <div class="container">
+            <h1>Отчет о сотрудниках</h1>
+    """
+
+    for item in data:
+        name = item.get("name", "N/A")
+        email = item.get("email", "N/A")
+        employer = item.get("employer") or {}
+
+        employer_name = employer.get("name", "N/A")
+        employer_area = employer.get("area", "N/A")
+        employer_site_url = employer.get("site_url", "")
+
+        phone_numbers = [
+            pn["phone_number"]
+            for pn in item.get("phone_numbers", [])
+            if "phone_number" in pn
+        ]
+        telegram_usernames = [
+            tu["username"]
+            for tu in item.get("telegram_usernames", [])
+            if "username" in tu
+        ]
+
+        html_content += f"""
+            <div class="person-card">
+                <h2>{name}</h2>
+                <p><strong>Email:</strong> <a href="mailto:{email}">{email}</a></p>
+        """
+
+        if employer_name != "N/A":
+            html_content += f"""
+                <div class="employer-info">
+                    <h3>Работодатель: {employer_name}</h3>
+                    <p><strong>Город:</strong> {employer_area}</p>
+            """
+            if employer_site_url:
+                html_content += f"""
+                    <p><strong>Сайт:</strong> <a href="{employer_site_url}" target="_blank">{employer_site_url}</a></p>
+                """
+            html_content += "</div>"  # Закрываем employer-info
+        else:
+            html_content += (
+                '<p class="no-data">Информация о работодателе отсутствует.</p>'
+            )
+
+        if phone_numbers:
+            html_content += "<p><strong>Номера телефонов:</strong></p><ul>"
+            for phone in phone_numbers:
+                html_content += f"<li><a href='tel:{phone}'>{phone}</a></li>"
+            html_content += "</ul>"
+        else:
+            html_content += '<p class="no-data">Номера телефонов отсутствуют.</p>'
+
+        if telegram_usernames:
+            html_content += "<p><strong>Имена пользователей Telegram:</strong></p><ul>"
+            for username in telegram_usernames:
+                html_content += f"<li><a href='https://t.me/{username}' target='_blank'>@{username}</a></li>"
+            html_content += "</ul>"
+        else:
+            html_content += (
+                '<p class="no-data">Имена пользователей Telegram отсутствуют.</p>'
+            )
+
+        html_content += "</div>"  # Закрываем person-card
+
+    html_content += """
+        </div>
+    </body>
+    </html>
+    """
+    return html_content
+
+
+def print_contacts(data: dict) -> None:
+    """Вывод всех контактов в древовидной структуре."""
+    page = data["page"]
+    pages = (data["total"] // data["per_page"]) + 1
+    print(f"Страница {page}/{pages}:")
+    contacts = data.get("contact_persons", [])
+    for idx, contact in enumerate(contacts):
+        is_last_contact = idx == len(contacts) - 1
+        print_contact(contact, is_last_contact)
+    print()
+
+
+def print_contact(contact: dict, is_last_contact: bool) -> None:
+    """Вывод информации о конкретном контакте."""
+    prefix = "└──" if is_last_contact else "├──"
+    print(f" {prefix} 🧑 {contact.get('name', 'Имя скрыто')}")
+    prefix2 = "    " if is_last_contact else " │   "
+    print(f"{prefix2}├── 📧 Email: {contact.get('email', 'н/д')}")
+    employer = contact.get("employer") or {}
+    print(f"{prefix2}├── 🏢 Работодатель: {employer.get('name', 'н/д')}")
+    print(f"{prefix2}├── 🏠 Город: {employer.get('area', 'н/д')}")
+    print(f"{prefix2}└── 🌐 Сайт: {employer.get('site_url', 'н/д')}")
+    print(prefix2)

{hh_applicant_tool-0.5.8 → hh_applicant_tool-0.6.0}/hh_applicant_tool/operations/list_resumes.py

@@ -23,8 +23,8 @@ class Operation(BaseOperation):
     def setup_parser(self, parser: argparse.ArgumentParser) -> None:
         pass
 
-    def run(self, api: ApiClient, _) -> None:
-        resumes: ApiListResponse = api.get("/resumes/mine")
+    def run(self, args: Namespace, api_client: ApiClient, *_) -> None:
+        resumes: ApiListResponse = api_client.get("/resumes/mine")
         t = PrettyTable(field_names=["ID", "Название", "Статус"], align="l", valign="t")
         t.add_rows(
             [

{hh_applicant_tool-0.5.8 → hh_applicant_tool-0.6.0}/hh_applicant_tool/operations/refresh_token.py

@@ -1,8 +1,8 @@
 # Этот модуль можно использовать как образец для других
 import argparse
 import logging
-
-from ..api import ApiError, ApiClient, OAuthClient
+from typing import Any
+from ..api import ApiError, ApiClient
 from ..main import BaseOperation
 from ..main import Namespace as BaseNamespace
 from ..utils import print_err
@@ -20,11 +20,9 @@ class Operation(BaseOperation):
     def setup_parser(self, parser: argparse.ArgumentParser) -> None:
         pass
 
-    def run(self, api: ApiClient, args: Namespace) -> None:
+    def run(self, _, api_client: ApiClient, *args: Any) -> None:
         try:
-            oauth: OAuthClient = api.oauth_client
-            token = oauth.refresh_access(api.refresh_token)
-            api.handle_access_token(token)
+            api_client.refresh_access_token()
             print("✅ Токен обновлен!")
         except ApiError as ex:
             print_err("❗ Ошибка:", ex)

{hh_applicant_tool-0.5.8 → hh_applicant_tool-0.6.0}/hh_applicant_tool/operations/reply_employers.py

@@ -66,8 +66,8 @@ class Operation(BaseOperation, GetResumeIdMixin):
             action=argparse.BooleanOptionalAction,
         )
 
-    def run(self, api: ApiClient, args: Namespace) -> None:
-        self.api = api
+    def run(self, args: Namespace, api_client: ApiClient, *_) -> None:
+        self.api_client = api_client
         self.resume_id = self._get_resume_id()
         self.reply_min_interval, self.reply_max_interval = args.reply_interval
         self.reply_message = args.reply_message or args.config["reply_message"]
@@ -79,7 +79,7 @@ class Operation(BaseOperation, GetResumeIdMixin):
         self._reply_chats()
 
     def _reply_chats(self) -> None:
-        me = self.me = self.api.get("/me")
+        me = self.me = self.api_client.get("/me")
 
         basic_message_placeholders = {
             "first_name": me.get("first_name", ""),
@@ -123,7 +123,7 @@ class Operation(BaseOperation, GetResumeIdMixin):
                 last_message: dict | None = None
                 message_history: list[str] = []
                 while True:
-                    messages_res = self.api.get(
+                    messages_res = self.api_client.get(
                         f"/negotiations/{nid}/messages", page=page
                     )
 
@@ -193,7 +193,7 @@ class Operation(BaseOperation, GetResumeIdMixin):
                             self.reply_max_interval,
                         )
                     )
-                    self.api.post(
+                    self.api_client.post(
                         f"/negotiations/{nid}/messages",
                         message=message,
                     )
@@ -209,7 +209,7 @@ class Operation(BaseOperation, GetResumeIdMixin):
     def _get_negotiations(self) -> list[dict]:
         rv = []
         for page in range(self.max_pages):
-            res = self.api.get("/negotiations", page=page, status="active")
+            res = self.api_client.get("/negotiations", page=page, status="active")
             rv.extend(res["items"])
             if page >= res["pages"] - 1:
                 break

{hh_applicant_tool-0.5.8 → hh_applicant_tool-0.6.0}/hh_applicant_tool/operations/update_resumes.py

@@ -21,11 +21,11 @@ class Operation(BaseOperation):
     def setup_parser(self, parser: argparse.ArgumentParser) -> None:
         pass
 
-    def run(self, api: ApiClient, args: Namespace) -> None:
-        resumes: ApiListResponse = api.get("/resumes/mine")
+    def run(self, args: Namespace, api_client: ApiClient, *_) -> None:
+        resumes: ApiListResponse = api_client.get("/resumes/mine")
         for resume in resumes["items"]:
             try:
-                res = api.post(f"/resumes/{resume['id']}/publish")
+                res = api_client.post(f"/resumes/{resume['id']}/publish")
                 assert res == {}
                 print("✅ Обновлено", truncate_string(resume["title"]))
             except ApiError as ex:

{hh_applicant_tool-0.5.8 → hh_applicant_tool-0.6.0}/hh_applicant_tool/operations/whoami.py

@@ -20,6 +20,6 @@ class Operation(BaseOperation):
     def setup_parser(self, parser: argparse.ArgumentParser) -> None:
         pass
 
-    def run(self, api: ApiClient, args: Namespace) -> None:
-        result = api.get("/me")
-        print(json.dumps(result, ensure_ascii=True, indent=2, sort_keys=True))
+    def run(self, args: Namespace, api_client: ApiClient, _) -> None:
+        result = api_client.get("/me")
+        print(json.dumps(result, ensure_ascii=False, indent=2, sort_keys=True))

{hh_applicant_tool-0.5.8 → hh_applicant_tool-0.6.0}/hh_applicant_tool/telemetry_client.py

@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 import json
 import logging
 import os
@@ -6,8 +8,8 @@ import warnings
 from functools import partialmethod
 from typing import Any, Dict, Optional
 from urllib.parse import urljoin
-
 import requests
+from .utils import Config
 
 # Сертификат на сервере давно истек, но его обновлять мне лень...
 warnings.filterwarnings("ignore", message="Unverified HTTPS request")
@@ -29,6 +31,7 @@ class TelemetryClient:
 
     def __init__(
         self,
+        telemetry_client_id: str,
         server_address: Optional[str] = None,
         *,
         session: Optional[requests.Session] = None,
@@ -36,6 +39,7 @@ class TelemetryClient:
         proxies: dict | None = None,
         delay: Optional[float] = None,
     ) -> None:
+        self.send_telemetry_id = telemetry_client_id
         self.server_address = os.getenv(
             "TELEMETRY_SERVER", server_address or self.server_address
         )
@@ -68,7 +72,10 @@ class TelemetryClient:
             response = self.session.request(
                 method,
                 url,
-                headers={"User-Agent": self.user_agent},
+                headers={
+                    "User-Agent": self.user_agent,
+                    "X-Telemetry-Client-ID": self.send_telemetry_id,
+                },
                 proxies=self.proxies,
                 params=data if not has_body else None,
                 json=data if has_body else None,
@@ -92,3 +99,8 @@ class TelemetryClient:
 
     get_telemetry = partialmethod(request, "GET")
     send_telemetry = partialmethod(request, "POST")
+
+    @classmethod
+    def create_from_config(cls, config: Config) -> "TelemetryClient":
+        assert "telemetry_client_id" in config
+        return cls(config["telemetry_client_id"])

{hh_applicant_tool-0.5.8 → hh_applicant_tool-0.6.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "hh-applicant-tool"
-version = "0.5.8"
+version = "0.6.0"
 description = ""
 authors = ["Senior YAML Developer <yamldeveloper@proton.me>"]
 readme = "README.md"
@@ -17,7 +17,6 @@ pyqt6-webengine = { version = "6.7.0", optional = true }
 qt = ["pyqt6", "pyqt6-webengine"]
 
 [tool.poetry.group.dev.dependencies]
-black = "^23.1.0"
 isort = "^5.12.0"
 pylint = "^2.16.4"
 pytest = "^7.2.2"
@@ -36,3 +35,6 @@ hh-applicant-tool = "hh_applicant_tool.main:main"
 # https://github.com/microsoft/pyright/blob/main/docs/configuration.md
 # Ошибки показывать он не бросит, но заебывать перестанет
 typeCheckingMode = "off"
+
+[tool.ruff]
+select = ["E", "F", "I", "W"]

hh_applicant_tool-0.5.8/hh_applicant_tool/operations/config.py

@@ -1,36 +0,0 @@
-import argparse
-import logging
-import os
-import subprocess
-
-from ..main import BaseOperation
-from ..main import Namespace as BaseNamespace
-
-logger = logging.getLogger(__package__)
-
-EDITOR = os.getenv("EDITOR", "nano")
-
-
-class Namespace(BaseNamespace):
-    print: bool
-
-
-class Operation(BaseOperation):
-    """Редактировать конфигурационный файл или показать путь до него"""
-
-    def setup_parser(self, parser: argparse.ArgumentParser) -> None:
-        parser.add_argument(
-            "-p",
-            "--print",
-            type=bool,
-            default=False,
-            action=argparse.BooleanOptionalAction,
-            help="Напечатать путь и выйти",
-        )
-
-    def run(self, _, args: Namespace) -> None:
-        config_path = str(args.config._config_path)
-        if args.print:
-            print(config_path)
-        else:
-            subprocess.call([EDITOR, config_path])

hh_applicant_tool-0.5.8/hh_applicant_tool/operations/get_employer_contacts.py

@@ -1,93 +0,0 @@
-import argparse
-import logging
-from os import getenv
-
-from ..main import BaseOperation
-from ..main import Namespace as BaseNamespace
-from ..main import get_proxies
-from ..telemetry_client import TelemetryClient
-
-logger = logging.getLogger(__package__)
-
-
-class Namespace(BaseNamespace):
-    username: str | None = None
-    password: str | None = None
-    search: str | None = None
-
-
-class Operation(BaseOperation):
-    """Выведет контакты работодателя по заданной строке поиска"""
-
-    def setup_parser(self, parser: argparse.ArgumentParser) -> None:
-        parser.add_argument(
-            "-u",
-            "--username",
-            type=str,
-            help="Имя пользователя для аутентификации",
-            default=getenv("AUTH_USERNAME"),
-        )
-        parser.add_argument(
-            "-P",
-            "--password",
-            type=str,
-            help="Пароль для аутентификации",
-            default=getenv("AUTH_PASSWORD"),
-        )
-        parser.add_argument(
-            "-s",
-            "--search",
-            type=str,
-            default="",
-            help="Строка поиска для контактов работодателя",
-        )
-        parser.add_argument(
-            "-p",
-            "--page",
-            default=1,
-            help="Номер страницы в выдаче",
-        )
-
-    def run(self, _, args: Namespace) -> None:
-        proxies = get_proxies(args)
-        client = TelemetryClient(proxies=proxies)
-        auth = (
-            (args.username, args.password) if args.username and args.password else None
-        )
-        # Аутентификация пользователя
-        results = client.get_telemetry(
-            "/contact/persons",
-            {"search": args.search, "per_page": 10, "page": args.page},
-            auth=auth,
-        )
-        if "contact_persons" not in results:
-            print("❌", results)
-            return 1
-
-        print("Данная информация была собрана из публичных источников.")
-        print()
-
-        self._print_contacts(results)
-
-    def _print_contacts(self, data: dict) -> None:
-        """Вывод всех контактов в древовидной структуре."""
-        page = data["page"]
-        pages = (data["total"] // data["per_page"]) + 1
-        print(f"📋 Контакты ({page}/{pages}):")
-        contacts = data.get("contact_persons", [])
-        for idx, contact in enumerate(contacts):
-            is_last_contact = idx == len(contacts) - 1
-            self._print_contact(contact, is_last_contact)
-        print()
-
-    def _print_contact(self, contact: dict, is_last_contact: bool) -> None:
-        """Вывод информации о конкретном контакте."""
-        prefix = "└──" if is_last_contact else "├──"
-        print(f" {prefix} 🧑 Контактное лицо")
-        prefix2 = "    " if is_last_contact else " │   "
-        print(f"{prefix2}├── 📧 Email: {contact.get('email', 'н/д')}")
-        employer = contact.get("employer") or {}
-        print(f"{prefix2}├── 🏢 Работодатель: {employer.get('name', 'н/д')}")
-        print(f"{prefix2}├── 🏠 Город: {employer.get('area', 'н/д')}")
-        print(f"{prefix2}└── 🌐 Сайт: {employer.get('site_url', 'н/д')}")
-        print(prefix2)