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.1.0.tar.gz (51.1 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.1.0-py3-none-any.whl (64.5 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: db_contrib_tool-2.1.0.tar.gz
  • Upload date:
  • Size: 51.1 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.1.0.tar.gz
Algorithm Hash digest
SHA256 751624adc3c2e7b3982ba3be3f06a5b808784efdb54c4e09262d844a8e9972ba
MD5 e04d15abe88fb26d94205675e7a202e0
BLAKE2b-256 d9692b9c56f388edd9a1d9fa031bc6e1bbabcecc8301b6e1cb45258286b06b5a

See more details on using hashes here.

File details

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

File metadata

  • Download URL: db_contrib_tool-2.1.0-py3-none-any.whl
  • Upload date:
  • Size: 64.5 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.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 81e6015040f27f6549894daebed0258415e832c70e27d79d3e864d8345ca8b02
MD5 21529c90aa2ca9e7d5c141c71b8e09e7
BLAKE2b-256 c5c69b43e584b7e9f9764f097a1007966d0548efb2ac8ef5e357e71d3e6c8a1f

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