fix: resolve all ruff linting issues

- Auto-fixed 13 issues with --unsafe-fixes:
  - Import reordering for better organization
  - Modernized isinstance() calls to use | operator
  - Converted .format() to f-strings
  - Simplified path comparisons
  - Converted generator to dict comprehension
  - Removed trailing whitespace
  - Updated type hints from typing module to built-in types

- Manual fixes:
  - Added noqa comments for exception chaining (B904) where existing pattern is intentional
  - Implemented __hash__ method for Sentinel class to properly support equality comparison

Author: taeold

example/functions/main.py

@@ -2,9 +2,10 @@
 Example Firebase Functions written in Python
 """
 
-from firebase_functions import https_fn, options, params, pubsub_fn
 from firebase_admin import initialize_app
 
+from firebase_functions import https_fn, options, params, pubsub_fn
+
 initialize_app()
 
 options.set_global_options(

samples/basic_alerts/functions/main.py

@@ -1,10 +1,12 @@
 """Cloud function samples for Firebase Alerts."""
 
 from firebase_functions import alerts_fn
-from firebase_functions.alerts import app_distribution_fn
-from firebase_functions.alerts import billing_fn
-from firebase_functions.alerts import crashlytics_fn
-from firebase_functions.alerts import performance_fn
+from firebase_functions.alerts import (
+    app_distribution_fn,
+    billing_fn,
+    crashlytics_fn,
+    performance_fn,
+)
 
 
 @alerts_fn.on_alert_published(alert_type=alerts_fn.AlertType.BILLING_PLAN_UPDATE)

samples/basic_db/functions/main.py

@@ -2,9 +2,10 @@
 Example Firebase Functions for RTDB written in Python
 """
 
-from firebase_functions import db_fn, options
 from firebase_admin import initialize_app
 
+from firebase_functions import db_fn, options
+
 initialize_app()
 
 options.set_global_options(region=options.SupportedRegion.EUROPE_WEST1)

samples/basic_firestore/functions/main.py

@@ -2,9 +2,10 @@
 Example Firebase Functions for Firestore written in Python
 """
 
-from firebase_functions import firestore_fn, options
 from firebase_admin import initialize_app
 
+from firebase_functions import firestore_fn, options
+
 initialize_app()
 
 options.set_global_options(region=options.SupportedRegion.EUROPE_WEST1)

samples/basic_params/functions/main.py

@@ -2,9 +2,10 @@
 Example Function params & inputs.
 """
 
-from firebase_functions import storage_fn, params
 from firebase_admin import initialize_app
 
+from firebase_functions import params, storage_fn
+
 initialize_app()
 
 bucket = params.StringParam(

samples/basic_storage/functions/main.py

@@ -2,10 +2,11 @@
 Example Firebase Functions for Storage triggers.
 """
 
-from firebase_functions import storage_fn
-from firebase_functions.storage_fn import StorageObjectData, CloudEvent
 from firebase_admin import initialize_app
 
+from firebase_functions import storage_fn
+from firebase_functions.storage_fn import CloudEvent, StorageObjectData
+
 initialize_app()
 
 

samples/basic_tasks/functions/main.py

@@ -5,8 +5,9 @@
 
 from firebase_admin import initialize_app
 from google.cloud import tasks_v2
-from firebase_functions import tasks_fn, https_fn
-from firebase_functions.options import SupportedRegion, RetryConfig, RateLimits
+
+from firebase_functions import https_fn, tasks_fn
+from firebase_functions.options import RateLimits, RetryConfig, SupportedRegion
 
 app = initialize_app()
 

setup.py

@@ -16,6 +16,7 @@
 """
 
 from os import path
+
 from setuptools import find_packages, setup
 
 install_requires = [

src/firebase_functions/alerts/app_distribution_fn.py

@@ -19,12 +19,12 @@
 import dataclasses as _dataclasses
 import functools as _functools
 import typing as _typing
+
 import cloudevents.http as _ce
-from firebase_functions.alerts import FirebaseAlertData
 
 import firebase_functions.private.util as _util
-
-from firebase_functions.core import T, CloudEvent
+from firebase_functions.alerts import FirebaseAlertData
+from firebase_functions.core import CloudEvent, T
 from firebase_functions.options import AppDistributionOptions
 
 
@@ -65,7 +65,7 @@ class InAppFeedbackPayload:
 
     feedback_report: str
     """
-    Resource name. Format: 
+    Resource name. Format:
     `projects/{project_number}/apps/{app_id}/releases/{release_id}/feedbackReports/{feedback_id}`
     """
 

src/firebase_functions/alerts/billing_fn.py

@@ -19,12 +19,12 @@
 import dataclasses as _dataclasses
 import functools as _functools
 import typing as _typing
+
 import cloudevents.http as _ce
-from firebase_functions.alerts import FirebaseAlertData
 
 import firebase_functions.private.util as _util
-
-from firebase_functions.core import T, CloudEvent
+from firebase_functions.alerts import FirebaseAlertData
+from firebase_functions.core import CloudEvent, T
 from firebase_functions.options import BillingOptions