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

Warn against installing "bson" from PyPI

    • Type: Icon: New Feature New Feature
    • Resolution: Done
    • Priority: Icon: Major - P3 Major - P3
    • 2.8, 3.0
    • Affects Version/s: None
    • Component/s: None
    • Labels:
      None
    • Fully Compatible

      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.

            Assignee:
            jesse@mongodb.com A. Jesse Jiryu Davis
            Reporter:
            jesse@mongodb.com A. Jesse Jiryu Davis
            Votes:
            0 Vote for this issue
            Watchers:
            1 Start watching this issue

              Created:
              Updated:
              Resolved: