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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: hh-applicant-tool
-Version: 0.5.9
+Version: 0.6.0
 Summary: 
 Author: Senior YAML Developer
 Author-email: yamldeveloper@proton.me
@@ -30,11 +30,6 @@ 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
@@ -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.9 → hh_applicant_tool-0.6.0}/README.md

@@ -11,11 +11,6 @@
   <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
@@ -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.9 → hh_applicant_tool-0.6.0}/hh_applicant_tool/main.py

@@ -11,9 +11,8 @@ from typing import Literal, Sequence
 
 from .api import ApiClient
 from .color_log import ColorHandler
-from .utils import Config, get_config_path
 from .telemetry_client import TelemetryClient
-
+from .utils import Config, get_config_path
 
 DEFAULT_CONFIG_PATH = (
     get_config_path() / (__package__ or "").replace("_", "-") / "config.json"

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.9 → hh_applicant_tool-0.6.0}/pyproject.toml

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

hh_applicant_tool-0.5.9/hh_applicant_tool/operations/get_employer_contacts.py

@@ -1,87 +0,0 @@
-import argparse
-import logging
-from os import getenv
-
-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 = 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, _, telemetry_client: TelemetryClient) -> None:
-        results = telemetry_client.get_telemetry(
-            "/contact/persons",
-            {"search": args.search, "per_page": 10, "page": args.page},
-        )
-        if "contact_persons" not in results:
-            print("❌", results)
-            return 1
-
-        print(
-            "Тут отображаются только данные, собранные с вашего telemetry_client_id. Вы так же можете их удалить с помощью команды delete-telemetry."
-        )
-        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} 🧑 {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)