Feature: Stronger typing for file consumption

[stumpylog]

Proposed change

This is a larger change, but I think worthwhile to make. It creates 2 data classes for handling typing and serialization of types when calling the main shared task consume_file. Some of the benefits I can think of:

• Arguments are consistently serialized and serialized into the correct types, instead of maybe becoming unexpected strings
• File mime type is gotten once, early on, instead of multiple times during consume and stored for all needs downstream
• New ability to define where the document is coming from, allowing some simplifications now (and maybe useful in the future)
• Easier to add new overrides
• Testing is less dependent on kwarg names, but can use strongly typed and named fields instead
• Testing utility for getting last call or call by index, nicely decoded included

Fixes # (issue)

Type of change

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to not work as expected)
• Other (please explain)

Checklist:

• I have read & agree with the contributing guidelines.
• If applicable, I have tested my code for new features & regressions on both mobile & desktop devices, using the latest version of major browsers.
• If applicable, I have checked that all tests pass, see documentation.
• I have run all pre-commit hooks, see documentation.
• I have made corresponding changes to the documentation as needed.
• I have checked my modifications for any breaking changes.

[codecov]

Codecov Report

Merging #2744 (60c1c53) into dev (dde3205) will decrease coverage by 0.02%.
The diff coverage is 95.58%.

❗ Current head 60c1c53 differs from pull request most recent head d7cafbe. Consider uploading reports for the commit d7cafbe to get more accurate results

@@            Coverage Diff             @@
##              dev    #2744      +/-   ##
==========================================
- Coverage   93.22%   93.20%   -0.02%     
==========================================
  Files         154      152       -2     
  Lines        6497     6435      -62     
==========================================
- Hits         6057     5998      -59     
+ Misses        440      437       -3     

Flag	Coverage Δ
backend	93.20% <95.58%> (-0.02%)	⬇️

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

Impacted Files	Coverage Δ
src/documents/consumer.py	95.71% <ø> (ø)
src/paperless_mail/mail.py	88.00% <71.42%> (-0.52%)	⬇️
src/documents/tasks.py	95.30% <94.73%> (+2.99%)	⬆️
src/documents/barcodes.py	100.00% <100.00%> (ø)
src/documents/data_models.py	100.00% <100.00%> (ø)
...documents/management/commands/document_consumer.py	93.93% <100.00%> (-0.04%)	⬇️
src/documents/signals/handlers.py	88.28% <100.00%> (-0.29%)	⬇️
src/documents/views.py	95.64% <100.00%> (-0.01%)	⬇️

... and 13 files with indirect coverage changes

📣 We’re building smart automated test selection to slash your CI/CD build times. Learn more

[shamoon]

All issues look resolved, thanks stumpy!

[github-actions]

This pull request has been automatically locked since there has not been any recent activity after it was closed. Please open a new discussion or issue for related concerns.