From d259ee51abae5a35e34f16ad74bfb1c62aa433d7 Mon Sep 17 00:00:00 2001 From: Andre Caron Date: Tue, 2 Jun 2015 23:47:11 -0400 Subject: Polishes builder documentation, --- docs/x509.rst | 33 ++++++++++++++++++++++++++++----- 1 file changed, 28 insertions(+), 5 deletions(-) (limited to 'docs/x509.rst') diff --git a/docs/x509.rst b/docs/x509.rst index f79f630c..a2a3ded7 100644 --- a/docs/x509.rst +++ b/docs/x509.rst @@ -473,14 +473,37 @@ X.509 CSR (Certificate Signing Request) Builder Object .. class:: CertificateSigningRequestBuilder - .. method:: __init__() + .. versionadded:: 1.0 - Creates an empty certificate signing request. + .. doctest:: - .. method:: set_version(version) + >>> from cryptography import x509 + >>> from cryptography.hazmat.backends import default_backend + >>> from cryptography.hazmat.primitives import hashes + >>> from cryptography.hazmat.primitives.asymmetric import rsa + >>> private_key = rsa.generate_private_key( + ... public_exponent=65537, + ... key_size=2048, + ... backend=default_backend() + ... ) + >>> builder = x509.CertificateSigningRequestBuilder() + >>> builder = builder.set_subject_name(x509.Name([ + ... x509.NameAttribute(x509.OID_COMMON_NAME, 'cryptography.io'), + ... ])) + >>> buidlder = builder.add_extension(x509.Extension( + ... x509.OID_BASIC_CONSTRAINTS, + ... True, + ... x509.BasicConstraints(False, None), + ... )) + >>> request = builder.sign( + ... default_backend(), private_key, hashes.SHA1() + ... ) + >>> isinstance(request, x509.CertificateSigningRequest) + True - :param version: The :class:`Version` of the X.509 protocol. - :returns: A new `CertificateSigningRequestBuilder`. + .. method:: __init__() + + Creates an empty certificate signing request. .. method:: set_subject_name(name) -- cgit v1.2.3