isfinal docs

CHANGELOG.md

@@ -20,6 +20,7 @@
 
 ## [7.6.1] - 31.08.2023
 
+* added `isFinal` scope parameter which fixes https://github.com/fluttercommunity/get_it/issues/326
 * version bump of dependencies and updates readme
 
 ## [7.6.0] - 09.05.2023

README.md

@@ -229,6 +229,10 @@ Another example could be a shopping basket where you want to ensure that not a c
   /// is still valid while it is executed
   /// [init] optional function to register Objects immediately after the new scope is
   /// pushed. This ensures that [onScopeChanged] will be called after their registration
+  /// if [isFinal] is set to true, you can't register any new objects in this scope after
+  /// this call. In Other words you have to register the objects for this scope inside
+  /// [init] if you set [isFinal] to true. This is useful if you want to ensure that
+  /// no new objects are registered in this scope by accident which could lead to race conditions
   void pushNewScope({void Function(GetIt getIt)? init,String scopeName, ScopeDisposeFunc dispose});
 
   /// Disposes all factories/Singletons that have been registered in this scope

analysis_options.yaml

@@ -6,6 +6,9 @@ include: package:lint/analysis_options_package.yaml
 linter:
   rules:
     - always_declare_return_types
+    - unawaited_futures
+    - discarded_futures
+
     # ------ Disable individual rules ----- #
     #                 ---                   #
     # Turn off what you don't like.         #

lib/get_it.dart

@@ -384,6 +384,10 @@ abstract class GetIt {
   /// is still valid while it is executed
   /// [init] optional function to register Objects immediately after the new scope is
   /// pushed. This ensures that [onScopeChanged] will be called after their registration
+  /// if [isFinal] is set to true, you can't register any new objects in this scope after
+  /// this call. In Other words you have to register the objects for this scope inside
+  /// [init] if you set [isFinal] to true. This is useful if you want to ensure that
+  /// no new objects are registered in this scope by accident which could lead to race conditions
   void pushNewScope({
     void Function(GetIt getIt)? init,
     String? scopeName,