Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (pypi.python.org).
Help us improve Python packaging - Donate today!

A small tool to check the link validity of external Vagrant boxes on Atlas

Project Description

Endymion is a command-line tool that checks if the specified Vagrant boxes can be downloaded from Hashicorp’s Atlas. In the case of the official CentOS Linux images for Vagrant, it will also check if the images correspond to the version listed on Atlas.

Installation

Endymion doesn’t have any external dependencies outside of the Python standard library, so it shouldn’t pose any problems to install it directly. You can also install it in a virtualenv if you prefer.

If you only plan to use Endymion, the simplest way is to install it from PyPI:

$ pip install endymion

Developers can also run the development version:

$ git clone https://github.com/lpancescu/endymion.git
$ git checkout python3 # only if you use Python 3.x
$ pip install -e .

Usage

Exporting Atlas data as JSON

If you would like to export the existing metadata from Atlas, use the --export option. Endymion expects to find the SHA256 checksum files in the same directory, named after the corresponding image (e.g. centos_7.sha256sum.txt for centos/7); since Atlas typically has no checksum information in the metadata, the checksums will be read from these external files and inserted in the generated JSON metadata.

$ endymion –export centos/6 centos/7

Limitations

  • endymion uses the HEAD method of HTTP 1.1 to check the availability of the boxes without downloading them. This usually works with external boxes like the ones provided by CentOS or Fedora, but it will fail with 405 Method Not Allowed for boxes hosted by Hashicorp; using GET with a Content-range header produces the same response.
  • The CentOS project provides GnuPG-signed SHA256 checksums, but endymion doesn’t try to validate them (this would require downloading each variant of a box)

Supported Python versions

Both Python 2.7 and Python 3.x are supported, although they have different codebases:

  • The master branch contains the Python 2.7 source code
  • The python3 branch, unsurprisingly, only runs under Python 3.x (instead of unifying the two code bases, I decided to convert the Python 2.7 code to Python 3, to avoid needlessly complicating the code to support both versions in the long term; if CentOS Linux 8 will default to Python 3, I can just move the Python 3 code to master).

If you are a regular user, this doesn’t matter: pip install endymion will always install the right package for your Python version.

Release History

Release History

This version
History Node

1.4.1

History Node

1.4.0

History Node

1.3.0

History Node

1.2.0

Download Files

Download Files

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

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
endymion-1.4.1-py2-none-any.whl (10.1 kB) Copy SHA256 Checksum SHA256 py2 Wheel Jul 10, 2017
endymion-1.4.1-py3-none-any.whl (10.0 kB) Copy SHA256 Checksum SHA256 py3 Wheel Jul 10, 2017
endymion-1.4.1.tar.gz (7.4 kB) Copy SHA256 Checksum SHA256 Source Jul 10, 2017

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting