[feat] Git sparse checkout for sourcesdir

[victorusu]

This expands the sourcesdir syntax to include a dictionary format. In this case, the git url is passed via the url key.
Additional command options can be added via the opts key. This capability was previously available in the git_clone function, but not accessible to the sourcesdir git clone interface.

The git sparse-checkout path is available when one defines the files keys with a list of files to checkout.
In this case, instead of emitting a git clone ... command the framework will emit the following set of commands

git clone --no-checkout --depth=1 ...
git sparse-checkout set --no-cone ${file list}
git checkout

where, ${file list} is the list of files defined in the files list.

An example test is this.

@rfm.simple_test
class git_clone_test(rfm.CompileOnlyRegressionTest):
    sourcesdir = {
         'url': 'https://github.com/eth-cscs/alps-gh200-reproducers.git',
         'files' : ['intranode-pinned-host-comm'],
         'opts' : ['--no-optional-locks', '--no-advice', '--no-pager']
    }
    build_system = 'SingleSource'
    sourcepath = 'intranode-pinned-host-comm/intranode_pinned_host_comm.cpp'
    valid_systems = ['*']
    valid_prog_environs = ['*']

Please note that I haven't added any unit tests because the framework does not include any unit tests for the original git_clone function.

closes #3627
closes #3053

[codecov]

Codecov Report

❌ Patch coverage is 46.15385% with 7 lines in your changes missing coverage. Please review.
✅ Project coverage is 91.32%. Comparing base (62babc6) to head (ea7a888).
⚠️ Report is 53 commits behind head on develop.

Files with missing lines	Patch %	Lines
reframe/core/pipeline.py	46.15%	7 Missing ⚠️

Additional details and impacted files

@@             Coverage Diff             @@
##           develop    #3629      +/-   ##
===========================================
+ Coverage    91.25%   91.32%   +0.06%     
===========================================
  Files           62       62              
  Lines        13587    13532      -55     
===========================================
- Hits         12399    12358      -41     
+ Misses        1188     1174      -14     

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

[vkarak]

Suggested change

	sourcesdir = variable(str, typ.Dict, type(None), value='src')
	sourcesdir = variable(str, typ.Dict[str, object], type(None), value='src')

[vkarak]

This is somewhat ugly. Ideally, I would see the keys of the sourcesdir correspond the arguments of the target function. You could do something along these lines:

if not isinstance(self.sourcesdir, dict):
    # Convert it to dict passing the default values
    self.sourcesdir = {'url': self.sourcesdir, ...}

try:
    self._clone_to_stagedir(**self.sourcesdir)
except TypeError as err:
    raise ReframeSyntaxError('invalid syntax for sourcesdir') from err

[vkarak]

Same here, fine tune the options to match those from _clone_stagedir(). Technically, it's vice-versa: _clone_stagedir() should follow the options of this one and sourcesdir the options in _clone_stagedir().