Skip to main content

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.

Project details


Download files

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

Source Distribution

endymion-1.4.1.tar.gz (7.4 kB view details)

Uploaded Source

Built Distributions

endymion-1.4.1-py3-none-any.whl (10.0 kB view details)

Uploaded Python 3

endymion-1.4.1-py2-none-any.whl (10.1 kB view details)

Uploaded Python 2

File details

Details for the file endymion-1.4.1.tar.gz.

File metadata

  • Download URL: endymion-1.4.1.tar.gz
  • Upload date:
  • Size: 7.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for endymion-1.4.1.tar.gz
Algorithm Hash digest
SHA256 061dd85338470f1e72d4f3ef916cca8364bd45f0ff5db2eba27c7b536e7d29d1
MD5 06ba2d64a2615b0a0454a026845b368f
BLAKE2b-256 113f9115e2f16e05d1b79d72ab4749e34efe12849cf0a287b3c9d77c34304906

See more details on using hashes here.

File details

Details for the file endymion-1.4.1-py3-none-any.whl.

File metadata

File hashes

Hashes for endymion-1.4.1-py3-none-any.whl
Algorithm Hash digest
SHA256 d8bba53693e6aebc2824e7f24f6927f13c32af5bb2df1fb73c524376854622c8
MD5 5f3aa95e5c1f27110da23b855595771a
BLAKE2b-256 e4ba3475f4e717d308ecd1df9828b214d4d002d6c832ea6098aabdd7167f8c4e

See more details on using hashes here.

File details

Details for the file endymion-1.4.1-py2-none-any.whl.

File metadata

File hashes

Hashes for endymion-1.4.1-py2-none-any.whl
Algorithm Hash digest
SHA256 268222c4f9b140279ce40102cf044dd4aed7c37359b133af52b7bb4e6210c7c3
MD5 ade517ceb62b4ef9a5ae4d3b710fdd4e
BLAKE2b-256 56ebf1a702f05d0b06e78aadebc4d9ea3143293d22271f3adf9ae03b5b9bd60f

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page