depr: deprecate utils.archives in favor of Dataset.extract()

[dkrako]

⚠️ Deprecation

utils.archives is deprecated. please use Dataset.extract() instead.
utils.archives will be removed in pymovements v0.26.0

Description

Deprecate utils.archives in favor of Dataset.extract()

The following warning is printed:

DeprecationWarning: Call to deprecated function (or staticmethod) extract_archive. (Please use Dataset.extract() instead. This function will be removed in v0.26.0.) -- Deprecated since version v0.21.0.

partly resolves #999

blocked by #1029

Implemented changes

• moved utils/archives.py to dataset/_utils/_archives.py and adjusted to new location
• use dataset._utils.archives in dataset.dataset_download
• created deprecated function in utils/archives.py
• moved tests/unit/utils/archives_test.py to tests/unit/dataset/_utils/_archives_test.py
• add test that function is correctly deprecated
• add test that function is removed in planned version

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 100.00%. Comparing base (21d539f) to head (5e1389c).

Additional details and impacted files

@@            Coverage Diff            @@
##              main     #1028   +/-   ##
=========================================
  Coverage   100.00%   100.00%           
=========================================
  Files           80        81    +1     
  Lines         3602      3609    +7     
  Branches       646       646           
=========================================
+ Hits          3602      3609    +7     

☔ 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.

[SiQube]

thank you for cleaning up the repo structure. I think there is one PR to split up and some minor changes.