Digitalmarketplace-apiclient

PR: [111](https://github.com/alphagov/digitalmarketplace-apiclient/pull/111)

`mapping` parameter is now required for Search API index creation, as we must be
able to distinguish between the 'services' mapping and the forthcoming potential
`briefs` mapping. We might also in future have multiple mappings to cover a new
non-compatible G-Cloud index, for advance preparation of the new index in advance
of the framework going live.

PR: [105](https://github.com/alphagov/digitalmarketplace-apiclient/pull/105)

Gives `user_id` parameter a default for `find_direct_award_project_searches` and `get_direct_award_project_services`,
which changes the order of their positional parameters.

The old/new examples below are calling the methods with no `user_id` and a `project_id` of 123.

Old

data_api_client.get_direct_award_project_services(None, 123)
data_api_client.find_direct_award_project_searches(None, 123)


New

data_api_client.get_direct_award_project_services(123)
data_api_client.find_direct_award_project_searches(123)

PR: [90](https://github.com/alphagov/digitalmarketplace-apiclient/pull/90)

Removes an unused parameter from the get_direct_award_project endpint.

Old
python
data_api_client.get_direct_award_project(user_id=123, project_id=123)


New
python
data_api_client.get_direct_award_project(project_id=123)

PR: [86](https://github.com/alphagov/digitalmarketplace-apiclient/pull/86)

Remove the default index from the Search API Client; it is now a required argument.

Example app cange

Old
python
search_api_client.search_services(q='hosting')


New
python
search_api_client.search_services(index='g-cloud-9', q='hosting')

PR: [62](https://github.com/alphagov/digitalmarketplace-apiclient/pull/62)

What changed

Removed `import_supplier` and `import_service` methods.

These routes have been around since G6, when we were importing a bunch of complete suppliers and their related services. As they were all production-ready (they already had IDs and everything) we just needed a way to create a new object from a JSON blob.

New services created through the app must start out as drafts, and for both services and suppliers IDs are assigned at creation time. This is what we are doing now and will continue doing going forward.

Technically this a breaking change because we are removing functionality, but IRL there were only two scripts using them and those are being deleted.

Example app change

Old
python
import suppler
api_client.import_supplier(1, {"supplier": "data"})


import service
api_client.import_service(1, {"service": "data"}, "paulpaul.paul")


New

You can't do this any more.

PR: [45](https://github.com/alphagov/digitalmarketplace-apiclient/pull/45)

What changed

Removed `temp_script_countersign_agreement` method.

This route, which allowed the timestamp for countersigning an agreement to be arbitrarily set, only existed for a
one-off script that has now been run on production.

Example app change

Old
python
api_client.temp_script_countersign_agreement(framework_agreement_id, countersigned_path, countersigned_at, user)


New

You can't do this any more.