Run tests on MongoDB v5.0.23 instead of v3.2.19

.circleci/config.yml

@@ -23,9 +23,9 @@ jobs:
     <<: *defaults
     docker:
     - image: circleci/python:3.10
-    - image: mongo:3.2.19
+    - image: mongo:5.0.23
   test-3.11:
     <<: *defaults
     docker:
     - image: cimg/python:3.11
-    - image: mongo:3.2.19
+    - image: mongo:5.0.23

docs/guide/querying.rst

@@ -357,21 +357,6 @@ To get the average (mean) of a field on a collection of documents, use
 
     mean_age = User.objects.average('age')
 
-As MongoDB provides native lists, MongoEngine provides a helper method to get a
-dictionary of the frequencies of items in lists across an entire collection --
-:meth:`~mongoengine.queryset.QuerySet.item_frequencies`. An example of its use
-would be generating "tag-clouds"::
-
-    class Article(Document):
-        tag = ListField(StringField())
-
-    # After adding some tagged articles...
-    tag_freqs = Article.objects.item_frequencies('tag', normalize=True)
-
-    from operator import itemgetter
-    top_tags = sorted(tag_freqs.items(), key=itemgetter(1), reverse=True)[:10]
-
-
 Query efficiency and performance
 ================================
 
@@ -497,7 +482,6 @@ that you may use with these methods:
 * ``dec`` -- decrement a value by a given amount
 * ``pop`` -- remove the last item from a list
 * ``push`` -- append a value to a list
-* ``push_all`` -- append several values to a list
 * ``pop`` -- remove the first or last element of a list
 * ``pull`` -- remove a value from a list
 * ``pull_all`` -- remove several values from a list
@@ -541,106 +525,3 @@ cannot use the `$` syntax in keyword arguments it has been mapped to `S`::
     Currently only top level lists are handled, future versions of mongodb /
     pymongo plan to support nested positional operators.  See `The $ positional
     operator <http://www.mongodb.org/display/DOCS/Updating#Updating-The%24positionaloperator>`_.
-
-Server-side javascript execution
-================================
-Javascript functions may be written and sent to the server for execution. The
-result of this is the return value of the Javascript function. This
-functionality is accessed through the
-:meth:`~mongoengine.queryset.QuerySet.exec_js` method on
-:meth:`~mongoengine.queryset.QuerySet` objects. Pass in a string containing a
-Javascript function as the first argument.
-
-The remaining positional arguments are names of fields that will be passed into
-you Javascript function as its arguments. This allows functions to be written
-that may be executed on any field in a collection (e.g. the
-:meth:`~mongoengine.queryset.QuerySet.sum` method, which accepts the name of
-the field to sum over as its argument). Note that field names passed in in this
-manner are automatically translated to the names used on the database (set
-using the :attr:`name` keyword argument to a field constructor).
-
-Keyword arguments to :meth:`~mongoengine.queryset.QuerySet.exec_js` are
-combined into an object called :attr:`options`, which is available in the
-Javascript function. This may be used for defining specific parameters for your
-function.
-
-Some variables are made available in the scope of the Javascript function:
-
-* ``collection`` -- the name of the collection that corresponds to the
-  :class:`~mongoengine.Document` class that is being used; this should be
-  used to get the :class:`Collection` object from :attr:`db` in Javascript
-  code
-* ``query`` -- the query that has been generated by the
-  :class:`~mongoengine.queryset.QuerySet` object; this may be passed into
-  the :meth:`find` method on a :class:`Collection` object in the Javascript
-  function
-* ``options`` -- an object containing the keyword arguments passed into
-  :meth:`~mongoengine.queryset.QuerySet.exec_js`
-
-The following example demonstrates the intended usage of
-:meth:`~mongoengine.queryset.QuerySet.exec_js` by defining a function that sums
-over a field on a document (this functionality is already available throught
-:meth:`~mongoengine.queryset.QuerySet.sum` but is shown here for sake of
-example)::
-
-    def sum_field(document, field_name, include_negatives=True):
-        code = """
-        function(sumField) {
-            var total = 0.0;
-            db[collection].find(query).forEach(function(doc) {
-                var val = doc[sumField];
-                if (val >= 0.0 || options.includeNegatives) {
-                    total += val;
-                }
-            });
-            return total;
-        }
-        """
-        options = {'includeNegatives': include_negatives}
-        return document.objects.exec_js(code, field_name, **options)
-
-As fields in MongoEngine may use different names in the database (set using the
-:attr:`db_field` keyword argument to a :class:`Field` constructor), a mechanism
-exists for replacing MongoEngine field names with the database field names in
-Javascript code. When accessing a field on a collection object, use
-square-bracket notation, and prefix the MongoEngine field name with a tilde.
-The field name that follows the tilde will be translated to the name used in
-the database. Note that when referring to fields on embedded documents,
-the name of the :class:`~mongoengine.fields.EmbeddedDocumentField`, followed by a dot,
-should be used before the name of the field on the embedded document. The
-following example shows how the substitutions are made::
-
-    class Comment(EmbeddedDocument):
-        content = StringField(db_field='body')
-
-    class BlogPost(Document):
-        title = StringField(db_field='doctitle')
-        comments = ListField(EmbeddedDocumentField(Comment), name='cs')
-
-    # Returns a list of dictionaries. Each dictionary contains a value named
-    # "document", which corresponds to the "title" field on a BlogPost, and
-    # "comment", which corresponds to an individual comment. The substitutions
-    # made are shown in the comments.
-    BlogPost.objects.exec_js("""
-    function() {
-        var comments = [];
-        db[collection].find(query).forEach(function(doc) {
-            // doc[~comments] -> doc["cs"]
-            var docComments = doc[~comments];
-
-            for (var i = 0; i < docComments.length; i++) {
-                // doc[~comments][i] -> doc["cs"][i]
-                var comment = doc[~comments][i];
-
-                comments.push({
-                    // doc[~title] -> doc["doctitle"]
-                    'document': doc[~title],
-
-                    // comment[~comments.content] -> comment["body"]
-                    'comment': comment[~comments.content]
-                });
-            }
-        });
-        return comments;
-    }
-    """)