index.rst 1.1 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445
  1. .. cloudbridge documentation master file, created by
  2. sphinx-quickstart on Sat Oct 10 03:17:52 2015.
  3. You can adapt this file completely to your liking, but it should at least
  4. contain the root `toctree` directive.
  5. Welcome to cloudbridge's documentation!
  6. =======================================
  7. cloudbridge provides a layer of abstraction over different cloud providers.
  8. It's a straightfoward implementation of the `bridge pattern`_.
  9. Usage example
  10. ~~~~~~~~~~~~~
  11. The simplest possible example for doing something useful with cloudbridge would
  12. look like the following.
  13. .. code-block:: python
  14. from cloudbridge.providers.factory import CloudProviderFactory, ProviderList
  15. provider = CloudProviderFactory().create_provider(ProviderList.AWS, {})
  16. print(provider.security.key_pairs.list())
  17. In the example above, the AWS_ACCESS_KEY and AWS_SECRET_KEY environment variables
  18. must be set to your cloud credentials.
  19. Contents:
  20. .. toctree::
  21. :glob:
  22. :maxdepth: 2
  23. api_docs/cloudbridge
  24. Indices and tables
  25. ==================
  26. * :ref:`genindex`
  27. * :ref:`modindex`
  28. * :ref:`search`
  29. .. _`bridge pattern`: https://en.wikipedia.org/wiki/Bridge_pattern