Skip to content
Merged
Show file tree
Hide file tree
Changes from 4 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
Expand Up @@ -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
Expand Down
2 changes: 1 addition & 1 deletion doc/async-tutorial.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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:
Expand Down
10 changes: 5 additions & 5 deletions doc/changelog.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down Expand Up @@ -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.

Expand Down Expand Up @@ -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:

Expand Down Expand Up @@ -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
Expand Down Expand Up @@ -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.

Expand Down
2 changes: 1 addition & 1 deletion doc/compatibility-policy.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
2 changes: 1 addition & 1 deletion doc/conf.py
Original file line number Diff line number Diff line change
Expand Up @@ -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 ----------------------------------------------------
Expand Down
2 changes: 1 addition & 1 deletion doc/examples/aggregation.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Up @@ -191,7 +191,7 @@ Two extra ``authMechanismProperties`` are supported on Windows platforms:
>>> uri = "mongodb://mongodbuser%[email protected]/?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/

Expand Down
2 changes: 1 addition & 1 deletion doc/examples/copydb.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
2 changes: 1 addition & 1 deletion doc/examples/gridfs.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
8 changes: 4 additions & 4 deletions doc/examples/high_availability.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down
2 changes: 1 addition & 1 deletion doc/examples/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
2 changes: 1 addition & 1 deletion doc/examples/tls.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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,
Expand Down
14 changes: 7 additions & 7 deletions doc/faq.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down Expand Up @@ -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.

Expand Down Expand Up @@ -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
Expand Down Expand Up @@ -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.

Expand All @@ -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).

Expand Down
6 changes: 3 additions & 3 deletions doc/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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**.

Expand Down Expand Up @@ -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
Expand All @@ -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
Expand Down
6 changes: 3 additions & 3 deletions doc/installation.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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"
Expand All @@ -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
Expand Down Expand Up @@ -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
Expand Down
2 changes: 1 addition & 1 deletion doc/make.bat
Original file line number Diff line number Diff line change
Expand Up @@ -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
)

Expand Down
40 changes: 19 additions & 21 deletions doc/tools.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand All @@ -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.
Expand Down Expand Up @@ -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
Expand All @@ -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
Expand Down
2 changes: 1 addition & 1 deletion doc/tutorial.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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:
Expand Down
Loading