keystoneauth1.fixture package

Submodules

keystoneauth1.fixture.discovery module

class keystoneauth1.fixture.discovery.DiscoveryList(href=None, v2=True, v3=True, v2_id=None, v3_id=None, v2_status=None, v2_updated=None, v2_html=True, v2_pdf=True, v3_status=None, v3_updated=None, v3_json=True, v3_xml=True)

Bases: dict

A List of version elements.

Creates a correctly structured list of identity service endpoints for use in testing with discovery.

Parameters:

• href (string) – The url that this should be based at.
• v2 (bool) – Add a v2 element.
• v3 (bool) – Add a v3 element.
• v2_status (string) – The status to use for the v2 element.
• v2_updated (DateTime) – The update time to use for the v2 element.
• v2_html (bool) – True to add a html link to the v2 element.
• v2_pdf (bool) – True to add a pdf link to the v2 element.
• v3_status (string) – The status to use for the v3 element.
• v3_updated (DateTime) – The update time to use for the v3 element.
• v3_json (bool) – True to add a html link to the v2 element.
• v3_xml (bool) – True to add a pdf link to the v2 element.

TEST_URL = 'http://keystone.host:5000/'

add_v2(href, **kwargs)

Add a v2 version to the list.

The parameters are the same as V2Discovery.

add_v3(href, **kwargs)

Add a v3 version to the list.

The parameters are the same as V3Discovery.

add_version(version)

Add a new version structure to the list.

Parameters:version (dict) – A new version structure to add to the list.

versions

class keystoneauth1.fixture.discovery.V2Discovery(href, id=None, html=True, pdf=True, **kwargs)

Bases: keystoneauth1.fixture.discovery.DiscoveryBase

A Version element for a V2 identity service endpoint.

Provides some default values and helper methods for creating a v2.0 endpoint version structure. Clients should use this instead of creating their own structures.

Parameters:

• href (string) – The url that this entry should point to.
• id (string) – The version id that should be reported. (optional) Defaults to ‘v2.0’.
• html (bool) – Add HTML describedby links to the structure.
• pdf (bool) – Add PDF describedby links to the structure.

add_html_description()

Add the HTML described by links.

The standard structure includes a link to a HTML document with the API specification. Add it to this entry.

add_pdf_description()

Add the PDF described by links.

The standard structure includes a link to a PDF document with the API specification. Add it to this entry.

class keystoneauth1.fixture.discovery.V3Discovery(href, id=None, json=True, xml=True, **kwargs)

Bases: keystoneauth1.fixture.discovery.DiscoveryBase

A Version element for a V3 identity service endpoint.

Provides some default values and helper methods for creating a v3 endpoint version structure. Clients should use this instead of creating their own structures.

Parameters:

• href – The url that this entry should point to.
• id (string) – The version id that should be reported. (optional) Defaults to ‘v3.0’.
• json (bool) – Add JSON media-type elements to the structure.
• xml (bool) – Add XML media-type elements to the structure.

add_json_media_type()

Add the JSON media-type links.

The standard structure includes a list of media-types that the endpoint supports. Add JSON to the list.

add_xml_media_type()

Add the XML media-type links.

The standard structure includes a list of media-types that the endpoint supports. Add XML to the list.

keystoneauth1.fixture.exception module

exception keystoneauth1.fixture.exception.FixtureValidationError

Bases: exceptions.Exception

The token you created is not legitimate.

The data contained in the token that was generated is not valid and would not have been returned from a keystone server. You should not do testing with this token.

keystoneauth1.fixture.hooks module

Custom hooks for betamax and keystoneauth.

Module providing a set of hooks specially designed for interacting with clouds and keystone authentication.

author:Yolanda Robla

keystoneauth1.fixture.hooks.mask_fixture_values(nested, prev_key)

keystoneauth1.fixture.hooks.pre_record_hook(interaction, cassette)

Hook to mask saved data.

This hook will be triggered before saving the interaction, and will perform two tasks: - mask user, project and password in the saved data - set token expiration time to an inifinite time.

keystoneauth1.fixture.keystoneauth_betamax module

A fixture to wrap the session constructor for use with Betamax.

class keystoneauth1.fixture.keystoneauth_betamax.BetamaxFixture(cassette_name, cassette_library_dir=None, serializer=None, record=False, pre_record_hook=<function pre_record_hook at 0x7fbcdfd360c8>)

Bases: fixtures.fixture.Fixture

setUp()

keystoneauth1.fixture.serializer module

A serializer to emit YAML but with request body in nicely formatted JSON.

class keystoneauth1.fixture.serializer.YamlJsonSerializer

Bases: betamax.serializers.base.BaseSerializer

deserialize(cassette_data)

static generate_cassette_name(cassette_library_dir, cassette_name)

name = 'yamljson'

serialize(cassette_data)

keystoneauth1.fixture.v2 module

class keystoneauth1.fixture.v2.Token(token_id=None, expires=None, issued=None, tenant_id=None, tenant_name=None, user_id=None, user_name=None, trust_id=None, trustee_user_id=None, audit_id=None, audit_chain_id=None)

Bases: dict

A V2 Keystone token that can be used for testing.

This object is designed to allow clients to generate a correct V2 token for use in there test code. It should prevent clients from having to know the correct token format and allow them to test the portions of token handling that matter to them and not copy and paste sample.

add_role(name=None, id=None)

add_service(type, name=None)

audit_chain_id

audit_id

expires

expires_str

issued

issued_str

root

set_bind(name, data)

set_scope(id=None, name=None)

set_trust(id=None, trustee_user_id=None)

tenant_id

tenant_name

token_id

trust_id

trustee_user_id

user_id

user_name

validate()

keystoneauth1.fixture.v3 module

class keystoneauth1.fixture.v3.Token(expires=None, issued=None, user_id=None, user_name=None, user_domain_id=None, user_domain_name=None, methods=None, project_id=None, project_name=None, project_domain_id=None, project_domain_name=None, domain_id=None, domain_name=None, trust_id=None, trust_impersonation=None, trustee_user_id=None, trustor_user_id=None, oauth_access_token_id=None, oauth_consumer_id=None, audit_id=None, audit_chain_id=None, is_admin_project=None, project_is_domain=None)

Bases: dict

A V3 Keystone token that can be used for testing.

This object is designed to allow clients to generate a correct V3 token for use in there test code. It should prevent clients from having to know the correct token format and allow them to test the portions of token handling that matter to them and not copy and paste sample.

add_role(name=None, id=None)

add_service(type, name=None, id=None)

add_service_provider(sp_id, sp_auth_url, sp_url)

audit_chain_id

audit_id

domain_id

domain_name

expires

expires_str

is_admin_project

issued

issued_str

methods

oauth_access_token_id

oauth_consumer_id

project_domain_id

project_domain_name

project_id

project_is_domain

project_name

role_ids

role_names

root

service_providers

set_bind(name, data)

set_domain_scope(id=None, name=None)

set_oauth(access_token_id=None, consumer_id=None)

set_project_scope(id=None, name=None, domain_id=None, domain_name=None, is_domain=None)

set_trust_scope(id=None, impersonation=False, trustee_user_id=None, trustor_user_id=None)

trust_id

trust_impersonation

trustee_user_id

trustor_user_id

user_domain_id

user_domain_name

user_id

user_name

validate()

class keystoneauth1.fixture.v3.V3FederationToken(methods=None, identity_provider=None, protocol=None, groups=None)

Bases: keystoneauth1.fixture.v3.Token

A V3 Keystone Federation token that can be used for testing.

Similar to V3Token, this object is designed to allow clients to generate a correct V3 federation token for use in test code.

FEDERATED_DOMAIN_ID = 'Federated'

add_federation_info_to_user(identity_provider=None, protocol=None, groups=None)

Module contents

Produce keystone compliant structures for use in testing.

They are part of the public API because they may be relied upon to generate test tokens for other clients. However they should never be imported into the main client (keystoneauth or other). Because of this there may be dependencies from this module on libraries that are only available in testing.

class keystoneauth1.fixture.DiscoveryList(href=None, v2=True, v3=True, v2_id=None, v3_id=None, v2_status=None, v2_updated=None, v2_html=True, v2_pdf=True, v3_status=None, v3_updated=None, v3_json=True, v3_xml=True)

Bases: dict

A List of version elements.

Creates a correctly structured list of identity service endpoints for use in testing with discovery.

Parameters:

• href (string) – The url that this should be based at.
• v2 (bool) – Add a v2 element.
• v3 (bool) – Add a v3 element.
• v2_status (string) – The status to use for the v2 element.
• v2_updated (DateTime) – The update time to use for the v2 element.
• v2_html (bool) – True to add a html link to the v2 element.
• v2_pdf (bool) – True to add a pdf link to the v2 element.
• v3_status (string) – The status to use for the v3 element.
• v3_updated (DateTime) – The update time to use for the v3 element.
• v3_json (bool) – True to add a html link to the v2 element.
• v3_xml (bool) – True to add a pdf link to the v2 element.

TEST_URL = 'http://keystone.host:5000/'

add_v2(href, **kwargs)

Add a v2 version to the list.

The parameters are the same as V2Discovery.

add_v3(href, **kwargs)

Add a v3 version to the list.

The parameters are the same as V3Discovery.

add_version(version)

Add a new version structure to the list.

Parameters:version (dict) – A new version structure to add to the list.

versions

exception keystoneauth1.fixture.FixtureValidationError

Bases: exceptions.Exception

The token you created is not legitimate.

The data contained in the token that was generated is not valid and would not have been returned from a keystone server. You should not do testing with this token.

class keystoneauth1.fixture.V2Discovery(href, id=None, html=True, pdf=True, **kwargs)

Bases: keystoneauth1.fixture.discovery.DiscoveryBase

A Version element for a V2 identity service endpoint.

Provides some default values and helper methods for creating a v2.0 endpoint version structure. Clients should use this instead of creating their own structures.

Parameters:

• href (string) – The url that this entry should point to.
• id (string) – The version id that should be reported. (optional) Defaults to ‘v2.0’.
• html (bool) – Add HTML describedby links to the structure.
• pdf (bool) – Add PDF describedby links to the structure.

add_html_description()

Add the HTML described by links.

The standard structure includes a link to a HTML document with the API specification. Add it to this entry.

add_pdf_description()

Add the PDF described by links.

The standard structure includes a link to a PDF document with the API specification. Add it to this entry.

class keystoneauth1.fixture.V3Discovery(href, id=None, json=True, xml=True, **kwargs)

Bases: keystoneauth1.fixture.discovery.DiscoveryBase

A Version element for a V3 identity service endpoint.

Provides some default values and helper methods for creating a v3 endpoint version structure. Clients should use this instead of creating their own structures.

Parameters:

• href – The url that this entry should point to.
• id (string) – The version id that should be reported. (optional) Defaults to ‘v3.0’.
• json (bool) – Add JSON media-type elements to the structure.
• xml (bool) – Add XML media-type elements to the structure.

add_json_media_type()

Add the JSON media-type links.

The standard structure includes a list of media-types that the endpoint supports. Add JSON to the list.

add_xml_media_type()

Add the XML media-type links.

The standard structure includes a list of media-types that the endpoint supports. Add XML to the list.

keystoneauth1.fixture.V2Token

alias of Token

keystoneauth1.fixture.V3Token

alias of Token

class keystoneauth1.fixture.V3FederationToken(methods=None, identity_provider=None, protocol=None, groups=None)

Bases: keystoneauth1.fixture.v3.Token

A V3 Keystone Federation token that can be used for testing.

Similar to V3Token, this object is designed to allow clients to generate a correct V3 federation token for use in test code.

FEDERATED_DOMAIN_ID = 'Federated'

add_federation_info_to_user(identity_provider=None, protocol=None, groups=None)