cyinfo 1.0.0__tar.gz

cyinfo-1.0.0/LICENSE.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 sripa
+
+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.

cyinfo-1.0.0/PKG-INFO

@@ -0,0 +1,196 @@
+Metadata-Version: 2.4
+Name: cyinfo
+Version: 1.0.0
+Summary: A comprehensive network security toolkit — SSL/TLS analysis, certificate inspection, vulnerability scanning, and deep HTTP/TLS probing via pycurl.
+Author: sripa
+Project-URL: Homepage, https://github.com/sripa/cyinfo
+Project-URL: Documentation, https://github.com/sripa/cyinfo#readme
+Project-URL: Repository, https://github.com/sripa/cyinfo
+Project-URL: Issues, https://github.com/sripa/cyinfo/issues
+Keywords: cybersecurity,ssl,tls,certificate,scanner,vulnerability,network,pycurl,security,pentest
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Information Technology
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Security
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: System :: Networking
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.28.0
+Requires-Dist: dnspython>=2.3.0
+Requires-Dist: pyOpenSSL>=23.0.0
+Requires-Dist: pycurl>=7.45.0
+Provides-Extra: jks
+Requires-Dist: pyjks>=20.0.0; extra == "jks"
+Provides-Extra: all
+Requires-Dist: pyjks>=20.0.0; extra == "all"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0; extra == "dev"
+Requires-Dist: build>=0.10; extra == "dev"
+Requires-Dist: twine>=4.0; extra == "dev"
+
+# CyInfo
+
+A comprehensive Python network security toolkit for SSL/TLS analysis, certificate inspection, vulnerability scanning, and deep HTTP/TLS probing.
+
+[![PyPI version](https://badge.fury.io/py/cyinfo.svg)](https://pypi.org/project/cyinfo/)
+[![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+---
+
+## Features
+
+### 🔍 Network Scanner (`cyinfo.scanner`)
+Three-tier scanning with increasing depth:
+
+| Level | Method | What it does |
+|-------|--------|-------------|
+| **Basic** | `basic_scan(target)` | IP resolution, DNS records (A/AAAA/MX/NS/TXT/CNAME/SOA), geolocation, HTTP status, reverse DNS |
+| **Medium** | `medium_scan(target)` | SSL certificate details, TLS version, cipher suite, security headers grading, port scan with banner grabbing |
+| **Advanced** | `advanced_scan(target)` | SSL handshake breakdown, encryption algorithms, PFS analysis, full certificate chain via pyOpenSSL |
+| **Full** | `full_scan(target)` | Runs all three levels |
+
+### 🔐 Certificate Analyzer (`cyinfo.cert_analyzer`)
+Deep certificate and keystore inspection:
+
+- **`analyze_certificate(path)`** — Parse any cert format (PEM, DER, CRT, CER, P7B). Extracts: type/usage, subject, issuer, dates, fingerprints (SHA-256/SHA-1/MD5), crypto suite, key usage, SANs, extensions, and more.
+- **`analyze_keystore(path, password)`** — Parse PKCS12/PFX and JKS keystores. Extracts private key info, certificate chain, and all cert details.
+- **`test_ssl_with_private_key(key, cert, port)`** — Bind a private key to a socket and test all TLS versions with 20-field handshake detail extraction.
+
+### 🌐 PyCurl Inspector (`cyinfo.pycurl_inspector`)
+Low-level HTTP/TLS analysis using only pycurl — **17 parameters tested**:
+
+TLS handshake • Certificate chain & fingerprints • TLS version probing (1.0–1.3) • HTTP response & timing breakdown • HTTP/2 & HTTP/3/QUIC detection • Redirect chain tracing • Compression support • Cookie inspection • Security headers (10 checks) • Server/CDN/WAF fingerprinting • SSH banner & key exchange • Keep-alive behavior
+
+---
+
+## Installation
+
+> [!IMPORTANT]
+> Please ensure you are using a **64-bit version of Python**. If you attempt to install on 32-bit Python, the installation will be blocked.
+
+```bash
+pip install cyinfo
+```
+
+With JKS keystore support:
+```bash
+pip install cyinfo[jks]
+```
+
+For development:
+```bash
+pip install cyinfo[dev]
+```
+
+---
+
+## Quick Start
+
+### Python API
+
+```python
+from cyinfo import basic_scan, medium_scan, advanced_scan
+
+# Level 1 — Basic recon
+result = basic_scan("example.com")
+print(result['ip_info']['resolved_ip'])
+print(result['geolocation']['country'])
+
+# Level 2 — Medium analysis
+result = medium_scan("example.com")
+print(result['ssl_tls_info']['tls_version'])
+print(result['security_headers_analysis']['grade'])
+
+# Level 3 — Advanced SSL deep dive
+result = advanced_scan("example.com")
+print(result['encryption_details']['key_exchange'])
+print(result['forward_secrecy']['supported'])
+```
+
+```python
+from cyinfo import analyze_certificate, analyze_keystore
+
+# Analyze any certificate
+cert = analyze_certificate("server.crt")
+print(cert['certificates'][0]['validity']['days_remaining'])
+
+# Parse a PKCS12 keystore
+ks = analyze_keystore("keystore.p12", "password123")
+print(ks['private_key_info']['bits'])
+```
+
+```python
+from cyinfo import pycurl_deep_inspect
+
+# Full 17-parameter inspection
+result = pycurl_deep_inspect("https://example.com")
+print(result['4_tls_version_support']['supported_versions'])
+print(result['13_security_headers']['grade'])
+print(result['15_ssh_info']['banner'])
+```
+
+### CLI
+
+```bash
+# Interactive scanner
+cyinfo scan
+
+# Quick commands
+cyinfo scan --target example.com --level basic
+cyinfo scan --target example.com --level full
+cyinfo cert --file server.crt
+cyinfo inspect --url https://example.com
+```
+
+---
+
+## Project Structure
+
+```
+cyinfo/
+├── pyproject.toml          # Package metadata & dependencies
+├── README.md
+├── LICENSE
+├── src/
+│   └── cyinfo/
+│       ├── __init__.py     # Public API exports
+│       ├── cli.py          # CLI entry point
+│       ├── scanner.py      # 3-tier network scanner
+│       ├── cert_analyzer.py # Certificate & keystore analyzer
+│       └── pycurl_inspector.py # PyCurl deep inspector
+└── tests/
+    ├── __init__.py
+    └── test_basic.py
+```
+
+---
+
+## Requirements
+
+- **Python 3.9+ (64-bit strictly required)**
+- `requests` — HTTP requests
+- `dnspython` — DNS resolution
+- `pyOpenSSL` — Certificate chain analysis
+- `pycurl` — Low-level HTTP/TLS probing
+
+> [!WARNING]
+> **64-bit Python Required:** Because this toolkit relies on advanced cryptographic libraries (`cryptography`, `twofish`), **you must use a 64-bit version of Python**. 32-bit Python will fail to install due to missing pre-compiled binaries.
+
+---
+
+## License
+
+MIT License — see [LICENSE](LICENSE) for details.

cyinfo-1.0.0/README.md

@@ -0,0 +1,154 @@
+# CyInfo
+
+A comprehensive Python network security toolkit for SSL/TLS analysis, certificate inspection, vulnerability scanning, and deep HTTP/TLS probing.
+
+[![PyPI version](https://badge.fury.io/py/cyinfo.svg)](https://pypi.org/project/cyinfo/)
+[![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+---
+
+## Features
+
+### 🔍 Network Scanner (`cyinfo.scanner`)
+Three-tier scanning with increasing depth:
+
+| Level | Method | What it does |
+|-------|--------|-------------|
+| **Basic** | `basic_scan(target)` | IP resolution, DNS records (A/AAAA/MX/NS/TXT/CNAME/SOA), geolocation, HTTP status, reverse DNS |
+| **Medium** | `medium_scan(target)` | SSL certificate details, TLS version, cipher suite, security headers grading, port scan with banner grabbing |
+| **Advanced** | `advanced_scan(target)` | SSL handshake breakdown, encryption algorithms, PFS analysis, full certificate chain via pyOpenSSL |
+| **Full** | `full_scan(target)` | Runs all three levels |
+
+### 🔐 Certificate Analyzer (`cyinfo.cert_analyzer`)
+Deep certificate and keystore inspection:
+
+- **`analyze_certificate(path)`** — Parse any cert format (PEM, DER, CRT, CER, P7B). Extracts: type/usage, subject, issuer, dates, fingerprints (SHA-256/SHA-1/MD5), crypto suite, key usage, SANs, extensions, and more.
+- **`analyze_keystore(path, password)`** — Parse PKCS12/PFX and JKS keystores. Extracts private key info, certificate chain, and all cert details.
+- **`test_ssl_with_private_key(key, cert, port)`** — Bind a private key to a socket and test all TLS versions with 20-field handshake detail extraction.
+
+### 🌐 PyCurl Inspector (`cyinfo.pycurl_inspector`)
+Low-level HTTP/TLS analysis using only pycurl — **17 parameters tested**:
+
+TLS handshake • Certificate chain & fingerprints • TLS version probing (1.0–1.3) • HTTP response & timing breakdown • HTTP/2 & HTTP/3/QUIC detection • Redirect chain tracing • Compression support • Cookie inspection • Security headers (10 checks) • Server/CDN/WAF fingerprinting • SSH banner & key exchange • Keep-alive behavior
+
+---
+
+## Installation
+
+> [!IMPORTANT]
+> Please ensure you are using a **64-bit version of Python**. If you attempt to install on 32-bit Python, the installation will be blocked.
+
+```bash
+pip install cyinfo
+```
+
+With JKS keystore support:
+```bash
+pip install cyinfo[jks]
+```
+
+For development:
+```bash
+pip install cyinfo[dev]
+```
+
+---
+
+## Quick Start
+
+### Python API
+
+```python
+from cyinfo import basic_scan, medium_scan, advanced_scan
+
+# Level 1 — Basic recon
+result = basic_scan("example.com")
+print(result['ip_info']['resolved_ip'])
+print(result['geolocation']['country'])
+
+# Level 2 — Medium analysis
+result = medium_scan("example.com")
+print(result['ssl_tls_info']['tls_version'])
+print(result['security_headers_analysis']['grade'])
+
+# Level 3 — Advanced SSL deep dive
+result = advanced_scan("example.com")
+print(result['encryption_details']['key_exchange'])
+print(result['forward_secrecy']['supported'])
+```
+
+```python
+from cyinfo import analyze_certificate, analyze_keystore
+
+# Analyze any certificate
+cert = analyze_certificate("server.crt")
+print(cert['certificates'][0]['validity']['days_remaining'])
+
+# Parse a PKCS12 keystore
+ks = analyze_keystore("keystore.p12", "password123")
+print(ks['private_key_info']['bits'])
+```
+
+```python
+from cyinfo import pycurl_deep_inspect
+
+# Full 17-parameter inspection
+result = pycurl_deep_inspect("https://example.com")
+print(result['4_tls_version_support']['supported_versions'])
+print(result['13_security_headers']['grade'])
+print(result['15_ssh_info']['banner'])
+```
+
+### CLI
+
+```bash
+# Interactive scanner
+cyinfo scan
+
+# Quick commands
+cyinfo scan --target example.com --level basic
+cyinfo scan --target example.com --level full
+cyinfo cert --file server.crt
+cyinfo inspect --url https://example.com
+```
+
+---
+
+## Project Structure
+
+```
+cyinfo/
+├── pyproject.toml          # Package metadata & dependencies
+├── README.md
+├── LICENSE
+├── src/
+│   └── cyinfo/
+│       ├── __init__.py     # Public API exports
+│       ├── cli.py          # CLI entry point
+│       ├── scanner.py      # 3-tier network scanner
+│       ├── cert_analyzer.py # Certificate & keystore analyzer
+│       └── pycurl_inspector.py # PyCurl deep inspector
+└── tests/
+    ├── __init__.py
+    └── test_basic.py
+```
+
+---
+
+## Requirements
+
+- **Python 3.9+ (64-bit strictly required)**
+- `requests` — HTTP requests
+- `dnspython` — DNS resolution
+- `pyOpenSSL` — Certificate chain analysis
+- `pycurl` — Low-level HTTP/TLS probing
+
+> [!WARNING]
+> **64-bit Python Required:** Because this toolkit relies on advanced cryptographic libraries (`cryptography`, `twofish`), **you must use a 64-bit version of Python**. 32-bit Python will fail to install due to missing pre-compiled binaries.
+
+---
+
+## License
+
+MIT License — see [LICENSE](LICENSE) for details.

cyinfo-1.0.0/pyproject.toml

@@ -0,0 +1,82 @@
+[build-system]
+requires = ["setuptools>=68.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "cyinfo"
+version = "1.0.0"
+description = "A comprehensive network security toolkit — SSL/TLS analysis, certificate inspection, vulnerability scanning, and deep HTTP/TLS probing via pycurl."
+readme = "README.md"
+requires-python = ">=3.9"
+authors = [
+    {name = "sripa"},
+]
+keywords = [
+    "cybersecurity",
+    "ssl",
+    "tls",
+    "certificate",
+    "scanner",
+    "vulnerability",
+    "network",
+    "pycurl",
+    "security",
+    "pentest",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Intended Audience :: Information Technology",
+    "Intended Audience :: System Administrators",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Security",
+    "Topic :: Internet :: WWW/HTTP",
+    "Topic :: System :: Networking",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+dependencies = [
+    "requests>=2.28.0",
+    "dnspython>=2.3.0",
+    "pyOpenSSL>=23.0.0",
+    "pycurl>=7.45.0",
+]
+
+[project.optional-dependencies]
+jks = ["pyjks>=20.0.0"]
+all = [
+    "pyjks>=20.0.0",
+]
+dev = [
+    "pytest>=7.0",
+    "pytest-cov>=4.0",
+    "build>=0.10",
+    "twine>=4.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/sripa/cyinfo"
+Documentation = "https://github.com/sripa/cyinfo#readme"
+Repository = "https://github.com/sripa/cyinfo"
+Issues = "https://github.com/sripa/cyinfo/issues"
+
+[project.scripts]
+cyinfo = "cyinfo.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+cyinfo = ["py.typed"]
+
+[tool.setuptools]
+license-files = []
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["src"]

cyinfo-1.0.0/setup.cfg

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

cyinfo-1.0.0/setup.py

@@ -0,0 +1,23 @@
+import sys
+from setuptools import setup
+
+# Ensure 64-bit Python to prevent massive C++ compilation errors 
+# from cryptography/twofish on 32-bit systems
+if sys.maxsize <= 2**32:
+    sys.exit(
+        "\n" + "=" * 70 + "\n"
+        "ERROR: CyInfo strictly requires a 64-bit Python interpreter!\n"
+        "You are currently using a 32-bit Python version.\n\n"
+        "Please install a 64-bit version of Python, and then install this package.\n"
+        + "=" * 70 + "\n"
+    )
+
+with open("README.md", "r", encoding="utf-8") as fh:
+    long_description = fh.read()
+
+setup(
+    name="cyinfo",
+    version="1.0.0",
+    long_description=long_description,
+    long_description_content_type="text/markdown"
+)

cyinfo-1.0.0/src/cyinfo/__init__.py

@@ -0,0 +1,69 @@
+"""
+CyInfo — Comprehensive Network Security Toolkit
+
+Modules:
+    scanner          — Three-tier network scanning (basic, medium, advanced)
+    cert_analyzer    — Certificate & keystore analysis with handshake testing
+    pycurl_inspector — Low-level HTTP/TLS probing via pycurl (17 parameters)
+"""
+
+__version__ = "1.0.0"
+__author__ = "sripa"
+
+import sys
+if sys.maxsize <= 2**32:
+    sys.exit(
+        "\n======================================================================\n"
+        "[ERROR] CyInfo strictly requires a 64-bit Python interpreter!\n"
+        "You are currently using a 32-bit Python version.\n"
+        "Please install a 64-bit version of Python and try again.\n"
+        "======================================================================\n"
+    )
+
+# ── Scanner — 3-tier network reconnaissance ──
+from cyinfo.scanner import (
+    basic_scan,
+    medium_scan,
+    advanced_scan,
+    full_scan,
+)
+
+# ── Certificate Analyzer — cert & keystore inspection ──
+from cyinfo.cert_analyzer import (
+    analyze_certificate,
+    analyze_keystore,
+    test_ssl_with_private_key,
+)
+
+# ── PyCurl Inspector — low-level HTTP/TLS probing ──
+from cyinfo.pycurl_inspector import (
+    pycurl_deep_inspect,
+    pycurl_tls_handshake,
+    pycurl_cert_chain,
+    pycurl_tls_versions,
+    pycurl_security_headers,
+    pycurl_ssh_info,
+    pycurl_timing,
+)
+
+__all__ = [
+    # Version
+    "__version__",
+    # Scanner
+    "basic_scan",
+    "medium_scan",
+    "advanced_scan",
+    "full_scan",
+    # Certificate Analyzer
+    "analyze_certificate",
+    "analyze_keystore",
+    "test_ssl_with_private_key",
+    # PyCurl Inspector
+    "pycurl_deep_inspect",
+    "pycurl_tls_handshake",
+    "pycurl_cert_chain",
+    "pycurl_tls_versions",
+    "pycurl_security_headers",
+    "pycurl_ssh_info",
+    "pycurl_timing",
+]