briefcase-python 2.4.1

Python bindings for Briefcase AI
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125

"""
Briefcase VCS integration for multi-provider version control and data versioning.

This module provides unified client interfaces for 7 different VCS providers:
- DVC (Data Version Control)
- Nessie (Apache Iceberg metadata service)
- Pachyderm (container-native data versioning)
- ArtiVC (Git-like VCS for artifacts)
- DuckLake (DuckDB + lakeFS)
- Iceberg (Apache Iceberg table format)
- Git LFS (Git Large File Storage)

Each provider is available as an optional integration with automatic import
handling for missing dependencies.

Usage:
    from briefcase.integrations.vcs import DvcClient, NessieClient

    # Using DVC
    dvc_client = DvcClient(
        repository="my-repo",
        branch="main",
        briefcase_client=client
    )
    data = dvc_client.read_object("data/training.csv")

    # Using Nessie
    nessie_client = NessieClient(
        repository="my-iceberg-catalog",
        branch="main",
        endpoint="https://nessie.example.com"
    )
    with nessie_client:
        nessie_client.create_version("Updated training data")

    # Multiple providers in sequence
    for provider_client in [dvc_client, nessie_client]:
        provider_client.write_object("results/output.csv", data)
"""

from briefcase.integrations.vcs.base import VcsClientBase

# Import each provider with graceful fallback for missing dependencies
_dvc_client = None
_nessie_client = None
_pachyderm_client = None
_artivc_client = None
_ducklake_client = None
_iceberg_client = None
_gitlfs_client = None

try:
    from briefcase.integrations.vcs.dvc import DvcClient
    _dvc_client = DvcClient
except ImportError:
    pass

try:
    from briefcase.integrations.vcs.nessie import NessieClient
    _nessie_client = NessieClient
except ImportError:
    pass

try:
    from briefcase.integrations.vcs.pachyderm import PachydermClient
    _pachyderm_client = PachydermClient
except ImportError:
    pass

try:
    from briefcase.integrations.vcs.artivc import ArtiVCClient
    _artivc_client = ArtiVCClient
except ImportError:
    pass

try:
    from briefcase.integrations.vcs.ducklake import DuckLakeClient
    _ducklake_client = DuckLakeClient
except ImportError:
    pass

try:
    from briefcase.integrations.vcs.iceberg import IcebergClient
    _iceberg_client = IcebergClient
except ImportError:
    pass

try:
    from briefcase.integrations.vcs.gitlfs import GitLFSClient
    _gitlfs_client = GitLFSClient
except ImportError:
    pass

__all__ = [
    "VcsClientBase",
]

# Conditionally export available clients
if _dvc_client:
    __all__.append("DvcClient")
    DvcClient = _dvc_client

if _nessie_client:
    __all__.append("NessieClient")
    NessieClient = _nessie_client

if _pachyderm_client:
    __all__.append("PachydermClient")
    PachydermClient = _pachyderm_client

if _artivc_client:
    __all__.append("ArtiVCClient")
    ArtiVCClient = _artivc_client

if _ducklake_client:
    __all__.append("DuckLakeClient")
    DuckLakeClient = _ducklake_client

if _iceberg_client:
    __all__.append("IcebergClient")
    IcebergClient = _iceberg_client

if _gitlfs_client:
    __all__.append("GitLFSClient")
    GitLFSClient = _gitlfs_client