Add create_shortcut for external data source shortcuts

[Copilot]

Adds a wrapper for the Fabric Create Shortcut API to create OneLake shortcuts pointing at external data sources. This replaces the previously disabled create_shortcut stub, which only handled adlsGen2/amazonS3 with a hardcoded Tables path and was never exported.

Changes

• lakehouse/_shortcuts.py: New @log-decorated create_shortcut supporting adlsGen2, amazonS3, googleCloudStorage, and s3Compatible sources.
  • Adds shortcut_path (Files/Tables), bucket (required for s3Compatible), and shortcut_conflict_policy (Abort/GenerateUniqueName) parameters.
  • Fail-fast validation on source, shortcut_path, bucket, and shortcut_conflict_policy; full numpydoc docstring and type hints.
• lakehouse/__init__.py: Exports create_shortcut.

Example

from sempy_labs.lakehouse import create_shortcut

create_shortcut(
    shortcut_name="sales",
    location="https://myaccount.dfs.core.windows.net",
    subpath="container/sales",
    source="adlsGen2",
    connection_id="00000000-0000-0000-0000-000000000000",
    lakehouse="MyLakehouse",
    workspace="MyWorkspace",
)

Note: the issue requested src/sempy_labs/shortcut, which does not exist; the function was added to src/sempy_labs/lakehouse/_shortcuts.py alongside the existing create_shortcut_onelake, delete_shortcut, and list_shortcuts.