httpprobe-axx 0.1.0__tar.gz

httpprobe_axx-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Богдан
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

httpprobe_axx-0.1.0/PKG-INFO

@@ -0,0 +1,90 @@
+Metadata-Version: 2.4
+Name: httpprobe-axx
+Version: 0.1.0
+Summary: Учебный HTTP-клиент для white-hat: запросы и анализ заголовков безопасности
+Author: Богдан
+License-Expression: MIT
+Project-URL: Homepage, https://pypi.org/project/httpprobe-axx/
+Keywords: http,security,whitehat,education
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Classifier: Intended Audience :: Education
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.31
+Dynamic: license-file
+
+# httpprobe-axx
+
+Учебный HTTP-клиент для white-hat: запросы и анализ заголовков безопасности.
+
+⚠️ **Только для своих сайтов или с разрешения владельца.**
+Это образовательный проект, а не инструмент для атак.
+
+## Установка
+
+    pip install httpprobe-axx
+
+## Что умеет
+
+- `get(url)` — GET-запрос
+- `head(url)` — только заголовки
+- `status(url)` — код ответа (200, 404, ...)
+- `is_alive(url)` — отвечает ли сайт
+- `security_headers(url)` — какие защитные заголовки есть
+- `check_https(url)` — использует ли сайт HTTPS
+- `report(url)` — красивый текстовый отчёт
+
+## Пример
+
+    import httpprobe_axx as h
+
+    print(h.is_alive("https://example.com"))   # True
+    print(h.report("https://github.com"))
+
+Пример вывода:
+
+    === Отчёт по https://github.com ===
+
+    HTTPS: ✅ да
+    Итоговый URL: https://github.com/
+    Статус: 200
+    Ответ за: 280 мс
+
+    Заголовки безопасности:
+      ✅ Strict-Transport-Security
+      ✅ Content-Security-Policy
+      ✅ X-Frame-Options
+      ✅ X-Content-Type-Options
+      ✅ Referrer-Policy
+      ❌ Permissions-Policy
+          → Ограничение API браузера
+
+    Итог: 5/6 защитных заголовков присутствуют
+
+## Какие заголовки проверяются
+
+| Заголовок | Зачем |
+|---|---|
+| Strict-Transport-Security | Заставляет браузер использовать HTTPS |
+| Content-Security-Policy | Защита от XSS и инъекций |
+| X-Frame-Options | Защита от clickjacking |
+| X-Content-Type-Options | Запрет MIME-sniffing |
+| Referrer-Policy | Контроль утечки referrer |
+| Permissions-Policy | Ограничение API браузера |
+
+## Обработка ошибок
+
+    import httpprobe_axx as h
+
+    try:
+        r = h.get("https://несуществующий-сайт.рф")
+    except h.ProbeError as e:
+        print("Не получилось:", e)
+
+## Лицензия
+
+MIT — делай что хочешь, только укажи автора.
+
+Автор: Богдан, 12 лет.

httpprobe_axx-0.1.0/README.md

@@ -0,0 +1,73 @@
+# httpprobe-axx
+
+Учебный HTTP-клиент для white-hat: запросы и анализ заголовков безопасности.
+
+⚠️ **Только для своих сайтов или с разрешения владельца.**
+Это образовательный проект, а не инструмент для атак.
+
+## Установка
+
+    pip install httpprobe-axx
+
+## Что умеет
+
+- `get(url)` — GET-запрос
+- `head(url)` — только заголовки
+- `status(url)` — код ответа (200, 404, ...)
+- `is_alive(url)` — отвечает ли сайт
+- `security_headers(url)` — какие защитные заголовки есть
+- `check_https(url)` — использует ли сайт HTTPS
+- `report(url)` — красивый текстовый отчёт
+
+## Пример
+
+    import httpprobe_axx as h
+
+    print(h.is_alive("https://example.com"))   # True
+    print(h.report("https://github.com"))
+
+Пример вывода:
+
+    === Отчёт по https://github.com ===
+
+    HTTPS: ✅ да
+    Итоговый URL: https://github.com/
+    Статус: 200
+    Ответ за: 280 мс
+
+    Заголовки безопасности:
+      ✅ Strict-Transport-Security
+      ✅ Content-Security-Policy
+      ✅ X-Frame-Options
+      ✅ X-Content-Type-Options
+      ✅ Referrer-Policy
+      ❌ Permissions-Policy
+          → Ограничение API браузера
+
+    Итог: 5/6 защитных заголовков присутствуют
+
+## Какие заголовки проверяются
+
+| Заголовок | Зачем |
+|---|---|
+| Strict-Transport-Security | Заставляет браузер использовать HTTPS |
+| Content-Security-Policy | Защита от XSS и инъекций |
+| X-Frame-Options | Защита от clickjacking |
+| X-Content-Type-Options | Запрет MIME-sniffing |
+| Referrer-Policy | Контроль утечки referrer |
+| Permissions-Policy | Ограничение API браузера |
+
+## Обработка ошибок
+
+    import httpprobe_axx as h
+
+    try:
+        r = h.get("https://несуществующий-сайт.рф")
+    except h.ProbeError as e:
+        print("Не получилось:", e)
+
+## Лицензия
+
+MIT — делай что хочешь, только укажи автора.
+
+Автор: Богдан, 12 лет.

httpprobe_axx-0.1.0/httpprobe_axx/__init__.py

@@ -0,0 +1,9 @@
+"""httpprobe-axx — учебный HTTP-клиент для white-hat."""
+from .client import get, head, status, is_alive, Response, ProbeError
+from .analyze import security_headers, check_https, report
+
+__version__ = "0.1.0"
+__all__ = [
+    "get", "head", "status", "is_alive", "Response", "ProbeError",
+    "security_headers", "check_https", "report",
+]

httpprobe_axx-0.1.0/httpprobe_axx/analyze.py

@@ -0,0 +1,75 @@
+"""Анализ заголовков безопасности — фишка white-hat."""
+from __future__ import annotations
+from .client import head, ProbeError
+
+SECURITY_HEADERS = {
+    "Strict-Transport-Security": "Заставляет браузер использовать HTTPS",
+    "Content-Security-Policy":   "Защита от XSS и инъекций",
+    "X-Frame-Options":           "Защита от clickjacking",
+    "X-Content-Type-Options":    "Запрет MIME-sniffing",
+    "Referrer-Policy":           "Контроль утечки referrer",
+    "Permissions-Policy":        "Ограничение API браузера",
+}
+
+
+def security_headers(url: str) -> dict:
+    """Проверить, какие защитные заголовки есть, а каких нет."""
+    r = head(url)
+    return _analyze_headers(r.headers)
+
+
+def _analyze_headers(headers: dict) -> dict:
+    result = {}
+    for name, purpose in SECURITY_HEADERS.items():
+        value = next((v for k, v in headers.items() if k.lower() == name.lower()), None)
+        result[name] = {"present": value is not None, "value": value, "purpose": purpose}
+    return result
+
+
+def check_https(url: str) -> dict:
+    """Использует ли сайт HTTPS."""
+    if not url.startswith(("http://", "https://")):
+        url = "https://" + url
+    r = head(url)
+    return {
+        "requested": url,
+        "final_url": r.url,
+        "uses_https": r.url.startswith("https://"),
+        "status": r.status,
+    }
+
+
+def report(url: str) -> str:
+    """Красивый текстовый отчёт. Делает ОДИН запрос."""
+    if not url.startswith(("http://", "https://")):
+        url = "https://" + url
+
+    lines = [f"=== Отчёт по {url} ===", ""]
+
+    try:
+        r = head(url)
+    except ProbeError as e:
+        lines.append(f"❌ Не удалось подключиться: {e}")
+        return "\n".join(lines)
+
+    uses_https = r.url.startswith("https://")
+    lines.append(f"HTTPS: {'✅ да' if uses_https else '❌ нет'}")
+    lines.append(f"Итоговый URL: {r.url}")
+    lines.append(f"Статус: {r.status}")
+    lines.append(f"Ответ за: {r.elapsed_ms:.0f} мс")
+    lines.append("")
+    lines.append("Заголовки безопасности:")
+
+    found = 0
+    total = len(SECURITY_HEADERS)
+    for name, data in _analyze_headers(r.headers).items():
+        mark = "✅" if data["present"] else "❌"
+        if data["present"]:
+            found += 1
+        lines.append(f"  {mark} {name}")
+        if not data["present"]:
+            lines.append(f"      → {data['purpose']}")
+
+    lines.append("")
+    lines.append(f"Итог: {found}/{total} защитных заголовков присутствуют")
+    return "\n".join(lines)

httpprobe_axx-0.1.0/httpprobe_axx/client.py

@@ -0,0 +1,68 @@
+"""Базовые HTTP-запросы для httpprobe-axx."""
+from __future__ import annotations
+from dataclasses import dataclass
+import requests
+
+USER_AGENT = "httpprobe-axx/0.1.0 (educational; +https://pypi.org/project/httpprobe-axx/)"
+TIMEOUT = 10
+
+
+class ProbeError(Exception):
+    """Ошибка при запросе (сеть, таймаут, DNS)."""
+
+
+@dataclass
+class Response:
+    url: str
+    status: int
+    headers: dict
+    text: str
+    elapsed_ms: float
+
+    def is_ok(self) -> bool:
+        return 200 <= self.status < 300
+
+
+def _request(method: str, url: str, timeout: int) -> requests.Response:
+    if not url.startswith(("http://", "https://")):
+        url = "https://" + url
+    try:
+        return requests.request(
+            method, url,
+            headers={"User-Agent": USER_AGENT},
+            timeout=timeout,
+            allow_redirects=True,
+        )
+    except requests.Timeout as e:
+        raise ProbeError(f"Таймаут при подключении к {url}") from e
+    except requests.ConnectionError as e:
+        raise ProbeError(f"Не удалось подключиться к {url}") from e
+    except requests.RequestException as e:
+        raise ProbeError(f"Ошибка запроса: {e}") from e
+
+
+def get(url: str, *, timeout: int = TIMEOUT) -> Response:
+    """Сделать GET-запрос. Только для своих сайтов или с разрешения."""
+    r = _request("GET", url, timeout)
+    return Response(r.url, r.status_code, dict(r.headers), r.text,
+                    r.elapsed.total_seconds() * 1000)
+
+
+def head(url: str, *, timeout: int = TIMEOUT) -> Response:
+    """HEAD-запрос: только заголовки, без тела."""
+    r = _request("HEAD", url, timeout)
+    return Response(r.url, r.status_code, dict(r.headers), "",
+                    r.elapsed.total_seconds() * 1000)
+
+
+def status(url: str, *, timeout: int = TIMEOUT) -> int:
+    """Только код ответа (200, 404, ...)."""
+    return head(url, timeout=timeout).status
+
+
+def is_alive(url: str, *, timeout: int = TIMEOUT) -> bool:
+    """Отвечает ли сайт вообще."""
+    try:
+        return status(url, timeout=timeout) < 500
+    except ProbeError:
+        return False

httpprobe_axx-0.1.0/httpprobe_axx.egg-info/PKG-INFO

@@ -0,0 +1,90 @@
+Metadata-Version: 2.4
+Name: httpprobe-axx
+Version: 0.1.0
+Summary: Учебный HTTP-клиент для white-hat: запросы и анализ заголовков безопасности
+Author: Богдан
+License-Expression: MIT
+Project-URL: Homepage, https://pypi.org/project/httpprobe-axx/
+Keywords: http,security,whitehat,education
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Classifier: Intended Audience :: Education
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.31
+Dynamic: license-file
+
+# httpprobe-axx
+
+Учебный HTTP-клиент для white-hat: запросы и анализ заголовков безопасности.
+
+⚠️ **Только для своих сайтов или с разрешения владельца.**
+Это образовательный проект, а не инструмент для атак.
+
+## Установка
+
+    pip install httpprobe-axx
+
+## Что умеет
+
+- `get(url)` — GET-запрос
+- `head(url)` — только заголовки
+- `status(url)` — код ответа (200, 404, ...)
+- `is_alive(url)` — отвечает ли сайт
+- `security_headers(url)` — какие защитные заголовки есть
+- `check_https(url)` — использует ли сайт HTTPS
+- `report(url)` — красивый текстовый отчёт
+
+## Пример
+
+    import httpprobe_axx as h
+
+    print(h.is_alive("https://example.com"))   # True
+    print(h.report("https://github.com"))
+
+Пример вывода:
+
+    === Отчёт по https://github.com ===
+
+    HTTPS: ✅ да
+    Итоговый URL: https://github.com/
+    Статус: 200
+    Ответ за: 280 мс
+
+    Заголовки безопасности:
+      ✅ Strict-Transport-Security
+      ✅ Content-Security-Policy
+      ✅ X-Frame-Options
+      ✅ X-Content-Type-Options
+      ✅ Referrer-Policy
+      ❌ Permissions-Policy
+          → Ограничение API браузера
+
+    Итог: 5/6 защитных заголовков присутствуют
+
+## Какие заголовки проверяются
+
+| Заголовок | Зачем |
+|---|---|
+| Strict-Transport-Security | Заставляет браузер использовать HTTPS |
+| Content-Security-Policy | Защита от XSS и инъекций |
+| X-Frame-Options | Защита от clickjacking |
+| X-Content-Type-Options | Запрет MIME-sniffing |
+| Referrer-Policy | Контроль утечки referrer |
+| Permissions-Policy | Ограничение API браузера |
+
+## Обработка ошибок
+
+    import httpprobe_axx as h
+
+    try:
+        r = h.get("https://несуществующий-сайт.рф")
+    except h.ProbeError as e:
+        print("Не получилось:", e)
+
+## Лицензия
+
+MIT — делай что хочешь, только укажи автора.
+
+Автор: Богдан, 12 лет.

httpprobe_axx-0.1.0/httpprobe_axx.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+LICENSE
+README.md
+pyproject.toml
+httpprobe_axx/__init__.py
+httpprobe_axx/analyze.py
+httpprobe_axx/client.py
+httpprobe_axx.egg-info/PKG-INFO
+httpprobe_axx.egg-info/SOURCES.txt
+httpprobe_axx.egg-info/dependency_links.txt
+httpprobe_axx.egg-info/requires.txt
+httpprobe_axx.egg-info/top_level.txt

httpprobe_axx-0.1.0/httpprobe_axx.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

httpprobe_axx-0.1.0/httpprobe_axx.egg-info/requires.txt

@@ -0,0 +1 @@
+requests>=2.31

httpprobe_axx-0.1.0/httpprobe_axx.egg-info/top_level.txt

@@ -0,0 +1 @@
+httpprobe_axx

httpprobe_axx-0.1.0/pyproject.toml

@@ -0,0 +1,29 @@
+[build-system]
+requires = ["setuptools>=77", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "httpprobe-axx"
+version = "0.1.0"
+description = "Учебный HTTP-клиент для white-hat: запросы и анализ заголовков безопасности"
+readme = "README.md"
+requires-python = ">=3.9"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "Богдан" }]
+keywords = ["http", "security", "whitehat", "education"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Operating System :: OS Independent",
+    "Intended Audience :: Education",
+]
+dependencies = [
+    "requests>=2.31",
+]
+
+[project.urls]
+Homepage = "https://pypi.org/project/httpprobe-axx/"
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["httpprobe_axx*"]

httpprobe_axx-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+