first init

2026-09-01 10:12:31 +08:00
commit ca6e55f853
718 changed files with 204746 additions and 0 deletions
@@ -0,0 +1,63 @@
+"""Smart card Reader abstract class.
+
+__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
+"""
+
+
+class Reader:
+    """Reader abstract class.
+
+    The reader class is responsible for creating connections
+    with a card.
+    """
+
+    def __init__(self, readername):
+        """Constructs a new reader and store readername."""
+        self.name = readername
+
+    def addtoreadergroup(self, groupname):
+        """Add reader to a reader group."""
+
+    def removefromreadergroup(self, groupname):
+        """Remove reader from a reader group."""
+
+    def createConnection(self):
+        """Returns a card connection thru reader."""
+
+    def __eq__(self, other):
+        """Returns True if self==other (same name)."""
+        if isinstance(other, type(self)):
+            return self.name == other.name
+
+        return False
+
+    def __hash__(self):
+        """Returns a hash value for this object (self.name is unique)."""
+        return hash(self.name)
+
+    def __repr__(self):
+        """Returns card reader name string for `object` calls."""
+        return f"'{self.name}'"
+
+    def __str__(self):
+        """Returns card reader name string for str(object) calls."""
+        return self.name
@@ -0,0 +1,65 @@
+"""ReaderFactory: creates smartcard readers.
+
+__author__ = "gemalto https://www.gemalto.com/"
+
+Factory pattern implementation borrowed from
+Thinking in Python, Bruce Eckel,
+http://mindview.net/Books/TIPython
+
+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
+"""
+
+import importlib
+
+from smartcard.pcsc.PCSCReader import PCSCReader
+
+
+class ReaderFactory:
+    """Class to create readers from reader type id."""
+
+    factories = {}
+    factorymethods = [PCSCReader.readers]
+
+    # A Template Method:
+    @staticmethod
+    def createReader(clazz: str, readername: str):
+        """Static method to create a reader from a reader clazz.
+
+        @param clazz:      the reader class name
+        @param readername: the reader name
+        """
+
+        if clazz not in ReaderFactory.factories:
+            module_name, _, class_name = clazz.rpartition(".")
+            imported_module = importlib.import_module(module_name)
+            imported_class = getattr(imported_module, class_name)
+            ReaderFactory.factories[clazz] = imported_class.Factory()
+
+        return ReaderFactory.factories[clazz].create(readername)
+
+    @staticmethod
+    def readers(groups=None):
+        """Return the list of readers"""
+        if groups is None:
+            groups = []
+        zreaders = []
+        for fm in ReaderFactory.factorymethods:
+            zreaders += fm(groups)
+        return zreaders
@@ -0,0 +1,105 @@
+"""ReaderGroups manages smart card reader in 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.Exceptions import SmartcardException
+from smartcard.ulist import ulist
+
+# pylint: disable=too-few-public-methods
+
+
+class BadReaderGroupException(SmartcardException):
+    """Raised when trying to add an invalid reader group."""
+
+    def __init__(self):
+        SmartcardException.__init__(self, "Invalid reader group")
+
+
+class innerreadergroups(ulist):
+    """Smartcard readers groups private class.
+
+    The readergroups singleton manages the creation of the unique
+    instance of this class.
+    """
+
+    def __init__(self, initlist=None):
+        """Retrieve and store list of reader groups"""
+        if initlist is None:
+            initlist = self.getreadergroups() or []
+        ulist.__init__(self, initlist)
+        self.unremovablegroups = []
+
+    def __onadditem__(self, item):
+        """Called when a reader group is added."""
+        self.addreadergroup(item)
+
+    def __onremoveitem__(self, item):
+        """Called when a reader group is added."""
+        self.removereadergroup(item)
+
+    def __iter__(self):
+        return ulist.__iter__(self)
+
+    #
+    # abstract methods implemented in subclasses
+    #
+
+    def getreadergroups(self):
+        """Returns the list of smartcard reader groups."""
+        return []
+
+    def addreadergroup(self, newgroup):
+        """Add a reader group"""
+        if not isinstance(newgroup, str):
+            raise BadReaderGroupException
+        self += newgroup
+
+    def removereadergroup(self, group):
+        """Remove a reader group"""
+        if not isinstance(group, str):
+            raise BadReaderGroupException
+        self.remove(group)
+
+    def addreadertogroup(self, readername, groupname):
+        """Add a reader to a reader group"""
+
+    def removereaderfromgroup(self, readername, groupname):
+        """Remove a reader from a reader group"""
+
+
+class readergroups:
+    """ReadersGroups organizes smart card reader as groups."""
+
+    # The single instance of __readergroups
+    instance = None
+    innerclazz = innerreadergroups
+
+    def __init__(self, initlist=None):
+        """Create a single instance of innerreadergroups on first call"""
+        if readergroups.instance is None:
+            readergroups.instance = self.innerclazz(initlist)
+
+    # All operators redirected to inner class.
+
+    def __getattr__(self, name):
+        return getattr(self.instance, name)