Issue #155 earnings calendar

[Amiram1]

Enhancement following #155

New earnings_calendar api based on the economic calendar api and follows the same logic as investing.com:

https://www.investing.com/earnings-calendar/

This allows to fetch company earnings updates: EPS, forecast EPS, revenue, forecast revenue, market cap etc.

basic usage:

        df = investpy.earnings_calendar(time_zone=param['time_zone'],
                              time_filter=param['time_filter'],
                              countries=param['countries'],
                              importances=param['importances'],
                              sectors=param['sectors'],
                              from_date=param['from_date'],
                              to_date=param['to_date'])

3 open tasks to resolve:

• would it be better to extract the shared logic with economic_calendar instead of the duplicated code?

• sectors don't work yet, need to check investing.com API for the exact sectors definitions

• missing the earnings_time parser (BMO, AMC), seems to be inconsistent in investing.com

[codecov]

Codecov Report

Merging #242 (aee0178) into master (ca9b3d5) will decrease coverage by 0.03%.
The diff coverage is 89.71%.

@@            Coverage Diff             @@
##           master     #242      +/-   ##
==========================================
- Coverage   90.96%   90.93%   -0.04%     
==========================================
  Files          26       26              
  Lines        4902     5007     +105     
==========================================
+ Hits         4459     4553      +94     
- Misses        443      454      +11     

[alvarobartt]

Cool @Amiram1! Thanks for the great work here 💪🏻 Should I wait until you complete the TODOs you have on your initial comment or do you want me to merge this now and iterate over a new PR to solve those?

Thanks a lot! 🤗

[alvarobartt]

Again, you did a great work here, taking care of the docstrings and the tests too! 💪🏻 Keep it up!

[Amiram1]

Thanks @alvarobartt happy to help, up to you if you want to merge it as is :-) I'm not sure when I'll have time to continue the open tasks

[alvarobartt]

Ok @Amiram1 then before merging this PR, could you please explain this 2 points you previously mentioned in just a few lines so that I can report those in order to tackle them later?

1 - Sectors don't work yet, need to check Investing.com API for the exact sectors definitions.
2 - Missing the earnings_time parser (BMO, AMC), seems to be inconsistent in Investing.com.

Thanks a lot! 👍🏻

[Amiram1]

Of course -
1 - Sectors - under https://www.investing.com/earnings-calendar/ there are options to filter companies by sectors, for the financial calendar the categories values are listed under consts for example: 'employment': '_employment'. For sectors we need to find out the correct sector values and update the SECTOR_FILTERS const dict

2 - earnings_time appear in https://www.investing.com/earnings-calendar/ as moon (After Markets Close) or sun icons (Before Markets Open). We need to parse correctly each row and add to earnings_time

[atowersc]

great function. this is already available in the master or not yet?