Files
mykad-reader-api/.venv/lib/python3.9/site-packages/smartcard/pcsc/PCSCReaderGroups.py
T
ISMAIL MASSERAN ca6e55f853 first init
2026-09-01 10:12:31 +08:00

129 lines
4.3 KiB
Python

"""PCSCReaderGroups organizes smartcard readers as groups.
__author__ = "gemalto 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.pcsc.PCSCExceptions import (
EstablishContextException,
ListReadersException,
ReleaseContextException,
)
from smartcard.reader.ReaderGroups import innerreadergroups, readergroups
from smartcard.scard import (
SCARD_S_SUCCESS,
SCARD_SCOPE_USER,
SCardEstablishContext,
SCardForgetReaderGroup,
SCardGetErrorMessage,
SCardIntroduceReaderGroup,
SCardListReaderGroups,
SCardReleaseContext,
error,
)
# pylint: disable=too-few-public-methods
class pcscinnerreadergroups(innerreadergroups):
"""Smartcard PCSC readers groups inner class.
The PCSCReaderGroups singleton manages the creation of the unique
instance of this class.
"""
def __init__(self, initlist=None):
"""Constructor."""
innerreadergroups.__init__(self, initlist)
self.unremovablegroups = ["SCard$DefaultReaders"]
def getreadergroups(self):
"""Returns the list of smartcard reader groups."""
innerreadergroups.getreadergroups(self)
hresult, hcontext = SCardEstablishContext(SCARD_SCOPE_USER)
if hresult != SCARD_S_SUCCESS:
raise EstablishContextException(hresult)
hresult, readers = SCardListReaderGroups(hcontext)
if hresult != SCARD_S_SUCCESS:
raise ListReadersException(hresult)
hresult = SCardReleaseContext(hcontext)
if hresult != SCARD_S_SUCCESS:
raise ReleaseContextException(hresult)
return readers
def addreadergroup(self, newgroup):
"""Add a reader group"""
hresult, hcontext = SCardEstablishContext(SCARD_SCOPE_USER)
if SCARD_S_SUCCESS != hresult:
raise error("Failed to establish context: " + SCardGetErrorMessage(hresult))
try:
hresult = SCardIntroduceReaderGroup(hcontext, newgroup)
if SCARD_S_SUCCESS != hresult:
raise error(
"Unable to introduce reader group: " + SCardGetErrorMessage(hresult)
)
innerreadergroups.addreadergroup(self, newgroup)
finally:
hresult = SCardReleaseContext(hcontext)
if SCARD_S_SUCCESS != hresult:
raise error(
"Failed to release context: " + SCardGetErrorMessage(hresult)
)
def removereadergroup(self, group):
"""Remove a reader group"""
hresult, hcontext = SCardEstablishContext(SCARD_SCOPE_USER)
if SCARD_S_SUCCESS != hresult:
raise error("Failed to establish context: " + SCardGetErrorMessage(hresult))
try:
hresult = SCardForgetReaderGroup(hcontext, group)
if hresult != SCARD_S_SUCCESS:
raise error(
"Unable to forget reader group: " + SCardGetErrorMessage(hresult)
)
innerreadergroups.removereadergroup(self, group)
finally:
hresult = SCardReleaseContext(hcontext)
if SCARD_S_SUCCESS != hresult:
raise error(
"Failed to release context: " + SCardGetErrorMessage(hresult)
)
class PCSCReaderGroups(readergroups):
"""PCSC readers groups."""
def __init__(self, initlist=None):
"""Create a single instance of pcscinnerreadergroups on first call"""
self.innerclazz = pcscinnerreadergroups
readergroups.__init__(self, initlist)
if __name__ == "__main__":
print(PCSCReaderGroups().getreadergroups())