Switch to sphinxcontrib.apidoc for automatically updating API docs

[djhoese]

As mentioned in #1540, this adds sphinxcontrib.apidoc to your sphinx documentation generation so it automatically reloads the satpy api and has up to date modules/structure.

• Closes Add missing docs with sphinx-apidoc #1540 modifier API documentation not included with sphinx-generated API documentation #1538
• Fully documented

[codecov]

Codecov Report

Merging #1543 (4a6adb8) into master (ae77ccd) will decrease coverage by 1.14%.
The diff coverage is 83.33%.

@@            Coverage Diff             @@
##           master    #1543      +/-   ##
==========================================
- Coverage   92.02%   90.88%   -1.15%     
==========================================
  Files         249      249              
  Lines       36325    36334       +9     
==========================================
- Hits        33429    33022     -407     
- Misses       2896     3312     +416     

Flag	Coverage Δ
behaviourtests	4.35% <13.33%> (+<0.01%)	⬆️
unittests	91.41% <83.33%> (-1.16%)	⬇️

Flags with carried forward coverage won't be shown. Click here to find out more.

Impacted Files	Coverage Δ
satpy/readers/ahi_l1b_gridded_bin.py	99.05% <ø> (ø)
satpy/readers/fci_l2_nc.py	92.80% <ø> (ø)
satpy/readers/goes_imager_nc.py	65.46% <0.00%> (ø)
satpy/readers/iasi_l2_so2_bufr.py	25.80% <ø> (-68.82%)	⬇️
satpy/readers/mimic_TPW2_nc.py	80.95% <ø> (ø)
satpy/readers/nucaps.py	89.14% <ø> (-0.05%)	⬇️
satpy/readers/nwcsaf_nc.py	60.40% <0.00%> (ø)
satpy/readers/olci_nc.py	91.42% <0.00%> (ø)
satpy/readers/scmi.py	82.91% <0.00%> (ø)
satpy/tests/reader_tests/test_ahi_hsd.py	100.00% <ø> (ø)
... and 35 more

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update ae77ccd...f8e89f5. Read the comment docs.

[ghost]

DeepCode failed to analyze this pull request

Something went wrong despite trying multiple times, sorry about that.
Please comment this pull request with "Retry DeepCode" to manually retry, or contact us so that a human can look into the issue.

[djhoese]

It is done! The website and linting complete with no errors...I hope. Tests do not run on github unless linting passes. The website is executed and if there are any warnings they are raised as an error.

[mraspaud]

LGTM, just one inline question

[mraspaud]

Why?

[djhoese]

This is an old reader that hasn't been updated to use xarray yet and has a lot of style issues (same for li_l2.py and the others).

[djhoese]

To clarify more, these modules use the deprecated Dataset import. To fully fix the styling in them I would have to update them to use xarray as flake8 (with all the various plugins we use) will likely complain about things in some way.

[mraspaud]

Are we running doctests on satpy btw?

[djhoese]

We are not and I'm not sure they are set up to be doctested (using non-existent paths, etc).

[sfinkens]

Awesome, thanks!