586
594
# gnutls.strerror()
588
596
if message is None and code is not None:
589
message = gnutls.strerror(code)
597
message = gnutls.strerror(code).decode(
598
"utf-8", errors="replace")
590
599
return super(gnutls.Error, self).__init__(
593
602
class CertificateSecurityError(Error):
606
def __init__(self, cls):
609
def from_param(self, obj):
610
if not isinstance(obj, self.cls):
611
raise TypeError("Not of type {}: {!r}"
612
.format(self.cls.__name__, obj))
613
return ctypes.byref(obj.from_param(obj))
615
class CastToVoidPointer:
616
def __init__(self, cls):
619
def from_param(self, obj):
620
if not isinstance(obj, self.cls):
621
raise TypeError("Not of type {}: {!r}"
622
.format(self.cls.__name__, obj))
623
return ctypes.cast(obj.from_param(obj), ctypes.c_void_p)
625
class With_from_param:
627
def from_param(cls, obj):
628
return obj._as_parameter_
631
class Credentials(With_from_param):
598
632
def __init__(self):
599
self._c_object = gnutls.certificate_credentials_t()
600
gnutls.certificate_allocate_credentials(
601
ctypes.byref(self._c_object))
633
self._as_parameter_ = gnutls.certificate_credentials_t()
634
gnutls.certificate_allocate_credentials(self)
602
635
self.type = gnutls.CRD_CERTIFICATE
604
637
def __del__(self):
605
gnutls.certificate_free_credentials(self._c_object)
638
gnutls.certificate_free_credentials(self)
640
class ClientSession(With_from_param):
608
641
def __init__(self, socket, credentials=None):
609
self._c_object = gnutls.session_t()
642
self._as_parameter_ = gnutls.session_t()
610
643
gnutls_flags = gnutls.CLIENT
611
644
if gnutls.check_version(b"3.5.6"):
612
645
gnutls_flags |= gnutls.NO_TICKETS
613
646
if gnutls.has_rawpk:
614
647
gnutls_flags |= gnutls.ENABLE_RAWPK
615
gnutls.init(ctypes.byref(self._c_object), gnutls_flags)
648
gnutls.init(self, gnutls_flags)
617
gnutls.set_default_priority(self._c_object)
618
gnutls.transport_set_ptr(self._c_object, socket.fileno())
619
gnutls.handshake_set_private_extensions(self._c_object,
650
gnutls.set_default_priority(self)
651
gnutls.transport_set_ptr(self, socket.fileno())
652
gnutls.handshake_set_private_extensions(self, True)
621
653
self.socket = socket
622
654
if credentials is None:
623
655
credentials = gnutls.Credentials()
624
gnutls.credentials_set(self._c_object, credentials.type,
625
ctypes.cast(credentials._c_object,
656
gnutls.credentials_set(self, credentials.type,
627
658
self.credentials = credentials
629
660
def __del__(self):
630
gnutls.deinit(self._c_object)
632
663
def handshake(self):
633
return gnutls.handshake(self._c_object)
664
return gnutls.handshake(self)
635
666
def send(self, data):
636
667
data = bytes(data)
637
668
data_len = len(data)
638
669
while data_len > 0:
639
data_len -= gnutls.record_send(self._c_object,
670
data_len -= gnutls.record_send(self, data[-data_len:],
644
return gnutls.bye(self._c_object, gnutls.SHUT_RDWR)
674
return gnutls.bye(self, gnutls.SHUT_RDWR)
646
676
# Error handling functions
647
677
def _error_code(result):
648
678
"""A function to raise exceptions on errors, suitable
649
679
for the 'restype' attribute on ctypes functions"""
680
if result >= gnutls.E_SUCCESS:
652
682
if result == gnutls.E_NO_CERTIFICATE_FOUND:
653
683
raise gnutls.CertificateSecurityError(code=result)
654
684
raise gnutls.Error(code=result)
656
def _retry_on_error(result, func, arguments):
686
def _retry_on_error(result, func, arguments,
687
_error_code=_error_code):
657
688
"""A function to retry on some errors, suitable
658
689
for the 'errcheck' attribute on ctypes functions"""
690
while result < gnutls.E_SUCCESS:
660
691
if result not in (gnutls.E_INTERRUPTED, gnutls.E_AGAIN):
661
692
return _error_code(result)
662
693
result = func(*arguments)
669
700
priority_set_direct = _library.gnutls_priority_set_direct
670
priority_set_direct.argtypes = [session_t, ctypes.c_char_p,
701
priority_set_direct.argtypes = [ClientSession, ctypes.c_char_p,
671
702
ctypes.POINTER(ctypes.c_char_p)]
672
703
priority_set_direct.restype = _error_code
674
705
init = _library.gnutls_init
675
init.argtypes = [ctypes.POINTER(session_t), ctypes.c_int]
706
init.argtypes = [PointerTo(ClientSession), ctypes.c_int]
676
707
init.restype = _error_code
678
709
set_default_priority = _library.gnutls_set_default_priority
679
set_default_priority.argtypes = [session_t]
710
set_default_priority.argtypes = [ClientSession]
680
711
set_default_priority.restype = _error_code
682
713
record_send = _library.gnutls_record_send
683
record_send.argtypes = [session_t, ctypes.c_void_p,
714
record_send.argtypes = [ClientSession, ctypes.c_void_p,
685
716
record_send.restype = ctypes.c_ssize_t
686
717
record_send.errcheck = _retry_on_error
688
719
certificate_allocate_credentials = (
689
720
_library.gnutls_certificate_allocate_credentials)
690
721
certificate_allocate_credentials.argtypes = [
691
ctypes.POINTER(certificate_credentials_t)]
722
PointerTo(Credentials)]
692
723
certificate_allocate_credentials.restype = _error_code
694
725
certificate_free_credentials = (
695
726
_library.gnutls_certificate_free_credentials)
696
certificate_free_credentials.argtypes = [
697
certificate_credentials_t]
727
certificate_free_credentials.argtypes = [Credentials]
698
728
certificate_free_credentials.restype = None
700
730
handshake_set_private_extensions = (
701
731
_library.gnutls_handshake_set_private_extensions)
702
handshake_set_private_extensions.argtypes = [session_t,
732
handshake_set_private_extensions.argtypes = [ClientSession,
704
734
handshake_set_private_extensions.restype = None
706
736
credentials_set = _library.gnutls_credentials_set
707
credentials_set.argtypes = [session_t, credentials_type_t,
737
credentials_set.argtypes = [ClientSession, credentials_type_t,
738
CastToVoidPointer(Credentials)]
709
739
credentials_set.restype = _error_code
711
741
strerror = _library.gnutls_strerror
730
760
global_set_log_function.restype = None
732
762
deinit = _library.gnutls_deinit
733
deinit.argtypes = [session_t]
763
deinit.argtypes = [ClientSession]
734
764
deinit.restype = None
736
766
handshake = _library.gnutls_handshake
737
handshake.argtypes = [session_t]
738
handshake.restype = _error_code
767
handshake.argtypes = [ClientSession]
768
handshake.restype = ctypes.c_int
739
769
handshake.errcheck = _retry_on_error
741
771
transport_set_ptr = _library.gnutls_transport_set_ptr
742
transport_set_ptr.argtypes = [session_t, transport_ptr_t]
772
transport_set_ptr.argtypes = [ClientSession, transport_ptr_t]
743
773
transport_set_ptr.restype = None
745
775
bye = _library.gnutls_bye
746
bye.argtypes = [session_t, close_request_t]
747
bye.restype = _error_code
776
bye.argtypes = [ClientSession, close_request_t]
777
bye.restype = ctypes.c_int
748
778
bye.errcheck = _retry_on_error
750
780
check_version = _library.gnutls_check_version
2774
2813
def rfc3339_duration_to_delta(duration):
2775
2814
"""Parse an RFC 3339 "duration" and return a datetime.timedelta
2777
>>> rfc3339_duration_to_delta("P7D") == datetime.timedelta(7)
2779
>>> rfc3339_duration_to_delta("PT60S") == datetime.timedelta(0, 60)
2781
>>> rfc3339_duration_to_delta("PT60M") == datetime.timedelta(0, 3600)
2783
>>> rfc3339_duration_to_delta("PT24H") == datetime.timedelta(1)
2785
>>> rfc3339_duration_to_delta("P1W") == datetime.timedelta(7)
2787
>>> rfc3339_duration_to_delta("PT5M30S") == datetime.timedelta(0, 330)
2789
>>> rfc3339_duration_to_delta("P1DT3M20S") == datetime.timedelta(1, 200)
2816
>>> timedelta = datetime.timedelta
2817
>>> rfc3339_duration_to_delta("P7D") == timedelta(7)
2819
>>> rfc3339_duration_to_delta("PT60S") == timedelta(0, 60)
2821
>>> rfc3339_duration_to_delta("PT60M") == timedelta(0, 3600)
2823
>>> rfc3339_duration_to_delta("PT24H") == timedelta(1)
2825
>>> rfc3339_duration_to_delta("P1W") == timedelta(7)
2827
>>> rfc3339_duration_to_delta("PT5M30S") == timedelta(0, 330)
2829
>>> rfc3339_duration_to_delta("P1DT3M20S") == timedelta(1, 200)
2793
2834
# Parsing an RFC 3339 duration with regular expressions is not