Skip to main content

Run retention policies against Artifactory repositories

Project description

[![Build Status](](

# Lavatory

Tooling to define repository specific retention policies in Artifactory. Allows highly customizable
retention policies via Python plugins.

This tool is an Work in Progres! Not ready for production use!

### Requirements:
- Python 3.4+
- Artifactory user with API permissions

## Authentication

This tool looks for 3 enviroment variables in order to authenticate:

`ARTIFACTORY_URL` - Base URL to use for Artifactory connections

`ARTIFACTORY_USERNAME` - Username to Artifactory

`ARTIFACTORY_PASSWORD` - Password for Artifactory

These will be loaded in at the beginning of a run and raise an exception if missing.

## Installing

From pypi:

`pip install lavatory`

Or install directly from the code:

git clone
cd lavatory
pip install -U .

## Running

$ lavatory --help
Usage: lavatory [OPTIONS] COMMAND [ARGS]...

Lavatory is a tool for managing Artifactory Retention Policies

-v, --verbose Increases logging level
--help Show this message and exit.

purge Deletes artifacts based on retention policies

### Purging Artifacts

`lavatory purge --policies-path=/path/to/policies`

$ lavatory purge --help
Usage: lavatory purge [OPTIONS]

Deletes artifacts based on retention policies

--policies-path TEXT Path to extra policies directory
--dryrun / --nodryrun Dryrun does not delete any artifacts. On by
--default / --no-default If false, does not apply default policy
--help Show this message and exit.

## Testing

pip install -r requirements-dev.txt

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release. See tutorial on generating distribution archives.

Built Distribution

lavatory-0.0.2-py3-none-any.whl (10.8 kB view hashes)

Uploaded 3 6

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page