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.0.2.tar.gz (50.9 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.0.2-py3-none-any.whl (64.3 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for db_contrib_tool-2.0.2.tar.gz
Algorithm Hash digest
SHA256 5fe681e4adeed9f1ba1894a493769926b2ec729e08a49ccffd806d3eda9d1042
MD5 ee08d47351ca614e0c2a85200ce24a65
BLAKE2b-256 391988d6547410a31a91da09442a3f8400ffc6f478094aee9fe6b4d6323f72a3

See more details on using hashes here.

File details

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

File metadata

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

File hashes

Hashes for db_contrib_tool-2.0.2-py3-none-any.whl
Algorithm Hash digest
SHA256 e9a99736651492433d6ad93ca766c15427ac8d24696928e170046e9c1dc35d3a
MD5 3bc3b9c8e1d182e451a0317f407e6fa6
BLAKE2b-256 b9ddf226e78f107cc0afa0f91e595d6779e4a8f65dcc552159cafecf0f30285a

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