14132208658

Committed 28 Mar 2025 03:17PM UTC coverage: 66.175% (+0.05%) from 66.13%

Build # 14132208658

Build Type

push

github

Committed by

LudovicRousseau

Commit Message

Remove obsolete issue template

Coverage Stats

103 of 480 branches covered (21.46%)

4441 of 6711 relevant lines covered (66.17%)

4.63 hits per line

Source File
Press 'n' to go to next uncovered line, 'b' for previous

100.0

/src/smartcard/Exceptions.py

"""Smartcard module exceptions.

This module defines the exceptions raised by the smartcard module.

__author__ = "https://www.gemalto.com/"

Copyright 2001-2012 gemalto
Author: Jean-Daniel Aussel, mailto:jean-daniel.aussel@gemalto.com

This file is part of pyscard.

pyscard is free software; you can redistribute it and/or modify
it under the terms of the GNU Lesser General Public License as published by
the Free Software Foundation; either version 2.1 of the License, or
(at your option) any later version.

pyscard is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public License
along with pyscard; if not, write to the Free Software
Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
"""

from smartcard.scard import SCardGetErrorMessage


class SmartcardException(Exception):
    """Base class for smartcard exceptions.

    smartcard exceptions are generated by the smartcard module and
    shield scard (i.e. PCSC) exceptions raised by the scard module.

    """

    def __init__(self, message="", hresult=-1, *args):
        super().__init__(message, *args)
        self.hresult = int(hresult)

    def __str__(self):
        text = super().__str__()
        if self.hresult != -1:
            hresult = self.hresult
            if hresult < 0:
                # convert 0x-7FEFFFE3 into 0x8010001D
                hresult += 0x100000000
            text += f": {SCardGetErrorMessage(self.hresult)} (0x{hresult:08X})"

        return text


class CardConnectionException(SmartcardException):
    """Raised when a CardConnection class method fails."""

    pass


class CardRequestException(SmartcardException):
    """Raised when a CardRequest wait fails."""

    pass


class CardRequestTimeoutException(SmartcardException):
    """Raised when a CardRequest times out."""

    def __init__(self, hresult=-1, *args):
        SmartcardException.__init__(
            self, "Time-out during card request", hresult=hresult, *args
        )


class CardServiceException(SmartcardException):
    """Raised when a CardService class method fails."""

    pass


class CardServiceStoppedException(SmartcardException):
    """Raised when the CardService was stopped"""

    pass


class CardServiceNotFoundException(SmartcardException):
    """Raised when the CardService is not found"""

    pass


class InvalidATRMaskLengthException(SmartcardException):
    """Raised when an ATR mask does not match an ATR length."""

    def __init__(self, mask):
        SmartcardException.__init__(self, "Invalid ATR mask length: %s" % mask)


class InvalidReaderException(SmartcardException):
    """Raised when trying to access an invalid smartcard reader."""

    def __init__(self, readername):
        SmartcardException.__init__(self, "Invalid reader: %s" % readername)


class ListReadersException(SmartcardException):
    """Raised when smartcard readers cannot be listed."""

    def __init__(self, hresult):
        SmartcardException.__init__(self, "Failed to list readers", hresult=hresult)


class NoCardException(SmartcardException):
    """Raised when no card in is present in reader."""

    def __init__(self, message, hresult):
        SmartcardException.__init__(self, message, hresult=hresult)


class NoReadersException(SmartcardException):
    """Raised when the system has no smartcard reader."""

    def __init__(self, *args):
        SmartcardException.__init__(self, "No reader found", *args)

1	"""Smartcard module exceptions.
2
3	This module defines the exceptions raised by the smartcard module.
4
5	__author__ = "https://www.gemalto.com/"
6
7	Copyright 2001-2012 gemalto
8	Author: Jean-Daniel Aussel, mailto:jean-daniel.aussel@gemalto.com
9
10	This file is part of pyscard.
11
12	pyscard is free software; you can redistribute it and/or modify
13	it under the terms of the GNU Lesser General Public License as published by
14	the Free Software Foundation; either version 2.1 of the License, or
15	(at your option) any later version.
16
17	pyscard is distributed in the hope that it will be useful,
18	but WITHOUT ANY WARRANTY; without even the implied warranty of
19	MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
20	GNU Lesser General Public License for more details.
21
22	You should have received a copy of the GNU Lesser General Public License
23	along with pyscard; if not, write to the Free Software
24	Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
25	"""
26
27	from smartcard.scard import SCardGetErrorMessage	20✔
28
29
30	class SmartcardException(Exception):	20✔
31	"""Base class for smartcard exceptions.
32
33	smartcard exceptions are generated by the smartcard module and
34	shield scard (i.e. PCSC) exceptions raised by the scard module.
35
36	"""
37
38	def __init__(self, message="", hresult=-1, *args):	20✔
39	super().__init__(message, *args)	19✔
40	self.hresult = int(hresult)	19✔
41
42	def __str__(self):	20✔
43	text = super().__str__()	19✔
44	if self.hresult != -1:	19✔
45	hresult = self.hresult	19✔
46	if hresult < 0:	19✔
47	# convert 0x-7FEFFFE3 into 0x8010001D
48	hresult += 0x100000000	15✔
49	text += f": {SCardGetErrorMessage(self.hresult)} (0x{hresult:08X})"	19✔
50
51	return text	19✔
52
53
54	class CardConnectionException(SmartcardException):	20✔
55	"""Raised when a CardConnection class method fails."""
56
57	pass	20✔
58
59
60	class CardRequestException(SmartcardException):	20✔
61	"""Raised when a CardRequest wait fails."""
62
63	pass	20✔
64
65
66	class CardRequestTimeoutException(SmartcardException):	20✔
67	"""Raised when a CardRequest times out."""
68
69	def __init__(self, hresult=-1, *args):	20✔
70	SmartcardException.__init__(	19✔
71	self, "Time-out during card request", hresult=hresult, *args
72	)
73
74
75	class CardServiceException(SmartcardException):	20✔
76	"""Raised when a CardService class method fails."""
77
78	pass	20✔
79
80
81	class CardServiceStoppedException(SmartcardException):	20✔
82	"""Raised when the CardService was stopped"""
83
84	pass	20✔
85
86
87	class CardServiceNotFoundException(SmartcardException):	20✔
88	"""Raised when the CardService is not found"""
89
90	pass	20✔
91
92
93	class InvalidATRMaskLengthException(SmartcardException):	20✔
94	"""Raised when an ATR mask does not match an ATR length."""
95
96	def __init__(self, mask):	20✔
97	SmartcardException.__init__(self, "Invalid ATR mask length: %s" % mask)	19✔
98
99
100	class InvalidReaderException(SmartcardException):	20✔
101	"""Raised when trying to access an invalid smartcard reader."""
102
103	def __init__(self, readername):	20✔
104	SmartcardException.__init__(self, "Invalid reader: %s" % readername)	19✔
105
106
107	class ListReadersException(SmartcardException):	20✔
108	"""Raised when smartcard readers cannot be listed."""
109
110	def __init__(self, hresult):	20✔
111	SmartcardException.__init__(self, "Failed to list readers", hresult=hresult)	19✔
112
113
114	class NoCardException(SmartcardException):	20✔
115	"""Raised when no card in is present in reader."""
116
117	def __init__(self, message, hresult):	20✔
118	SmartcardException.__init__(self, message, hresult=hresult)	19✔
119
120
121	class NoReadersException(SmartcardException):	20✔
122	"""Raised when the system has no smartcard reader."""
123
124	def __init__(self, *args):	20✔
125	SmartcardException.__init__(self, "No reader found", *args)	19✔

LudovicRousseau / pyscard / 14132208658

Source File Press 'n' to go to next uncovered line, 'b' for previous

Source File
Press 'n' to go to next uncovered line, 'b' for previous