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.6.tar.gz (52.3 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.6-py3-none-any.whl (65.8 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: db_contrib_tool-2.2.6.tar.gz
  • Upload date:
  • Size: 52.3 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.6.tar.gz
Algorithm Hash digest
SHA256 e6f112b47e750d11b449420d5dae8d1cb71a0bf41bac15a8fc372776afcc69ac
MD5 b1827415ba3d3e33e72fcea6b8afb47b
BLAKE2b-256 e70e30a69d42269025795e95be6e97392aa1249b270d2bf602587923da649247

See more details on using hashes here.

File details

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

File metadata

  • Download URL: db_contrib_tool-2.2.6-py3-none-any.whl
  • Upload date:
  • Size: 65.8 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.6-py3-none-any.whl
Algorithm Hash digest
SHA256 f395e3e8d0acfefd2341c3f81f9b9cd5b01631d151e8c56e077a1c6f28aedeff
MD5 6491e72d8e263199ab39425ea40242e7
BLAKE2b-256 8ec6bfdf03c1502d3df840549dbcec3a7345b273e3a890d9ca1df02d5c585f74

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