https://github.com/signiant/umpire
Asynchronous generic dependency resolver. Uses a simple file name convention on an S3 bucket to download files, and is configured by feeding it a JSON file. Support authenticated access.
https://github.com/signiant/umpire
Last synced: about 1 year ago
JSON representation
Asynchronous generic dependency resolver. Uses a simple file name convention on an S3 bucket to download files, and is configured by feeding it a JSON file. Support authenticated access.
- Host: GitHub
- URL: https://github.com/signiant/umpire
- Owner: Signiant
- License: mit
- Created: 2015-10-27T23:16:35.000Z (over 10 years ago)
- Default Branch: develop
- Last Pushed: 2024-06-18T20:32:28.000Z (almost 2 years ago)
- Last Synced: 2025-04-13T11:08:32.060Z (about 1 year ago)
- Language: Python
- Homepage:
- Size: 153 KB
- Stars: 6
- Watchers: 6
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Umpire: A Dependency Manager
Umpire is a Python-based generic dependency resolver which aims to be platform agnostic, extensible, and simple to use.
Umpire was developed as an easy to install command line tool, with it's flexibility being derived from the JSON file options.
Umpire reads a JSON file to retrieve, cache, and link files to their appropriate destination from an Amazon S3 backed repository of compressed packages.
## Installation
Umpire requires **Python 3.11.6 or above**
Umpire is available as a [pip package](https://pypi.python.org/pypi/pip).
To install Umpire:
1. Download `get-pip.py` from [PyPA](https://pypa.io).
```sh
$ curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py
```
2. Run the Python script to complete the install.
```sh
$ python get-pip.py
```
3. Use latest python3 pip to install Umpire.
```sh
$ pip3 install umpire
```
## Development
To run a local version of the Umpire
you clone the repo. and then do a
```sh
pip3 install -e
```
now the umpire will be from your local development repo
You can check by running
```sh
pip3 freeze | grep umpire
```
## Examples
Below is an example deployment JSON file. The URL is composed of the identifier (s3://) and the bucket name. When using an authenticated bucket, the user must have either the AWS\_ACCESS\_KEY\_ID and AWS\_SECRET\_ACCESS\_KEY variables set or a properly configured credentials file for your platform.
The items array contains the list of dependencies. Each one requires a platform, name and version. In the s3 bucket they need to be stored with the prefix: **$PLATFORM/$NAME/$VERSION**. Umpire does a case insensitive match against this naming convention to find the appropriate dependency. It will download all files matching the prefix in the bucket, and will attempt to unpack them for future deployment.
There's also a couple of other options that you can specify. They are:
**link**: [true/false] -- Specifies whether Umpire should link the dependency files to the destination or copy them. Default true.
**keep_updated**: [true/false] -- Specifies whether Umpire should check with the remote S3 bucket when run to see if the dependency has been changed. Default false.
```
[
{
"url":"s3://umpire-test/",
"items":[
{
"name":"test",
"version":"test_tgz",
"platform":"test",
"keep_updated":true,
"link":false,
"destination":"$ENVIRONMENT_VARIABLE/destination"
},
{
"name":"test",
"version":"test_zip",
"platform":"test",
"keep_updated":true,
"destination":"./destination"
}
]
}
]
```
## Contributing
Want to help out? Awesome!
We'll gladly take any help in bug fixes, or feature updates if it fits within our whole vision of Umpire. Feel free to create a fork of the repository, and submit a pull request if you do anything cool.
## Todos
- Publishing support
- Bzip support
- Optional unpacking
- File exclusion
## License
----
Umpire is licensed under the [MIT license](https://github.com/Signiant/umpire/blob/develop/LICENSE)