pytest-oarepo 3.1.0

No project description provided

pytest oarepo

Pytest fixtures and other test code for OARepo.

The module is divided into different parts for basic repositories, repositories with requests and repositories with communities.

How to use:

For fixtures, add to your conftest.py following

pytest_plugins = [
    "pytest_oarepo.requests.fixtures",
    "pytest_oarepo.records",
    "pytest_oarepo.fixtures",
    "pytest_oarepo.users",
]

Other code can be imported like everything else

The basic package contains:

• fixtures
  • host - where the tests are running
  • link2testclient - helper function to convert links into format used by pytest test client
  • default_record_json - basic data for record creation without workflow
  • default_record_with_workflow_json - the same but with explicitly added default workflow
  • prepare_record_data - Function for merging input definitions into data passed to record service.
  • vocab_cf - initiates OARepo defined custom fields, expected to be used as autouse where needed
  • logged_client - wrapper ensuring the correct user sends an api requests
• functions
  • link2testclient - transforms resource link to form used by pytest test clients
  • is_valid_subdict - Checks whether dictionary is valid subdictionary and returns where they differ if not.
• records
  • draft_factory - Creates instance of a draft, additionally allows specifying custom workflow, additional draft data, expand and other keywords arguments for the record service. Example of use with custom workflow:

  draft1 = draft_factory(user1.identity, custom_workflow="with_approve")
  

  • record_factory - the same for published records
  • record_with_files_factory - the same for published records with attached file
• users
  • a bunch of user fixtures

The requests module contains

• fixtures
  • requests_service - Underlying requests service
  • requests_events_service - Underlying service for creating request events
  • oarepo_requests_service - OARepo requests service
  • role - Returns a group object that can be used as receiver of a request for example.
  • role_ui_serialization - Returns an expected ui serialization of the group object
  • events_resource_data - Default data for creating a request event.
  • request_type_additional_data - Function giving additional data if specific request type needs them
  • create_request - Base fixture for creating a request.
  • create_request_on_draft - Fixture for creating a request on a draft.

      resp_request_create = create_request_on_draft(
        creator.identity, draft1_id, "publish_draft"
    )
  

  • create_request_on_record - Fixture for creating a request on a published record.
  • submit_request_on_draft - Fixture for creating and submitting request on a draft in one call.
  • submit_request_on_record - Fixture for creating and submitting request on a published record in one call.
  • submit_request - creates and submits specific request on a specific record
• classes
  • TestEventType - Custom generic EventType usable in tests.
  • UserGenerator - Permission generator primarily used to define specific user as recipient of a request.
• functions
  • get_request_type - Function returning dict representing serialized request type from serialized request types on record.
  • get_request_create_link - The same but returns create link.

The communities module contains

• fixtures
  • community_inclusion_service - service for direct inclusion and exclusion of records from communities
  • community_records_service - service for communities related record creations and searches
  • minimal_community - Default data used for creating a new community.
  • init_communities_cf - init oarepo specific custom fields including the ones relevant for communities, expected to be used with autouse
  • community - Basic community.
  • community_owner - User fixture used as owner of the community fixture.
  • community_get_or_create - Function returning existing community or creating new one if one with the same slug doesn't exist.
• functions
  • invite - Adds user into a community in a specified role.
  • remove_member_from_community - Removes a user from a community.
  • set_community_workflow - Set default workflow of a community.
• records
  • draft_with_community_factory - Creates instance of a draft in specified community.
  • published_record_with_community_factory - Creates instance of a published record in specified community.