Package Search Help

You can use boolean logic (e.g. AND/OR/NOT) for complex search queries. For more help and examples, see the search documentation.

Search by package name:
my-package (implicit)
name:my-package (explicit)

Search by package filename:
filename:my-package.ext 

Search by package tag:
tag:latest 

Search by package version:
version:1.0.0  prerelease:true (prereleases)
prerelease:false (no prereleases)

Search by package architecture:
architecture:x86_64 

Search by package distribution:
distribution:el 

Search by package license:
license:MIT 

Search by package format:
format:deb 

Search by package status:
status:in_progress 

Search by package file checksum:
checksum:5afba 

Search by package security status:
severity:critical 

Search by package vulnerabilities:
vulnerabilities:>1 
vulnerabilities:<1000 

Search by # of package downloads:
downloads:>8 
downloads:<100 

Search by package type:
type:binary 
type:source 

Search by package size (bytes):
size:>50000 
size:<10000 

Search by dependency name/version:
dependency:log4j 
dependency:log4j=1.0.0 
dependency:log4j>1.0.0 

Search by uploaded date:
uploaded:>"1 day ago" 
uploaded:<"August 14, 2022 EST" 

Search by entitlement token (identifier):
entitlement:3lKPVJPosCsY 

Search by policy violation:
policy_violated:true
deny_policy_violated:true
license_policy_violated:true
vulnerability_policy_violated:true

Search by repository:
repository:repo-name

Search by last download date:
last_downloaded:<"30 days ago" 
last_downloaded:>"August 14, 2022 EST" 

Search queries for all Debian-specific (and related) package types

Search by component:
deb_component:unstable

Search queries for all Maven-specific (and related) package types

Search by group ID:
maven_group_id:org.apache

Search queries for all Docker-specific (and related) package types

Search by image digest:
docker_image_digest:sha256:7c5..6d4
(full hashref only)

Search by layer digest:
docker_layer_digest:sha256:4c4..ae4
(full hashref only)

Search queries for all Generic-specific package types

Search by file path:
generic_filepath:path/to/file.txt

Search by directory:
generic_directory:path/to

Field type modifiers (depending on the type, you can influence behaviour)

For all queries, you can use:
~foo for negation

For string queries, you can use:
^foo to anchor to start of term
foo$ to anchor to end of term
foo*bar for fuzzy matching

For number/date or version queries, you can use:
>foo for values greater than
>=foo for values greater / equal
<foo for values less than
<=foo for values less / equal

Need a secure and centralised artifact repository to deliver Alpine, Cargo, CocoaPods, Composer, Conan, Conda, CRAN, Dart, Debian, Docker, Generic, Go, Helm, Hex, HuggingFace, LuaRocks, Maven, npm, NuGet, P2, Python, RedHat, Ruby, Swift, Terraform, Vagrant, VSX, Raw & More packages?

Cloudsmith is the new standard in Package / Artifact Management and Software Distribution.

With support for all major package formats, you can trust us to manage your software supply chain.

Start My Free Trial
Set Me Up
 Public — demo-docs demo-docs / awesome-repo
A certifiably-awesome public package repository curated by demo-docs, hosted by Cloudsmith.
Packages 19189 Package Groups 1676 Public Keys

Python logo artifetch  0.0.14

Download

One-liner (summary)

Universal artifact fetcher for Artifactory, GitLab, and Git.

Description

Artifetch (High-Level README)

Overview

Artifetch is a universal fetcher for developer assets. In v1 it focuses on Git-based workflows and related content.

The purpose of Artifetch

  • Fetch full repositories via shallow Git clone (with optional branch/tag).
  • Fetch repository content without Git (entire repo contents, a subfolder flattened into the destination, or a single file).
  • Fetch build artifacts (e.g., GitLab job artifacts, Artifactory downloads).

Core Fetchers

  • RepoCloneFetcher (module: artifetch.fetchers.repo_clone) Shallow git clone by default, optional branch/tag checkout. See detailed guide: docs/RepoCloneFetcher.md

Installation

From PyPI:
pip install artifetch
From source:
pip install -e .

High-Level Usage Examples

1) Clone a repository (default branch)

```python from pathlib import Path from artifetch.fetchers.repo_clone import RepoCloneFetcher

fetcher = RepoCloneFetcher() target = fetcher.fetch("https://gitlab.com/org/repo.git", Path("./repos")) print(f"Cloned to: {target}") ```

2) Clone a repository (specific branch)

```python from pathlib import Path from artifetch.fetchers.repo_clone import RepoCloneFetcher

fetcher = RepoCloneFetcher() target = fetcher.fetch("git@gitlab.com:org/repo.git", Path("./repos"), branch="release/2025.10") print(f"Cloned to: {target}") ```

CLI Usage

Artifetch also includes a CLI for automation. Your command layout may vary depending on your integration. Typical examples:

# Clone via CLI (default branch) ` artifetch repo-clone --source "https://gitlab.com/org/repo.git" --dest ./repos `

# Clone via CLI (specific branch) ` artifetch repo-clone --source "git@gitlab.com:org/repo.git" --dest ./repos --branch main `

Environment Variables

Common variables (used by RepoCloneFetcher and/or RepoContentFetcher):

  • GIT_BINARY : Path to git executable (RepoCloneFetcher). Default: auto-detect via PATH.
  • ARTIFETCH_GIT_HOST : Host for shorthand normalization (RepoCloneFetcher). Default: gitlab.com
  • ARTIFETCH_GIT_PROTO : ssh or https for shorthand (RepoCloneFetcher). Default: ssh
  • ARTIFETCH_GIT_USER : SSH user for shorthand (RepoCloneFetcher). Default: git
  • GITLAB_TOKEN : Optional token for private GitLab when using RepoContentFetcher (and GitLabFetcher).
  • ARTIFETCH_GITLAB_API_BASE: Optional explicit GitLab API base (e.g., https://git.example.local/api/v4)
  • ARTIFETCH_GIT_HOST (same name, used by RepoContentFetcher env-discovery for GitLab host if needed)
Example (shell):
export ARTIFETCH_GIT_PROTO=https export ARTIFETCH_GIT_HOST=git.mycorp.local
Or in a .env file:
ARTIFETCH_GIT_PROTO=https ARTIFETCH_GIT_HOST=git.mycorp.local

Documentation

  • docs/RepoCloneFetcher.md (detailed clone behavior, flags, troubleshooting)
  • RepoContentFetcher (coming soon)
  • GitLabFetcher (coming soon)
  • ArtifactoryFetcher (coming soon)

Roadmap

  • RepoContentFetcher (module: artifetch.fetchers.repo_content) Download repository files without .git (full repo snapshot, a subfolder flattened, or a single file).
  • GitLabFetcher (module: artifetch.fetchers.gitlab) Retrieve GitLab job artifacts.
  • ArtifactoryFetcher (module: artifetch.fetchers.artifactory) Download artifacts from Artifactory.

License

MIT

License

MIT License

Size

15.4 KB

Downloads

5

Tags

bdist/wheel whl noarch py3 upstream python-upstream-pro… latest

Status  Completed
Checksum (MD5) 761728b45109c0a616dc5da06976558e
Checksum (SHA-1) 6ce7b092222dbcc38b398997bc9e2b893f03f7ad
Checksum (SHA-256) bc0df11e43c687bbe9b73fbad374325a895c8a573b8b880b8b56e57c45109927
Checksum (SHA-512) 1b319203bd55e77deb0ac62e84261ef29b99459622bfb89289f69397b768483033…
GPG Signature
Download
GPG Fingerprint 6811684bac0b8895434e97bdd4391b8fb999e537
Storage Region  Dublin, Ireland
Type  Binary (contains binaries and binary artifacts)
Uploaded At 4 months, 2 weeks ago
Uploaded By Fetched by Cloudsmith
Slug Id artifetch-0014-py3-none-anywhl-bff9
Unique Id wWur10DqAQ6YUCX2
Version (Raw) 0.0.14
Version (Parsed)
  • Major: 0
  • Minor: 0
  • Patch: 14
  • Type: SemVer (Compat)
  extended metadata
Metadata Version 2.4
Project Urls Documentation, https://github.com/gemmamary/artifetch/#README.md | Homepage, https://github.com/gemmamary/artifetch/
Py Filetype bdist_wheel
Py Version py3
Requires Dist black; extra == "dev" | build; extra == "dev" | deptry; extra == "dev" | mypy; extra == "dev" | pytest; extra == "dev" | python-dotenv | python-gitlab | requests | ruff; extra == "dev" | setuptools; extra == "dev" | setuptools_scm; extra == "dev" | twine; extra == "dev" | wheel; extra == "dev"
pkg artifetch-0.0.14-py3-none-any.w… 5
15.4 KB 		md5 sha1 sha256 sha512
Package Contents (artifetch-0.0.14-py3-none-any.whl)
Loading...

This package has 21 files/directories.

Last scanned

4 months, 2 weeks ago

Scan result

Clean

Vulnerability count

0

Max. severity

Unknown

You can embed a badge in another website that shows this or the latest version of this package.

To embed the badge for this specific package version, use the following: 

[![This version of 'artifetch' @ Cloudsmith](https://api.cloudsmith.com/v1/badges/version/demo-docs/awesome-repo/python/artifetch/0.0.14/a=noarch;xf=bdist_wheel;xn=artifetch;xv=py3/?render=true)](https://cloudsmith.io/~demo-docs/repos/awesome-repo/packages/detail/python/artifetch/0.0.14/a=noarch;xf=bdist_wheel;xn=artifetch;xv=py3/)
|This version of 'artifetch' @ Cloudsmith|
.. |This version of 'artifetch' @ Cloudsmith| image:: https://api.cloudsmith.com/v1/badges/version/demo-docs/awesome-repo/python/artifetch/0.0.14/a=noarch;xf=bdist_wheel;xn=artifetch;xv=py3/?render=true
   :target: https://cloudsmith.io/~demo-docs/repos/awesome-repo/packages/detail/python/artifetch/0.0.14/a=noarch;xf=bdist_wheel;xn=artifetch;xv=py3/
image::https://api.cloudsmith.com/v1/badges/version/demo-docs/awesome-repo/python/artifetch/0.0.14/a=noarch;xf=bdist_wheel;xn=artifetch;xv=py3/?render=true[link="https://cloudsmith.io/~demo-docs/repos/awesome-repo/packages/detail/python/artifetch/0.0.14/a=noarch;xf=bdist_wheel;xn=artifetch;xv=py3/",title="This version of 'artifetch' @ Cloudsmith"]
<a href="https://cloudsmith.io/~demo-docs/repos/awesome-repo/packages/detail/python/artifetch/0.0.14/a=noarch;xf=bdist_wheel;xn=artifetch;xv=py3/"><img src="https://api.cloudsmith.com/v1/badges/version/demo-docs/awesome-repo/python/artifetch/0.0.14/a=noarch;xf=bdist_wheel;xn=artifetch;xv=py3/?render=true" alt="This version of 'artifetch' @ Cloudsmith" /></a>

rendered as: This version of 'artifetch' @ Cloudsmith

To embed the badge for the latest package version, use the following: 

[![Latest version of 'artifetch' @ Cloudsmith](https://api.cloudsmith.com/v1/badges/version/demo-docs/awesome-repo/python/artifetch/latest/a=noarch;xf=bdist_wheel;xn=artifetch;xv=py3/?render=true&show_latest=true)](https://cloudsmith.io/~demo-docs/repos/awesome-repo/packages/detail/python/artifetch/latest/a=noarch;xf=bdist_wheel;xn=artifetch;xv=py3/)
|Latest version of 'artifetch' @ Cloudsmith|
.. |Latest version of 'artifetch' @ Cloudsmith| image:: https://api.cloudsmith.com/v1/badges/version/demo-docs/awesome-repo/python/artifetch/latest/a=noarch;xf=bdist_wheel;xn=artifetch;xv=py3/?render=true&show_latest=true
   :target: https://cloudsmith.io/~demo-docs/repos/awesome-repo/packages/detail/python/artifetch/latest/a=noarch;xf=bdist_wheel;xn=artifetch;xv=py3/
image::https://api.cloudsmith.com/v1/badges/version/demo-docs/awesome-repo/python/artifetch/latest/a=noarch;xf=bdist_wheel;xn=artifetch;xv=py3/?render=true&show_latest=true[link="https://cloudsmith.io/~demo-docs/repos/awesome-repo/packages/detail/python/artifetch/latest/a=noarch;xf=bdist_wheel;xn=artifetch;xv=py3/",title="Latest version of 'artifetch' @ Cloudsmith"]
<a href="https://cloudsmith.io/~demo-docs/repos/awesome-repo/packages/detail/python/artifetch/latest/a=noarch;xf=bdist_wheel;xn=artifetch;xv=py3/"><img src="https://api.cloudsmith.com/v1/badges/version/demo-docs/awesome-repo/python/artifetch/latest/a=noarch;xf=bdist_wheel;xn=artifetch;xv=py3/?render=true&show_latest=true" alt="Latest version of 'artifetch' @ Cloudsmith" /></a>

rendered as: Latest version of 'artifetch' @ Cloudsmith

These instructions assume you have setup the repository first (or read it).

To install/use artifetch @ version 0.0.14 ... 

pip install 'artifetch==0.0.14'

You can also install the latest version of this package: 

pip install --upgrade 'artifetch'

If necessary, you can specify the repository directly: 

pip install \
  --index-url=https://dl.cloudsmith.io/public/demo-docs/awesome-repo/python/simple/ \
  artifetch==0.0.14

If you've got a project requirements.txt file, you can specify this as a dependency: 

--index-url=https://dl.cloudsmith.io/public/demo-docs/awesome-repo/python/simple/
artifetch==0.0.14

In addition, you can use this repository as an extra index url. However, please read our documentation on this parameter before using it. For example in a requirements.txt file: 

--extra-index-url=https://dl.cloudsmith.io/public/demo-docs/awesome-repo/python/simple/
artifetch==0.0.14
Warning: We highly recommend using pip (or similar) rather than installing directly.
Still stuck? Need help? Don't panic. Just contact us for help (even if you're not a customer).
Previous Version: 0.0.13
Next Version
Top