Skip to content

PYTHON-5205 Replace http with https in doc links #2204

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 5 commits into from
Mar 15, 2025
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion doc/api/index.rst
Original file line number Diff line number Diff line change
@@ -3,7 +3,7 @@ API Documentation

The PyMongo distribution contains three top-level packages for
interacting with MongoDB. :mod:`bson` is an implementation of the
`BSON format <http://bsonspec.org>`_, :mod:`pymongo` is a
`BSON format <https://bsonspec.org>`_, :mod:`pymongo` is a
full-featured driver for MongoDB, and :mod:`gridfs` is a set of tools
for working with the `GridFS
<https://github.com/mongodb/specifications/blob/master/source/gridfs/gridfs-spec.md/>`_ storage
2 changes: 1 addition & 1 deletion doc/async-tutorial.rst
Original file line number Diff line number Diff line change
@@ -385,7 +385,7 @@ Indexing
Adding indexes can help accelerate certain queries and can also add additional
functionality to querying and storing documents. In this example, we'll
demonstrate how to create a `unique index
<http://mongodb.com/docs/manual/core/index-unique/>`_ on a key that rejects
<https://mongodb.com/docs/manual/core/index-unique/>`_ on a key that rejects
documents whose value for that key already exists in the index.

First, we'll need to create the index:
10 changes: 5 additions & 5 deletions doc/changelog.rst
Original file line number Diff line number Diff line change
@@ -3067,7 +3067,7 @@ fixes. Highlights include:
:class:`~gridfs.grid_file.GridOutCursor`.
- Greatly improved :doc:`support for mod_wsgi </examples/mod_wsgi>` when using
PyMongo's C extensions. Read `Jesse's blog post
<http://emptysqua.re/blog/python-c-extensions-and-mod-wsgi/>`_ for details.
<https://emptysqua.re/blog/python-c-extensions-and-mod-wsgi/>`_ for details.
- Improved C extension support for ARM little endian.

Breaking changes
@@ -3322,7 +3322,7 @@ Important New Features:
- Support for mongos failover.
- A new :meth:`~pymongo.collection.Collection.aggregate` method to support
MongoDB's new `aggregation framework
<http://mongodb.com/docs/manual/applications/aggregation/>`_.
<https://mongodb.com/docs/manual/applications/aggregation/>`_.
- Support for legacy Java and C# byte order when encoding and decoding UUIDs.
- Support for connecting directly to an arbiter.

@@ -3686,7 +3686,7 @@ Changes in Version 1.9 (2010/09/28)

Version 1.9 adds a new package to the PyMongo distribution,
:mod:`bson`. :mod:`bson` contains all of the `BSON
<http://bsonspec.org>`_ encoding and decoding logic, and the BSON
<https://bsonspec.org>`_ encoding and decoding logic, and the BSON
types that were formerly in the :mod:`pymongo` package. The following
modules have been renamed:

@@ -3819,7 +3819,7 @@ Changes in Version 1.7 (2010/06/17)
Version 1.7 is a recommended upgrade for all PyMongo users. The full
release notes are below, and some more in depth discussion of the
highlights is `here
<http://dirolf.com/2010/06/17/pymongo-1.7-released.html>`_.
<https://dirolf.com/2010/06/17/pymongo-1.7-released.html>`_.

- no longer attempt to build the C extension on big-endian systems.
- added :class:`~bson.min_key.MinKey` and
@@ -3870,7 +3870,7 @@ The biggest change in version 1.6 is a complete re-implementation of
:mod:`gridfs` with a lot of improvements over the old
implementation. There are many details and examples of using the new
API in `this blog post
<http://dirolf.com/2010/03/29/new-gridfs-implementation-for-pymongo.html>`_. The
<https://dirolf.com/2010/03/29/new-gridfs-implementation-for-pymongo.html>`_. The
old API has been removed in this version, so existing code will need
to be modified before upgrading to 1.6.

2 changes: 1 addition & 1 deletion doc/compatibility-policy.rst
Original file line number Diff line number Diff line change
@@ -52,7 +52,7 @@ deprecated PyMongo features.
.. seealso:: The Python documentation on `the warnings module`_,
and `the -W command line option`_.

.. _semantic versioning: http://semver.org/
.. _semantic versioning: https://semver.org/

.. _DeprecationWarning:
https://docs.python.org/3/library/exceptions.html#DeprecationWarning
2 changes: 1 addition & 1 deletion doc/conf.py
Original file line number Diff line number Diff line change
@@ -88,7 +88,7 @@
"https://github.com/mongodb/specifications/blob/master/source/server-discovery-and-monitoring/server-monitoring.md#requesting-an-immediate-check",
"https://github.com/mongodb/libmongocrypt/blob/master/bindings/python/README.rst#installing-from-source",
r"https://wiki.centos.org/[\w/]*",
r"http://sourceforge.net/",
r"https://sourceforge.net/",
]

# -- Options for extensions ----------------------------------------------------
2 changes: 1 addition & 1 deletion doc/examples/aggregation.rst
Original file line number Diff line number Diff line change
@@ -87,4 +87,4 @@ you can add computed fields, create new virtual sub-objects, and extract
sub-fields into the top-level of results.

.. seealso:: The full documentation for MongoDB's `aggregation framework
<http://mongodb.com/docs/manual/applications/aggregation>`_
<https://mongodb.com/docs/manual/applications/aggregation>`_
2 changes: 1 addition & 1 deletion doc/examples/authentication.rst
Original file line number Diff line number Diff line change
@@ -191,7 +191,7 @@ Two extra ``authMechanismProperties`` are supported on Windows platforms:
>>> uri = "mongodb://mongodbuser%40EXAMPLE.COM@example.com/?authMechanism=GSSAPI&authMechanismProperties=SERVICE_REALM:otherrealm"


.. _kerberos: http://pypi.python.org/pypi/kerberos
.. _kerberos: https://pypi.python.org/pypi/kerberos
.. _pykerberos: https://pypi.python.org/pypi/pykerberos
.. _winkerberos: https://pypi.python.org/pypi/winkerberos/

2 changes: 1 addition & 1 deletion doc/examples/copydb.rst
Original file line number Diff line number Diff line change
@@ -67,7 +67,7 @@ Versions of PyMongo before 3.0 included a ``copy_database`` helper method,
but it has been removed.

.. _copyDatabase function in the mongo shell:
http://mongodb.com/docs/manual/reference/method/db.copyDatabase/
https://mongodb.com/docs/manual/reference/method/db.copyDatabase/

.. _Copy a Database:
https://www.mongodb.com/docs/database-tools/mongodump/mongodump-examples/#copy-and-clone-databases
2 changes: 1 addition & 1 deletion doc/examples/gevent.rst
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
Gevent
======

PyMongo supports `Gevent <http://www.gevent.org/>`_. Simply call Gevent's
PyMongo supports `Gevent <https://www.gevent.org/>`_. Simply call Gevent's
``monkey.patch_all()`` before loading any other modules:

.. code-block:: pycon
2 changes: 1 addition & 1 deletion doc/examples/gridfs.rst
Original file line number Diff line number Diff line change
@@ -14,7 +14,7 @@ objects (e.g. files) in MongoDB.
.. seealso:: The API docs for :mod:`gridfs`.

.. seealso:: `This blog post
<http://dirolf.com/2010/03/29/new-gridfs-implementation-for-pymongo.html>`_
<https://dirolf.com/2010/03/29/new-gridfs-implementation-for-pymongo.html>`_
for some motivation behind this API.

Setup
8 changes: 4 additions & 4 deletions doc/examples/high_availability.rst
Original file line number Diff line number Diff line change
@@ -2,25 +2,25 @@ High Availability and PyMongo
=============================

PyMongo makes it easy to write highly available applications whether
you use a `single replica set <http://dochub.mongodb.org/core/rs>`_
you use a `single replica set <https://dochub.mongodb.org/core/rs>`_
or a `large sharded cluster
<https://www.mongodb.com/docs/manual/sharding/>`_.

Connecting to a Replica Set
---------------------------

PyMongo makes working with `replica sets
<http://dochub.mongodb.org/core/rs>`_ easy. Here we'll launch a new
<https://dochub.mongodb.org/core/rs>`_ easy. Here we'll launch a new
replica set and show how to handle both initialization and normal
connections with PyMongo.

.. seealso:: The MongoDB documentation on `replication <http://dochub.mongodb.org/core/rs>`_.
.. seealso:: The MongoDB documentation on `replication <https://dochub.mongodb.org/core/rs>`_.

Starting a Replica Set
~~~~~~~~~~~~~~~~~~~~~~

The main `replica set documentation
<http://dochub.mongodb.org/core/rs>`_ contains extensive information
<https://dochub.mongodb.org/core/rs>`_ contains extensive information
about setting up a new replica set or migrating an existing MongoDB
setup, be sure to check that out. Here, we'll just do the bare minimum
to get a three node replica set setup locally.
2 changes: 1 addition & 1 deletion doc/examples/index.rst
Original file line number Diff line number Diff line change
@@ -6,7 +6,7 @@ of how to accomplish specific tasks with MongoDB and PyMongo.

Unless otherwise noted, all examples assume that a MongoDB instance is
running on the default host and port. Assuming you have `downloaded
and installed <http://www.mongodb.org/display/DOCS/Getting+Started>`_
and installed <https://www.mongodb.org/display/DOCS/Getting+Started>`_
MongoDB, you can start it like so:

.. code-block:: bash
2 changes: 1 addition & 1 deletion doc/examples/tls.rst
Original file line number Diff line number Diff line change
@@ -3,7 +3,7 @@ TLS/SSL and PyMongo

PyMongo supports connecting to MongoDB over TLS/SSL. This guide covers the
configuration options supported by PyMongo. See `the server documentation
<http://mongodb.com/docs/manual/tutorial/configure-ssl/>`_ to configure
<https://mongodb.com/docs/manual/tutorial/configure-ssl/>`_ to configure
MongoDB.

.. warning:: Industry best practices recommend, and some regulations require,
14 changes: 7 additions & 7 deletions doc/faq.rst
Original file line number Diff line number Diff line change
@@ -53,9 +53,9 @@ a non `async-signal-safe`_ function. For examples of deadlocks or crashes
that could occur see `PYTHON-3406`_.

For a long but interesting read about the problems of Python locks in
multithreaded contexts with ``fork()``, see http://bugs.python.org/issue6721.
multithreaded contexts with ``fork()``, see https://bugs.python.org/issue6721.

.. _not fork-safe: http://bugs.python.org/issue6721
.. _not fork-safe: https://bugs.python.org/issue6721
.. _OpenSSL: https://github.com/openssl/openssl/issues/19066
.. _fork(): https://man7.org/linux/man-pages/man2/fork.2.html
.. _signal-safety(7): https://man7.org/linux/man-pages/man7/signal-safety.7.html
@@ -174,10 +174,10 @@ Does PyMongo support asynchronous frameworks like Gevent, asyncio, Tornado, or T
PyMongo fully supports :doc:`Gevent <examples/gevent>`.

To use MongoDB with `asyncio <https://docs.python.org/3/library/asyncio.html>`_
or `Tornado <http://www.tornadoweb.org/>`_, see the
or `Tornado <https://www.tornadoweb.org/>`_, see the
`Motor <https://github.com/mongodb/motor>`_ project.

For `Twisted <http://twistedmatrix.com/>`_, see `TxMongo
For `Twisted <https://twistedmatrix.com/>`_, see `TxMongo
<https://github.com/twisted/txmongo>`_. Its stated mission is to keep feature
parity with PyMongo.

@@ -381,7 +381,7 @@ Can you add attribute style access for documents?
-------------------------------------------------
This request has come up a number of times but we've decided not to
implement anything like this. The relevant `jira case
<http://jira.mongodb.org/browse/PYTHON-35>`_ has some information
<https://jira.mongodb.org/browse/PYTHON-35>`_ has some information
about the decision, but here is a brief summary:

1. This will pollute the attribute namespace for documents, so could
@@ -451,7 +451,7 @@ in Flask_ (other web frameworks are similar)::

How can I use PyMongo from Django?
----------------------------------
`Django <http://www.djangoproject.com/>`_ is a popular Python web
`Django <https://www.djangoproject.com/>`_ is a popular Python web
framework. Django includes an ORM, :mod:`django.db`. Currently,
there's no official MongoDB backend for Django.

@@ -468,7 +468,7 @@ using just MongoDB, but most of what Django provides can still be
used.

One project which should make working with MongoDB and Django easier
is `mango <http://github.com/vpulim/mango>`_. Mango is a set of
is `mango <https://github.com/vpulim/mango>`_. Mango is a set of
MongoDB backends for Django sessions and authentication (bypassing
:mod:`django.db` entirely).

6 changes: 3 additions & 3 deletions doc/index.rst
Original file line number Diff line number Diff line change
@@ -9,7 +9,7 @@ PyMongo |release| Documentation
Overview
--------
**PyMongo** is a Python distribution containing tools for working with
`MongoDB <http://www.mongodb.org>`_, and is the recommended way to
`MongoDB <https://www.mongodb.org>`_, and is the recommended way to
work with MongoDB from Python. This documentation attempts to explain
everything you need to know to use **PyMongo**.

@@ -81,7 +81,7 @@ Issues
------
All issues should be reported (and can be tracked / voted for /
commented on) at the main `MongoDB JIRA bug tracker
<http://jira.mongodb.org/browse/PYTHON>`_, in the "Python Driver"
<https://jira.mongodb.org/browse/PYTHON>`_, in the "Python Driver"
project.

Feature Requests / Feedback
@@ -94,7 +94,7 @@ Contributing
**PyMongo** has a large :doc:`community <contributors>` and
contributions are always encouraged. Contributions can be as simple as
minor tweaks to this documentation. To contribute, fork the project on
`GitHub <http://github.com/mongodb/mongo-python-driver/>`_ and send a
`GitHub <https://github.com/mongodb/mongo-python-driver/>`_ and send a
pull request.

Changes
6 changes: 3 additions & 3 deletions doc/installation.rst
Original file line number Diff line number Diff line change
@@ -3,7 +3,7 @@ Installing / Upgrading
.. highlight:: bash

**PyMongo** is in the `Python Package Index
<http://pypi.python.org/pypi/pymongo/>`_.
<https://pypi.python.org/pypi/pymongo/>`_.

.. warning:: **Do not install the "bson" package from pypi.** PyMongo comes
with its own bson package; doing "pip install bson"
@@ -12,7 +12,7 @@ Installing / Upgrading
Installing with pip
-------------------

We recommend using `pip <http://pypi.python.org/pypi/pip>`_
We recommend using `pip <https://pypi.python.org/pypi/pip>`_
to install pymongo on all platforms::

$ python3 -m pip install pymongo
@@ -136,7 +136,7 @@ is a workaround::
# For some Python builds from python.org
$ env ARCHFLAGS='-arch i386 -arch x86_64' python -m pip install pymongo

See `http://bugs.python.org/issue11623 <http://bugs.python.org/issue11623>`_
See `https://bugs.python.org/issue11623 <https://bugs.python.org/issue11623>`_
for a more detailed explanation.

**Lion (10.7) and newer** - PyMongo's C extensions can be built against
2 changes: 1 addition & 1 deletion doc/make.bat
Original file line number Diff line number Diff line change
@@ -21,7 +21,7 @@ if errorlevel 9009 (
echo.may add the Sphinx directory to PATH.
echo.
echo.If you don't have Sphinx installed, grab it from
echo.http://sphinx-doc.org/
echo.https://sphinx-doc.org/
exit /b 1
)

40 changes: 19 additions & 21 deletions doc/tools.rst
Original file line number Diff line number Diff line change
@@ -31,7 +31,7 @@ MongoEngine
layer on top of PyMongo. It allows you to define schemas for
documents and query collections using syntax inspired by the Django
ORM. The code is available on `GitHub
<http://github.com/mongoengine/mongoengine>`_; for more information, see
<https://github.com/mongoengine/mongoengine>`_; for more information, see
the `tutorial <https://docs.mongoengine.org/tutorial.html>`_.

MincePy
@@ -47,17 +47,15 @@ Ming
`Ming <https://ming.readthedocs.io/en/latest/>`_ is a
library that allows you to enforce schemas on a MongoDB database in
your Python application. It was developed by `SourceForge
<http://sourceforge.net/>`_ in the course of their migration to
MongoDB. See the `introductory blog post
<http://blog.pythonisito.com/2009/12/ming-01-released-python-library-for.html>`_
for more details.
<https://sourceforge.net/>`_ in the course of their migration to
MongoDB.

MotorEngine
`MotorEngine <https://motorengine.readthedocs.io/>`_ is a port of
MongoEngine to Motor, for asynchronous access with Tornado.
It implements the same modeling APIs to be data-portable, meaning that a
model defined in MongoEngine can be read in MotorEngine. The source is
`available on GitHub <http://github.com/heynemann/motorengine>`_.
`available on GitHub <https://github.com/heynemann/motorengine>`_.

uMongo
`uMongo <https://umongo.readthedocs.io/>`_ is a Python MongoDB ODM.
@@ -89,28 +87,28 @@ PyMODM
<https://pymodm.readthedocs.io/en/stable/>`_.

MongoKit
The `MongoKit <http://github.com/namlook/mongokit>`_ framework
The `MongoKit <https://github.com/namlook/mongokit>`_ framework
is an ORM-like layer on top of PyMongo. There is also a MongoKit
`google group <http://groups.google.com/group/mongokit>`_.
`google group <https://groups.google.com/group/mongokit>`_.

Minimongo
`minimongo <http://pypi.python.org/pypi/minimongo>`_ is a lightweight,
`minimongo <https://pypi.python.org/pypi/minimongo>`_ is a lightweight,
pythonic interface to MongoDB. It retains pymongo's query and update API,
and provides a number of additional features, including a simple
document-oriented interface, connection pooling, index management, and
collection & database naming helpers. The `source is on GitHub
<https://github.com/MiniMongo/minimongo>`_.

Manga
`Manga <http://pypi.python.org/pypi/manga>`_ aims to be a simpler ORM-like
`Manga <https://pypi.python.org/pypi/manga>`_ aims to be a simpler ORM-like
layer on top of PyMongo. The syntax for defining schema is inspired by the
Django ORM, but Pymongo's query language is maintained. The source `is on
GitHub <http://github.com/wladston/manga>`_.
GitHub <https://github.com/wladston/manga>`_.

Humongolus
`Humongolus <https://github.com/entone/Humongolus>`_ is a lightweight ORM
framework for Python and MongoDB. The name comes from the combination of
MongoDB and `Homunculus <http://en.wikipedia.org/wiki/Homunculus>`_ (the
MongoDB and `Homunculus <https://en.wikipedia.org/wiki/Homunculus>`_ (the
concept of a miniature though fully formed human body). Humongolus allows
you to create models/schemas with robust validation. It attempts to be as
pythonic as possible and exposes the pymongo cursor objects whenever
@@ -133,30 +131,30 @@ various Python frameworks and libraries.
database backend for Django that completely integrates with its ORM.
For more information `see the tutorial
<https://django-mongodb-engine.readthedocs.io/en/latest/tutorial.html>`_.
* `mango <http://github.com/vpulim/mango>`_ provides MongoDB backends for
* `mango <https://github.com/vpulim/mango>`_ provides MongoDB backends for
Django sessions and authentication (bypassing :mod:`django.db` entirely).
* `Django MongoEngine
<https://github.com/MongoEngine/django-mongoengine>`_ is a MongoDB backend for
Django, an `example:
<https://github.com/MongoEngine/django-mongoengine/tree/master/example/tumblelog>`_.
For more information see `<https://django-mongoengine.readthedocs.io/en/latest/>`_
* `mongodb_beaker <http://pypi.python.org/pypi/mongodb_beaker>`_ is a
* `mongodb_beaker <https://pypi.python.org/pypi/mongodb_beaker>`_ is a
project to enable using MongoDB as a backend for `beakers <https://beaker.readthedocs.io/en/latest/>`_ caching / session system.
`The source is on GitHub <http://github.com/bwmcadams/mongodb_beaker>`_.
`The source is on GitHub <https://github.com/bwmcadams/mongodb_beaker>`_.
* `Log4Mongo <https://github.com/log4mongo/log4mongo-python>`_ is a flexible
Python logging handler that can store logs in MongoDB using normal and capped
collections.
* `MongoLog <http://github.com/puentesarrin/mongodb-log/>`_ is a Python logging
* `MongoLog <https://github.com/puentesarrin/mongodb-log/>`_ is a Python logging
handler that stores logs in MongoDB using a capped collection.
* `rod.recipe.mongodb <http://pypi.python.org/pypi/rod.recipe.mongodb/>`_ is a
* `rod.recipe.mongodb <https://pypi.python.org/pypi/rod.recipe.mongodb/>`_ is a
ZC Buildout recipe for downloading and installing MongoDB.
* `mongobox <http://github.com/theorm/mongobox>`_ is a tool to run a sandboxed
* `mongobox <https://github.com/theorm/mongobox>`_ is a tool to run a sandboxed
MongoDB instance from within a python app.
* `Flask-MongoAlchemy <http://github.com/cobrateam/flask-mongoalchemy/>`_ Add
* `Flask-MongoAlchemy <https://github.com/cobrateam/flask-mongoalchemy/>`_ Add
Flask support for MongoDB using MongoAlchemy.
* `Flask-MongoKit <http://github.com/jarus/flask-mongokit/>`_ Flask extension
* `Flask-MongoKit <https://github.com/jarus/flask-mongokit/>`_ Flask extension
to better integrate MongoKit into Flask.
* `Flask-PyMongo <http://github.com/dcrosta/flask-pymongo/>`_ Flask-PyMongo
* `Flask-PyMongo <https://github.com/dcrosta/flask-pymongo/>`_ Flask-PyMongo
bridges Flask and PyMongo.

Alternative Drivers
2 changes: 1 addition & 1 deletion doc/tutorial.rst
Original file line number Diff line number Diff line change
@@ -375,7 +375,7 @@ Indexing
Adding indexes can help accelerate certain queries and can also add additional
functionality to querying and storing documents. In this example, we'll
demonstrate how to create a `unique index
<http://mongodb.com/docs/manual/core/index-unique/>`_ on a key that rejects
<https://mongodb.com/docs/manual/core/index-unique/>`_ on a key that rejects
documents whose value for that key already exists in the index.

First, we'll need to create the index:
Loading
Loading