Added date argument in prtvol2csv (#712)

[lilbe66]

Closes #712

• Added date argument to prtvol2csv.py, to extract volumes from PRT file at the specified date
• Included function to search for report date in PRT file
• Check that a volume report exists at the specified date
• Check that the date provided has ISO 8601 format, or one of the strings "first" and "last"
• Updated the ERT forward model for prtvol2csv with a date argument
• Updated the documentation (Subscript, ERT)

[codecov-commenter]

Codecov Report

❌ Patch coverage is 92.47312% with 7 lines in your changes missing coverage. Please review.
✅ Project coverage is 84.51%. Comparing base (e949b0d) to head (5dadeb8).
⚠️ Report is 5 commits behind head on main.

Files with missing lines	Patch %	Lines
src/subscript/prtvol2csv/prtvol2csv.py	92.39%	7 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #850      +/-   ##
==========================================
+ Coverage   83.52%   84.51%   +0.98%     
==========================================
  Files          49       49              
  Lines        7279     7349      +70     
==========================================
+ Hits         6080     6211     +131     
+ Misses       1199     1138      -61     

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

[Copilot]

Pull request overview

This pull request adds functionality to extract volumes from PRT files at a specified date by introducing a --date argument to the prtvol2csv tool. The changes allow users to specify either an ISO-8601 formatted date (YYYY-MM-DD) or the strings "first" or "last" to select which BALANCE report to extract volumes from.

Changes:

• Added date argument support with validation for ISO-8601 format or "first"/"last" keywords
• Modified function signatures to return additional date information
• Added helper functions for date parsing and validation from PRT files
• Enhanced test coverage with new test cases and test data

Reviewed changes

Copilot reviewed 4 out of 5 changed files in this pull request and generated 17 comments.

Show a summary per file

File	Description
src/subscript/prtvol2csv/prtvol2csv.py	Core implementation: added date parameter, date parsing functions, and modified return types to include date information
tests/test_prtvol2csv.py	Added comprehensive tests for date parsing, validation, and command-line usage with date argument
src/subscript/rmsecl_volumetrics/rmsecl_volumetrics.py	Updated to handle new tuple return type from currently_in_place_from_prt
tests/testdata_prtvol2csv/DROGON_NOBAL_FLOW.PRT	New test data file for Flow PRT files without BALANCE reports
tests/testdata_prtvol2csv/0readme.txt	Documentation of test data files

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

Pull request overview

Copilot reviewed 4 out of 5 changed files in this pull request and generated 6 comments.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[rnyb]

LGTM