CXX-2697 Add search index spec tests and management helpers

[joshbsiegel]

Summary

This PR will add the search index spec tests and respective functionality needed to pass the spec tests.

Background

Due to the spec test additions made in mongodb/specifications#1423, it was necessary to sync the spec test changes made and then ensure that the driver can pass those tests. To accomplish this, we chose to add an index view API and referenced the pseudocode function definitions found in the specifications PR.

Design

The search_index_view structure is very similar to the existing index_view structure. All of the public API functions call their private counterpart which constructs a BSON command and sends it to the server. Both search_index_view and search_index_model are designed with the PIMPL pattern.

Testing

At the moment, there are only spec tests for search indexes from this commit. There is no capability for e2e testing yet but when there is a separate PR will be made with additions to test/search_index_view.cpp. Edit: e2e testing was implemented in this ticket: #1002

What's New

• 5 new spec tests
• Add functionality to return a search_index_view from a collection
• search_index_model.hpp and search_index_model.cpp
• search_index_view.hpp and search_index_view.cpp
• private/search_index_view.hh
• private/search_index_model.hh
• 5 new operation handlers in operations.cpp
• Updating CMake configuration to recognize the new files
• private/append_aggregate_options: a helper function for options::aggregate::append and search_index_view::impl::list

[joshbsiegel]

Marking a function as noexcept requires that all members of the class must also have noexcept on the corresponding function. While the _definition field is a bsoncxx::document::value which has its move assign operator as noexcept, the bsoncxx::stdx::optional<std::string> _name field does not have the same tag on its move assign operator. Instead of making changes to stdx::optional which could affect the entire codebase, it's easier to just remove the noexcept from the move assign operator.

[joshbsiegel]

This file is for future testing that cannot be done at the moment.

[joshbsiegel]

This file contains the code that was previously in options::aggregate::append. In order to reduce code duplication, the best practice would be to use append to extract the options from the options::aggregate variables passed through to list. However, because append is private, search_index_view would need to become a friend of options::aggregate. Because the code in append only accesses public variables and functions in options::aggregate and it seemed unneccessary to give search_index_view access to all of options::aggregate, we opted to move the function to a private file.

[kevinAlbs]

Nice work. LGTM with one comment.

[eramongodb]

Small feedback remaining; otherwise, LGTM. 👍

[eramongodb]

Needs similar fix as search_index_model w.r.t. error_code enumerator.

[kevinAlbs]

LGTM with minor comments addressed.

[kevinAlbs]

Suggested change

	#include <mongocxx/private/client_session.hh>
	#include <mongocxx/private/libbson.hh>
	#include <mongocxx/private/libmongoc.hh>
	#include <mongocxx/search_index_model.hpp>

Include search_index_model.hpp directly. Remove unnecessary headers.

[kevinAlbs]

Suggested change

	throw logic_error{error_code::k_invalid_search_index_model};
	throw mongocxx::logic_error{error_code::k_invalid_search_index_model};

search_index_model.cpp appears to rely on headers included throughclient_session.hh. Update search_index_model.cpp to include headers needed for throwing error:

#include <mongocxx/exception/error_code.hpp>
#include <mongocxx/exception/logic_error.hpp>