[WIP] add find_date function and tests: finds the first date

[lopuhin]

This function is similar to search_dates, but gets only the first date, and more suitable to shorts strings. It uses a brute-force approach, but has more predictable performance (at least on shorter strings - we limit the length to 100), and better quality in our tests, although still not perfect.

Not sure if it should be exposed in current form, but may be useful for future development.

NOTE: this PR is not worked on currently and free to pick up.

TODO:

• gather feedback on whether the API (finding the first match) makes sense? Maybe instead we could have an API similar to search_dates and make this a generator, allowing the user to stop at the first match. Although that would likely make the implementation a bit harder.
• Also what's about new vs old search dates? There are likely cases when old search dates works better in terms of performance or quality, and we won't maintain full backwards compatibility if we replace.
• clean up the API regarding languages (not sure if auto-adding 'en' and auto-detection is what we want) - that would require some test changes
• clean up the date cleanup code - it might be invalid for some languages?
• take care of the docs

[codecov]

Codecov Report

❌ Patch coverage is 94.44444% with 2 lines in your changes missing coverage. Please review.
✅ Project coverage is 98.21%. Comparing base (255c421) to head (2af6489).
⚠️ Report is 288 commits behind head on master.

Files with missing lines	Patch %	Lines
dateparser/find_date.py	94.44%	2 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##           master     #931      +/-   ##
==========================================
- Coverage   98.26%   98.21%   -0.06%     
==========================================
  Files         231      232       +1     
  Lines        2597     2633      +36     
==========================================
+ Hits         2552     2586      +34     
- Misses         45       47       +2     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[gavishpoddar]

Many of the issues associated with the search_dates can be solved if this code is used to improve the current search_dates.

Like #930, #918, #921, #894 will be resolved.

[gavishpoddar]

Tests seem to be failing with Python 3.5 because was it introduced in Python 3.6 which provides a guarantee that keyword arguments are passed in the same order they appear in the code (from left to right)

PEP 468 -- Preserving the order of **kwargs in a function.

A possible solution for the issue,
We may need to pass the input as a sequence of tuples to preserve ordering.

[serhii73]

We can close this PR after merging #945