Changeset cad7502 for server/lib/gutenbach/server/requests.py

Timestamp:

Dec 20, 2011, 2:19:43 PM (12 years ago)

Author:

Jessica B. Hamrick <jhamrick@…>

Branches:

no-cups

Children:

ef8df33

Parents:

6effd50

git-author:

Jessica B. Hamrick <jhamrick@…> (12/20/11 14:19:43)

git-committer:

Jessica B. Hamrick <jhamrick@…> (12/20/11 14:19:43)

Message:

Fix bugs; can now again do 'lpq' and get back a reasonable response

File:

• server/lib/gutenbach/server/requests.py (modified) (1 diff)

server/lib/gutenbach/server/requests.py

@@ -125 +125 @@
     @handler_for(const.Operations.GET_PRINTER_ATTRIBUTES)
     def get_printer_attributes(self, request, response):
+        """RFC 2911: 3.2.5 Get-Printer-Attributes Operation
+
+        This REQUIRED operation allows a client to request the values
+        of the attributes of a Printer object.
+        
+        In the request, the client supplies the set of Printer
+        attribute names and/or attribute group names in which the
+        requester is interested. In the response, the Printer object
+        returns a corresponding attribute set with the appropriate
+        attribute values filled in.
+
+        For Printer objects, the possible names of attribute groups are:
+        
+        - 'job-template': the subset of the Job Template attributes
+          that apply to a Printer object (the last two columns of the
+          table in Section 4.2) that the implementation supports for
+          Printer objects.
+
+        - 'printer-description': the subset of the attributes
+          specified in Section 4.4 that the implementation supports
+          for Printer objects.
+
+        - 'all': the special group 'all' that includes all attributes
+          that the implementation supports for Printer objects.
+        
+        Since a client MAY request specific attributes or named
+        groups, there is a potential that there is some overlap. For
+        example, if a client requests, 'printer-name' and 'all', the
+        client is actually requesting the 'printer-name' attribute
+        twice: once by naming it explicitly, and once by inclusion in
+        the 'all' group. In such cases, the Printer object NEED NOT
+        return each attribute only once in the response even if it is
+        requested multiple times. The client SHOULD NOT request the
+        same attribute in multiple ways.
+
+        It is NOT REQUIRED that a Printer object support all
+        attributes belonging to a group (since some attributes are
+        OPTIONAL). However, it is REQUIRED that each Printer object
+        support all group names.
+
+        """
+
         # this is just like cups_get_default, except the printer name
         # is given