Adds type hints with TablesCrawler for the table crawlers where required #2819 (#2819)

\## Changes
Adds type hints with `TablesCrawler` for the table crawlers where
required #2819

FasterTableCrawler now extends TablesCrawler

### Linked issues
(https://github.com/databrickslabs/ucx/pull/2813/files#r1786418356)

Author: pritishpai

src/databricks/labs/ucx/contexts/workflow_task.py

@@ -84,8 +84,7 @@ def global_init_scripts_crawler(self) -> GlobalInitScriptCrawler:
         return GlobalInitScriptCrawler(self.workspace_client, self.sql_backend, self.inventory_database)
 
     @cached_property
-    def tables_crawler(self):
-        # TODO: Update tables crawler inheritance to specify return type hint
+    def tables_crawler(self) -> FasterTableScanCrawler:
         return FasterTableScanCrawler(self.sql_backend, self.inventory_database, self.config.include_databases)
 
     @cached_property

src/databricks/labs/ucx/hive_metastore/grants.py

@@ -32,14 +32,15 @@
 )
 from databricks.labs.ucx.framework.crawlers import CrawlerBase
 from databricks.labs.ucx.framework.utils import escape_sql_identifier
+from databricks.labs.ucx.hive_metastore import TablesCrawler
 from databricks.labs.ucx.hive_metastore.locations import (
     ExternalLocations,
     Mount,
     Mounts,
 )
 from databricks.labs.ucx.hive_metastore.mapping import TableToMigrate, Rule
 from databricks.labs.ucx.hive_metastore.table_migration_status import TableMigrationStatusRefresher
-from databricks.labs.ucx.hive_metastore.tables import Table, TablesCrawler
+from databricks.labs.ucx.hive_metastore.tables import Table
 from databricks.labs.ucx.hive_metastore.udfs import UdfsCrawler
 from databricks.labs.ucx.workspace_access.groups import GroupManager
 

src/databricks/labs/ucx/hive_metastore/table_migrate.py

@@ -9,7 +9,7 @@
 from databricks.labs.ucx.framework.utils import escape_sql_identifier
 from databricks.sdk import WorkspaceClient
 
-from databricks.labs.ucx.hive_metastore import TablesCrawler, Mounts
+from databricks.labs.ucx.hive_metastore import Mounts, TablesCrawler
 from databricks.labs.ucx.hive_metastore.grants import MigrateGrants
 from databricks.labs.ucx.hive_metastore.locations import Mount, ExternalLocations
 from databricks.labs.ucx.hive_metastore.mapping import (

src/databricks/labs/ucx/hive_metastore/tables.py

@@ -486,7 +486,7 @@ def _describe(self, catalog: str, database: str, table: str) -> Table | None:
             return None
 
 
-class FasterTableScanCrawler(CrawlerBase[Table]):
+class FasterTableScanCrawler(TablesCrawler):
     """
     FasterTableScanCrawler is a specialized version of TablesCrawler that uses spark._jsparkSession to utilize
     faster scanning with Scala APIs.
@@ -503,7 +503,7 @@ def __init__(self, backend: SqlBackend, schema, include_databases: list[str] | N
         # pylint: disable-next=import-error,import-outside-toplevel
         from pyspark.sql.session import SparkSession  # type: ignore[import-not-found]
 
-        super().__init__(backend, "hive_metastore", schema, "tables", Table)
+        super().__init__(backend, schema, include_databases)
         self._spark = SparkSession.builder.getOrCreate()
 
     @cached_property