Changeset 3249

Timestamp:

09/27/07 00:00:27 (17 years ago)

Author:

jerome

Message:

Removed ipp module which was still present in PyKota. Now pkipplib
is mandatory.
Added a module to handle cups dialoging and datas.

Location:

pykota/trunk/pykota

Files:

• cups.py (copied) (copied from pykota/trunk/pykota/__init__.py) (2 diffs)
• ipp.py (deleted)

pykota/trunk/pykota/cups.py

@@ -2 +2 @@
 # -*- coding: ISO-8859-15 -*-
 #
-# PyKota : Print Quotas for CUPS and LPRng
+# PyKota : Print Quotas for CUPS
 #
 # (c) 2003, 2004, 2005, 2006, 2007 Jerome Alet <alet@librelogiciel.com>
@@ -21 +21 @@
 # $Id$
 #
+
+"""This module implements some CUPS specific classes."""
+
+from pykota.tool import PyKotaToolError
+try :
+    from pkipplib import pkipplib
+except ImportError :        
+    raise RuntimeError, "The python-pkipplib module is now mandatory. You can download pkipplib from http://www.pykota.com/"
+
+class Job :    
+    """A class to hold CUPS print job informations."""
+    def __init__(self, jobid=None, copies=1, filename=None) :
+        """Initializes a print job's information."""
+        self.JobId = jobid
+        self.Copies = copies
+        self.FileName = filename
+        self.Charset = None
+        self.UserName = None
+        self.Title = None
+        self.BillingCode = None
+        self.OriginatingHostName = None
+        self.TimeAtCreation = None
+        self.TimeAtProcessing = None
+        self.MimeType = None
+        self.UUID = None
+        if self.JobId is not None :
+            self.retrieveAttributesFromCUPS()
+        
+    def getAttributeTypeAndValue(self, ippanswer, attribute, category="job") :    
+        """Retrieves a particular attribute's type and value from an IPP answer.
+        
+           Returns a tuple of the form (type, value).
+        """
+        try :
+            return getattr(ippanswer, category)[attribute][0]
+        except KeyError :    
+            return (None, None)
+            
+    def retrieveAttributesFromCUPS(self) :
+        """Retrieve attribute's values from CUPS."""
+        server = pkipplib.CUPS() # TODO : username and password and/or encryption
+        answer = server.getJobAttributes(self.JobId)
+        if answer is None :
+            raise PyKotaToolError, "Network error while querying the CUPS server : %s" \
+                                      % server.lastErrorMessage
+        (dummy, self.Charset) = self.getAttributeTypeAndValue(answer, "attributes-charset", "operation")                              
+        (dummy, self.UserName) = self.getAttributeTypeAndValue(answer, "job-originating-user-name")
+        (dummy, self.Title) = self.getAttributeTypeAndValue(answer, "job-name")
+        (dummy, self.BillingCode) = self.getAttributeTypeAndValue(answer, "job-billing")
+        (dummy, self.OriginatingHostName) = self.getAttributeTypeAndValue(answer, "job-originating-host-name")
+        (dummy, self.UUID) = self.getAttributeTypeAndValue(answer, "job-uuid")
+        (dummy, self.TimeAtCreation) = self.getAttributeTypeAndValue(answer, "time-at-creation")
+        (dummy, self.TimeAtProcessing) = self.getAttributeTypeAndValue(answer, "time-at-processing")
+        (dummy, self.MimeType) = self.getAttributeTypeAndValue(answer, "document-format")
+    
+if __name__ == "__main__" :    
+    import sys
+    if len(sys.argv) != 2 :
+        sys.stderr.write("usage : python cups.py jobid\n")
+    else :    
+        job = Job(int(sys.argv[1]))
+        for attribute in ("Charset", "JobId", "Copies", "FileName", "UserName", 
+                          "Title", "BillingCode", "OriginatingHostName", 
+                          "TimeAtCreation", "TimeAtProcessing", "UUID",
+                          "MimeType") :
+            sys.stdout.write("%s : %s\n" % (attribute, repr(getattr(job, attribute))))