Module gxml

Gchecky.gxml module provides an abstraction layer when dealing with Google Checkout API services (GC API). It translates XML messages into human-friendly python structures and vice versa.

In practice it means that when you have recieved a notification message from GC API, and you want to understand what's in that XML message, you simply pass it to gchecky and it parses (and automatically validates it for you) the XML text into python objects - instances of the class corresponding to the message type. Then that object is passed to your hook method along with extracted google order_id.

For example when an <order-state-change /> XML message is send to you by GC API gchecky will call on_order_state_change passing it an instance of gchecky.gxml.order_state_change_t along with google order_id.

This is very convenient since you don't have to manipulate xml text, or xml DOM tree, neither do you have to validate the recieved message - it is already done by gchecky.

   class Child(Parent):
       @apply_parent_validation(Child, error_prefix="From Child: ")
       def validate(data):
           # I can assume now that the parent validation method succeeded.
           # ...