Uploaded image for project: 'Python Driver'
  1. Python Driver
  2. PYTHON-757

Warn against installing "bson" from PyPI

    XMLWordPrintable

    Details

    • Type: New Feature
    • Status: Closed
    • Priority: Major - P3
    • Resolution: Fixed
    • Affects Version/s: None
    • Fix Version/s: 2.8, 3.0
    • Component/s: None
    • Labels:
      None
    • Backwards Compatibility:
      Fully Compatible
    • Sprint:
      Python Sprint 9

      Description

      The third-party "bson" package in PyPI is unmaintained and unrelated to PyMongo.

      Unfortunately, since "pip install pymongo" also installs a top-level "bson" package, users see example code like:

      import bson
      import pymongo

      ...and assume they should install bson and pymongo from PyPI. Depending on the Python packaging configuration of their system this can lead to a variety of surprising and unintelligible errors. Sometimes immediately, sometimes only after a PyMongo upgrade.

      The PyMongo docs should warn against installing "bson" from PyPI, in "installation.rst" and perhaps elsewhere.

        Attachments

          Activity

            People

            • Votes:
              0 Vote for this issue
              Watchers:
              1 Start watching this issue

              Dates

              • Created:
                Updated:
                Resolved: