fix: add API methods, get_employees() and get_employee()

corepos/api.py

@@ -2,7 +2,7 @@
 ################################################################################
 #
 #  pyCOREPOS -- Python Interface to CORE POS
-#  Copyright © 2018-2023 Lance Edgar
+#  Copyright © 2018-2024 Lance Edgar
 #
 #  This file is part of pyCOREPOS.
 #
@@ -198,6 +198,40 @@ class CoreWebAPI(object):
         if result:
             return result
 
+    def get_employees(self, **columns):
+        """
+        Fetch some or all of Employee records from CORE.
+
+        :returns: A (potentially empty) list of employee dict records.
+        """
+        params = {
+            'entity': 'Employees',
+            'submethod': 'get',
+            'columns': columns,
+        }
+        response = self.post(params)
+        result = self.parse_response(response)
+        return [json.loads(rec) for rec in result]
+
+    def get_employee(self, emp_no, **columns):
+        """
+        Fetch an existing Employee record from CORE.
+
+        :returns: Either a employee dict record, or ``None``.
+        """
+        columns['emp_no'] = emp_no
+        params = {
+            'entity': 'Employees',
+            'submethod': 'get',
+            'columns': columns,
+        }
+        response = self.post(params)
+        result = self.parse_response(response)
+        if result:
+            if len(result) > 1:
+                log.warning("CORE API returned %s employee results", len(result))
+            return json.loads(result[0])
+
     def get_stores(self, **columns):
         """
         Fetch some or all of Store records from CORE.