Import .coverdata after test run and improve documentation

[zachallaun]

Hi friends! Thanks for such a great tool.

This PR adds additional documentation/usage for the --import-cover flag and makes a change that improves the ergonomics of integration test coverage.

• .coverdata is now imported just before ExCoveralls.execute/3, instead of during ExCoveralls.start/2. This allows coverage data generated during the test run to be included in the final report.
• Fixed a small error in documentation: --import_cover -> --import-cover
• Added a new section to the README with additional explanation and an example of --import-cover usage.

/cc @albertored, who first introduced this feature

[zachallaun]

Additional context for my own use-case:

I'm working on a library that modifies the behavior of mix test. To do end-to-end integration testing, some test modules are dynamically generated, saved to a temp directory, and run using a shell command to mix test.

test_command = """
echo "#{test.test_input}" | \
  CI=false mix test #{file_path} \
    --seed 0
"""

task = Task.async(System, :shell, [test_command])

This change allows me to save out the coverage data from those tests and include them in the final coverage report, all within the same test run:

test_command = """
echo "#{test.test_input}" | \
  CI=false mix test #{file_path} \
    --seed 0 \
    --cover \
    --export-coverage #{test.name}
"""

task = Task.async(System, :shell, [test_command])

Now I can run the following:

$ mix coveralls --import-cover cover

[zachallaun]

Just wanted to bump this in case it can sneak into the release you mentioned might be later today, @parroty! No worries if not :)

[parroty]

Thank you for the follow-up 🙇 .

[zachallaun]

And thank you for the work you do!