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_microversion(href, id, **kwargs)¶

Add a microversion version to the list.

The parameters are the same as MicroversionDiscovery.

add_nova_microversion(href, id, **kwargs)¶

Add a nova microversion version to the list.

The parameters are the same as NovaMicroversionDiscovery.

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.

class keystoneauth1.fixture.discovery.VersionDiscovery(href, id, **kwargs)¶

Bases: keystoneauth1.fixture.discovery.DiscoveryBase

A Version element for non-keystone services without microversions.

Provides some default values and helper methods for creating a microversion 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.

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.

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>, serializer_name=None, request_matchers=None)¶

Bases: fixtures.fixture.Fixture

serializer_name¶

Determine the name of the selected serializer.

If a class was specified, use the name attribute to generate this, otherwise, use the serializer_name parameter from __init__.

Returns:	Name of the serializer
Return type:	str

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_microversion(href, id, **kwargs)¶

Add a microversion version to the list.

The parameters are the same as MicroversionDiscovery.

add_nova_microversion(href, id, **kwargs)¶

Add a nova microversion version to the list.

The parameters are the same as NovaMicroversionDiscovery.

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)¶

class keystoneauth1.fixture.VersionDiscovery(href, id, **kwargs)¶

Bases: keystoneauth1.fixture.discovery.DiscoveryBase

A Version element for non-keystone services without microversions.

Provides some default values and helper methods for creating a microversion 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.