cryptoparser 1.0.0__tar.gz → 1.0.2__tar.gz

cryptoparser-1.0.2/.coveragerc

@@ -0,0 +1,11 @@
+[run]
+source = cryptoparser
+omit = cryptoparser/__setup__.py
+
+[report]
+exclude_lines =
+    pragma: no cover
+    raise NotImplementedError
+fail_under = 100
+include = cryptoparser/*
+show_missing = True

cryptoparser-1.0.2/.flake8

@@ -0,0 +1,2 @@
+[flake8]
+max-line-length = 120

cryptoparser-1.0.2/.gitignore

@@ -0,0 +1,17 @@
+*.orig
+*.rej
+
+*.swp
+
+*.pyc
+
+*.egg-info
+
+/.coverage
+
+/.eggs
+/.tox
+/Pipfile
+/Pipfile.lock
+/build
+/dist

cryptoparser-1.0.2/.gitlab-ci.yml

@@ -0,0 +1,101 @@
+image: python
+
+stages:
+- earlytest
+- fulltest
+- deploy
+
+before_script:
+- pip install tox .[tests]
+
+variables:
+  GIT_SUBMODULE_DEPTH: 1
+  GIT_SUBMODULE_STRATEGY: recursive
+  PYTHONPATH: "submodules/cryptodatahub"
+
+pylint:
+  image: python:3.14-slim
+  stage: earlytest
+  script: tox -e pylint
+
+pep8:
+  image: python:3.14-slim
+  stage: earlytest
+  script: tox -e pep8
+
+python314:
+  image: python:3.14-slim
+  stage: earlytest
+  script: tox -e py314
+
+python39:
+  image: python:3.9-slim
+  stage: fulltest
+  script: tox -e py39
+
+python310:
+  image: python:3.10-slim
+  stage: fulltest
+  script: tox -e py310
+
+python311:
+  image: python:3.11-slim
+  stage: fulltest
+  script: tox -e py311
+
+python312:
+  image: python:3.12-slim
+  stage: fulltest
+  script: tox -e py312
+
+python313:
+  image: python:3.13-slim
+  stage: fulltest
+  script: tox -e py313
+
+pythonrc:
+  image: python:3.15-rc-slim
+  stage: fulltest
+  script: tox -e py315
+
+pypy3:
+  image: pypy:3-slim
+  stage: fulltest
+  script: tox -e pypy3
+
+coveralls:
+  image: python:3.12-slim
+  variables:
+    CI_NAME: gitlab
+    CI_BUILD_NUMBER: "${CI_JOB_ID}"
+    CI_BUILD_URL: "${CI_JOB_URL}"
+    CI_BRANCH: "${CI_COMMIT_REF_NAME}"
+    GIT_SUBMODULE_DEPTH: 1
+    GIT_SUBMODULE_STRATEGY: recursive
+    PYTHONPATH: "submodules/cryptodatahub"
+  stage: deploy
+  script:
+    - pip install coveralls
+    - pip install .
+    - pip install .[tests]
+    - coverage run -m unittest -v -f
+    - coveralls
+  only:
+    refs:
+      - master
+
+obs:
+  image:
+    name: coroner/python_obs:1.0.0
+    pull_policy: always
+  stage: deploy
+  variables:
+    GIT_SUBMODULE_DEPTH: 1
+    GIT_SUBMODULE_STRATEGY: recursive
+  before_script: []
+  script:
+    - obs.sh
+  only:
+    refs:
+      - master
+      - tags

cryptoparser-1.0.2/.gitmodules

@@ -0,0 +1,3 @@
+[submodule "submodules/cryptodatahub"]
+	path = submodules/cryptodatahub
+	url = https://gitlab.com/coroner/cryptodatahub.git

cryptoparser-1.0.2/.pylintrc

@@ -0,0 +1,20 @@
+[MAIN]
+
+jobs=0
+
+[MASTER]
+
+load-plugins = pylint.extensions.no_self_use
+
+[FORMAT]
+
+max-line-length=120
+
+[MESSAGES CONTROL]
+
+disable=
+    missing-docstring,
+    too-few-public-methods,
+    too-many-function-args,
+    too-many-ancestors,
+    duplicate-code,

cryptoparser-1.0.2/.readthedocs.yaml

@@ -0,0 +1,17 @@
+version: 2
+
+sphinx:
+  configuration: docs/conf.py
+  builder: dirhtml
+
+build:
+  os: "ubuntu-22.04"
+  tools:
+    python: "3.10"
+
+python:
+  install:
+    - method: pip
+      path: .
+      extra_requirements:
+        - docs

{cryptoparser-1.0.0 → cryptoparser-1.0.2}/CHANGELOG.rst

@@ -2,6 +2,28 @@
 Changelog
 =========
 
+-------------------
+1.0.2 - 2025-12-30
+-------------------
+
+Notable fixes
+=============
+
+-  Generic
+
+   -  Purge submodules directory from distribution (#90)
+
+-------------------
+1.0.1 - 2025-12-07
+-------------------
+
+Refactor
+========
+
+-  Generic
+
+   -  Remove unnecessary dateutil dependency (#89)
+ 
 -------------------
 1.0.0 - 2025-01-05
 -------------------

{cryptoparser-1.0.0 → cryptoparser-1.0.2/CryptoParser.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: CryptoParser
-Version: 1.0.0
+Version: 1.0.2
 Summary: An analysis oriented security protocol parser and generator
 Author-email: Szilárd Pfeiffer <coroner@pfeifferszilard.hu>
 Maintainer-email: Szilárd Pfeiffer <coroner@pfeifferszilard.hu>
@@ -17,7 +17,6 @@ Classifier: Framework :: tox
 Classifier: Intended Audience :: Information Technology
 Classifier: Intended Audience :: Science/Research
 Classifier: Intended Audience :: System Administrators
-Classifier: License :: OSI Approved :: Mozilla Public License 2.0 (MPL 2.0)
 Classifier: Natural Language :: English
 Classifier: Operating System :: MacOS
 Classifier: Operating System :: Microsoft :: Windows
@@ -27,6 +26,7 @@ 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: Programming Language :: Python :: 3.14
 Classifier: Programming Language :: Python :: Implementation :: CPython
 Classifier: Programming Language :: Python :: Implementation :: PyPy
 Classifier: Programming Language :: Python
@@ -40,14 +40,14 @@ Description-Content-Type: text/x-rst
 License-File: LICENSE.txt
 Requires-Dist: asn1crypto
 Requires-Dist: attrs
-Requires-Dist: cryptodatahub==1.0.0
-Requires-Dist: python-dateutil
+Requires-Dist: cryptodatahub==1.0.2
 Requires-Dist: urllib3
 Provides-Extra: tests
 Requires-Dist: pyfakefs; extra == "tests"
 Provides-Extra: docs
 Requires-Dist: sphinx; extra == "docs"
 Requires-Dist: sphinx-sitemap; extra == "docs"
+Dynamic: license-file
 
 .. image:: https://gitlab.com/coroner/cryptoparser/badges/master/pipeline.svg
     :alt:  Pipeline

cryptoparser-1.0.2/CryptoParser.egg-info/SOURCES.txt

@@ -0,0 +1,105 @@
+.coveragerc
+.flake8
+.gitignore
+.gitlab-ci.yml
+.gitmodules
+.pylintrc
+.readthedocs.yaml
+CHANGELOG.rst
+CONTRIBUTING.rst
+LICENSE.txt
+MANIFEST.in
+README.rst
+pyproject.toml
+setup.py
+CryptoParser.egg-info/PKG-INFO
+CryptoParser.egg-info/SOURCES.txt
+CryptoParser.egg-info/dependency_links.txt
+CryptoParser.egg-info/requires.txt
+CryptoParser.egg-info/top_level.txt
+cryptoparser/__init__.py
+cryptoparser/__setup__.py
+cryptoparser/common/__init__.py
+cryptoparser/common/base.py
+cryptoparser/common/classes.py
+cryptoparser/common/exception.py
+cryptoparser/common/field.py
+cryptoparser/common/parse.py
+cryptoparser/common/utils.py
+cryptoparser/common/x509.py
+cryptoparser/dnsrec/__init__.py
+cryptoparser/dnsrec/record.py
+cryptoparser/dnsrec/txt.py
+cryptoparser/httpx/__init__.py
+cryptoparser/httpx/header.py
+cryptoparser/httpx/parse.py
+cryptoparser/httpx/version.py
+cryptoparser/ssh/__init__.py
+cryptoparser/ssh/key.py
+cryptoparser/ssh/record.py
+cryptoparser/ssh/subprotocol.py
+cryptoparser/ssh/version.py
+cryptoparser/tls/__init__.py
+cryptoparser/tls/algorithm.py
+cryptoparser/tls/ciphersuite.py
+cryptoparser/tls/extension.py
+cryptoparser/tls/grease.py
+cryptoparser/tls/ldap.py
+cryptoparser/tls/mysql.py
+cryptoparser/tls/openvpn.py
+cryptoparser/tls/postgresql.py
+cryptoparser/tls/rdp.py
+cryptoparser/tls/record.py
+cryptoparser/tls/subprotocol.py
+cryptoparser/tls/version.py
+docs/.gitignore
+docs/changelog.rst
+docs/conf.py
+docs/development.rst
+docs/features.rst
+docs/index.rst
+test/__init__.py
+test/common/__init__.py
+test/common/classes.py
+test/common/test_algorithm.py
+test/common/test_base.py
+test/common/test_classes.py
+test/common/test_exception.py
+test/common/test_field.py
+test/common/test_parse.py
+test/common/test_utils.py
+test/common/test_x509.py
+test/common/certs/ecc256.badssl.com.pem
+test/common/certs/rsa8192.badssl.com.pem
+test/common/certs/rsa8192.badssl.com_certificate.crt
+test/common/certs/rsa8192.badssl.com_root_ca.crt
+test/common/certs/snakeoil_cert.pem
+test/dnsrec/__init__.py
+test/dnsrec/test_record.py
+test/dnsrec/test_txt.py
+test/httpx/__init__.py
+test/httpx/classes.py
+test/httpx/test_header.py
+test/httpx/test_version.py
+test/ssh/__init__.py
+test/ssh/test_ciphersuites.py
+test/ssh/test_key.py
+test/ssh/test_record.py
+test/ssh/test_subprotocol.py
+test/ssh/test_version.py
+test/tls/__init__.py
+test/tls/classes.py
+test/tls/test_alert.py
+test/tls/test_application_data.py
+test/tls/test_change_cipher_spec.py
+test/tls/test_ciphersuite.py
+test/tls/test_extension.py
+test/tls/test_grease.py
+test/tls/test_handshake.py
+test/tls/test_ldap.py
+test/tls/test_mysql.py
+test/tls/test_openvpn.py
+test/tls/test_postgresql.py
+test/tls/test_rdp.py
+test/tls/test_record.py
+test/tls/test_version.py

{cryptoparser-1.0.0 → cryptoparser-1.0.2}/CryptoParser.egg-info/requires.txt

@@ -1,7 +1,6 @@
 asn1crypto
 attrs
-cryptodatahub==1.0.0
-python-dateutil
+cryptodatahub==1.0.2
 urllib3
 
 [docs]

{cryptoparser-1.0.0 → cryptoparser-1.0.2}/CryptoParser.egg-info/top_level.txt

@@ -1,4 +1,5 @@
 cryptoparser
+dist
 docs
 submodules
 test

cryptoparser-1.0.2/MANIFEST.in

@@ -0,0 +1,2 @@
+include *.rst
+prune submodules

{cryptoparser-1.0.0/CryptoParser.egg-info → cryptoparser-1.0.2}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: CryptoParser
-Version: 1.0.0
+Version: 1.0.2
 Summary: An analysis oriented security protocol parser and generator
 Author-email: Szilárd Pfeiffer <coroner@pfeifferszilard.hu>
 Maintainer-email: Szilárd Pfeiffer <coroner@pfeifferszilard.hu>
@@ -17,7 +17,6 @@ Classifier: Framework :: tox
 Classifier: Intended Audience :: Information Technology
 Classifier: Intended Audience :: Science/Research
 Classifier: Intended Audience :: System Administrators
-Classifier: License :: OSI Approved :: Mozilla Public License 2.0 (MPL 2.0)
 Classifier: Natural Language :: English
 Classifier: Operating System :: MacOS
 Classifier: Operating System :: Microsoft :: Windows
@@ -27,6 +26,7 @@ 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: Programming Language :: Python :: 3.14
 Classifier: Programming Language :: Python :: Implementation :: CPython
 Classifier: Programming Language :: Python :: Implementation :: PyPy
 Classifier: Programming Language :: Python
@@ -40,14 +40,14 @@ Description-Content-Type: text/x-rst
 License-File: LICENSE.txt
 Requires-Dist: asn1crypto
 Requires-Dist: attrs
-Requires-Dist: cryptodatahub==1.0.0
-Requires-Dist: python-dateutil
+Requires-Dist: cryptodatahub==1.0.2
 Requires-Dist: urllib3
 Provides-Extra: tests
 Requires-Dist: pyfakefs; extra == "tests"
 Provides-Extra: docs
 Requires-Dist: sphinx; extra == "docs"
 Requires-Dist: sphinx-sitemap; extra == "docs"
+Dynamic: license-file
 
 .. image:: https://gitlab.com/coroner/cryptoparser/badges/master/pipeline.svg
     :alt:  Pipeline

{cryptoparser-1.0.0 → cryptoparser-1.0.2}/cryptoparser/common/parse.py

@@ -9,10 +9,6 @@ import time
 
 import attr
 
-import dateutil
-import dateutil.parser
-import dateutil.tz
-
 from cryptodatahub.common.exception import InvalidValue
 from cryptodatahub.common.types import CryptoDataEnumBase, CryptoDataEnumCodedBase
 
@@ -466,9 +462,15 @@ class ParserText(ParserBase):
     def parse_date_time(self, name):
         try:
             value = self._parsable[self._parsed_length:]
-            date_time = dateutil.parser.parse(value.decode(self._encoding))
-        except ValueError as e:
-            raise InvalidValue(value, type(self), 'value') from e
+            value_str = value.decode(self._encoding)
+
+            date_time = datetime.datetime.strptime(value_str, '%a, %d %b %Y %H:%M:%S %z')
+        except ValueError:
+            try:
+                date_time = datetime.datetime.strptime(value_str, '%a, %d %b %Y %H:%M:%S GMT')
+                date_time = date_time.replace(tzinfo=datetime.timezone.utc)
+            except ValueError as e:
+                raise InvalidValue(value, type(self), 'value') from e
 
         self._parsed_values[name] = date_time
         self._parsed_length = len(self._parsable)
@@ -500,7 +502,7 @@ class ParserBinary(ParserBase):
             if milliseconds:
                 millis = value % 1000
                 value //= 1000
-            value = datetime.datetime.fromtimestamp(0x00000000ffffffff & value, dateutil.tz.UTC)
+            value = datetime.datetime.fromtimestamp(0x00000000ffffffff & value, datetime.timezone.utc)
             if milliseconds:
                 value += datetime.timedelta(milliseconds=millis)
             self._parsed_values[name] = value

{cryptoparser-1.0.0 → cryptoparser-1.0.2}/cryptoparser/tls/subprotocol.py

@@ -293,7 +293,7 @@ class TlsHandshakeHelloRandom(ParsableBase):
 
     @time.default
     def _default_time(self):  # pylint: disable=no-self-use
-        return datetime.datetime.utcnow()
+        return datetime.datetime.now(datetime.timezone.utc)
 
     @random.default
     def _default_random(self):  # pylint: disable=no-self-use
@@ -305,7 +305,7 @@ class TlsHandshakeHelloRandom(ParsableBase):
     def _parse(cls, parsable):
         parser = ParserBinary(parsable)
 
-        parser.parse_numeric('time', 4, datetime.datetime.utcfromtimestamp)
+        parser.parse_timestamp('time', item_size=4)
         parser.parse_parsable('random', TlsHandshakeHelloRandomBytes)
 
         return TlsHandshakeHelloRandom(parser['time'], parser['random']), parser.parsed_length

cryptoparser-1.0.2/docs/.gitignore

@@ -0,0 +1,2 @@
+_build
+html

cryptoparser-1.0.2/docs/changelog.rst

@@ -0,0 +1 @@
+.. include:: ../CHANGELOG.rst

cryptoparser-1.0.2/docs/development.rst

@@ -0,0 +1,11 @@
+-----------
+Development
+-----------
+
+If you want to setup a development environment, you are in need of `pipenv <https://docs.pipenv.org/>`__.
+
+.. code:: shell
+
+   $ cd cryptoparser
+   $ pipenv install --dev
+   $ pipenv shell

cryptoparser-1.0.2/docs/features.rst

@@ -0,0 +1,132 @@
+--------
+Features
+--------
+
+Supported Protocols
+===================
+
+Secure Shell (SSH)
+------------------
+
+-  `SSH 2.0 <https://tools.ietf.org/html/rfc4253>`__
+
+Secure Socket Layer (SSL)
+-------------------------
+
+-  `SSL 2.0 <https://tools.ietf.org/html/draft-hickman-netscape-ssl-00>`__
+-  `SSL 3.0 <https://tools.ietf.org/html/rfc6101>`__
+
+Transport Layer Security (TLS)
+------------------------------
+
+-  `TLS 1.0 <https://tools.ietf.org/html/rfc2246>`__
+-  `TLS 1.1 <https://tools.ietf.org/html/rfc4346>`__
+-  `TLS 1.2 <https://tools.ietf.org/html/rfc5246>`__
+-  `TLS 1.3 <https://tools.ietf.org/html/rfc8446>`__
+
+Domain Name System (DNS)
+------------------------
+
+-  `DNSSEC <https://www.rfc-editor.org/rfc/rfc4034>`__ (Domain Name System Security Extensions)
+
+Protocol Specific Features
+==========================
+
+Hypertext Transfer Protocol (HTTP)
+----------------------------------
+
+1. supports header wire format parsing
+2. supports detailed parsing of generic headers
+   (`Content-Type <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Content-Type>`__,
+   `NEL <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/NEL>`__ (Network Error Logging),
+   `Server <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Server>`__,
+   `Set-Cookie <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Set-Cookie>`__)
+3. supports detailed parsing of caching headers
+   (`Age <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Age>`__,
+   `Cache-Control <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Cache-Control>`__,
+   `Date <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Date>`__,
+   `ETag <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/ETag>`__,
+   `Expires <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Expires>`__,
+   `Last-Modified <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Last-Modified>`__,
+   `Pragma <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Pragma>`__)
+4. supports detailed parsing of security headers
+   (`Content Security Policy <https://developer.mozilla.org/en-US/docs/Web/HTTP/CSP>`__ (CSP),
+   `Content-Security-Policy-Report-Only <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Content-Security-Policy-Report-Only>`__,
+   `Expect-CT <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Expect-CT>`__,
+   `Expect-Staple <https://scotthelme.co.uk/designing-a-new-security-header-expect-staple>`__,
+   `HTTP Public Key Pinning <https://en.wikipedia.org/wiki/HTTP_Public_Key_Pinning>`__ (HPKP),
+   `Referrer-Policy <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Referrer-Policy>`__,
+   `Strict-Transport-Security <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Strict-Transport-Security>`__,
+   `X-Content-Type-Options <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/X-Content-Type-Options>`__,
+   `X-Frame-Options <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/X-Frame-Options>`__,
+   `X-XSS-Protection <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/X-XSS-Protection>`__)
+
+Transport Layer Security (TLS)
+------------------------------
+
+Only features that cannot be or difficultly implemented by some of the most popular SSL/TLS implementations (eg:
+`GnuTls <https://www.gnutls.org/>`__, `LibreSSL <https://www.libressl.org/>`__, `OpenSSL <https://www.openssl.org/>`__,
+`wolfSSL <https://www.wolfssl.com/>`__, ...) are listed.
+
+-  generic
+
+   1. supports
+      `Generate Random Extensions And Sustain Extensibility <https://tools.ietf.org/html/draft-ietf-tls-grease-04>`__
+      (GREASE) values for
+
+      -  protocol version
+      -  extension type
+      -  ciphers suite
+      -  signature algorithms
+      -  named group
+
+   2. supports easy
+      `JA3 fingerprint <https://engineering.salesforce.com/tls-fingerprinting-with-ja3-and-ja3s-247362855967>`__
+      generation
+
+-  protocol versions
+
+   1. support not only the final, but also draft versions
+
+-  cipher suites
+
+   1. supports each cipher suites discussed on `ciphersuite.info <https://ciphersuite.info>`__
+   2. supports `GOST <https://en.wikipedia.org/wiki/GOST>`__ (national standards of the Russian Federation and CIS
+      countries) cipher suites
+
+-  application layer
+
+   - supports TLS handshake-related `MySQL <https://en.wikipedia.org/wiki/MySQL>`__ messages
+   - supports TLS handshake-related `OpenVPN <https://en.wikipedia.org/wiki/OpenVPN>`__ messages
+   - supports TLS handshake-related `PostgreSQL <https://en.wikipedia.org/wiki/PostgreSQL>`__ messages
+   - supports TLS handshake-related `RDP <https://en.wikipedia.org/wiki/Remote_Desktop_Protocol`__ messages
+
+Secure Shell (SSH)
+------------------
+
+-  cipher suites
+
+   1. identifies as much encryption algorithms as possible (more than 200, compared to 70+ currently supported by
+      OpenSSH)
+   2. supports `HASSH fingerprint <https://engineering.salesforce.com/open-sourcing-hassh-abed3ae5044c/>`__ calculation
+
+-  public keys
+
+   1. supports host keys, cretificates (both ``V00`` and ``V01``), X.509 certificates and chains
+
+Domain Name System (DNS)
+------------------------
+
+-  e-mail authentication, reporting
+
+   -  `Domain-based Message Authentication, Reporting, and Conformance <https://www.rfc-editor.org/rfc/rfc7489>`__
+      (DMARC)
+   -  `Sender Policy Framework <https://www.rfc-editor.org/rfc/rfc7208>`__ (SPF)
+   -  `SMTP MTA Strict Transport Security <https://www.rfc-editor.org/rfc/rfc8461>`__ (MTA-STS)
+   -  `SMTP TLS Reporting <https://www.rfc-editor.org/rfc/rfc8460>`__ (TLSRPT)
+
+-  DNSSEC (Domain Name System Security Extensions)
+
+   -  `DNSKEY <https://www.rfc-editor.org/rfc/rfc4034#section-2>`__
+   -  `DS <https://www.rfc-editor.org/rfc/rfc4034#section-5>`__
+   -  `RRSIG <https://www.rfc-editor.org/rfc/rfc4034#section-3>`__

cryptoparser-1.0.2/docs/index.rst

@@ -0,0 +1,54 @@
+.. meta::
+    :google-site-verification:
+        2AAgZNptPaMHxDeXJegA8i8aW1jURVBpQseacnHQr8Q
+
+.. meta::
+    :description:
+        An analysis oriented security protocol parser and generator
+
+.. meta::
+    :keywords:
+        cryptoparser,cryptolyzer,cryptography,cryptographic algorithms,tls handdhake,ssl handdhake,ssh handdhake,
+        starttls,opportunistic tls,ssh host keys,ssh host certificates,http caching headers,http security header,
+        dnssec records,email authentication
+
+.. meta::
+    :author:
+        Szilárd Pfeiffer
+
+=======
+Summary
+=======
+
+.. include:: ../README.rst
+
+=======
+Details
+=======
+
+The main purpose of creating this library is the fact, that cryptography protocol analysis differs in many aspect from
+establishing a connection using a cryptographic protocol. Analysis is mostly testing where we trigger special and corner
+cases of the protocol and we also trying to establish connection with hardly supported, experimental, obsoleted or even
+deprecated mechanisms or algorithms which are may or may not supported by the latest or any version of an implementation
+of the cryptographic protocol.
+
+One the one hand it is neither a comprehensive nor a secure implementation of any cryptographic protocol. On the one
+hand library implements only the absolutely necessary parts of the protocol. On the other it contains completely insecure
+algorithms and mechanisms. It is not designed and contraindicated to use this library establishing secure connections.
+If you are searching for cryptographic protocol implementation, there are several existing wrappers and native
+implementations for Python (eg: M2Crypto, pyOpenSSL, Paramiko, ...).
+
+.. toctree::
+    :maxdepth: 3
+
+    features
+    development
+
+=======
+History
+=======
+
+.. toctree::
+    :maxdepth: 2
+
+    changelog