Skip to main content

The `db-contrib-tool` - MongoDB's tool for contributors.

Project description

db-contrib-tool

The db-contrib-tool - a collection of tooling to support repro environments.

Description

The command line tool with various subcommands:

  • setup-repro-env
    • README.md
    • downloads and installs:
      • particular MongoDB versions
      • debug symbols
      • artifacts (including resmoke, python scripts etc)
      • python venv for resmoke, python scripts etc
  • setup-mongot-repro-env
    • README.md
    • Downloads and installs particular Mongot versions into install directory.
  • symbolize
    • README.md
    • Symbolizes stacktraces from recent mongod and mongos binaries compiled in Evergreen, including patch builds, mainline builds, and release/production builds.
    • Requires authenticating to an internal MongoDB symbol mapping service.

Dependencies

Installation

Make sure dependencies are installed. Use pipx to install db-contrib-tool that will be available globally on your machine:

python3 -m pip install pipx
python3 -m pipx ensurepath

Installing db-contrib-tool:

python3 -m pipx install db-contrib-tool

Upgrading db-contrib-tool:

python3 -m pipx upgrade db-contrib-tool

In case of installation errors, some of them may be related to pipx and could be fixed by re-installing pipx.

Removing pipx completely (WARNING! This will delete everything that is installed and managed by pipx):

python3 -m pip uninstall pipx
rm -rf ~/.local/pipx  # in case you're using the default pipx home directory

Now you can try to install again from scratch.

Usage

Print out help message:

db-contrib-tool --help

Download and install the v8.0 mongo binary:

db-contrib-tool setup-repro-env 8.0

Download other accompanying artifacts with flags:

db-contrib-tool setup-repro-env 8.0 \
  --downloadSymbols \
  --downloadArtifacts \
  --downloadPythonVenv

Download latest binary from the 10gen/mongo master branch:

db-contrib-tool setup-repro-env master

There are more ways to specify binary versions - see setup_repro_env/README.md.

Contributing

See ./CONTRIBUTING.md on details for development on this project.

Project details


Release history Release notifications | RSS feed

Download files

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

Source Distribution

db_contrib_tool-2.2.1.tar.gz (50.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

db_contrib_tool-2.2.1-py3-none-any.whl (64.1 kB view details)

Uploaded Python 3

File details

Details for the file db_contrib_tool-2.2.1.tar.gz.

File metadata

  • Download URL: db_contrib_tool-2.2.1.tar.gz
  • Upload date:
  • Size: 50.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.5.1 CPython/3.9.25 Linux/5.4.0-1009-aws

File hashes

Hashes for db_contrib_tool-2.2.1.tar.gz
Algorithm Hash digest
SHA256 5a6179fbae288dad2a4b8402bbed2b1ff990881ec1ce15100f23bd614c7ce9e3
MD5 7eafd4db2f73e1068626cce5ba465cb0
BLAKE2b-256 4b3c343a855cbfd074048dda1974a2e9f79a3369a8bf6555a12e75f40a6f8623

See more details on using hashes here.

File details

Details for the file db_contrib_tool-2.2.1-py3-none-any.whl.

File metadata

  • Download URL: db_contrib_tool-2.2.1-py3-none-any.whl
  • Upload date:
  • Size: 64.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.5.1 CPython/3.9.25 Linux/5.4.0-1009-aws

File hashes

Hashes for db_contrib_tool-2.2.1-py3-none-any.whl
Algorithm Hash digest
SHA256 3d75e921bf4b0f010cebd1b8c4727c3996ffd86a74840b4e1f60a5daed1869fd
MD5 c5642a0e2fcfd94baa6094fc0e9e4cee
BLAKE2b-256 8b1cc623e2fe26b0de7f79800c43ac3c603ff4fe2165e5b6ed0956bb7278fb39

See more details on using hashes here.

Supported by

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