Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Enhancement documentation #52

Open
wants to merge 4 commits into
base: master
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 20 additions & 0 deletions docs/Makefile
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
# Minimal makefile for Sphinx documentation
#

# You can set these variables from the command line.
SPHINXOPTS =
SPHINXBUILD = sphinx-build
SPHINXPROJ = OpenStack-In-A-Box
SOURCEDIR = .
BUILDDIR = _build

# Put it first so that "make" without argument is like "make help".
help:
@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)

.PHONY: help Makefile

# Catch-all target: route all unknown targets to Sphinx using the new
# "make mode" option. $(O) is meant as a shortcut for $(SPHINXOPTS).
%: Makefile
@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
10 changes: 10 additions & 0 deletions docs/api/index.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
Class and Functions
===================

.. toctree::
:maxdepth: 2

manager
models/index
services/index
utils/index
23 changes: 23 additions & 0 deletions docs/api/manager.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,23 @@
.. _manager:

OpenStackInABox Manager
=======================

.. currentmodule:: openstackinabox.manager

Exceptions
----------

.. autoexception:: OpenStackServiceManagerException

.. autoexception:: ServiceNotAvailable

.. autoexception:: ServiceVersionNotAvailable

.. autoexception:: KeystoneUrlNotSet

Manager
-------

.. autoclass:: OpenStackServicesManager
:members:
9 changes: 9 additions & 0 deletions docs/api/models/base_db.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
.. _base_db:

Model Database Base
===================

.. currentmodule:: openstackinabox.models.base_db

.. autoclass:: ModelDbBase
:members:
11 changes: 11 additions & 0 deletions docs/api/models/base_model.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
.. _base_model:

Base Model
==========

.. currentmodule:: openstackinabox.models.base_model

.. autoexception:: BaseModelExceptions

.. autoclass:: BaseModel
:members:
9 changes: 9 additions & 0 deletions docs/api/models/cinder/index.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
OpenStack Cinder Services
=========================

.. currentmodule:: openstackinabox.models.cinder

.. toctree::
:maxdepth: 2

model
9 changes: 9 additions & 0 deletions docs/api/models/cinder/model.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
.. _cinder_model:

Cinder Model
============

.. currentmodule:: openstackinabox.models.cinder.model

.. autoclass:: CinderModel
:members:
13 changes: 13 additions & 0 deletions docs/api/models/index.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
OpenStack Service Models
========================

.. currentmodule:: openstackinabox.models

.. toctree::
:maxdepth: 2

base_db
base_model
cinder/index
keystone/index
swift/index
9 changes: 9 additions & 0 deletions docs/api/models/keystone/db/base.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
.. _keystone_db_base:

Keystone Database Base
======================

.. currentmodule:: openstackinabox.models.keystone.db.base

.. autoclass:: KeystoneDbBase
:members:
9 changes: 9 additions & 0 deletions docs/api/models/keystone/db/endpoints.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
.. _keystone_db_endpoints:

Keystone Endpoints Database
===========================

.. currentmodule:: openstackinabox.models.keystone.db.endpoints

.. autoclass:: KeystoneDbServiceEndpoints
:members:
15 changes: 15 additions & 0 deletions docs/api/models/keystone/db/index.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
OpenStack Keystone Services
===========================

.. currentmodule:: openstackinabox.models.keystone.db

.. toctree::
:maxdepth: 2

base
endpoints
roles
services
tenants
tokens
users
9 changes: 9 additions & 0 deletions docs/api/models/keystone/db/roles.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
.. _keystone_db_roles:

Keystone Roles Database
=======================

.. currentmodule:: openstackinabox.models.keystone.db.roles

.. autoclass:: KeystoneDbRoles
:members:
9 changes: 9 additions & 0 deletions docs/api/models/keystone/db/services.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
.. _keystone_db_services:

Keystone Services Database
==========================

.. currentmodule:: openstackinabox.models.keystone.db.services

.. autoclass:: KeystoneDbServices
:members:
9 changes: 9 additions & 0 deletions docs/api/models/keystone/db/tenants.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
.. _keystone_db_tenants:

Keystone Tenants Database
=========================

.. currentmodule:: openstackinabox.models.keystone.db.tenants

.. autoclass:: KeystoneDbTenants
:members:
9 changes: 9 additions & 0 deletions docs/api/models/keystone/db/tokens.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
.. _keystone_db_tokens:

Keystone Tokens Database
========================

.. currentmodule:: openstackinabox.models.keystone.db.tokens

.. autoclass:: KeystoneDbTokens
:members:
9 changes: 9 additions & 0 deletions docs/api/models/keystone/db/users.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
.. _keystone_db_users:

Keystone Users Database
=======================

.. currentmodule:: openstackinabox.models.keystone.db.users

.. autoclass:: KeystoneDbUsers
:members:
40 changes: 40 additions & 0 deletions docs/api/models/keystone/exceptions.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,40 @@
.. _keystone_model_exceptions:

Keystone Model Exceptions
=========================

.. currentmodule:: openstackinabox.models.keystone.exceptions

.. autoexception:: KeystoneError

.. autoexception:: KeystoneTenantError

.. autoexception:: KeystoneUserError

.. autoexception:: KeystoneDisabledUserError

.. autoexception:: KeystoneUnknownUserError

.. autoexception:: KeystoneUserAuthError

.. autoexception:: KeystoneUserInvalidPasswordError

.. autoexception:: KeystoneUserInvalidApiKeyError

.. autoexception:: KeystoneTokenError

.. autoexception:: KeystoneInvalidTokenError

.. autoexception:: KeystoneRevokedTokenError

.. autoexception:: KeystoneExpiredTokenError

.. autoexception:: KeystoneRoleError

.. autoexception:: KeystoneServiceCatalogError

.. autoexception:: KeystoneServiceCatalogServiceError

.. autoexception:: KeystoneServiceCatalogEndpointError

.. autoexception:: KeystoneEndpointUrlError
11 changes: 11 additions & 0 deletions docs/api/models/keystone/index.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
OpenStack Keystone Services
===========================

.. currentmodule:: openstackinabox.models.keystone

.. toctree::
:maxdepth: 2

exceptions
model
db/index
9 changes: 9 additions & 0 deletions docs/api/models/keystone/model.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
.. _keystone_model:

Keystone Model
==============

.. currentmodule:: openstackinabox.models.keystone.model

.. autoclass:: KeystoneModel
:members:
14 changes: 14 additions & 0 deletions docs/api/models/swift/exceptions.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
.. _swift_model_exceptions:

Swift Model Exceptions
======================

.. currentmodule:: openstackinabox.models.swift.exceptions

.. autoexception:: SwiftExceptions

.. autoexception:: SwiftUnknownTenantError

.. autoexception:: SwiftUnknownContainerError

.. autoexception:: SwiftUnknownObjectError
11 changes: 11 additions & 0 deletions docs/api/models/swift/index.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
OpenStack Swift Services
=========================

.. currentmodule:: openstackinabox.models.swift

.. toctree::
:maxdepth: 2

exceptions
model
storage
9 changes: 9 additions & 0 deletions docs/api/models/swift/model.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
.. _swift_model:

Swift Model
===========

.. currentmodule:: openstackinabox.models.swift.model

.. autoclass:: SwiftServiceModel
:members:
9 changes: 9 additions & 0 deletions docs/api/models/swift/storage.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
.. _swift_model_storage:

Swift Storage Model
===================

.. currentmodule:: openstackinabox.models.swift.storage

.. autoclass:: SwiftStorage
:members:
9 changes: 9 additions & 0 deletions docs/api/services/base_service.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
.. _base_service:

Base Service
============

.. currentmodule:: openstackinabox.services.base_service

.. autoclass:: BaseService
:members:
9 changes: 9 additions & 0 deletions docs/api/services/cinder/index.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
OpenStack Cinder Service
========================

.. currentmodule:: openstackinabox.services.cinder

.. toctree::
:maxdepth: 2

v1/index
9 changes: 9 additions & 0 deletions docs/api/services/cinder/v1/base.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
.. _cinder_v1_base:

Cinder v1 Base Service
======================

.. currentmodule:: openstackinabox.services.cinder.v1.base

.. autoclass:: CinderV1ServiceBase
:members:
10 changes: 10 additions & 0 deletions docs/api/services/cinder/v1/index.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
OpenStack Cinder v1 Service
===========================

.. currentmodule:: openstackinabox.services.cinder.v1

.. toctree::
:maxdepth: 2

base
volumes
9 changes: 9 additions & 0 deletions docs/api/services/cinder/v1/volumes.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
.. _volumes:

Cinder v1 Volumes
=================

.. currentmodule:: openstackinabox.services.cinder.v1.volumes

.. autoclass:: CinderV1Volumes
:members:
12 changes: 12 additions & 0 deletions docs/api/services/index.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
OpenStack Services
==================

.. currentmodule:: openstackinabox.services

.. toctree::
:maxdepth: 2

base_service
cinder/index
keystone/index
swift/index
9 changes: 9 additions & 0 deletions docs/api/services/keystone/index.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
OpenStack Keystone Services
===========================

.. currentmodule:: openstackinabox.services.keystone

.. toctree::
:maxdepth: 2

v2/index
9 changes: 9 additions & 0 deletions docs/api/services/keystone/v2/base.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
.. _keystone_v2_base:

Keystone V2 Base Service
========================

.. currentmodule:: openstackinabox.services.keystone.v2.base

.. autoclass:: KeystoneV2ServiceBase
:members:
Loading