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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: hh-applicant-tool
-Version: 0.1.9
+Version: 0.2.1
 Summary: 
 Author: Senior YAML Developer
 Author-email: yamldeveloper@proton.me
@@ -110,16 +110,17 @@ https://hh.ru/employer/1918903
 - `-v` используется для вывода отладочной информации. Два таких флага, например, выводят запросы к **API**.
 - `-c <path>` можно создать путь до конфига. С помощью этого флага можно одновременно использовать несколько профилей.
 
-| Операция               | Описание                                                                                                                                      |
-| ---------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
-| **add-handler**        | Добавляет обработчик протокола `hhandroid`                                                                                                    |
-| **authorize**          | Открывает сайт hh.ru для авторизации и перехватывает перенаправление на `hhadnroid://oauthresponse`                                           |
-| **whoami**             | Выводит информацию об авторизованном пользователе                                                                                             |
-| **list-resumes**       | Список резюме                                                                                                                                 |
-| **update-resumes**     | Обновить все резюме. Аналогично нажатию кнопки «Обновить дату».                                                                               |
-| **apply-similar**      | Откликнуться на все подходящие вакансии. Лимит = 200 в день                                                                                   |
-| **clear-negotiations** | Удаляет отказы и отменяет заявки, которые долго висят                                                                                         |
-| **call-api**           | Вызвать произвольный метод API м вывести результат. Я эту команду придумал чтобы собирать ссылки на сайты и загонять их в сканер уязвимостей. |
+| Операция               | Описание                                                                                            |
+| ---------------------- | --------------------------------------------------------------------------------------------------- |
+| **add-handler**        | Добавляет обработчик протокола `hhandroid`                                                          |
+| **authorize**          | Открывает сайт hh.ru для авторизации и перехватывает перенаправление на `hhadnroid://oauthresponse` |
+| **whoami**             | Выводит информацию об авторизованном пользователе                                                   |
+| **list-resumes**       | Список резюме                                                                                       |
+| **update-resumes**     | Обновить все резюме. Аналогично нажатию кнопки «Обновить дату».                                     |
+| **apply-similar**      | Откликнуться на все подходящие вакансии. Лимит = 200 в день                                         |
+| **clear-negotiations** | Удаляет отказы и отменяет заявки, которые долго висят                                               |
+| **call-api**           | Вызов произвольного метода API с вводом результата.                                                 |
+| **refresh-token**      | Обновляет access_token.                                                                             |
 
 Для начала нужно добавить обработчик протокола `hhandroid`, который используется Android-приложением для усложнения жизни честным автоматизаторам:
 
@@ -223,7 +224,7 @@ datetime.datetime(2023, 3, 23, 6, 36, 15, 596290)
 >>>
 ```
 
-После нужно авторизоваться по новой.
+После нужно вызвать `refresh-token`.
 
 ![](https://user-images.githubusercontent.com/12753171/222870516-b29f2417-d11a-4122-8291-7d440a422a31.png)
 

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

@@ -96,16 +96,17 @@ https://hh.ru/employer/1918903
 - `-v` используется для вывода отладочной информации. Два таких флага, например, выводят запросы к **API**.
 - `-c <path>` можно создать путь до конфига. С помощью этого флага можно одновременно использовать несколько профилей.
 
-| Операция               | Описание                                                                                                                                      |
-| ---------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
-| **add-handler**        | Добавляет обработчик протокола `hhandroid`                                                                                                    |
-| **authorize**          | Открывает сайт hh.ru для авторизации и перехватывает перенаправление на `hhadnroid://oauthresponse`                                           |
-| **whoami**             | Выводит информацию об авторизованном пользователе                                                                                             |
-| **list-resumes**       | Список резюме                                                                                                                                 |
-| **update-resumes**     | Обновить все резюме. Аналогично нажатию кнопки «Обновить дату».                                                                               |
-| **apply-similar**      | Откликнуться на все подходящие вакансии. Лимит = 200 в день                                                                                   |
-| **clear-negotiations** | Удаляет отказы и отменяет заявки, которые долго висят                                                                                         |
-| **call-api**           | Вызвать произвольный метод API м вывести результат. Я эту команду придумал чтобы собирать ссылки на сайты и загонять их в сканер уязвимостей. |
+| Операция               | Описание                                                                                            |
+| ---------------------- | --------------------------------------------------------------------------------------------------- |
+| **add-handler**        | Добавляет обработчик протокола `hhandroid`                                                          |
+| **authorize**          | Открывает сайт hh.ru для авторизации и перехватывает перенаправление на `hhadnroid://oauthresponse` |
+| **whoami**             | Выводит информацию об авторизованном пользователе                                                   |
+| **list-resumes**       | Список резюме                                                                                       |
+| **update-resumes**     | Обновить все резюме. Аналогично нажатию кнопки «Обновить дату».                                     |
+| **apply-similar**      | Откликнуться на все подходящие вакансии. Лимит = 200 в день                                         |
+| **clear-negotiations** | Удаляет отказы и отменяет заявки, которые долго висят                                               |
+| **call-api**           | Вызов произвольного метода API с вводом результата.                                                 |
+| **refresh-token**      | Обновляет access_token.                                                                             |
 
 Для начала нужно добавить обработчик протокола `hhandroid`, который используется Android-приложением для усложнения жизни честным автоматизаторам:
 
@@ -209,7 +210,7 @@ datetime.datetime(2023, 3, 23, 6, 36, 15, 596290)
 >>>
 ```
 
-После нужно авторизоваться по новой.
+После нужно вызвать `refresh-token`.
 
 ![](https://user-images.githubusercontent.com/12753171/222870516-b29f2417-d11a-4122-8291-7d440a422a31.png)
 

{hh_applicant_tool-0.1.9 → hh_applicant_tool-0.2.1}/hh_applicant_tool/api/client.py

@@ -14,8 +14,8 @@ import requests
 from requests import Response, Session
 
 from ..constants import (
-    HHANDROID_CLIENT_ID,
-    HHANDROID_CLIENT_SECRET,
+    ANDROID_CLIENT_ID,
+    ANDROID_CLIENT_SECRET,
     DEFAULT_USER_AGENT,
 )
 from ..types import AccessToken
@@ -99,11 +99,12 @@ class BaseClient:
                     "%d %-6s %s",
                     response.status_code,
                     method,
-                    url + (
+                    url
+                    + (
                         "?" + urlencode(params)
                         if not has_body and params
                         else ""
-                    )
+                    ),
                 )
                 self.previous_request_time = time.monotonic()
         self.raise_for_status(response, rv)
@@ -143,8 +144,8 @@ class BaseClient:
 
 @dataclass
 class OAuthClient(BaseClient):
-    client_id: str = HHANDROID_CLIENT_ID
-    client_secret: str = HHANDROID_CLIENT_SECRET
+    client_id: str = ANDROID_CLIENT_ID
+    client_secret: str = ANDROID_CLIENT_SECRET
     _: dataclasses.KW_ONLY
     base_url: str = "https://hh.ru/oauth"
     state: str = ""
@@ -181,7 +182,8 @@ class OAuthClient(BaseClient):
 
 @dataclass
 class ApiClient(BaseClient):
-    access_token: str
+    # Например, для просмотра информации о компании токен не нужен
+    access_token: str | None = None
     refresh_token: str | None = None
     _: dataclasses.KW_ONLY
     base_url: str = "https://api.hh.ru/"
@@ -196,7 +198,11 @@ class ApiClient(BaseClient):
     def additional_headers(
         self,
     ) -> dict[str, str]:
-        return {"Authorization": f"Bearer {self.access_token}"}
+        return (
+            {"Authorization": f"Bearer {self.access_token}"}
+            if self.access_token
+            else {}
+        )
 
     # def refresh_access(self) -> AccessToken:
     #     tok = self.oauth_client.refresh_access(self.refresh_token)

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

@@ -1,7 +1,7 @@
-#from copy import deepcopy
+# from copy import deepcopy
 from typing import Any
 
-from requests import Response, Request
+from requests import Request, Response
 from requests.adapters import CaseInsensitiveDict
 
 __all__ = (
@@ -20,7 +20,11 @@ class ApiError(Exception):
     def __init__(self, response: Response, data: dict[str, Any]) -> None:
         self._response = response
         self._raw = data
-    
+
+    @property
+    def data(self) -> dict:
+        return self._raw
+
     @property
     def request(self) -> Request:
         return self._response.request

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

@@ -1,8 +1,8 @@
 DEFAULT_USER_AGENT = "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/110.0.0.0 Safari/537.36"
-HHANDROID_CLIENT_ID = (
+ANDROID_CLIENT_ID = (
     "HIOMIAS39CA9DICTA7JIO64LQKQJF5AGIK74G9ITJKLNEDAOH5FHS5G1JI7FOEGD"
 )
-HHANDROID_CLIENT_SECRET = (
+ANDROID_CLIENT_SECRET = (
     "V9M870DE342BGHFRUJ5FTCGCUA1482AN0DI8C5TFI9ULMA89H10N60NOP8I4JMVS"
 )
 HHANDROID_SOCKET_PATH = "/tmp/hhandroid.sock"

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

@@ -8,7 +8,7 @@ from ..api import ApiClient, ApiError, BadRequest
 from ..main import BaseOperation
 from ..main import Namespace as BaseNamespace
 from ..types import ApiListResponse, VacancyItem
-from ..utils import truncate_string
+from ..utils import print_err, truncate_string
 
 logger = logging.getLogger(__package__)
 
@@ -74,8 +74,9 @@ class Operation(BaseOperation):
                 page=page,
                 per_page=per_page,
                 # Мне кажется, что так поисковая выдача можно забиться неадекватами, которые по полгода кого-то ищут
-                # order_by="relevance",
-                order_by="publication_time",
+                # Но так откликается на что-то уж совсем нерелевантное
+                # order_by="publication_time",
+                order_by="relevance",
             )
             rv.extend(res["items"])
             if page >= res["pages"] - 1:
@@ -117,7 +118,7 @@ class Operation(BaseOperation):
                     ")",
                 )
             except ApiError as ex:
-                logger.warning(ex)
+                print_err("❗ Ошибка:", ex)
                 if isinstance(ex, BadRequest) and ex.limit_exceeded:
                     break
         print("📝 Отклики на вакансии разосланы!")

{hh_applicant_tool-0.1.9 → hh_applicant_tool-0.2.1}/hh_applicant_tool/operations/call_api.py

@@ -1,11 +1,12 @@
 # Этот модуль можно использовать как образец для других
 import argparse
+import json
 import logging
+import sys
 
-from ..api import ApiClient
+from ..api import ApiClient, ApiError
 from ..main import BaseOperation
 from ..main import Namespace as BaseNamespace
-from ..utils import dumps
 
 logger = logging.getLogger(__package__)
 
@@ -14,6 +15,7 @@ class Namespace(BaseNamespace):
     method: str
     endpoint: str
     params: list[str]
+    pretty_print: bool
 
 
 class Operation(BaseOperation):
@@ -24,7 +26,7 @@ class Operation(BaseOperation):
         parser.add_argument(
             "param",
             nargs="*",
-            help="PARAM=VALUE. Значения можно оборачивать в кавычки.",
+            help="PARAM=VALUE",
             default=[],
         )
         parser.add_argument(
@@ -38,5 +40,9 @@ class Operation(BaseOperation):
             user_agent=args.config["user_agent"],
         )
         params = dict(x.split("=", 1) for x in args.param)
-        result = api.request(args.method, args.endpoint, params=params)
-        print(dumps(result))
+        try:
+            result = api.request(args.method, args.endpoint, params=params)
+            print(json.dumps(result, ensure_ascii=True))
+        except ApiError as ex:
+            json.dump(ex.data, sys.stderr, ensure_ascii=True)
+            return 1

{hh_applicant_tool-0.1.9 → hh_applicant_tool-0.2.1}/hh_applicant_tool/operations/clear_negotiations.py

@@ -8,7 +8,7 @@ from ..constants import INVALID_ISO8601_FORMAT
 from ..main import BaseOperation
 from ..main import Namespace as BaseNamespace
 from ..types import ApiListResponse
-from ..utils import truncate_string
+from ..utils import print_err, truncate_string
 
 logger = logging.getLogger(__package__)
 
@@ -100,6 +100,5 @@ class Operation(BaseOperation):
                             ")",
                         )
                     except ClientError as ex:
-                        logger.warning(ex)
-
+                        print_err("❗ Ошибка:", ex)
         print("🧹 Чистка заявок завершена!")

hh_applicant_tool-0.2.1/hh_applicant_tool/operations/refresh_token.py

@@ -0,0 +1,42 @@
+# Этот модуль можно использовать как образец для других
+import argparse
+import logging
+
+from ..api import ApiError, OAuthClient
+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):
+    """Получает новый access_token."""
+
+    def setup_parser(self, parser: argparse.ArgumentParser) -> None:
+        pass
+
+    def run(self, args: Namespace) -> None:
+        if (
+            not args.config["token"]
+            or not args.config["token"]["refresh_token"]
+        ):
+            print_err("❗ Необходим refresh_token!")
+            return 1
+        try:
+            oauth = OAuthClient(
+                user_agent=(
+                    args.config["oauth_user_agent"]
+                    or args.config["user_agent"]
+                ),
+            )
+            token = oauth.refresh_access(args.config["token"]["refresh_token"])
+            args.config.save(token=token)
+            print("✅ Токен обновлен!")
+        except ApiError as ex:
+            print_err("❗ Ошибка:", ex)
+            return 1

{hh_applicant_tool-0.1.9 → hh_applicant_tool-0.2.1}/hh_applicant_tool/operations/update_resumes.py

@@ -6,7 +6,7 @@ from ..api import ApiClient, ApiError
 from ..main import BaseOperation
 from ..main import Namespace as BaseNamespace
 from ..types import ApiListResponse
-from ..utils import truncate_string
+from ..utils import print_err, truncate_string
 
 logger = logging.getLogger(__package__)
 
@@ -34,4 +34,4 @@ class Operation(BaseOperation):
                 assert res == {}
                 print("✅ Обновлено", truncate_string(resume["title"]))
             except ApiError as ex:
-                logger.warning(ex)
+                print_err("❗ Ошибка:", ex)

{hh_applicant_tool-0.1.9 → hh_applicant_tool-0.2.1}/hh_applicant_tool/operations/whoami.py

@@ -1,11 +1,11 @@
 # Этот модуль можно использовать как образец для других
 import argparse
+import json
 import logging
 
 from ..api import ApiClient
 from ..main import BaseOperation
 from ..main import Namespace as BaseNamespace
-from ..utils import dumps
 
 logger = logging.getLogger(__package__)
 
@@ -27,4 +27,4 @@ class Operation(BaseOperation):
             user_agent=args.config["user_agent"],
         )
         result = api.get("/me")
-        print(dumps(result))
+        print(json.dumps(result, ensure_ascii=True, indent=2, sort_keys=True))

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

@@ -9,13 +9,6 @@ from typing import Any
 
 print_err = partial(print, file=sys.stderr)
 
-json_dump_kwargs = dict(
-    indent=2, ensure_ascii=False, sort_keys=True, default=str
-)
-
-dump = partial(json.dump, **json_dump_kwargs)
-dumps = partial(json.dumps, **json_dump_kwargs)
-
 
 class AttrDict(dict):
     __getattr__ = dict.get
@@ -43,8 +36,10 @@ class Config(dict):
         self.update(*args, **kwargs)
         self._config_path.parent.mkdir(exist_ok=True, parents=True)
         with self._lock:
-            with self._config_path.open("w+") as f:
-                dump(self, f)
+            with self._config_path.open("w+") as fp:
+                json.dump(
+                    self, fp, ensure_ascii=True, indent=2, sort_keys=True
+                )
 
     __getitem__ = dict.get
 

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

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