Metadata-Version: 2.4
Name: securitycore
Version: 1.1.1
Summary: Modular library for analysis, data protection, and validation
License: MIT
License-File: LICENSE
Keywords: security,cryptography,validation,xss-protection,audit
Author: Mihhail327
Author-email: mixa-amr@hotmail.com
Requires-Python: >=3.13
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Requires-Dist: cryptography (>=46.0.5,<47.0.0)
Requires-Dist: pydantic (>=2.12.5,<3.0.0)
Project-URL: Homepage, https://github.com/Mihhail327/SecurityCore
Project-URL: Issues, https://github.com/Mihhail327/SecurityCore/issues
Project-URL: Repository, https://github.com/Mihhail327/SecurityCore
Description-Content-Type: text/markdown


---

# 🔐 SecurityCore

<p align="center">
<img src="https://img.shields.io/badge/Python-3.13+-blue?style=for-the-badge&logo=python&logoColor=white" alt="Python Version">
<img src="https://img.shields.io/badge/Poetry-Project-6366f1?style=for-the-badge&logo=poetry&logoColor=white" alt="Poetry">
<img src="https://img.shields.io/badge/License-MIT-green?style=for-the-badge" alt="License">
</p>

**SecurityCore** — это швейцарский нож для обеспечения безопасности ваших данных. Объединил продвинутый анализ энтропии, многоуровневую защиту от инъекций и строгую валидацию в один лаконичный SDK.

---

## 🛠 Ключевые возможности

| Модуль | Описание | Основные функции |
| --- | --- | --- |
| **🔑 Crypto** | Продвинутая криптография и анализ | `analyze_password`, `hash_data`, `generate_token` |
| **🛡️ Protection** | Защита от классических атак (OWASP) | `sanitize_xss`, `sanitize_sql_input`, `ensure_safe_path` |
| **✔️ Validation** | Строгая проверка типов и форматов | `validate_email`, `validate_ip`, `validate_url` |
| **📜 Audit** | Протоколирование для SIEM | `audit`, `audit_json` |

---

## 🚀 Быстрый старт

### 1. Установка

```bash
# Установка через pip
pip install securitycore

# Для разработки и контрибьютинга
git clone https://github.com/Mihhail327/SecurityCore.git
cd SecurityCore && poetry install

```

---

### 2. Примеры использования

#### 🧠 Анализ сложности (Энтропия)

> Не просто считает длину, а вычисляет реальную стойкость к брутфорсу.

```python
from securitycore import password_analyzer

res = password_analyzer("SuperSecret123!")
print(f"📊 Стойкость: {res['strength']} ({res['bits']:.2f} bits)")

```

#### 🧼 Очистка ввода (XSS/SQLi)

```python
from securitycore import input_sanitizer

raw_html = "<img src=x onerror=alert(1)> Привет!"
clean_html = input_sanitizer(raw_html)
# Результат: &lt;img src=x onerror=alert(1)&gt; Привет!

```

#### 🌐 Валидация сетевых данных

```python
from securitycore import validate_ip

ip = validate_ip("2001:db8::1") # Поддержка IPv6 из коробки

```

---

## 🧪 Надежность и Тестирование

Придерживаюсь подхода **Test-Driven Development**. Стабильность гарантирована полным покрытием `pytest`.

```bash
poetry run pytest -v

```

---

## 👨‍💻 Об авторе

Проект поддерживается **Mihhail327**.

Библиотека **SecurityCore** выросла из личного интереса к теме информационной безопасности и стремления создавать инструменты, которые делают код чище и защищеннее.

---

## 📜 Лицензия

Распространяется под лицензией **MIT**. Подробности в файле `LICENSE`.

---

