Skip to main content

System dependency version checker.

Project description

…chews through your system dependencies, spitting out incompatible

versions.

Unix: Unix Build Status Windows: Windows Build StatusMetrics: Coverage Status Scrutinizer Code QualityUsage: PyPI Version PyPI Downloads

Overview

When onboarding new team members, ensuring their computer has everything needed to work on the project can be painful. Verchew is a command-line program and embeddable Python script to check the versions of your project’s system dependencies. Its only external dependency is any Python interpreter, which should already be installed on macOS and most Linux-based operating systems.

Setup

Requirements

  • Python 2.7+ or Python 3.3+

Installation

Install verchew with pip:

$ pip install verchew

or directly from the source code:

$ git clone https://github.com/jacebrowning/verchew.git
$ cd verchew
$ python setup.py install

or embedded the script in your project using this guide.

Usage

Create a configuration file (.verchew.ini) containing your project’s system dependencies:

[Working Program]

cli = working-program
version = 1.2.

[Newer Working Program]

cli = working-program
version =  4.
message = Version 4 is required to get the special features

[Broken Program]

cli = broken-program
version = 1.2.3

[Optional Missing Program]

cli = missing-program
version = 1.2.3
optional = true

[Missing Program]

cli = missing-program
version = 1.2.3

Run verchew to see if you have the expected versions installed:

$ verchew

Checking for Working Program...

$ working-program --version
1.2.3
 MATCHED: 1.2.

Checking for Newer Working Program...

$ working-program --version
1.2.3
 EXPECTED: 4.

Checking for Broken Program...

$ broken-program --version
An error occurred.
 EXPECTED: 1.2.3

Checking for Optional Missing Program...

$ missing-program --version
sh: command not found: missing-program
 EXPECTED: 1.2.3

Checking for Missing Program...

$ missing-program --version
sh: command not found: missing-program
 EXPECTED: 1.2.3

Results:     

Revision History

1.2 (unreleased)

  • Added optional = true settings to downgrade errors to warnings.

  • Added message setting to display optional message for missing programs.

1.1 (2017/05/17)

  • Added --init command to generate a sample configuration file.

1.0 (2017/01/09)

  • Initial stable release.

0.5 (2016/11/02)

  • Added --exit-code option to return non-zero exit codes on failure.

0.4 (2016/10/20)

  • Added support for custom version arguments.

  • Fixed handling of internal versions matches.

0.3 (2016/10/18)

  • Added support for detecting missing and broken programs.

0.2.1 (2016/10/18)

  • Now stripping whitespace after calling --version on a program.

0.2 (2016/10/17)

  • Added --version command.

0.1 (2016/10/17)

  • Initial release.

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

verchew-1.2b2.tar.gz (13.1 kB view details)

Uploaded Source

Built Distribution

verchew-1.2b2-py2-none-any.whl (12.7 kB view details)

Uploaded Python 2

File details

Details for the file verchew-1.2b2.tar.gz.

File metadata

  • Download URL: verchew-1.2b2.tar.gz
  • Upload date:
  • Size: 13.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for verchew-1.2b2.tar.gz
Algorithm Hash digest
SHA256 3d002a07125aeb71cacff705c3fb145131d918220469b979db0713125ea7e515
MD5 4af0f0c4f6527e57b61cdd11e62fb5e2
BLAKE2b-256 ef4a162ebac749dee84d06bc7b0f2515ab727af13721cee8380acd72cd73955b

See more details on using hashes here.

File details

Details for the file verchew-1.2b2-py2-none-any.whl.

File metadata

File hashes

Hashes for verchew-1.2b2-py2-none-any.whl
Algorithm Hash digest
SHA256 f25f2e1a19dac6167fad505f7564f26222807d9ebb001dc565eefd6fc246dba2
MD5 1cff01b65df129d7ffc2cfeec50d39eb
BLAKE2b-256 fb4aefdf02881eaad250ae763697c257e607367da68699bd03dec5849be5fa1b

See more details on using hashes here.

Supported by

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