New 'institution' search entries for an ArgoIndex

[gmaze]

Implement new search entries for an ArgoIndex related to institution.

This could go like this

from argopy import ArgoIndex

idx = ArgoIndex()

# Codes from Ref. Table 4:
idx.query.institution_code('AO')
idx.query.institution_code(['AO', 'JA'])

# Long names from Ref. Table 4:
idx.query.institution_name('CSIRO, Australia')
idx.query.institution_name(['Australia', 'France'])

# From DAC name (inferred from file path):
idx.query.dac('jma')
idx.query.dac(['jma', 'bodc'])

check list:

• Implement new features
• Add CI tests for coverage
• Update documentation
• All CI tests passed

[gmaze]

I dont understand yet why, but all CI tests are passed except, and systematically, with All - pinned - Ubuntu, with Python 3.11 and 3.12

e.g.:

• https://github.com/euroargodev/argopy/actions/runs/18249734516
• https://github.com/euroargodev/argopy/actions/runs/18231645040
• https://github.com/euroargodev/argopy/actions/runs/18227809856

and it's not systematic with upstream, but one of 3.12, or 3.11 also fails systematically:

• https://github.com/euroargodev/argopy/actions/runs/18283270953
• https://github.com/euroargodev/argopy/actions/runs/18263675699
• https://github.com/euroargodev/argopy/actions/runs/18249734528
• https://github.com/euroargodev/argopy/actions/runs/18231645027

All of these actions +/- finishes at the same step, just after some s3 ArgoIndex institution_code requests:

2025-10-05T20:27:16.7314661Z argopy/tests/test_stores_index.py::Test_IndexStore_pandas_CORE::test_a_search[s3, institution_code[n=2], nrows=2] PASSED
2025-10-05T20:27:18.5629066Z argopy/tests/test_stores_index.py::Test_IndexStore_pandas_CORE::test_a_search[s3, institution_name[n=1], nrows=None] PASSED
2025-10-05T20:27:19.4499615Z ##[error]The runner has received a shutdown signal. This can happen when the runner service is stopped, or a manually started runner is canceled.
2025-10-05T20:27:21.0445249Z argopy/tests/test_stores_index.py::Test_IndexStore_pandas_CORE::test_a_search[s3, institution_name[n=1], nrows=2] 
2025-10-05T20:27:21.1794454Z ##[error]The operation was canceled.
2025-10-05T20:27:21.2273153Z Uploading runner diagnostic logs
2025-10-05T20:27:21.3805005Z Completed runner diagnostic log upload
2025-10-05T20:27:21.3807278Z Cleaning up orphan processes

[gmaze]

I also note that the error arise with the Pandas backend,
will try to disable Pandas and check if it fails with Pyarrow as well

[gmaze]

Pyarrow tests are passed ok: https://github.com/euroargodev/argopy/actions/runs/18285385886?pr=528

Restoring Pandas

[gmaze]

Restoring Pandas in backend testes re-raise the error on CI tests
with a more verbose logging we have:

argopy/tests/test_stores_index.py::Test_IndexStore_pandas_CORE::test_a_search[s3, institution_name[n=2], nrows=None] PASSED
##[debug]Re-evaluate condition on job cancellation for step: 'Test with pytest'.
##[debug]Skip Re-evaluate condition on runner shutdown.
argopy/tests/test_stores_index.py::Test_IndexStore_pandas_CORE::test_a_search[s3, institution_name[n=2], nrows=2] 
Error: The operation was canceled.
##[debug]System.OperationCanceledException: The operation was canceled.
##[debug]   at System.Threading.CancellationToken.ThrowOperationCanceledException()
##[debug]   at GitHub.Runner.Sdk.ProcessInvoker.ExecuteAsync(String workingDirectory, String fileName, String arguments, IDictionary`2 environment, Boolean requireExitCodeZero, Encoding outputEncoding, Boolean killProcessOnCancel, Channel`1 redirectStandardIn, Boolean inheritConsoleHandler, Boolean keepStandardInOpen, Boolean highPriorityProcess, CancellationToken cancellationToken)
##[debug]   at GitHub.Runner.Common.ProcessInvokerWrapper.ExecuteAsync(String workingDirectory, String fileName, String arguments, IDictionary`2 environment, Boolean requireExitCodeZero, Encoding outputEncoding, Boolean killProcessOnCancel, Channel`1 redirectStandardIn, Boolean inheritConsoleHandler, Boolean keepStandardInOpen, Boolean highPriorityProcess, CancellationToken cancellationToken)
##[debug]   at GitHub.Runner.Worker.Handlers.DefaultStepHost.ExecuteAsync(IExecutionContext context, String workingDirectory, String fileName, String arguments, IDictionary`2 environment, Boolean requireExitCodeZero, Encoding outputEncoding, Boolean killProcessOnCancel, Boolean inheritConsoleHandler, String standardInInput, CancellationToken cancellationToken)
##[debug]   at GitHub.Runner.Worker.Handlers.ScriptHandler.RunAsync(ActionRunStage stage)
##[debug]   at GitHub.Runner.Worker.ActionRunner.RunAsync()
##[debug]   at GitHub.Runner.Worker.StepsRunner.RunStepAsync(IStep step, CancellationToken jobCancellationToken)
##[debug]Finishing: Test with pytest

[gmaze]

Now trying to disable ArgoIndex tests with S3 host
(make sure we can attribute GA cancellation)

[gmaze]

CI tests passed ok when s3 disabled:
https://github.com/euroargodev/argopy/actions/runs/18307732349?pr=528

restoring all CI tests...

[gmaze]

trying to disable test :

argopy/tests/test_stores_index.py::Test_IndexStore_pandas_CORE::test_a_search[s3, institution_name[n=2], nrows=2]

which seems to be the one leading to job cancellation

[gmaze]

tests ok
keeping test_a_search[s3, institution_name[n=2], nrows=2] disabled
re-enable test_a_search[s3, dac...

[gmaze]

should not have done this squashed commit !