Skip to content

Commit 1e98f48

Browse files
committed
all: Refactored restructured text docs accordingto the Python Style Guide
1 parent b6c2a81 commit 1e98f48

File tree

3 files changed

+38
-36
lines changed

3 files changed

+38
-36
lines changed

CHANGELOG.rst

Lines changed: 20 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,9 @@
1+
=========
12
Changelog
23
=========
34

45
Features
5-
^^^^^^^^
6+
--------
67

78
* HTTP(S) (``http``)
89

@@ -53,10 +54,10 @@ Features
5354
.. _v0-5-0:
5455

5556
0.5.0 - 2021-04-08
56-
------------------
57+
==================
5758

5859
Features
59-
^^^^^^^^
60+
--------
6061

6162
* Generic
6263

@@ -75,7 +76,7 @@ Features
7576
* add `algorithm negotiation <https://tools.ietf.org/html/rfc4253#section-7.1>`_ related messages (#21)
7677

7778
Usability
78-
^^^^^^^^^
79+
---------
7980

8081
* Generic
8182

@@ -86,10 +87,10 @@ Usability
8687
.. _v0-4-0:
8788

8889
0.4.0 - 2021-01-30
89-
------------------
90+
==================
9091

9192
Features
92-
^^^^^^^^
93+
--------
9394

9495
* TLS (``tls``)
9596

@@ -102,7 +103,7 @@ Features
102103
* add `client public key request <https://tools.ietf.org/html/rfc2246#section-7.4.4>`_ related messages (#24)
103104

104105
Improvements
105-
^^^^^^^^^^^^
106+
------------
106107

107108
* Generic
108109

@@ -111,17 +112,17 @@ Improvements
111112
.. _v0-3-1:
112113

113114
0.3.1 - 2020-09-15
114-
------------------
115+
==================
115116

116117
Features
117-
^^^^^^^^
118+
--------
118119

119120
* Generic
120121

121122
* `Markdown <https://en.wikipedia.org/wiki/Markdown>`_ serializable format (#19)
122123

123124
Improvements
124-
^^^^^^^^^^^^
125+
------------
125126

126127
* TLS (``tls``)
127128

@@ -137,7 +138,7 @@ Improvements
137138
* add missing SSLv3 cipher suites (#15)
138139

139140
Notable fixes
140-
^^^^^^^^^^^^^
141+
-------------
141142

142143
* Generic
143144

@@ -152,10 +153,10 @@ Notable fixes
152153
.. _v0-3-0:
153154

154155
0.3.0 - 2020-04-30
155-
------------------
156+
==================
156157

157158
Features
158-
^^^^^^^^
159+
--------
159160

160161
* TLS (``tls``)
161162

@@ -171,28 +172,28 @@ Bugs
171172
* compose all the messages in case of a TLS record (#1)
172173

173174
Refactor
174-
^^^^^^^^
175+
--------
175176

176177
* use attrs to avoid boilerplates (#3)
177178

178179
.. _v0-2-0:
179180

180181
0.2.0 - 2019-12-02
181-
------------------
182+
==================
182183

183184
Notable fixes
184-
^^^^^^^^^^^^^
185+
-------------
185186

186187
* clarify TLS related parameter names
187188
* several packaging fixes
188189

189190
.. _v0-1-0:
190191

191192
0.1.0 - 2019-03-20
192-
------------------
193+
==================
193194

194195
Features
195-
^^^^^^^^
196+
--------
196197

197198
* added TLS record protocol support
198199
* added TLS ChangeCipherSpec message support
@@ -202,7 +203,7 @@ Features
202203
* added SSL support
203204

204205
Improvements
205-
^^^^^^^^^^^^
206+
------------
206207

207208
* added serialization support for classes
208209
* added elliptic-curve related descriptive classes
File renamed without changes.

README.rst

Lines changed: 18 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,9 @@
1+
============
12
CryptoParser
23
============
34

45
What is it and what is it not?
5-
------------------------------
6+
==============================
67

78
As the project name CryptoParser implies, it is a cryptographic protocol parser. The main purpose of creating this
89
library is the fact, that cryptography protocol analysis differs in many aspect from establishing a connection using a
@@ -18,7 +19,7 @@ If you are searching for cryptographic protocol implementation, there are severa
1819
implementations for Python (eg: M2Crypto, pyOpenSSL, Paramiko, ...).
1920

2021
Quick start
21-
-----------
22+
===========
2223

2324
CryptoParser can be installed directly via pip:
2425

@@ -27,7 +28,7 @@ CryptoParser can be installed directly via pip:
2728
pip install cryptoparser
2829

2930
Development environment
30-
-----------------------
31+
=======================
3132

3233
If you want to setup a development environment, you are in need of `pipenv <https://docs.pipenv.org/>`_.
3334

@@ -39,10 +40,10 @@ If you want to setup a development environment, you are in need of `pipenv <http
3940

4041

4142
Features
42-
--------
43+
========
4344

4445
Protocols
45-
^^^^^^^^^
46+
---------
4647

4748
* Secure Shell (SSH)
4849

@@ -61,26 +62,26 @@ Protocols
6162
* `TLS 1.3 <https://tools.ietf.org/html/rfc8446>`_
6263

6364
Python implementation
64-
^^^^^^^^^^^^^^^^^^^^^
65+
---------------------
6566

6667
* CPython (2.7, >=3.3)
6768
* PyPy (2.7, 3.5)
6869

6970
Operating systems
70-
^^^^^^^^^^^^^^^^^
71+
-----------------
7172

7273
* Linux
7374
* macOS
7475
* Windows
7576

7677
Protocol Specific Features
77-
--------------------------
78+
==========================
7879

7980
Hypertext Transfer Protocol (HTTP)
80-
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
81+
----------------------------------
8182

8283
Headers
83-
"""""""
84+
^^^^^^^
8485

8586
#. supports header wire format parsing
8687
#. supports detailed parsing of generic headers (\
@@ -103,14 +104,14 @@ Headers
103104
`X-Frame-Options <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/X-Frame-Options>`_)
104105

105106
Transport Layer Security (TLS)
106-
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
107+
------------------------------
107108

108109
Only features that cannot be or difficultly implemented by some of the most popular SSL/TLS implementations (eg:
109110
`GnuTls <https://www.gnutls.org/>`_, `LibreSSL <https://www.libressl.org/>`_, `OpenSSL <https://www.openssl.org/>`_,
110111
`wolfSSL <https://www.wolfssl.com/>`_, ...) are listed.
111112

112113
Generic
113-
"""""""
114+
^^^^^^^
114115

115116
#. supports `Generate Random Extensions And Sustain Extensibility <https://tools.ietf.org/html/draft-ietf-tls-grease-04>`_
116117
(GREASE) values for
@@ -125,27 +126,27 @@ Generic
125126
generation
126127

127128
Protocol Versions
128-
"""""""""""""""""
129+
^^^^^^^^^^^^^^^^^
129130

130131
#. support not only the final, but also draft versions
131132

132133
Cipher Suites
133-
"""""""""""""
134+
^^^^^^^^^^^^^
134135

135136
#. supports each cipher suites discussed on `ciphersuite.info <https://ciphersuite.info>`_
136137
#. supports `GOST <https://en.wikipedia.org/wiki/GOST>`_ (national standards of the Russian Federation and CIS
137138
countries) cipher suites
138139

139140
Secure Shell (SSH)
140-
^^^^^^^^^^^^^^^^^^
141+
------------------
141142

142143
Cipher Suites
143-
"""""""""""""
144+
^^^^^^^^^^^^^
144145

145146
#. identifies as much encryption algorithms as possible (more than 200, compared to 70+ currently supported by OpenSSH)
146147

147148
License
148-
-------
149+
=======
149150

150151
The code is available under the terms of Mozilla Public License Version 2.0 (MPL 2.0).
151152

0 commit comments

Comments
 (0)