Bring your own file sources: Add the WebDAV template and configuration

[sanjaysrikakulam]

This PR adds the

1. WebDAV example template and configuration
2. Updates the docs, the file source model, and the client API schema.

ToDo:

1. Generate diagrams and images for the docs

[bgruening]

@sanjaysrikakulam there is a make target that helps with the lining

@jmchilton can this go to 24.1?

[sanjaysrikakulam]

@sanjaysrikakulam there is a make target that helps with the lining

Cool, thanks! Unfortunately, I don't have the Galaxy environment. It's taking forever to create it due to some network error,

Example:

WARNING: Retrying (Retry(total=4, connect=None, read=None, redirect=None, status=None)) after connection broken by 'NewConnectionError('<pip._vendor.urllib3.connection.HTTPSConnection object at 0x7ff3b44af700>: Failed to establish a new connection: [Errno -2] Name or service not known')': /simple/cwl-upgrader/

Hence, the reason for the draft. I am unable to generate the diagrams and images at the moment.

[volodymyrss]

With prior advice of @bgruening , I just want to stress that this feature is very important for us in astro(particle)physics!

[davelopez]

I don't think this will work 🤔 this is importing the config module, but I guess you need an instance of the app config with all the processed values available in the _open_fs method.

Maybe @mvdbeek or @jmchilton know how to reference the configuration values here, I don't know a good way of doing that but I might be missing something 😞

[mvdbeek]

Just don't do it. Parse the config values in the config, this is too late. props as serialized should contain all values ready to go.

[jmchilton]

I'll have a look at this.

[jmchilton]

I think #18909 is a version of what I was hoping for. Can we rebase this PR after that one is merged? Might be worth re-testing it on your end after that as well. Thanks for you patience - sorry to be a menace about this - I'm just very anxious about what we put in the database.

[davelopez]

No worries John, we just want to do it as best as we can :)

[sanjaysrikakulam]

Thank you @jmchilton! Yes, I can rebase and fix this PR accordingly and would be happy to test it.