refactor: improve API consistency for jobs and schema.drop

AutoPopulate.jobs:
- Changed from @Property to descriptor pattern
- Now accessible on both class and instance:
    Analysis.jobs.refresh()    # class access
    Analysis().jobs.refresh()  # instance access
- Maintains lazy initialization behavior

Schema.drop():
- Changed parameter from `force` to `prompt` for clarity
- prompt=True: show confirmation prompt
- prompt=False: drop without confirmation
- prompt=None (default): use dj.config['safemode'] setting
- More intuitive: prompt=False means "don't prompt"
  vs force=True which meant "force without prompt"

Co-Authored-By: Claude Opus 4.5 <[email protected]>

Author: dimitri-yatsenko

src/datajoint/autopopulate.py

@@ -93,27 +93,40 @@ class AutoPopulate:
     _allow_insert = False
     _jobs = None
 
-    @property
-    def jobs(self) -> Job:
-        """
-        Access the job table for this auto-populated table.
+    class _JobsDescriptor:
+        """Descriptor allowing jobs access on both class and instance."""
 
-        The job table (``~~table_name``) is created lazily on first access.
-        It tracks job status, priority, scheduling, and error information
-        for distributed populate operations.
+        def __get__(self, obj, objtype=None):
+            """
+            Access the job table for this auto-populated table.
 
-        Returns
-        -------
-        Job
-            Job management object for this table.
-        """
-        if self._jobs is None:
-            from .jobs import Job
+            The job table (``~~table_name``) is created lazily on first access.
+            It tracks job status, priority, scheduling, and error information
+            for distributed populate operations.
+
+            Can be accessed on either the class or an instance::
 
-            self._jobs = Job(self)
-            if not self._jobs.is_declared:
-                self._jobs.declare()
-        return self._jobs
+                # Both work equivalently
+                Analysis.jobs.refresh()
+                Analysis().jobs.refresh()
+
+            Returns
+            -------
+            Job
+                Job management object for this table.
+            """
+            if obj is None:
+                # Accessed on class - instantiate first
+                obj = objtype()
+            if obj._jobs is None:
+                from .jobs import Job
+
+                obj._jobs = Job(obj)
+                if not obj._jobs.is_declared:
+                    obj._jobs.declare()
+            return obj._jobs
+
+    jobs: Job = _JobsDescriptor()
 
     def _declare_check(self, primary_key: list[str], fk_attribute_map: dict[str, tuple[str, str]]) -> None:
         """

src/datajoint/schemas.py

@@ -390,27 +390,27 @@ def spawn_missing_classes(self, context: dict[str, Any] | None = None) -> None:
             self._decorate_table(part_class, context=context, assert_declared=True)
             setattr(master_class, class_name, part_class)
 
-    def drop(self, force: bool = False) -> None:
+    def drop(self, prompt: bool | None = None) -> None:
         """
         Drop the associated schema and all its tables.
 
         Parameters
         ----------
-        force : bool, optional
-            If True, skip confirmation prompt. Default False.
+        prompt : bool, optional
+            If True, show confirmation prompt before dropping.
+            If False, drop without confirmation.
+            If None (default), use ``dj.config['safemode']`` setting.
 
         Raises
         ------
         AccessError
             If insufficient permissions to drop the schema.
         """
+        prompt = config["safemode"] if prompt is None else prompt
+
         if not self.exists:
             logger.info("Schema named `{database}` does not exist. Doing nothing.".format(database=self.database))
-        elif (
-            not config["safemode"]
-            or force
-            or user_choice("Proceed to delete entire schema `%s`?" % self.database, default="no") == "yes"
-        ):
+        elif not prompt or user_choice("Proceed to delete entire schema `%s`?" % self.database, default="no") == "yes":
             logger.debug("Dropping `{database}`.".format(database=self.database))
             try:
                 self.connection.query("DROP DATABASE `{database}`".format(database=self.database))