From 918a59a76f072bb1db067698fb8a7d6be65c4bbd Mon Sep 17 00:00:00 2001
From: James Kassemi <james.kassemi@close.com>
Date: Tue, 14 Jan 2025 13:50:52 -0500
Subject: [PATCH] Address deprecation warnings for invalid escape sequences

* docstring fixes
* removed `_sub_js_fields` method (unreferenced as of https://github.com/closeio/mongoengine/pull/49/files#diff-03ddbd7a5e58eeaa534e7a277ffa30ebc2f215be6028190f76f2184e078b9532L1152)
---
 mongoengine/queryset/queryset.py | 29 ++---------------------------
 1 file changed, 2 insertions(+), 27 deletions(-)

diff --git a/mongoengine/queryset/queryset.py b/mongoengine/queryset/queryset.py
index 841de2dfa..a79650b7f 100644
--- a/mongoengine/queryset/queryset.py
+++ b/mongoengine/queryset/queryset.py
@@ -639,7 +639,7 @@ def with_id(self, object_id):
     def in_bulk(self, object_ids):
         """Retrieve a set of documents by their ids.
 
-        :param object_ids: a list or tuple of ``ObjectId``\ s
+        :param object_ids: a list or tuple of ``ObjectId``'s
         :rtype: dict of ObjectIds as keys and collection-specific
                 Document subclasses as values.
 
@@ -931,7 +931,7 @@ def clear_cls_query(self):
 
     def explain(self, format=False):
         """Return an explain plan record for the
-        :class:`~mongoengine.queryset.QuerySet`\ 's cursor.
+        :class:`~mongoengine.queryset.QuerySet`'s cursor.
 
         :param format: format the plan before returning it
         """
@@ -1280,31 +1280,6 @@ def clean(data, path=None):
             return data
         return clean(row)
 
-    def _sub_js_fields(self, code):
-        """When fields are specified with [~fieldname] syntax, where
-        *fieldname* is the Python name of a field, *fieldname* will be
-        substituted for the MongoDB name of the field (specified using the
-        :attr:`name` keyword argument in a field's constructor).
-        """
-        def field_sub(match):
-            # Extract just the field name, and look up the field objects
-            field_name = match.group(1).split('.')
-            fields = self._document._lookup_field(field_name)
-            # Substitute the correct name for the field into the javascript
-            return '["%s"]' % fields[-1].db_field
-
-        def field_path_sub(match):
-            # Extract just the field name, and look up the field objects
-            field_name = match.group(1).split('.')
-            fields = self._document._lookup_field(field_name)
-            # Substitute the correct name for the field into the javascript
-            return ".".join([f.db_field for f in fields])
-
-        code = re.sub('\[\s*~([A-z_][A-z_0-9.]+?)\s*\]', field_sub, code)
-        code = re.sub('\{\{\s*~([A-z_][A-z_0-9.]+?)\s*\}\}', field_path_sub,
-                      code)
-        return code
-
     # Deprecated
     def ensure_index(self, **kwargs):
         """Deprecated use :func:`Document.ensure_index`"""