Add more explicit interface to differentiate substring and full-string wildcard queries.

[LinZhihao-723]

References

Description

As discussed in PR #27, users usually want the query to be automatically surrounded with wildcard * to match a substring. This PR implements such a query in a way we discussed and agreed on in PR #27. Essentially, this PR contains the following changes:

• Redesign WildcardQuery classes. WildcardQuery is now marked as deprecated. Instead, users should use its derived class SubstringWildcardQuery and FullStringWildcardQuery to define a wildcard query. When using SubstringWildcardQuery, * prefix and postfix will be automatically added to match a substring.
• Redesign QueryBuilder to change the method's signature of add_wildcard_query. It's taking a WildcardQuery class instead of a string and a boolean argument. The old signature can still be called but it is marked as deprecated.

We can support substring matches without breaking existing user code with the above implementations. In the future, we should also do the following cleanup:

• Formally remove the old signature of add_wildcard_query
• Make WildcardQuery as an abstract base class
• Close PR Add support for partial matching in the wildcard query #27

Validation performed

• All unit tests passed
• Add unit tests to cover deprecated functions
• CI passed, successfully built and tested across all the supported platforms and Python versions

[davidlion]

Improve add_wildcard_query

[davidlion]

As discussed lets drop no_type_check and lets try a different approach.

[davidlion]

Lets change the title + commit message to something more direct like:
Add more explicit interface to differentiate substring and full-string wildcard queries. (#62).

[LinZhihao-723]

Lets change the title + commit message to something more direct like: Add more explicit interface to differentiate substring and full-string wildcard queries. (#62).

The commit msg lgtm, thx!