-Soup is a SOAP (Simple Object Access Protocol) implementation in C.
+libsoup is an HTTP client/server library for GNOME. It uses GObjects
+and the glib main loop, to integrate well with GNOME applications.
-It provides an queued asynchronous callback-based mechanism for sending and
-servicing SOAP requests, and a WSDL (Web Service Definition Language) to C
-compiler which generates client stubs and server skeletons for easily calling
-and implementing SOAP methods.
-
-It uses the Glib main loop and is designed to work well with GTK
-applications. This enables GNOME applications to access SOAP servers
-on the network in a completely asynchronous fashion, very similar to the
-Gtk+ programming model (a synchronous operation mode is also supported
-for those who want it).
+Features:
+ * Both asynchronous (GMainLoop and callback-based) and synchronous APIs
+ * Automatically caches connections
+ * SSL support
+ * Proxy support, including authentication and SSL tunneling
+ * Client support for Digest, NTLM, and Basic authentication
+ * Server support for Digest and Basic authentication
+ * XML-RPC support
-The WSDL compiler will help you make your applications interoperate
-with services that expose their descriptions through WSDL.
+See the documentation in docs/reference/ and the test programs in
+tests/ for simple examples of how to use the code. The
+evolution-data-server and evolution-exchange modules in GNOME CVS have
+some more complicated examples.
-Features:
- * Completely Asynchronous
- * Connection cache
- * HTTP chunked transfer support
- * authenticated HTTP, SOCKS4, and SOCKS5 proxy support
- * SSL Support using OpenSSL
- * Apache module server support
- * Client digest authentication
+There is a mailing list for libsoup-related questions/discussions at
+gnome.org. Visit http://mail.gnome.org/mailman/listinfo/libsoup-list
+to subscribe or read the archives.
-Planned Features:
- * Standalone SOAP server support
- * SSL Support through Mozilla NSS
- * Server digest authentication
- * Gconf configuration and proxy integration
- * UDDI Support
- * Disco support
- * GTK or Bonobo object generation
+Bugs against libsoup can be filed at the GNOME bugzilla:
+http://bugzilla.gnome.org/enter_bug.cgi?product=libsoup
-To subscribe to the Soup discussion list, send mail with the word "Subscribe" in
-the message body to soup-list-request@ximian.com.
+More information (including the libsoup To Do list) is available at
+http://live.gnome.org/LibSoup
Licensing:
- * The Soup runtime is licensed LGPL, see COPYING.LIB for more details.
- * The WSDL compiler is licensed GPL, see COPYING for more details.
- * The soup-ssl-proxy application is licensed GPL, see COPYING for more
- details. This is in order to comply with the licensing restrictions
- imposed by the SSL libraries used by Soup, while allowing the Soup
- application libraries and runtime to remain LGPL.
+libsoup is licensed under the LGPL, see COPYING for more details.