Metadata-Version: 2.4
Name: az-artifacts
Version: 0.2.0
Summary: Native Python discovery, metadata, inspection, downloads, and publishing for Azure DevOps Universal Packages
Author: az-artifacts contributors
License-Expression: MIT
License-File: LICENSE
Classifier: Development Status :: 3 - Alpha
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Typing :: Typed
Requires-Dist: httpx>=0.28.1,<1
Requires-Dist: wcmatch>=10.1,<11
Requires-Dist: azure-identity>=1.19,<2 ; extra == 'azure-identity'
Requires-Python: >=3.12
Project-URL: Homepage, https://github.com/cataggar/az-artifacts
Project-URL: Issues, https://github.com/cataggar/az-artifacts/issues
Provides-Extra: azure-identity
Description-Content-Type: text/markdown

# az-artifacts

Native Python access to Azure DevOps Universal Packages: publish and download
files, discover packages, read metadata, and inspect or compare package contents.
No Azure CLI or ArtifactTool runtime dependency.

## Installation

```bash
uv add az-artifacts
```

For development from a checkout, see [source installation](doc/reference.md#installation).

## Quick start

Provide a PAT with Packaging: Read and access to the feed through your
environment or secret store, not source code or command-line arguments.

```python
import os

from az_artifacts import UniversalPackageClient

with UniversalPackageClient(
    "https://dev.azure.com/org",
    credential=os.environ["AZURE_DEVOPS_EXT_PAT"],
) as client:
    result = client.download(
        feed="feed",
        name="package",
        version="1.2.3",
        path="./download",
        scope="project",
        project="project",
    )

print(result.files)
```

## Documentation

- [Publish packages](doc/reference.md#publish-a-package)
- [Download options and authentication](doc/reference.md#download-a-package)
- [Discover feeds, packages, and versions](doc/reference.md#discover-feeds-packages-and-versions)
- [Read metadata](doc/reference.md#read-package-metadata)
- [Compare local files](doc/reference.md#compare-a-local-file-before-uploading)
- [Inspect files and path history](doc/reference.md#inspect-package-files-and-path-history)
- [Register already-uploaded content](doc/reference.md#register-already-uploaded-content)
- [Development and releases](doc/reference.md#development-and-verification)

## License

[MIT](LICENSE). See [provenance](doc/reference.md#license-and-provenance) for
upstream attribution. This is not an official Azure DevOps SDK.
