Greetings,

Thanks for the new Python client library! I've had a project on 
the back burner for a few months and was surprised to find this 
library waiting for me now that I'm getting around to it. A few 
recommendations as I install it here:

   1. The normal way to package and install Python libraries is
      with distutils (although setuptools is gaining steam). This
      means writing a setup.py script:

        http://docs.python.org/dist/dist.html


   2. Python packages of similar scope usually use a nested
      structure, i.e., this:

        gdata/__init__.py
        gdata/gbase/__init__.py
        gdata/gbase/service.py

      Instead of this:

        gdata.py
        gbase.py
        gbase_service.py


    3. Tests are usually kept in a separate subpackage rather than
       interspersed with actual modules.


    4. In the absence of documentation, you could at least
       generate some basic API docs with Epydoc:

         http://epydoc.sourceforge.net/

       I've taken the liberty of posting such docs here:

         http://tech2.whit537.org/2007/gdata-python/1.0/


Not sure if these were intentional departures or not, but thought 
I'd mention them as I would have found the library more 
immediately comfortable without them.

Thanks again! Looking forward to using the library.



chad

--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups 
"Google Data API" group.
To post to this group, send email to [email protected]
To unsubscribe from this group, send email to [EMAIL PROTECTED]
For more options, visit this group at 
http://groups.google.com/group/google-help-dataapi?hl=en
-~----------~----~----~----~------~----~------~--~---

Reply via email to