Metadata-Version: 1.1
Name: gs.form
Version: 2.2.0
Summary: Functions for posting data to forms.
Home-page: https://source.iopen.net/groupserver/gs.form/
Author: Michael JasonSmith
Author-email: mpj17@onlinegroups.net
License: ZPL 2.1
Description: ===========
        ``gs.form``
        ===========
        ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
        Submit a form to a Web server using a ``POST``
        ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
        
        :Author: `Michael JasonSmith`_
        :Contact: Michael JasonSmith <mpj17@onlinegroups.net>
        :Date: 2014-05-05
        :Organization: `GroupServer.org`_
        :Copyright: This document is licensed under a
          `Creative Commons Attribution-Share Alike 4.0 International License`_
          by `OnlineGroups.Net`_.
        
        Introduction
        ============
        
        This product contains the core functions and classes for making
        HTTP ``POST`` requests to send data to forms. For the most part
        it consists of the `post_multipart`_ utility, for posting data to
        a form.
        
        While originally written for GroupServer_, there is nothing
        specific to GroupServer in this product.
        
        ``post_multipart``
        ==================
        
        The ``gs.form.post_multipart`` function is used to post data to a
        form::
        
          post_multipart(host, selector, fields, files=[], usessl=False)
        
        See the documentation for more on how to use this function.
        
        Acknowledgements
        ================
        
        The post_multipart_ code was based on `a Python recipe by Wade
        Leftwich`_. It was changed to use ``email.multipart`` to create
        the multipart document that is sent using a ``POST``.
        
        The Python standard library currently lacks a module for making a
        ``POST`` to a Web server. `Issue 3244`_ tracks the inclusion of a
        module into the standard library.
        
        
        Resources
        =========
        
        - Documentation: http://gsform.readthedocs.org/
        - Code repository: https://source.iopen.net/groupserver/gs.form
        - Questions and comments to http://groupserver.org/groups/development
        - Report bugs at https://redmine.iopen.net/projects/groupserver
        
        .. _GroupServer: http://groupserver.org/
        .. _GroupServer.org: http://groupserver.org/
        .. _OnlineGroups.Net: https://onlinegroups.net
        .. _Michael JasonSmith: http://groupserver.org/p/mpj17
        .. _Creative Commons Attribution-Share Alike 4.0 International License:
            http://creativecommons.org/licenses/by-sa/4.0/
        .. _a Python recipe by Wade Leftwich: http://code.activestate.com/recipes/146306-http-client-to-post-using-multipartform-data/
        .. _Issue 3244: http://bugs.python.org/issue3244
        
        Changelog
        =========
        
        2.2.0 (2014-05-05)
        ------------------
        
        * Added unit tests.
        * Refactored code into smaller modules and functions.
        * Added docstrings
        * Added Sphinx support
        * Added Python 3 support
        
        1.1.1 (2014-01-23)
        ------------------
        
        * Metadata cleanup for the product.
        * PEP-8 tidy.
        * Switch to Unicode literals.
        
        1.1.0 (2012-08-01)
        ------------------
        
        * Added SSL (TLS) support.
        
        1.0.1 (2012-07-30)
        ------------------
        
        * Support Unicode properly.
        
        1.0.0 (2012-07-16)
        ------------------
        
        * Added ``post_multipart`` to the module
        * Moved the user-interface code to ``gs.content.form``
        * Renamed this module ``gs.form``.
        
Keywords: http,post,POST,form,web form
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Zope Public License
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Software Development :: Libraries :: Python Modules
