Skip to main content

Manage Evergreen modules locally.

Project description

Evergreen Module Manager

Manage Evergreen modules in your local environment.

PyPI - Python Version PyPI Documentation

Table of contents

  1. Description
  2. Documentation
  3. Dependencies
  4. Installation
  5. Usage
  6. Contributor's Guide
  7. Resources

Description

The evg-module-manager is a tool to help improve the local workflows of working with modules in your evergreen projects. It will help you keep any modules defined in your local project in sync. It supports the following functionality:

  • List what modules are defined in the local project.
  • List what modules are currently active in your local repo.
  • Clone a module repository.
  • Enable/disable modules in your local repo.
  • Create an evergreen patch build that includes changes from the local patch build and all enabled modules.
  • Submit a changes to the commit-queue that includes changes from the local patch build and all enabled modules.

Documentation

Read the documentation here.

Dependencies

See Usage Prerequisites for more details.

Installation

We strongly recommend using a tool like pipx to install this tool. This will isolate the dependencies and ensure they don't conflict with other tools.

$ pipx install evg-module-manager

Usage

See the documentation for details about using this tool.

Usage: evg-module-manager [OPTIONS] COMMAND [ARGS]...

  Evergreen Module Manager is a tool help simplify the local workflows of evergreen modules.

Options:
  --modules-dir PATH      Directory to store module repositories [default='..']
  --evg-config-file PATH  Path to file with evergreen auth configuration
                          [default='/Users/dbradf/.evergreen.yml']
  --evg-project TEXT      Name of Evergreen project [default='mongodb-mongo-master']
  --help                  Show this message and exit.

Commands:
  disable       Disable the specified module in the current repo.
  enable        Enable the specified module in the current repo.
  evg           Perform evergreen actions against the base repo and enabled modules.
  git           Perform git actions against the base repo and enabled modules.
  list-modules  List the modules available for the current repo.
  pull-request  Create a Github pull request for changes in the base repository and any...

Contributor's Guide

Setting up a local development environment

This project uses poetry for setting up a local environment.

git clone ...
cd evg-module-manager
poetry install

linting/formatting

This project uses black and isort for formatting.

poetry run black src tests
poetry run isort src tests

Running tests

This project uses pytest for testing.

poetry run pytest

Automatically running checks on commit

This project has pre-commit configured. Pre-commit will run configured checks at git commit time. To enable pre-commit on your local repository run:

poetry run pre-commit install

Versioning

This project uses semver for versioning.

Please include a description what is added for each new version in CHANGELOG.md.

Code Review

Please open a Github Pull Request for code review.

Deployment

Deployment to pypi is automatically triggered on merges to main.

Resources

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

evg-module-manager-1.1.4.tar.gz (26.4 kB view hashes)

Uploaded Source

Built Distribution

evg_module_manager-1.1.4-py3-none-any.whl (31.9 kB view hashes)

Uploaded Python 3

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