Update docs and remove deprecated features.

Author: guzman-raphael

.vscode/settings.json

@@ -10,5 +10,6 @@
     },
     "[markdown]": {
         "editor.defaultFormatter": "disable"
-    }
+    },
+    "files.autoSave": "off"
 }

CHANGELOG.md

@@ -1,6 +1,6 @@
 ## Release notes
 
-### 0.14.0 -- TBA
+### 0.14.0 -- Feb 10, 2023
 - Fixed - Activating a schema requires all tables to exist even if `create_tables=False` PR [#1058](https://github.com/datajoint/datajoint-python/pull/1058)
 - Changed - Populate call with `reserve_jobs=True` to exclude `error` and `ignore` keys - PR [#1062](https://github.com/datajoint/datajoint-python/pull/1062)
 - Added - Support for inserting data with CSV files - PR [#1067](https://github.com/datajoint/datajoint-python/pull/1067)

datajoint/condition.py

@@ -25,10 +25,10 @@ def translate_attribute(key):
         return match, match["attr"]
     else:
         return match, "json_value(`{}`, _utf8mb4'$.{}'{})".format(
-            *{
-                k: ((f" returning {v}" if k == "type" else v) if v else "")
+            *[
+                ((f" returning {v}" if k == "type" else v) if v else "")
                 for k, v in match.items()
-            }.values()
+            ]
         )
 
 

datajoint/declare.py

@@ -163,19 +163,14 @@ def compile_foreign_key(
     from .table import Table
     from .expression import QueryExpression
 
-    obsolete = False  # See issue #436.  Old style to be deprecated in a future release
     try:
         result = foreign_key_parser.parseString(line)
-    except pp.ParseException:
-        try:
-            result = foreign_key_parser_old.parseString(line)
-        except pp.ParseBaseException as err:
-            raise DataJointError('Parsing error in line "%s". %s.' % (line, err))
-        else:
-            obsolete = True
+    except pp.ParseException as err:
+        raise DataJointError('Parsing error in line "%s". %s.' % (line, err))
+
     try:
         ref = eval(result.ref_table, context)
-    except NameError if obsolete else Exception:
+    except Exception:
         raise DataJointError(
             "Foreign key reference %s could not be resolved" % result.ref_table
         )
@@ -191,18 +186,6 @@ def compile_foreign_key(
             'Primary dependencies cannot be nullable in line "{line}"'.format(line=line)
         )
 
-    if obsolete:
-        logger.warning(
-            'Line "{line}" uses obsolete syntax that will no longer be supported in datajoint 0.14. '
-            "For details, see issue #780 https://github.com/datajoint/datajoint-python/issues/780".format(
-                line=line
-            )
-        )
-        if not isinstance(ref, type) or not issubclass(ref, Table):
-            raise DataJointError(
-                "Foreign key reference %r must be a valid query" % result.ref_table
-            )
-
     if isinstance(ref, type) and issubclass(ref, Table):
         ref = ref()
 
@@ -218,55 +201,6 @@ def compile_foreign_key(
             % result.ref_table
         )
 
-    if obsolete:
-        # for backward compatibility with old-style dependency declarations.  See issue #436
-        if not isinstance(ref, Table):
-            DataJointError(
-                'Dependency "%s" is not supported. Check documentation.'
-                % result.ref_table
-            )
-        if not all(r in ref.primary_key for r in result.ref_attrs):
-            raise DataJointError('Invalid foreign key attributes in "%s"' % line)
-        try:
-            raise DataJointError(
-                'Duplicate attributes "{attr}" in "{line}"'.format(
-                    attr=next(attr for attr in result.new_attrs if attr in attributes),
-                    line=line,
-                )
-            )
-        except StopIteration:
-            pass  # the normal outcome
-
-        # Match the primary attributes of the referenced table to local attributes
-        new_attrs = list(result.new_attrs)
-        ref_attrs = list(result.ref_attrs)
-
-        # special case, the renamed attribute is implicit
-        if new_attrs and not ref_attrs:
-            if len(new_attrs) != 1:
-                raise DataJointError(
-                    'Renamed foreign key must be mapped to the primary key in "%s"'
-                    % line
-                )
-            if len(ref.primary_key) == 1:
-                # if the primary key has one attribute, allow implicit renaming
-                ref_attrs = ref.primary_key
-            else:
-                # if only one primary key attribute remains, then allow implicit renaming
-                ref_attrs = [attr for attr in ref.primary_key if attr not in attributes]
-                if len(ref_attrs) != 1:
-                    raise DataJointError(
-                        'Could not resolve which primary key attribute should be referenced in "%s"'
-                        % line
-                    )
-
-        if len(new_attrs) != len(ref_attrs):
-            raise DataJointError('Mismatched attributes in foreign key "%s"' % line)
-
-        if ref_attrs:
-            # convert to projected dependency
-            ref = ref.proj(**dict(zip(new_attrs, ref_attrs)))
-
     # declare new foreign key attributes
     for attr in ref.primary_key:
         if attr not in attributes:

datajoint/table.py

@@ -774,58 +774,6 @@ def describe(self, context=None, printout=False):
             logger.info("\n" + definition)
         return definition
 
-    def _update(self, attrname, value=None):
-        """
-        This is a deprecated function to be removed in datajoint 0.14.
-        Use ``.update1`` instead.
-
-        Updates a field in one existing tuple. self must be restricted to exactly one entry.
-        In DataJoint the principal way of updating data is to delete and re-insert the
-        entire record and updates are reserved for corrective actions.
-        This is because referential integrity is observed on the level of entire
-        records rather than individual attributes.
-
-        Safety constraints:
-           1. self must be restricted to exactly one tuple
-           2. the update attribute must not be in primary key
-
-        Example:
-        >>> (v2p.Mice() & key)._update('mouse_dob', '2011-01-01')
-        >>> (v2p.Mice() & key)._update( 'lens')   # set the value to NULL
-        """
-        logger.warning(
-            "`_update` is a deprecated function to be removed in datajoint 0.14. "
-            "Use `.update1` instead."
-        )
-        if len(self) != 1:
-            raise DataJointError("Update is only allowed on one tuple at a time")
-        if attrname not in self.heading:
-            raise DataJointError("Invalid attribute name")
-        if attrname in self.heading.primary_key:
-            raise DataJointError("Cannot update a key value.")
-
-        attr = self.heading[attrname]
-
-        if attr.is_blob:
-            value = blob.pack(value)
-            placeholder = "%s"
-        elif attr.numeric:
-            if value is None or np.isnan(float(value)):  # nans are turned into NULLs
-                placeholder = "NULL"
-                value = None
-            else:
-                placeholder = "%s"
-                value = str(int(value) if isinstance(value, bool) else value)
-        else:
-            placeholder = "%s" if value is not None else "NULL"
-        command = "UPDATE {full_table_name} SET `{attrname}`={placeholder} {where_clause}".format(
-            full_table_name=self.from_clause(),
-            attrname=attrname,
-            placeholder=placeholder,
-            where_clause=self.where_clause(),
-        )
-        self.connection.query(command, args=(value,) if value is not None else ())
-
     # --- private helper functions ----
     def __make_placeholder(self, name, value, ignore_extra_fields=False):
         """