Giter VIP home page Giter VIP logo

soappy-py3's Introduction

==============================================
SOAPpy - Simple to use SOAP library for Python
==============================================

.. contents::

Disclaimer
==========
Please use `suds <https://pypi.python.org/pypi/suds>`_ rather than SOAPpy.
SOAPpy is old and clamsy.

Credits
========

Companies
---------
|makinacom|_

  * `Planet Makina Corpus <http://www.makina-corpus.org>`_
  * `Contact us <mailto:[email protected]>`_

.. |makinacom| image:: http://depot.makina-corpus.org/public/logo.gif
.. _makinacom:  http://www.makina-corpus.com

Authors
------------

- Cayce Ullman <[email protected]>
- Brian Matthews <[email protected]>
- Gregory R. Warnes <[email protected]>
- Makina Corpus <[email protected]>
- Mathieu Le Marec - Pasquet <[email protected]>

Contributors
----------------
- Christopher Blunck <[email protected]>
- Brad Knotwell <[email protected]>
- Mark Bucciarelli <[email protected]> (ported WSDL client from ZSI)
- Ivan R. Judson     <[email protected]> (Globus support)
- Kirk Strauser <[email protected]>
- Antonio Beamud Montero <[email protected]> (patches for integrating SOAPpy into Zope)
- And others.

Copyright (c) 20011 Makina Corpus
Copyright (c) 2002-2005, Pfizer, Inc.
Copyright (c) 2001, Cayce Ullman.
Copyright (c) 2001, Brian Matthews.
All rights reserved, see the file LICENSE for conditions of use.

INTRODUCTION
==============

The goal of the SOAPpy team is to provide a full-featured SOAP library
for Python that is very simple to use and that fully supports dynamic
interaction between clients and servers.


INCLUDED
--------
- General SOAP Parser based on sax.xml
- General SOAP Builder
- SOAP Proxy for RPC client code
- SOAP Server framework for RPC server code

FEATURES
--------
- Handles all SOAP 1.0 types
- Handles faults
- Allows namespace specification
- Allows SOAPAction specification
- Homogeneous typed arrays
- Supports multiple schemas
- Header support (mustUnderstand and actor)
- XML attribute support
- Multi-referencing support (Parser/Builder)
- Understands SOAP-ENC:root attribute
- Good interop, passes all client tests for Frontier, SOAP::LITE, SOAPRMI
- Encodings
- SSL clients (with Python compiled with OpenSSL support)
- SSL servers (with Python compiled with OpenSSL support and M2Crypto installed)
- Encodes XML tags per SOAP 1.2 name mangling specification (Gregory Warnes)
- Automatic stateful SOAP server support (Apache v2.x) (blunck2)
- WSDL client support
- WSDL server support

TODO (See RELEASE_INFO and CHANGELOG for recent changes)
----------------------------------------------------------
- Timeout on method calls
- Advanced arrays (sparse, multidimensional and partial)
- Attachments
- mod_python example
- medusa example
- Improved documentation

MANIFEST
--------
::

    Files

        README              This file
        RELEASE_NOTES       General information about each release
        ChangeLog           Detailed list of changes
        TODO                List of tasks that need to be done
        setup.py            Python installation control files
        SOAPpy.spec         RPM package control file

    Directories

        SOAPpy/            Source code for the package
        SOAPpy/wstools/    Source code for WSDL tools
        tests/             unit tests and examples
        validate/          interop client and servers
        bid/               N+I interop client and server
        contrib/           Contributed examples (also see test/)
        docs/              Documentation
        tools/             Misc tools useful for the SOAPpy developers
        zope/              Patches to Zope allowing it to provide SOAP services


INSTALLATION
============

USING GITHUB
------------

    You can install SOAPpy and its dependencies directly from GitHub using PIP:

        pip install -e "git+http://github.com/kiroky/SOAPpy.git@develop#egg=SOAPpy"

REQUIRED PACKAGES
------------------

    - wstools


OPTIONAL PACKAGES
-----------------

    - pyGlobus, optional support for Globus,
      <http://www-itg.lbl.gov/gtg/projects/pyGlobus/>

    - M2Crypto.SSL, optional support for server-side SSL
      <http://sandbox.rulemaker.net/ngps/m2/>

    - If Python is compiled with SSL support (Python 2.3 does so by
      default), client-side use of SSL is supported

INSTALLATION STEPS
------------------

    As of version 0.9.8 SOAPpy can be installed using the standard python
    package installation tools.

    To install:

      1) Unpack the distribution package:

         On Windows, use your favorite zip file uncompression tool.

         On Unix::

             $ tar -xvzf SOAPpy-$VERSION$.tar.gz

         If you have gnu tar, otherwise
            ::

             $ gzcat SOAPpy-$VERSION$.tar.gz | tar -xvf -

      2) Change into the source directory
         ::

                 cd SOAPpy-$VERSION$

      3) Compile the package::

                $ python setup.py build

      4) Install the package

         On Windows::

                $ python setup.py install

         On Unix install as the owner of the python directories
         (usally root)::

                $ su root
                Password: XXXXXX
                $ python setup.py install


DOCUMENTATION
=============
QUICK START
-----------

A simple "Hello World" http SOAP server::

        import SOAPpy
        def hello():
            return "Hello World"
        server = SOAPpy.SOAPServer(("localhost", 8080))
        server.registerFunction(hello)
        server.serve_forever()

And the corresponding client::

        import SOAPpy
        server = SOAPpy.SOAPProxy("http://localhost:8080/")
        print server.hello()

BASIC TUTORIAL
--------------
Mark Pilgrims _Dive Into Python, published in printed form by
Apress and online at at http://diveintopython.org provides a
nice tutorial for SOAPpy in Chapter 12, "SOAP Web Services".
See http://diveintopython.org/soap_web_services .

OTHER DOCUMENTATION
-------------------

For further information see the files in the docs/ directory.

Note that documentation is one of SOAPpy's current weak points.
Please help us out!


Support
============
Github: https://github.com/kiorky/SOAPpy
Issues: https://github.com/kiorky/SOAPpy/issues

soappy-py3's People

Contributors

baldulin avatar claytonc avatar dawryn avatar franklx avatar hefee avatar jarrodchesney avatar jasonl888 avatar jeffkit avatar jonozzz avatar jsmolina avatar julien-lang avatar kiorky avatar llouislu avatar neurones67 avatar pelletier avatar pollux42 avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.