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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: hh-applicant-tool
-Version: 0.3.5
+Version: 0.3.6
 Summary: 
 Author: Senior YAML Developer
 Author-email: yamldeveloper@proton.me
@@ -19,8 +19,6 @@ Description-Content-Type: text/markdown
 
 ## HH Applicant Tool
 
-> ! Наложен мораторий на доработки/переработки. Разработка будет возобновлена после 100 звезд 💫
-
 ![Publish to PyPI](https://github.com/s3rgeym/hh-applicant-tool/actions/workflows/publish.yml/badge.svg) 
 [![PyPi Version](https://img.shields.io/pypi/v/hh-applicant-tool)]() 
 [![Python Versions](https://img.shields.io/pypi/pyversions/hh-applicant-tool.svg)]() 
@@ -72,18 +70,18 @@ $ pipx upgrade hh-applicant-tool
 
 Отдельно я распишу процесс установки в **Windows** в подробностях:
 
-* Для начала поставьте Python 3 любым удобным способом.
-* Запустите терминал/консоль от Администратора и выполните:
+* Для начала поставьте последнюю версию **Python 3** любым удобным способом.
+* Запустите **Terminal** или **PowerShell** от Администратора и выполните:
   ```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`:
+* Поставьте все пакеты в виртуальное окружение `hh-applicant-venv`:
   ```ps
   (hh-applicant-venv) PS> pip install hh-applicant-tool[qt]
   ```
@@ -91,10 +89,10 @@ $ pipx upgrade hh-applicant-tool
   ```ps
   (hh-applicant-venv) PS> hh-applicant-tool -h
   ```
-* В случае неудачи, вернитесь к первому шагу. Для последующих запусков сперва активируйте виртуальное окружение.
+* В случае неудачи вернитесь к первому шагу.
+* Для последующих запусков сначала активируйте виртуальное окружение.
   
 
-
 Использование:
 
 ```bash
@@ -158,10 +156,11 @@ https://hh.ru/employer/1918903
 | **whoami**             | Выводит информацию об авторизованном пользователе                                                   |
 | **list-resumes**       | Список резюме                                                                                       |
 | **update-resumes**     | Обновить все резюме. Аналогично нажатию кнопки «Обновить дату».                                     |
-| **apply-similar**      | Откликнуться на все подходящие вакансии. Лимит = 200 в день                                         |
+| **apply-similar**      | Откликнуться на все подходящие вакансии. Лимит = 200 в день. На HH есть спам-фильтры, так что лучше не рассылайте отклики со ссылками. |
 | **clear-negotiations** | Удаляет отказы и отменяет заявки, которые долго висят                                               |
 | **call-api**           | Вызов произвольного метода API с выводом результата.                                                |
 | **refresh-token**      | Обновляет access_token.                                                                             |
+| **get-employer-contacts** | Получить список контактов работодателя, даже если тот не высылал приглашения. Контакты получаются строго из публичного доступа, например, сайта фирмы и могут быть удалены по просьбе упал_намоченный лицо. Данная функция готова и будет доступна после 100 ⭐  |
 
 Авторизуемся:
 
@@ -262,7 +261,7 @@ rm -f ~/.local/share/applications/hhandroid.desktop
 
 Отдельные замечания у меня к API HH. Оно пиздец какое кривое. Например, при создании заявки возвращается пустой ответ либо редирект, хотя по логике должен возвраться созданный объект. Так же в ответах сервера нет `Content-Length`. Из-за этого нельзя узнать есть тело у ответа сервера нужно его пробовать прочитать. Я так понял там какой-то прокси оборачивает все запросы и отдает всегда `Transfer-Encoding: Chunked`. А еще он возвращает 502 ошибку, когда бекенд на Java падает либо долго отвечает (таймаут)? А вот [язык запросов](https://hh.ru/article/1175) мне понравился. Можно что-то типа этого использовать `NOT (!ID:123 OR !ID:456 OR !ID:789)` что бы отсеить какие-то вакансии.
 
-Утилита собирает и передает на сервер разработчика следующую ифнормацию:
+Утилита собирает и передает на сервер разработчика следующую информацию:
 
 1. Название вакансии.
 1. Тип вакансии (открытая/закрытая).
@@ -271,7 +270,7 @@ rm -f ~/.local/share/applications/hhandroid.desktop
 1. Прямая ссылка на вакансию.
 1. Дата создания вакансии.
 1. Дата публикации вакансии.
-1. Контактная информация хрюши (ее телефон, email и тп).
+1. Контактная информация работодателя, которую он или его сотрудники сами выложили в общественный доступ, хранящаеся в строго обезличенной форме с соблюдением законов РФ, GDPR и американского экспортного контроля (может быть удалена при письменном запросе в утвержденной Законом форме с оригинальными печатями фирмы и росписью генерального директора и/или по требованию РКН, прокуратуры или лично Адама Кадырова).
 1. Название компании.
 1. Тип компании.
 1. Описание компании.

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

@@ -1,7 +1,5 @@
 ## HH Applicant Tool
 
-> ! Наложен мораторий на доработки/переработки. Разработка будет возобновлена после 100 звезд 💫
-
 ![Publish to PyPI](https://github.com/s3rgeym/hh-applicant-tool/actions/workflows/publish.yml/badge.svg) 
 [![PyPi Version](https://img.shields.io/pypi/v/hh-applicant-tool)]() 
 [![Python Versions](https://img.shields.io/pypi/pyversions/hh-applicant-tool.svg)]() 
@@ -53,18 +51,18 @@ $ pipx upgrade hh-applicant-tool
 
 Отдельно я распишу процесс установки в **Windows** в подробностях:
 
-* Для начала поставьте Python 3 любым удобным способом.
-* Запустите терминал/консоль от Администратора и выполните:
+* Для начала поставьте последнюю версию **Python 3** любым удобным способом.
+* Запустите **Terminal** или **PowerShell** от Администратора и выполните:
   ```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`:
+* Поставьте все пакеты в виртуальное окружение `hh-applicant-venv`:
   ```ps
   (hh-applicant-venv) PS> pip install hh-applicant-tool[qt]
   ```
@@ -72,10 +70,10 @@ $ pipx upgrade hh-applicant-tool
   ```ps
   (hh-applicant-venv) PS> hh-applicant-tool -h
   ```
-* В случае неудачи, вернитесь к первому шагу. Для последующих запусков сперва активируйте виртуальное окружение.
+* В случае неудачи вернитесь к первому шагу.
+* Для последующих запусков сначала активируйте виртуальное окружение.
   
 
-
 Использование:
 
 ```bash
@@ -139,10 +137,11 @@ https://hh.ru/employer/1918903
 | **whoami**             | Выводит информацию об авторизованном пользователе                                                   |
 | **list-resumes**       | Список резюме                                                                                       |
 | **update-resumes**     | Обновить все резюме. Аналогично нажатию кнопки «Обновить дату».                                     |
-| **apply-similar**      | Откликнуться на все подходящие вакансии. Лимит = 200 в день                                         |
+| **apply-similar**      | Откликнуться на все подходящие вакансии. Лимит = 200 в день. На HH есть спам-фильтры, так что лучше не рассылайте отклики со ссылками. |
 | **clear-negotiations** | Удаляет отказы и отменяет заявки, которые долго висят                                               |
 | **call-api**           | Вызов произвольного метода API с выводом результата.                                                |
 | **refresh-token**      | Обновляет access_token.                                                                             |
+| **get-employer-contacts** | Получить список контактов работодателя, даже если тот не высылал приглашения. Контакты получаются строго из публичного доступа, например, сайта фирмы и могут быть удалены по просьбе упал_намоченный лицо. Данная функция готова и будет доступна после 100 ⭐  |
 
 Авторизуемся:
 
@@ -243,7 +242,7 @@ rm -f ~/.local/share/applications/hhandroid.desktop
 
 Отдельные замечания у меня к API HH. Оно пиздец какое кривое. Например, при создании заявки возвращается пустой ответ либо редирект, хотя по логике должен возвраться созданный объект. Так же в ответах сервера нет `Content-Length`. Из-за этого нельзя узнать есть тело у ответа сервера нужно его пробовать прочитать. Я так понял там какой-то прокси оборачивает все запросы и отдает всегда `Transfer-Encoding: Chunked`. А еще он возвращает 502 ошибку, когда бекенд на Java падает либо долго отвечает (таймаут)? А вот [язык запросов](https://hh.ru/article/1175) мне понравился. Можно что-то типа этого использовать `NOT (!ID:123 OR !ID:456 OR !ID:789)` что бы отсеить какие-то вакансии.
 
-Утилита собирает и передает на сервер разработчика следующую ифнормацию:
+Утилита собирает и передает на сервер разработчика следующую информацию:
 
 1. Название вакансии.
 1. Тип вакансии (открытая/закрытая).
@@ -252,7 +251,7 @@ rm -f ~/.local/share/applications/hhandroid.desktop
 1. Прямая ссылка на вакансию.
 1. Дата создания вакансии.
 1. Дата публикации вакансии.
-1. Контактная информация хрюши (ее телефон, email и тп).
+1. Контактная информация работодателя, которую он или его сотрудники сами выложили в общественный доступ, хранящаеся в строго обезличенной форме с соблюдением законов РФ, GDPR и американского экспортного контроля (может быть удалена при письменном запросе в утвержденной Законом форме с оригинальными печатями фирмы и росписью генерального директора и/или по требованию РКН, прокуратуры или лично Адама Кадырова).
 1. Название компании.
 1. Тип компании.
 1. Описание компании.

{hh_applicant_tool-0.3.5 → hh_applicant_tool-0.3.6}/hh_applicant_tool/api/client.py

@@ -12,11 +12,12 @@ from urllib.parse import urlencode
 
 import requests
 from requests import Response, Session
+import random
 
 from ..constants import (
     ANDROID_CLIENT_ID,
     ANDROID_CLIENT_SECRET,
-    DEFAULT_USER_AGENT,
+    USER_AGENT_TEMPLATE,
 )
 from ..types import AccessToken
 from . import errors
@@ -38,6 +39,7 @@ class BaseClient:
     user_agent: str | None = None
     session: Session | None = None
     previous_request_time: float = 0.0
+    delay: float = 0.334
 
     def __post_init__(self) -> None:
         self.lock = Lock()
@@ -46,11 +48,31 @@ class BaseClient:
             session.headers.update(
                 {
                     **self.additional_headers(),
-                    "User-Agent": self.user_agent or DEFAULT_USER_AGENT,
+                    "User-Agent": self.user_agent or self.default_user_agent(),
                 }
             )
             logger.debug("Default Headers: %r", session.headers)
 
+    def default_user_agent(self) -> str:
+        return USER_AGENT_TEMPLATE % (
+            random.choice(["8.0", "8.1", "9", "10", "11", "12"]),
+            random.choice(
+                [
+                    "SM-G998B",  # Samsung Galaxy S21 Ultra
+                    "Pixel 6",  # Google Pixel 6
+                    "Mi 11",  # Xiaomi Mi 11
+                    "OnePlus 9",  # OnePlus 9
+                    "P40",  # Huawei P40
+                    "LG G8",  # LG G8
+                    "Xperia 1 II",  # Sony Xperia 1 II
+                    "Moto G Power",  # Motorola Moto G Power
+                    "HTC U12+",  # HTC U12+
+                    "ROG Phone 5",  # Asus ROG Phone 5
+                ]
+            ),
+            random.randint(88, 130),
+        )
+
     def additional_headers(
         self,
     ) -> dict[str, str]:
@@ -61,7 +83,7 @@ class BaseClient:
         method: ALLOWED_METHODS,
         endpoint: str,
         params: dict | None = None,
-        delay: float = 0.34,
+        delay: float | None = None,
         **kwargs: Any,
     ) -> dict:
         # Не знаю насколько это "правильно"
@@ -72,7 +94,9 @@ class BaseClient:
         with self.lock:
             # На серваке какая-то анти-DDOS система
             if (
-                delay := delay - time.monotonic() + self.previous_request_time
+                delay := (self.delay if delay is None else delay)
+                - time.monotonic()
+                + self.previous_request_time
             ) > 0:
                 logger.debug("wait %fs before request", delay)
                 time.sleep(delay)

{hh_applicant_tool-0.3.5 → hh_applicant_tool-0.3.6}/hh_applicant_tool/constants.py

@@ -1,4 +1,4 @@
-DEFAULT_USER_AGENT = "Mozilla/5.0 (Linux; Android 10; K) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/130.0.0.0 Mobile Safari/537.36"
+USER_AGENT_TEMPLATE = "Mozilla/5.0 (Linux; Android %s; %s) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/%s.0.0.0 Mobile Safari/537.36"
 
 ANDROID_CLIENT_ID = (
     "HIOMIAS39CA9DICTA7JIO64LQKQJF5AGIK74G9ITJKLNEDAOH5FHS5G1JI7FOEGD"

{hh_applicant_tool-0.3.5 → hh_applicant_tool-0.3.6}/hh_applicant_tool/main.py

@@ -9,14 +9,12 @@ from os import getenv
 from pathlib import Path
 from pkgutil import iter_modules
 from typing import Sequence
-
+from .api import ApiClient
 from .color_log import ColorHandler
 from .utils import Config, get_config_path
 
 DEFAULT_CONFIG_PATH = (
-    get_config_path()
-    / __package__.replace("_", "-")
-    / "config.json"
+    get_config_path() / __package__.replace("_", "-") / "config.json"
 )
 
 logger = logging.getLogger(__package__)
@@ -35,6 +33,18 @@ OPERATIONS = "operations"
 class Namespace(argparse.Namespace):
     config: Config
     verbosity: int
+    delay: float
+
+
+def get_api(args: Namespace) -> ApiClient:
+    token = args.config.get("token", {})
+    api = ApiClient(
+        access_token=token.get("access_token"),
+        refresh_token=token.get("refresh_token"),
+        user_agent=args.config["user_agent"],
+        delay=args.delay,
+    )
+    return api
 
 
 class HHApplicantTool:
@@ -45,32 +55,46 @@ class HHApplicantTool:
     Группа поддержки: <https://t.me/+aSjr8qM_AP85ZDBi>
     """
 
+    class ArgumentFormatter(
+        argparse.ArgumentDefaultsHelpFormatter,
+        argparse.RawDescriptionHelpFormatter,
+    ):
+        pass
+
     def create_parser(self) -> argparse.ArgumentParser:
         parser = argparse.ArgumentParser(
             description=self.__doc__,
-            formatter_class=argparse.RawDescriptionHelpFormatter,
+            formatter_class=self.ArgumentFormatter,
         )
         parser.add_argument(
             "-c",
             "--config",
-            help="config path",
+            help="Путь до файла конфигурации",
             type=Config,
             default=Config(DEFAULT_CONFIG_PATH),
         )
         parser.add_argument(
             "-v",
             "--verbosity",
-            help="increase verbosity",
+            help="При использовании от одного и более раз увеличивает количество отладочной информации в выводе",
             action="count",
             default=0,
         )
+        parser.add_argument(
+            "-d",
+            "--delay",
+            type=float,
+            default=0.334,
+            help="Задержка между запросами к API HH",
+        )
         subparsers = parser.add_subparsers(help="commands")
         package_dir = Path(__file__).resolve().parent / OPERATIONS
         for _, module_name, _ in iter_modules([str(package_dir)]):
             mod = import_module(f"{__package__}.{OPERATIONS}.{module_name}")
             op: BaseOperation = mod.Operation()
             op_parser = subparsers.add_parser(
-                module_name.replace("_", "-"), description=op.__doc__
+                module_name.replace("_", "-"),
+                description=op.__doc__, formatter_class=self.ArgumentFormatter
             )
             op_parser.set_defaults(run=op.run)
             op.setup_parser(op_parser)

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

@@ -8,7 +8,7 @@ from typing import TextIO, Tuple
 
 from ..api import ApiClient, ApiError, BadRequest
 from ..main import BaseOperation
-from ..main import Namespace as BaseNamespace
+from ..main import Namespace as BaseNamespace, get_api
 from ..telemetry_client import TelemetryError
 from ..telemetry_client import get_client as get_telemetry_client
 from ..types import ApiListResponse, VacancyItem
@@ -83,11 +83,7 @@ class Operation(BaseOperation):
         return min(min_interval, max_interval), max(min_interval, max_interval)
 
     def run(self, args: Namespace) -> None:
-        assert args.config["token"]
-        api = ApiClient(
-            access_token=args.config["token"]["access_token"],
-            user_agent=args.config["user_agent"],
-        )
+        api = get_api(args)
         resume_id = self._get_resume_id(args, api)
         application_messages = self._get_application_messages(args)
 
@@ -178,7 +174,7 @@ class Operation(BaseOperation):
 
                 try:
                     employer_id = vacancy["employer"]["id"]
-                except IndexError:
+                except KeyError:
                     logger.warning(
                         f"Вакансия без работодателя: {vacancy['alternate_url']}"
                     )
@@ -209,7 +205,7 @@ class Operation(BaseOperation):
                     message_template = random.choice(application_messages)
 
                     try:
-                        params["message"] = template_message % vacancy
+                        params["message"] = message_template % vacancy
                     except TypeError as ex:
                         # TypeError: not enough arguments for format string
                         # API HH все кривое, иногда нет идентификатора работодателя, иногда у вакансии нет названия.

{hh_applicant_tool-0.3.5 → hh_applicant_tool-0.3.6}/hh_applicant_tool/operations/call_api.py

@@ -4,8 +4,8 @@ import json
 import logging
 import sys
 
-from ..api import ApiClient, ApiError
-from ..main import BaseOperation
+from ..api import ApiError
+from ..main import BaseOperation, get_api
 from ..main import Namespace as BaseNamespace
 
 logger = logging.getLogger(__package__)
@@ -34,11 +34,7 @@ class Operation(BaseOperation):
         )
 
     def run(self, args: Namespace) -> None:
-        assert args.config["token"]
-        api = ApiClient(
-            access_token=args.config["token"]["access_token"],
-            user_agent=args.config["user_agent"],
-        )
+        api = get_api(args)
         params = dict(x.split("=", 1) for x in args.param)
         try:
             result = api.request(args.method, args.endpoint, params=params)

{hh_applicant_tool-0.3.5 → hh_applicant_tool-0.3.6}/hh_applicant_tool/operations/clear_negotiations.py

@@ -5,7 +5,7 @@ from datetime import datetime, timedelta, timezone
 
 from ..api import ApiClient, ClientError
 from ..constants import INVALID_ISO8601_FORMAT
-from ..main import BaseOperation
+from ..main import BaseOperation, get_api
 from ..main import Namespace as BaseNamespace
 from ..types import ApiListResponse
 from ..utils import print_err, truncate_string
@@ -51,11 +51,7 @@ class Operation(BaseOperation):
         return rv
 
     def run(self, args: Namespace) -> None:
-        assert args.config["token"]
-        api = ApiClient(
-            access_token=args.config["token"]["access_token"],
-            user_agent=args.config["user_agent"],
-        )
+        api = get_api(args)
         negotiations = self._get_active_negotiations(api)
         print("Всего активных:", len(negotiations))
         for item in negotiations:

{hh_applicant_tool-0.3.5 → hh_applicant_tool-0.3.6}/hh_applicant_tool/operations/list_resumes.py

@@ -5,7 +5,7 @@ import logging
 from prettytable import PrettyTable
 
 from ..api import ApiClient
-from ..main import BaseOperation
+from ..main import BaseOperation, get_api
 from ..main import Namespace as BaseNamespace
 from ..types import ApiListResponse
 from ..utils import truncate_string
@@ -24,11 +24,7 @@ class Operation(BaseOperation):
         pass
 
     def run(self, args: Namespace) -> None:
-        assert args.config["token"]
-        api = ApiClient(
-            access_token=args.config["token"]["access_token"],
-            user_agent=args.config["user_agent"],
-        )
+        api = get_api(args)
         resumes: ApiListResponse = api.get("/resumes/mine")
         t = PrettyTable(
             field_names=["ID", "Название", "Статус"], align="l", valign="t"

{hh_applicant_tool-0.3.5 → hh_applicant_tool-0.3.6}/hh_applicant_tool/operations/update_resumes.py

@@ -3,7 +3,7 @@ import argparse
 import logging
 
 from ..api import ApiClient, ApiError
-from ..main import BaseOperation
+from ..main import BaseOperation, get_api
 from ..main import Namespace as BaseNamespace
 from ..types import ApiListResponse
 from ..utils import print_err, truncate_string
@@ -22,11 +22,7 @@ class Operation(BaseOperation):
         pass
 
     def run(self, args: Namespace) -> None:
-        assert args.config["token"]
-        api = ApiClient(
-            access_token=args.config["token"]["access_token"],
-            user_agent=args.config["user_agent"],
-        )
+        api = get_api(args)
         resumes: ApiListResponse = api.get("/resumes/mine")
         for resume in resumes["items"]:
             try:

{hh_applicant_tool-0.3.5 → hh_applicant_tool-0.3.6}/hh_applicant_tool/operations/whoami.py

@@ -4,7 +4,7 @@ import json
 import logging
 
 from ..api import ApiClient
-from ..main import BaseOperation
+from ..main import BaseOperation, get_api
 from ..main import Namespace as BaseNamespace
 
 logger = logging.getLogger(__package__)
@@ -21,10 +21,6 @@ class Operation(BaseOperation):
         pass
 
     def run(self, args: Namespace) -> None:
-        assert args.config["token"]
-        api = ApiClient(
-            access_token=args.config["token"]["access_token"],
-            user_agent=args.config["user_agent"],
-        )
+        api = get_api(args)
         result = api.get("/me")
         print(json.dumps(result, ensure_ascii=True, indent=2, sort_keys=True))

{hh_applicant_tool-0.3.5 → hh_applicant_tool-0.3.6}/hh_applicant_tool/telemetry_client.py

@@ -51,8 +51,6 @@ class TelemetryClient:
         :raises TelemetryError: Если произошла ошибка при отправке или декодировании JSON.
         """
         url = urljoin(self.server_address, endpoint)
-        logger.debug(data)
-
         try:
             response = self.session.post(url, json=data)
             # response.raise_for_status()

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

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