reference-feed-cloud.rst 1.8 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465
  1. :py:attr:`feed.cloud`
  2. =====================
  3. No one really knows what a cloud is. It is vaguely documented in `:abbr:`SOAP
  4. (Simple Object Access Protocol)` meets :abbr:`RSS (Rich Site Summary)`
  5. <http://www.thetwowayweb.com/soapmeetsrss>`_.
  6. .. _reference.feed.cloud.domain:
  7. :py:attr:`feed.cloud.domain`
  8. ----------------------------
  9. The domain of the cloud. Should be just the domain name, not including the
  10. http:// protocol. All clouds are presumed to operate over :abbr:`HTTP
  11. (Hypertext Transfer Protocol)`. The cloud specification does not support
  12. secure clouds over :abbr:`HTTPS`, nor can clouds operate over other protocols.
  13. .. _reference.feed.cloud.port:
  14. :py:attr:`feed.cloud.port`
  15. --------------------------
  16. The port of the cloud. Should be an integer, but :program:`Universal Feed
  17. Parser` currently returns it as a string.
  18. .. _reference.feed.cloud.path:
  19. :py:attr:`feed.cloud.path`
  20. --------------------------
  21. The :abbr:`URL (Uniform Resource Locator)` path of the cloud.
  22. .. _reference.feed.cloud.registerProcedure:
  23. :py:attr:`feed.cloud.registerProcedure`
  24. ---------------------------------------
  25. The name of the procedure to call on the cloud.
  26. .. _reference.feed.cloud.protocol:
  27. :py:attr:`feed.cloud.protocol`
  28. ------------------------------
  29. The protocol of the cloud. Documentation differs on what the acceptable values
  30. are. Acceptable values definitely include xml-rpc and soap, although only in
  31. lowercase, despite both being acronyms.
  32. There is no way for a publisher to specify the version number of the protocol
  33. to use. soap refers to :abbr:`SOAP (Simple Object Access Protocol)` 1.1; the
  34. cloud interface does not support :abbr:`SOAP (Simple Object Access Protocol)`
  35. 1.0 or 1.2.
  36. post or http-post might also be acceptable values; nobody really knows for
  37. sure.
  38. .. rubric:: Comes from
  39. * /rss/channel/cloud