added provider with params and changed build version

Add parameter to provider

AUTHORS.md

@@ -0,0 +1 @@
+Sergey Penkovsky <sergey.penkovsky@gmail.com>

CHANGELOG.md

@@ -1,4 +1,28 @@
 
+# Changelog
+
+1.0.3  Added provider with params
+
+---
+
+1.0.2  Updated doc and fixed syntax error
+
+---
+1.0.1  Fixed syntax error
+
+---
+1.0.0  Refactored code and added experimental api
+
+---
+
+0.1.2+1  Fixed initializtaion error
+
+---
+0.1.2  Fixed warnings in code
+
+---
+0.1.1+2  Updated libraries and fixed warnings
+
 ---
 
 0.1.1+1  Updated pubspec and readme.md
@@ -11,4 +35,4 @@
 
 0.1.0  Initial release
 
----
+---

README.md

@@ -1,9 +1,201 @@
-# cherrypick
+# Quick start
 
-Experimental development of DI in the Dart language
+## Main components DI
+
+
+### Binding
+
+Binding is a custom instance configurator that contains methods for configuring a dependency.
+
+There are two main methods for initializing a custom instance `toInstance()` and `toProvide()` and auxiliary `withName()` and `singleton()`.
+
+`toInstance()` - takes a initialized instance
+
+`toProvide()` -  takes a `provider` function (instance constructor)
+
+`withName()` - takes a string to name the instance. By this name, it will be possible to extract instance from the DI container
+
+`singleton()` -  sets a flag in the Binding that tells the DI container that there is only one dependency.
+
+Example:
+
+```dart
+ // initializing a text string instance through a method toInstance()
+ Binding<String>().toInstance("hello world");
+
+ // or
+
+ // initializing a text string instance
+ Binding<String>().toProvide(() => "hello world");
+
+ // initializing an instance of a string named
+ Binding<String>().withName("my_string").toInstance("hello world");
+ // or
+ Binding<String>().withName("my_string").toProvide(() => "hello world");
+
+ // instance initialization like singleton
+ Binding<String>().toInstance("hello world");
+ // or
+ Binding<String>().toProvide(() => "hello world").singleton();
+
+```
+
+### Module
+
+Module is a container of user instances, and on the basis of which the user can create their modules. The user in his module must implement the `void builder (Scope currentScope)` method.
+
+
+Example:
+
+```dart
+class AppModule extends Module {
+  @override
+  void builder(Scope currentScope) {
+    bind<ApiClient>().toInstance(ApiClientMock());
+  }
+}
+```
+
+### Scope
+
+Scope is a container that stores the entire dependency tree (scope, modules, instances).
+Through the scope, you can access the custom `instance`, for this you need to call the `resolve<T>()` method and specify the type of the object, and you can also pass additional parameters.
+
+Example:
+
+```dart
+    // open main scope
+    final rootScope =  Cherrypick.openRootScope();
+
+    // initializing scope with a custom module
+    rootScope.installModules([AppModule()]);
+
+    // takes custom instance
+    final str = rootScope.resolve<String>();
+    // or
+    final str = rootScope.tryResolve<String>();
+
+    // close main scope
+    Cherrypick.closeRootScope();
+```
+
+## Example app
+
+
+```dart
+import 'dart:async';
+import 'package:meta/meta.dart';
+import 'package:cherrypick/cherrypick.dart';
+
+class AppModule extends Module {
+  @override
+  void builder(Scope currentScope) {
+    bind<ApiClient>().withName("apiClientMock").toInstance(ApiClientMock());
+    bind<ApiClient>().withName("apiClientImpl").toInstance(ApiClientImpl());
+  }
+}
+
+class FeatureModule extends Module {
+  bool isMock;
+
+  FeatureModule({required this.isMock});
+
+  @override
+  void builder(Scope currentScope) {
+    bind<DataRepository>()
+        .withName("networkRepo")
+        .toProvide(
+          () => NetworkDataRepository(
+            currentScope.resolve<ApiClient>(
+              named: isMock ? "apiClientMock" : "apiClientImpl",
+            ),
+          ),
+        )
+        .singleton();
+    bind<DataBloc>().toProvide(
+      () => DataBloc(
+        currentScope.resolve<DataRepository>(named: "networkRepo"),
+      ),
+    );
+  }
+}
+
+void main() async {
+  final scope = openRootScope().installModules([
+    AppModule(),
+  ]);
+
+  final subScope = scope
+      .openSubScope("featureScope")
+      .installModules([FeatureModule(isMock: true)]);
+
+  final dataBloc = subScope.resolve<DataBloc>();
+  dataBloc.data.listen((d) => print('Received data: $d'),
+      onError: (e) => print('Error: $e'), onDone: () => print('DONE'));
+
+  await dataBloc.fetchData();
+}
+
+class DataBloc {
+  final DataRepository _dataRepository;
+
+  Stream<String> get data => _dataController.stream;
+  StreamController<String> _dataController = new StreamController.broadcast();
+
+  DataBloc(this._dataRepository);
+
+  Future<void> fetchData() async {
+    try {
+      _dataController.sink.add(await _dataRepository.getData());
+    } catch (e) {
+      _dataController.sink.addError(e);
+    }
+  }
+
+  void dispose() {
+    _dataController.close();
+  }
+}
+
+abstract class DataRepository {
+  Future<String> getData();
+}
+
+class NetworkDataRepository implements DataRepository {
+  final ApiClient _apiClient;
+  final _token = 'token';
+
+  NetworkDataRepository(this._apiClient);
+
+  @override
+  Future<String> getData() async => await _apiClient.sendRequest(
+      url: 'www.google.com', token: _token, requestBody: {'type': 'data'});
+}
+
+abstract class ApiClient {
+  Future sendRequest({@required String url, String token, Map requestBody});
+}
+
+class ApiClientMock implements ApiClient {
+  @override
+  Future sendRequest(
+      {@required String? url, String? token, Map? requestBody}) async {
+    return 'Local Data';
+  }
+}
+
+class ApiClientImpl implements ApiClient {
+  @override
+  Future sendRequest(
+      {@required String? url, String? token, Map? requestBody}) async {
+    return 'Network data';
+  }
+}
+```
+
+
+[GitHub Linl](https://github.com/pese-git/cherrypick)
 
-- [New Api ENG](/doc/quick_start_en.md)
-- [New Api RU](/doc/quick_start_ru.md)
 
 
 ### Features

analysis_options.yaml

@@ -0,0 +1 @@
+include: package:pedantic/analysis_options.yaml

doc/quick_start_en.md

@@ -7,7 +7,7 @@
 
 Binding is a custom instance configurator that contains methods for configuring a dependency.
 
-There are two main methods for initializing a custom instance `toInstance ()` and `toProvide ()` and auxiliary `withName ()` and `singeltone ()`.
+There are two main methods for initializing a custom instance `toInstance ()` and `toProvide ()` and auxiliary `withName ()` and `singleton ()`.
 
 `toInstance()` - takes a initialized instance
 
@@ -15,7 +15,7 @@ There are two main methods for initializing a custom instance `toInstance ()` an
 
 `withName()` - takes a string to name the instance. By this name, it will be possible to extract instance from the DI container
 
-`singeltone()` -  sets a flag in the Binding that tells the DI container that there is only one dependency.
+`singleton()` -  sets a flag in the Binding that tells the DI container that there is only one dependency.
 
 Example:
 
@@ -36,7 +36,7 @@ Example:
  // instance initialization like singleton
  Binding<String>().toInstance("hello world");
  // or
- Binding<String>().toProvide(() => "hello world").singeltone();
+ Binding<String>().toProvide(() => "hello world").singleton();
 
 ```
 
@@ -85,8 +85,7 @@ Example:
 ```dart
 import 'dart:async';
 import 'package:meta/meta.dart';
-import 'package:cherrypick/scope.dart';
+import 'package:cherrypick/cherrypick.dart';
-import 'package:cherrypick/module.dart';
 
 class AppModule extends Module {
   @override
@@ -112,7 +111,7 @@ class FeatureModule extends Module {
             ),
           ),
         )
-        .singeltone();
+        .singleton();
     bind<DataBloc>().toProvide(
       () => DataBloc(
         currentScope.resolve<DataRepository>(named: "networkRepo"),

doc/quick_start_ru.md

@@ -7,7 +7,7 @@
 
 Binding - по сути это конфигуратор  для  пользовательского instance, который соддержит методы для конфигурирования зависимости.
 
-Есть два основных метода для инициализации пользовательского instance `toInstance()` и `toProvide()` и вспомогательных `withName()` и `singeltone()`.
+Есть два основных метода для инициализации пользовательского instance `toInstance()` и `toProvide()` и вспомогательных `withName()` и `singleton()`.
 
 `toInstance()` - принимает готовый экземпляр
 
@@ -15,7 +15,7 @@ Binding - по сути это конфигуратор  для  пользов
 
 `withName()` - принимает строку для именования экземпляра. По этому имени можно будет извлечь instance из  DI контейнера
 
-`singeltone()` -  устанавливает флаг в Binding, который говорит DI контейнеру, что зависимость одна.
+`singleton()` -  устанавливает флаг в Binding, который говорит DI контейнеру, что зависимость одна.
 
 Пример:
 
@@ -36,7 +36,7 @@ Binding - по сути это конфигуратор  для  пользов
  // инициализация экземпляра, как сингелтон
  Binding<String>().toInstance("hello world");
  // или
- Binding<String>().toProvide(() => "hello world").singeltone();
+ Binding<String>().toProvide(() => "hello world").singleton();
 
 ```
 
@@ -85,8 +85,7 @@ Scope - это контейнер, который хранит все дерев
 ```dart
 import 'dart:async';
 import 'package:meta/meta.dart';
-import 'package:cherrypick/scope.dart';
+import 'package:cherrypick/cherrypick.dart';
-import 'package:cherrypick/module.dart';
 
 class AppModule extends Module {
   @override
@@ -112,7 +111,7 @@ class FeatureModule extends Module {
             ),
           ),
         )
-        .singeltone();
+        .singleton();
     bind<DataBloc>().toProvide(
       () => DataBloc(
         currentScope.resolve<DataRepository>(named: "networkRepo"),

example/README.md

@@ -1,5 +1,4 @@
-## Example
+# Example
-
 
 pubspec.yaml:
 
@@ -19,10 +18,8 @@ dev_dependencies:
   test: ^1.16.8
 ```
 
-
 main.dart:
 
-
 ```dart
 import 'dart:async';
 import 'package:meta/meta.dart';
@@ -53,7 +50,7 @@ class FeatureModule extends Module {
             ),
           ),
         )
-        .singeltone();
+        .singleton();
     bind<DataBloc>().toProvide(
       () => DataBloc(
         currentScope.resolve<DataRepository>(named: "networkRepo"),
@@ -133,4 +130,4 @@ class ApiClientImpl implements ApiClient {
     return 'Network data';
   }
 }
-```
+```

example/bin/main.dart

@@ -1,13 +1,13 @@
 import 'dart:async';
+
+import 'package:cherrypick/cherrypick.dart';
 import 'package:meta/meta.dart';
-import 'package:cherrypick/scope.dart';
-import 'package:cherrypick/module.dart';
 
 class AppModule extends Module {
   @override
   void builder(Scope currentScope) {
-    bind<ApiClient>().withName("apiClientMock").toInstance(ApiClientMock());
+    bind<ApiClient>().withName('apiClientMock').toInstance(ApiClientMock());
-    bind<ApiClient>().withName("apiClientImpl").toInstance(ApiClientImpl());
+    bind<ApiClient>().withName('apiClientImpl').toInstance(ApiClientImpl());
   }
 }
 
@@ -19,18 +19,20 @@ class FeatureModule extends Module {
   @override
   void builder(Scope currentScope) {
     bind<DataRepository>()
-        .withName("networkRepo")
+        .withName('networkRepo')
         .toProvide(
           () => NetworkDataRepository(
             currentScope.resolve<ApiClient>(
-              named: isMock ? "apiClientMock" : "apiClientImpl",
+              named: isMock ? 'apiClientMock' : 'apiClientImpl',
             ),
           ),
         )
-        .singeltone();
+        .singleton();
-    bind<DataBloc>().toProvide(
+
-      () => DataBloc(
+    bind<DataBloc>().toProvideWithParams(
-        currentScope.resolve<DataRepository>(named: "networkRepo"),
+      (param) => DataBloc(
+        currentScope.resolve<DataRepository>(named: 'networkRepo'),
+        param,
       ),
     );
   }
@@ -42,10 +44,10 @@ void main() async {
   ]);
 
   final subScope = scope
-      .openSubScope("featureScope")
+      .openSubScope('featureScope')
       .installModules([FeatureModule(isMock: true)]);
 
-  final dataBloc = subScope.resolve<DataBloc>();
+  final dataBloc = subScope.resolve<DataBloc>(params: 'PARAMETER');
   dataBloc.data.listen((d) => print('Received data: $d'),
       onError: (e) => print('Error: $e'), onDone: () => print('DONE'));
 
@@ -56,13 +58,15 @@ class DataBloc {
   final DataRepository _dataRepository;
 
   Stream<String> get data => _dataController.stream;
-  StreamController<String> _dataController = new StreamController.broadcast();
+  final StreamController<String> _dataController = StreamController.broadcast();
 
-  DataBloc(this._dataRepository);
+  final String param;
+
+  DataBloc(this._dataRepository, this.param);
 
   Future<void> fetchData() async {
     try {
-      _dataController.sink.add(await _dataRepository.getData());
+      _dataController.sink.add(await _dataRepository.getData(param));
     } catch (e) {
       _dataController.sink.addError(e);
     }
@@ -74,7 +78,7 @@ class DataBloc {
 }
 
 abstract class DataRepository {
-  Future<String> getData();
+  Future<String> getData(String param);
 }
 
 class NetworkDataRepository implements DataRepository {
@@ -84,26 +88,42 @@ class NetworkDataRepository implements DataRepository {
   NetworkDataRepository(this._apiClient);
 
   @override
-  Future<String> getData() async => await _apiClient.sendRequest(
+  Future<String> getData(String param) async => await _apiClient.sendRequest(
-      url: 'www.google.com', token: _token, requestBody: {'type': 'data'});
+      url: 'www.google.com',
+      token: _token,
+      requestBody: {'type': 'data'},
+      param: param);
 }
 
 abstract class ApiClient {
-  Future sendRequest({@required String url, String token, Map requestBody});
+  Future sendRequest({
+    @required String url,
+    String token,
+    Map requestBody,
+    String param,
+  });
 }
 
 class ApiClientMock implements ApiClient {
   @override
-  Future sendRequest(
+  Future sendRequest({
-      {@required String? url, String? token, Map? requestBody}) async {
+    @required String? url,
-    return 'Local Data';
+    String? token,
+    Map? requestBody,
+    String? param,
+  }) async {
+    return 'Local Data $param';
   }
 }
 
 class ApiClientImpl implements ApiClient {
   @override
-  Future sendRequest(
+  Future sendRequest({
-      {@required String? url, String? token, Map? requestBody}) async {
+    @required String? url,
-    return 'Network data';
+    String? token,
+    Map? requestBody,
+    String? param,
+  }) async {
+    return 'Network data $param';
   }
 }

example/pubspec.yaml

@@ -1,7 +1,7 @@
 name: example
 version: 1.0.0
-author: "Sergey Penkovsky <sergey.penkovsky@gmail.com>"
 homepage: localhost
+publish_to: none
 
 environment:
   sdk: ">=2.12.0 <3.0.0"

lib/cherrypick.dart

@@ -0,0 +1,19 @@
+///
+/// Copyright 2021 Sergey Penkovsky <sergey.penkovsky@gmail.com>
+/// Licensed under the Apache License, Version 2.0 (the "License");
+/// you may not use this file except in compliance with the License.
+/// You may obtain a copy of the License at
+///      http://www.apache.org/licenses/LICENSE-2.0
+/// Unless required by applicable law or agreed to in writing, software
+/// distributed under the License is distributed on an "AS IS" BASIS,
+/// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+/// See the License for the specific language governing permissions and
+/// limitations under the License.
+///
+
+library cherrypick;
+
+export 'package:cherrypick/src/binding.dart';
+export 'package:cherrypick/src/helper.dart';
+export 'package:cherrypick/src/module.dart';
+export 'package:cherrypick/src/scope.dart';

lib/dart_di.dart

@@ -1,19 +0,0 @@
-/**
- * Copyright 2021 Sergey Penkovsky <sergey.penkovsky@gmail.com>
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *      http://www.apache.org/licenses/LICENSE-2.0
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-library dart_di;
-
-export 'package:cherrypick/scope.dart';
-export 'package:cherrypick/module.dart';
-export 'package:cherrypick/binding.dart';
-export 'package:cherrypick/di.dart';

lib/di.dart

@@ -1,38 +0,0 @@
-/**
- * Copyright 2021 Sergey Penkovsky <sergey.penkovsky@gmail.com>
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *      http://www.apache.org/licenses/LICENSE-2.0
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-import 'package:cherrypick/scope.dart';
-
-Scope? _rootScope = null;
-
-class CherryPick {
-  /// RU: Метод открывает главный [Scope].
-  /// ENG: The method opens the main [Scope].
-  ///
-  /// return
-  static Scope openRootScope() {
-    if (_rootScope == null) {
-      _rootScope = Scope(null);
-    }
-    return _rootScope!;
-  }
-
-  /// RU: Метод закрывает главный [Scope].
-  /// ENG: The method close the main [Scope].
-  ///
-  ///
-  static void closeRootScope() {
-    if (_rootScope != null) {
-      _rootScope = null;
-    }
-  }
-}

lib/factory.dart

@@ -1,18 +0,0 @@
-/**
- * Copyright 2021 Sergey Penkovsky <sergey.penkovsky@gmail.com>
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *      http://www.apache.org/licenses/LICENSE-2.0
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-import 'package:cherrypick/scope.dart';
-
-abstract class Factory<T> {
-  T createInstance(Scope scope);
-}

lib/src/binding.dart

@@ -1,17 +1,19 @@
-/**
+///
- * Copyright 2021 Sergey Penkovsky <sergey.penkovsky@gmail.com>
+/// Copyright 2021 Sergey Penkovsky <sergey.penkovsky@gmail.com>
- * Licensed under the Apache License, Version 2.0 (the "License");
+/// Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
+/// you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
+/// You may obtain a copy of the License at
- *      http://www.apache.org/licenses/LICENSE-2.0
+///      http://www.apache.org/licenses/LICENSE-2.0
- * Unless required by applicable law or agreed to in writing, software
+/// Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
+/// distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+/// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
+/// See the License for the specific language governing permissions and
- * limitations under the License.
+/// limitations under the License.
- */
+///
 
-enum Mode { SIMPLE, INSTANCE, PROVIDER_INSTANCE }
+enum Mode { SIMPLE, INSTANCE, PROVIDER_INSTANCE, PROVIDER_WITH_PARAMS_INSTANCE }
+
+typedef ProviderWithParams<T> = T Function(dynamic params);
 
 /// RU: Класс Binding<T> настраивает параметры экземпляра.
 /// ENG: The Binding<T> class configures the settings for the instance.
@@ -20,9 +22,10 @@ class Binding<T> {
   late Mode _mode;
   late Type _key;
   late String _name;
-  T? _instance = null;
+  T? _instance;
-  T? Function()? _provider = null;
+  T? Function()? _provider;
-  late bool _isSingeltone = false;
+  ProviderWithParams<T>? _providerWithParams;
+  late bool _isSingleton = false;
   late bool _isNamed = false;
 
   Binding() {
@@ -52,7 +55,7 @@ class Binding<T> {
   /// ENG: The method checks the singleton instance or not.
   ///
   /// return [bool]
-  bool get isSingeltone => _isSingeltone;
+  bool get isSingleton => _isSingleton;
 
   /// RU: Метод проверяет именован экземпляр или нет.
   /// ENG: The method checks whether the instance is named or not.
@@ -77,7 +80,7 @@ class Binding<T> {
   Binding<T> toInstance(T value) {
     _mode = Mode.INSTANCE;
     _instance = value;
-    _isSingeltone = true;
+    _isSingleton = true;
     return this;
   }
 
@@ -91,15 +94,22 @@ class Binding<T> {
     return this;
   }
 
+  /// RU: Инициализация экземляпяра  через провайдер [value] c динамическим параметром.
+  /// ENG: Initialization instance via provider [value] with a dynamic param.
+  ///
+  /// return [Binding]
+  Binding<T> toProvideWithParams(ProviderWithParams<T> value) {
+    _mode = Mode.PROVIDER_WITH_PARAMS_INSTANCE;
+    _providerWithParams = value;
+    return this;
+  }
+
   /// RU: Инициализация экземляпяра  как сингелтон [value].
   /// ENG: Initialization instance as a singelton [value].
   ///
   /// return [Binding]
-  Binding<T> singeltone() {
+  Binding<T> singleton() {
-    if (_mode == Mode.PROVIDER_INSTANCE) {
+    _isSingleton = true;
-      _instance = _provider?.call();
-    }
-    _isSingeltone = true;
     return this;
   }
 
@@ -113,5 +123,20 @@ class Binding<T> {
   /// ENG: Resolve instance.
   ///
   /// return [T]
-  T? get provider => _provider?.call();
+  T? get provider {
+    if (_isSingleton) {
+      _instance ??= _provider?.call();
+      return _instance;
+    }
+    return _provider?.call();
+  }
+
+  /// RU: Поиск экземпляра с параметром.
+  ///
+  /// ENG: Resolve instance with [params].
+  ///
+  /// return [T]
+  T? providerWithParams(dynamic params) {
+    return _providerWithParams?.call(params);
+  }
 }

lib/src/factory.dart

@@ -0,0 +1,17 @@
+///
+/// Copyright 2021 Sergey Penkovsky <sergey.penkovsky@gmail.com>
+/// Licensed under the Apache License, Version 2.0 (the "License");
+/// you may not use this file except in compliance with the License.
+/// You may obtain a copy of the License at
+///      http://www.apache.org/licenses/LICENSE-2.0
+/// Unless required by applicable law or agreed to in writing, software
+/// distributed under the License is distributed on an "AS IS" BASIS,
+/// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+/// See the License for the specific language governing permissions and
+/// limitations under the License.
+///
+import 'package:cherrypick/src/scope.dart';
+
+abstract class Factory<T> {
+  T createInstance(Scope scope);
+}

lib/src/helper.dart

@@ -0,0 +1,105 @@
+///
+/// Copyright 2021 Sergey Penkovsky <sergey.penkovsky@gmail.com>
+/// Licensed under the Apache License, Version 2.0 (the "License");
+/// you may not use this file except in compliance with the License.
+/// You may obtain a copy of the License at
+///      http://www.apache.org/licenses/LICENSE-2.0
+/// Unless required by applicable law or agreed to in writing, software
+/// distributed under the License is distributed on an "AS IS" BASIS,
+/// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+/// See the License for the specific language governing permissions and
+/// limitations under the License.
+///
+import 'package:cherrypick/src/scope.dart';
+import 'package:meta/meta.dart';
+
+Scope? _rootScope;
+
+class CherryPick {
+  /// RU: Метод открывает главный [Scope].
+  /// ENG: The method opens the main [Scope].
+  ///
+  /// return
+  static Scope openRootScope() {
+    _rootScope ??= Scope(null);
+    return _rootScope!;
+  }
+
+  /// RU: Метод закрывает главный [Scope].
+  /// ENG: The method close the main [Scope].
+  ///
+  ///
+  static void closeRootScope() {
+    if (_rootScope != null) {
+      _rootScope = null;
+    }
+  }
+
+  /// RU: Метод открывает  дочерний [Scope].
+  /// ENG: The method open the child [Scope].
+  ///
+  /// Дочерний [Scope] открывается с [scopeName]
+  /// Child [Scope] open with [scopeName]
+  ///
+  /// Example:
+  /// ```
+  /// final String scopeName = 'firstScope.secondScope';
+  /// final subScope = CherryPick.openScope(scopeName);
+  /// ```
+  ///
+  ///
+  @experimental
+  static Scope openScope({String scopeName = '', String separator = '.'}) {
+    if (scopeName.isEmpty) {
+      return openRootScope();
+    }
+
+    final nameParts = scopeName.split(separator);
+    if (nameParts.isEmpty) {
+      throw Exception('Can not open sub scope because scopeName can not split');
+    }
+
+    return nameParts.fold(
+        openRootScope(),
+        (Scope previousValue, String element) =>
+            previousValue.openSubScope(element));
+  }
+
+  /// RU: Метод открывает  дочерний [Scope].
+  /// ENG: The method open the child [Scope].
+  ///
+  /// Дочерний [Scope] открывается с [scopeName]
+  /// Child [Scope] open with [scopeName]
+  ///
+  /// Example:
+  /// ```
+  /// final String scopeName = 'firstScope.secondScope';
+  /// final subScope = CherryPick.closeScope(scopeName);
+  /// ```
+  ///
+  ///
+  @experimental
+  static void closeScope({String scopeName = '', String separator = '.'}) {
+    if (scopeName.isEmpty) {
+      closeRootScope();
+    }
+
+    final nameParts = scopeName.split(separator);
+    if (nameParts.isEmpty) {
+      throw Exception(
+          'Can not close sub scope because scopeName can not split');
+    }
+
+    if (nameParts.length > 1) {
+      final lastPart = nameParts.removeLast();
+
+      final scope = nameParts.fold(
+          openRootScope(),
+          (Scope previousValue, String element) =>
+              previousValue.openSubScope(element));
+      scope.closeSubScope(lastPart);
+    } else {
+      openRootScope().closeSubScope(nameParts[0]);
+    }
+  }
+}

lib/src/module.dart

@@ -1,20 +1,19 @@
-/**
+///
- * Copyright 2021 Sergey Penkovsky <sergey.penkovsky@gmail.com>
+/// Copyright 2021 Sergey Penkovsky <sergey.penkovsky@gmail.com>
- * Licensed under the Apache License, Version 2.0 (the "License");
+/// Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
+/// you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
+/// You may obtain a copy of the License at
- *      http://www.apache.org/licenses/LICENSE-2.0
+///      http://www.apache.org/licenses/LICENSE-2.0
- * Unless required by applicable law or agreed to in writing, software
+/// Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
+/// distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+/// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
+/// See the License for the specific language governing permissions and
- * limitations under the License.
+/// limitations under the License.
- */
+///
-
 import 'dart:collection';
 
-import 'package:cherrypick/binding.dart';
+import 'package:cherrypick/src/binding.dart';
-import 'package:cherrypick/scope.dart';
+import 'package:cherrypick/src/scope.dart';
 
 /// RU: Класс Module является основой для пользовательских модулей.
 ///  Этот класс нужен для инициализации [Scope].

lib/src/scope.dart

@@ -1,20 +1,19 @@
-/**
+///
- * Copyright 2021 Sergey Penkovsky <sergey.penkovsky@gmail.com>
+/// Copyright 2021 Sergey Penkovsky <sergey.penkovsky@gmail.com>
- * Licensed under the Apache License, Version 2.0 (the "License");
+/// Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
+/// you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
+/// You may obtain a copy of the License at
- *      http://www.apache.org/licenses/LICENSE-2.0
+///      http://www.apache.org/licenses/LICENSE-2.0
- * Unless required by applicable law or agreed to in writing, software
+/// Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
+/// distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+/// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
+/// See the License for the specific language governing permissions and
- * limitations under the License.
+/// limitations under the License.
- */
+///
-
 import 'dart:collection';
 
-import 'package:cherrypick/binding.dart';
+import 'package:cherrypick/src/binding.dart';
-import 'package:cherrypick/module.dart';
+import 'package:cherrypick/src/module.dart';
 
 Scope openRootScope() => Scope(null);
 
@@ -87,8 +86,8 @@ class Scope {
   /// If you want to get [null] if the dependency cannot be found then use [tryResolve] instead
   /// return - returns an object of type [T] or [StateError]
   ///
-  T resolve<T>({String? named}) {
+  T resolve<T>({String? named, dynamic params}) {
-    var resolved = tryResolve<T>(named: named);
+    var resolved = tryResolve<T>(named: named, params: params);
     if (resolved != null) {
       return resolved;
     } else {
@@ -100,11 +99,11 @@ class Scope {
   /// RU: Возвращает найденную зависимость типа [T] или null, если она не может быть найдена.
   /// ENG: Returns found dependency of type [T] or null if it cannot be found.
   ///
-  T? tryResolve<T>({String? named}) {
+  T? tryResolve<T>({String? named, dynamic params}) {
     // 1 Поиск зависимости по всем модулям текущего скоупа
     if (_modulesList.isNotEmpty) {
-      for (Module module in _modulesList) {
+      for (var module in _modulesList) {
-        for (Binding binding in module.bindingSet) {
+        for (var binding in module.bindingSet) {
           if (binding.key == T &&
               ((!binding.isNamed && named == null) ||
                   (binding.isNamed && named == binding.name))) {
@@ -112,9 +111,12 @@ class Scope {
               case Mode.INSTANCE:
                 return binding.instance;
               case Mode.PROVIDER_INSTANCE:
-                return binding.isSingeltone
+                return binding.provider;
-                    ? binding.instance
+              case Mode.PROVIDER_WITH_PARAMS_INSTANCE:
-                    : binding.provider;
+                if (params == null) {
+                  throw StateError('Param is null. Maybe you forget pass it');
+                }
+                return binding.providerWithParams(params);
               default:
                 return null;
             }

pubspec.yaml

@@ -1,7 +1,7 @@
 name: cherrypick
 description: Cherrypick is a small dependency injection (DI) library for dart/flutter projects.
-version: 0.1.1+1
+version: 1.0.3
-homepage: https://github.com/pese-git/cherrypick
+homepage: https://pese-git.github.io/cherrypick-site/
 documentation: https://github.com/pese-git/cherrypick/wiki
 repository: https://github.com/pese-git/cherrypick
 issue_tracker: https://github.com/pese-git/cherrypick/issues
@@ -13,6 +13,8 @@ dependencies:
   meta: ^1.3.0
 
 dev_dependencies:
-  test: ^1.16.8
+  pedantic: ^1.11.0
 
-  mockito: ^5.0.3
+  test: ^1.17.2
+
+  mockito: ^5.0.6

test/src/binding_test.dart

@@ -1,294 +1,294 @@
-import 'package:cherrypick/binding.dart';
+import 'package:cherrypick/src/binding.dart';
 import 'package:test/test.dart';
 
 void main() {
-  group("Check instance.", () {
+  group('Check instance.', () {
-    group("Without name.", () {
+    group('Without name.', () {
-      test("Binding resolves null", () {
+      test('Binding resolves null', () {
         final binding = Binding<int>();
         expect(binding.instance, null);
       });
 
-      test("Binding check mode", () {
+      test('Binding check mode', () {
         final expectedValue = 5;
         final binding = Binding<int>().toInstance(expectedValue);
 
         expect(binding.mode, Mode.INSTANCE);
       });
 
-      test("Binding check singeltone", () {
+      test('Binding check singleton', () {
         final expectedValue = 5;
         final binding = Binding<int>().toInstance(expectedValue);
 
-        expect(binding.isSingeltone, true);
+        expect(binding.isSingleton, true);
       });
 
-      test("Binding check value", () {
+      test('Binding check value', () {
         final expectedValue = 5;
         final binding = Binding<int>().toInstance(expectedValue);
 
         expect(binding.instance, expectedValue);
       });
 
-      test("Binding resolves value", () {
+      test('Binding resolves value', () {
         final expectedValue = 5;
         final binding = Binding<int>().toInstance(expectedValue);
         expect(binding.instance, expectedValue);
       });
     });
 
-    group("With name.", () {
+    group('With name.', () {
-      test("Binding resolves null", () {
+      test('Binding resolves null', () {
-        final binding = Binding<int>().withName("expectedValue");
+        final binding = Binding<int>().withName('expectedValue');
         expect(binding.instance, null);
       });
 
-      test("Binding check mode", () {
+      test('Binding check mode', () {
         final expectedValue = 5;
         final binding =
-            Binding<int>().withName("expectedValue").toInstance(expectedValue);
+            Binding<int>().withName('expectedValue').toInstance(expectedValue);
 
         expect(binding.mode, Mode.INSTANCE);
       });
 
-      test("Binding check key", () {
+      test('Binding check key', () {
         final expectedValue = 5;
         final binding =
-            Binding<int>().withName("expectedValue").toInstance(expectedValue);
+            Binding<int>().withName('expectedValue').toInstance(expectedValue);
 
         expect(binding.key, int);
       });
 
-      test("Binding check singeltone", () {
+      test('Binding check singleton', () {
         final expectedValue = 5;
         final binding =
-            Binding<int>().withName("expectedValue").toInstance(expectedValue);
+            Binding<int>().withName('expectedValue').toInstance(expectedValue);
 
-        expect(binding.isSingeltone, true);
+        expect(binding.isSingleton, true);
       });
 
-      test("Binding check value", () {
+      test('Binding check value', () {
         final expectedValue = 5;
         final binding =
-            Binding<int>().withName("expectedValue").toInstance(expectedValue);
+            Binding<int>().withName('expectedValue').toInstance(expectedValue);
 
         expect(binding.instance, expectedValue);
       });
 
-      test("Binding check value", () {
+      test('Binding check value', () {
         final expectedValue = 5;
         final binding =
-            Binding<int>().withName("expectedValue").toInstance(expectedValue);
+            Binding<int>().withName('expectedValue').toInstance(expectedValue);
 
-        expect(binding.name, "expectedValue");
+        expect(binding.name, 'expectedValue');
       });
 
-      test("Binding resolves value", () {
+      test('Binding resolves value', () {
         final expectedValue = 5;
         final binding =
-            Binding<int>().withName("expectedValue").toInstance(expectedValue);
+            Binding<int>().withName('expectedValue').toInstance(expectedValue);
         expect(binding.instance, expectedValue);
       });
     });
   });
 
-  group("Check provide.", () {
+  group('Check provide.', () {
-    group("Without name.", () {
+    group('Without name.', () {
-      test("Binding resolves null", () {
+      test('Binding resolves null', () {
         final binding = Binding<int>();
         expect(binding.provider, null);
       });
 
-      test("Binding check mode", () {
+      test('Binding check mode', () {
         final expectedValue = 5;
         final binding = Binding<int>().toProvide(() => expectedValue);
 
         expect(binding.mode, Mode.PROVIDER_INSTANCE);
       });
 
-      test("Binding check singeltone", () {
+      test('Binding check singleton', () {
         final expectedValue = 5;
         final binding = Binding<int>().toProvide(() => expectedValue);
 
-        expect(binding.isSingeltone, false);
+        expect(binding.isSingleton, false);
       });
 
-      test("Binding check value", () {
+      test('Binding check value', () {
         final expectedValue = 5;
         final binding = Binding<int>().toProvide(() => expectedValue);
 
         expect(binding.provider, expectedValue);
       });
 
-      test("Binding resolves value", () {
+      test('Binding resolves value', () {
         final expectedValue = 5;
         final binding = Binding<int>().toProvide(() => expectedValue);
         expect(binding.provider, expectedValue);
       });
     });
 
-    group("With name.", () {
+    group('With name.', () {
-      test("Binding resolves null", () {
+      test('Binding resolves null', () {
-        final binding = Binding<int>().withName("expectedValue");
+        final binding = Binding<int>().withName('expectedValue');
         expect(binding.provider, null);
       });
 
-      test("Binding check mode", () {
+      test('Binding check mode', () {
         final expectedValue = 5;
         final binding = Binding<int>()
-            .withName("expectedValue")
+            .withName('expectedValue')
             .toProvide(() => expectedValue);
 
         expect(binding.mode, Mode.PROVIDER_INSTANCE);
       });
 
-      test("Binding check key", () {
+      test('Binding check key', () {
         final expectedValue = 5;
         final binding = Binding<int>()
-            .withName("expectedValue")
+            .withName('expectedValue')
             .toProvide(() => expectedValue);
 
         expect(binding.key, int);
       });
 
-      test("Binding check singeltone", () {
+      test('Binding check singleton', () {
         final expectedValue = 5;
         final binding = Binding<int>()
-            .withName("expectedValue")
+            .withName('expectedValue')
             .toProvide(() => expectedValue);
 
-        expect(binding.isSingeltone, false);
+        expect(binding.isSingleton, false);
       });
 
-      test("Binding check value", () {
+      test('Binding check value', () {
         final expectedValue = 5;
         final binding = Binding<int>()
-            .withName("expectedValue")
+            .withName('expectedValue')
             .toProvide(() => expectedValue);
 
         expect(binding.provider, expectedValue);
       });
 
-      test("Binding check value", () {
+      test('Binding check value', () {
         final expectedValue = 5;
         final binding = Binding<int>()
-            .withName("expectedValue")
+            .withName('expectedValue')
             .toProvide(() => expectedValue);
 
-        expect(binding.name, "expectedValue");
+        expect(binding.name, 'expectedValue');
       });
 
-      test("Binding resolves value", () {
+      test('Binding resolves value', () {
         final expectedValue = 5;
         final binding = Binding<int>()
-            .withName("expectedValue")
+            .withName('expectedValue')
             .toProvide(() => expectedValue);
         expect(binding.provider, expectedValue);
       });
     });
   });
 
-  group("Check singeltone provide.", () {
+  group('Check singleton provide.', () {
-    group("Without name.", () {
+    group('Without name.', () {
-      test("Binding resolves null", () {
+      test('Binding resolves null', () {
-        final binding = Binding<int>().singeltone();
+        final binding = Binding<int>().singleton();
         expect(binding.provider, null);
       });
 
-      test("Binding check mode", () {
+      test('Binding check mode', () {
         final expectedValue = 5;
         final binding =
-            Binding<int>().toProvide(() => expectedValue).singeltone();
+            Binding<int>().toProvide(() => expectedValue).singleton();
 
         expect(binding.mode, Mode.PROVIDER_INSTANCE);
       });
 
-      test("Binding check singeltone", () {
+      test('Binding check singleton', () {
         final expectedValue = 5;
         final binding =
-            Binding<int>().toProvide(() => expectedValue).singeltone();
+            Binding<int>().toProvide(() => expectedValue).singleton();
 
-        expect(binding.isSingeltone, true);
+        expect(binding.isSingleton, true);
       });
 
-      test("Binding check value", () {
+      test('Binding check value', () {
         final expectedValue = 5;
         final binding =
-            Binding<int>().toProvide(() => expectedValue).singeltone();
+            Binding<int>().toProvide(() => expectedValue).singleton();
 
         expect(binding.provider, expectedValue);
       });
 
-      test("Binding resolves value", () {
+      test('Binding resolves value', () {
         final expectedValue = 5;
         final binding =
-            Binding<int>().toProvide(() => expectedValue).singeltone();
+            Binding<int>().toProvide(() => expectedValue).singleton();
         expect(binding.provider, expectedValue);
       });
     });
 
-    group("With name.", () {
+    group('With name.', () {
-      test("Binding resolves null", () {
+      test('Binding resolves null', () {
-        final binding = Binding<int>().withName("expectedValue").singeltone();
+        final binding = Binding<int>().withName('expectedValue').singleton();
         expect(binding.provider, null);
       });
 
-      test("Binding check mode", () {
+      test('Binding check mode', () {
         final expectedValue = 5;
         final binding = Binding<int>()
-            .withName("expectedValue")
+            .withName('expectedValue')
             .toProvide(() => expectedValue)
-            .singeltone();
+            .singleton();
 
         expect(binding.mode, Mode.PROVIDER_INSTANCE);
       });
 
-      test("Binding check key", () {
+      test('Binding check key', () {
         final expectedValue = 5;
         final binding = Binding<int>()
-            .withName("expectedValue")
+            .withName('expectedValue')
             .toProvide(() => expectedValue)
-            .singeltone();
+            .singleton();
 
         expect(binding.key, int);
       });
 
-      test("Binding check singeltone", () {
+      test('Binding check singleton', () {
         final expectedValue = 5;
         final binding = Binding<int>()
-            .withName("expectedValue")
+            .withName('expectedValue')
             .toProvide(() => expectedValue)
-            .singeltone();
+            .singleton();
 
-        expect(binding.isSingeltone, true);
+        expect(binding.isSingleton, true);
       });
 
-      test("Binding check value", () {
+      test('Binding check value', () {
         final expectedValue = 5;
         final binding = Binding<int>()
-            .withName("expectedValue")
+            .withName('expectedValue')
             .toProvide(() => expectedValue)
-            .singeltone();
+            .singleton();
 
         expect(binding.provider, expectedValue);
       });
 
-      test("Binding check value", () {
+      test('Binding check value', () {
         final expectedValue = 5;
         final binding = Binding<int>()
-            .withName("expectedValue")
+            .withName('expectedValue')
             .toProvide(() => expectedValue)
-            .singeltone();
+            .singleton();
 
-        expect(binding.name, "expectedValue");
+        expect(binding.name, 'expectedValue');
       });
 
-      test("Binding resolves value", () {
+      test('Binding resolves value', () {
         final expectedValue = 5;
         final binding = Binding<int>()
-            .withName("expectedValue")
+            .withName('expectedValue')
             .toProvide(() => expectedValue)
-            .singeltone();
+            .singleton();
         expect(binding.provider, expectedValue);
       });
     });

test/src/scope_test.dart

@@ -1,28 +1,28 @@
-import 'package:cherrypick/module.dart';
+import 'package:cherrypick/src/module.dart';
-import 'package:cherrypick/scope.dart';
+import 'package:cherrypick/src/scope.dart';
 import 'package:test/test.dart';
 
 void main() {
-  group("Without parent scope.", () {
+  group('Without parent scope.', () {
     test('Parent scope is null.', () {
-      final scope = new Scope(null);
+      final scope = Scope(null);
       expect(scope.parentScope, null);
     });
 
     test('Open sub scope.', () {
-      final scope = new Scope(null);
+      final scope = Scope(null);
-      final subScope = scope.openSubScope("subScope");
+      final subScope = scope.openSubScope('subScope');
-      expect(scope.openSubScope("subScope"), subScope);
+      expect(scope.openSubScope('subScope'), subScope);
     });
 
     test("Container throws state error if the value can't be resolved", () {
-      final scope = new Scope(null);
+      final scope = Scope(null);
       expect(() => scope.resolve<String>(), throwsA(isA<StateError>()));
     });
 
     test('Container resolves value after adding a dependency', () {
-      final expectedValue = "test string";
+      final expectedValue = 'test string';
-      final scope = new Scope(null)
+      final scope = Scope(null)
           .installModules([TestModule<String>(value: expectedValue)]);
       expect(scope.resolve<String>(), expectedValue);
     });
@@ -42,7 +42,7 @@ void main() {
           throwsA(isA<StateError>()));
     });
 */
-    test("Container resolve() returns a value from parent container.", () {
+    test('Container resolve() returns a value from parent container.', () {
       final expectedValue = 5;
       final parentScope = Scope(null);
       final scope = Scope(parentScope);
@@ -52,10 +52,10 @@ void main() {
       expect(scope.resolve<int>(), expectedValue);
     });
 
-    test("Container resolve() returns a  several value from parent container.",
+    test('Container resolve() returns a  several value from parent container.',
         () {
       final expectedIntValue = 5;
-      final expectedStringValue = "Hello world";
+      final expectedStringValue = 'Hello world';
       final parentScope = Scope(null).installModules([
         TestModule<int>(value: expectedIntValue),
         TestModule<String>(value: expectedStringValue)