Update PyROS Solver Argument Resolution and Validation Routines

[shermanjasonaf]

Fixes #2428

Fixes #2437

Changes proposed in this PR:

• Use domain interfaces of common.config more extensively for argument-wise validation.
• Provide more informative warning/error messages in event of invalid or ambiguous inputs.
• Add more rigorous validation checks and appropriate tests.
• Use interfaces of Improve formatting of docstrings generated from ConfigDict #2754 in lieu of that of Update PyROS Solver and Webpage Documentation #2707 to generate the docstring of PyROS.solve(). Remove interface of Update PyROS Solver and Webpage Documentation #2707.

Legal Acknowledgement

By contributing to this software project, I have read the contribution guide and agree to the following terms and conditions for my contribution:

1. I agree my contributions are submitted under the BSD license.
2. I represent I am authorized to make the contributions and grant the license. If my employer has rights to intellectual property that includes these contributions, I represent that I have received permission to make contributions and grant the required license on behalf of that employer.

[codecov]

Codecov Report

Attention: 4 lines in your changes are missing coverage. Please review.

Comparison is base (922ea8e) 88.33% compared to head (3556a60) 88.35%.
Report is 23 commits behind head on main.

Files	Patch %	Lines
pyomo/contrib/pyros/config.py	97.93%	3 Missing ⚠️
pyomo/contrib/pyros/util.py	98.07%	1 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #3126      +/-   ##
==========================================
+ Coverage   88.33%   88.35%   +0.02%     
==========================================
  Files         833      834       +1     
  Lines       92648    92648              
==========================================
+ Hits        81836    81862      +26     
+ Misses      10812    10786      -26     

Flag	Coverage Δ
linux	86.26% <98.12%> (+0.03%)	⬆️
osx	75.72% <97.65%> (+0.02%)	⬆️
other	86.45% <98.12%> (+0.03%)	⬆️
win	83.68% <98.12%> (+0.03%)	⬆️

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

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[jsiirola]

A couple comments after a quick read-through

[jsiirola]

This is fine to merge. Longer term, I'd like kto revisit if we need as many functors as we currently have.

[jsiirola]

Why is this (and PositiveIntOrMinusOne below) a functor and not just a plain function? Is it just so that you can define the domain_name() method? If that is the case, then I think we should update ConfigValue to allow for domain_name to just be an attribute - then these can be simple functions and not need to be full classes / instances.

[shermanjasonaf]

Just to define the domain_name() method. I agree that updating ConfigValue to make domain_name an attribute would help simplify.