feat: add initials extension to string

Author: kishormainali

.dart_tool/package_config.json

@@ -153,9 +153,9 @@
     },
     {
       "name": "file_picker",
-      "rootUri": "file:///Users/kishor/.pub-cache/hosted/pub.dev/file_picker-5.5.0",
+      "rootUri": "file:///Users/kishor/.pub-cache/hosted/pub.dev/file_picker-6.0.0",
       "packageUri": "lib/",
-      "languageVersion": "2.17"
+      "languageVersion": "2.19"
     },
     {
       "name": "file_selector_linux",
@@ -572,7 +572,7 @@
       "languageVersion": "3.0"
     }
   ],
-  "generated": "2023-10-12T10:29:39.107737Z",
+  "generated": "2023-10-16T10:49:55.061202Z",
   "generator": "pub",
   "generatorVersion": "3.1.3"
 }

.dart_tool/package_config_subset

@@ -99,9 +99,9 @@ file
 file:///Users/kishor/.pub-cache/hosted/pub.dev/file-7.0.0/
 file:///Users/kishor/.pub-cache/hosted/pub.dev/file-7.0.0/lib/
 file_picker
-2.17
-file:///Users/kishor/.pub-cache/hosted/pub.dev/file_picker-5.5.0/
-file:///Users/kishor/.pub-cache/hosted/pub.dev/file_picker-5.5.0/lib/
+2.19
+file:///Users/kishor/.pub-cache/hosted/pub.dev/file_picker-6.0.0/
+file:///Users/kishor/.pub-cache/hosted/pub.dev/file_picker-6.0.0/lib/
 file_selector_linux
 2.18
 file:///Users/kishor/.pub-cache/hosted/pub.dev/file_selector_linux-0.9.2/

.flutter-plugins

@@ -1,5 +1,5 @@
 # This is a generated file; do not edit or check into version control.
-file_picker=/Users/kishor/.pub-cache/hosted/pub.dev/file_picker-5.5.0/
+file_picker=/Users/kishor/.pub-cache/hosted/pub.dev/file_picker-6.0.0/
 file_selector_linux=/Users/kishor/.pub-cache/hosted/pub.dev/file_selector_linux-0.9.2/
 file_selector_macos=/Users/kishor/.pub-cache/hosted/pub.dev/file_selector_macos-0.9.3+1/
 file_selector_windows=/Users/kishor/.pub-cache/hosted/pub.dev/file_selector_windows-0.9.3/

.flutter-plugins-dependencies

@@ -1 +1 @@
-{"info":"This is a generated file; do not edit or check into version control.","plugins":{"ios":[{"name":"file_picker","path":"/Users/kishor/.pub-cache/hosted/pub.dev/file_picker-5.5.0/","native_build":true,"dependencies":[]},{"name":"image_picker_ios","path":"/Users/kishor/.pub-cache/hosted/pub.dev/image_picker_ios-0.8.8/","native_build":true,"dependencies":[]}],"android":[{"name":"file_picker","path":"/Users/kishor/.pub-cache/hosted/pub.dev/file_picker-5.5.0/","native_build":true,"dependencies":["flutter_plugin_android_lifecycle"]},{"name":"flutter_plugin_android_lifecycle","path":"/Users/kishor/.pub-cache/hosted/pub.dev/flutter_plugin_android_lifecycle-2.0.15/","native_build":true,"dependencies":[]},{"name":"image_picker_android","path":"/Users/kishor/.pub-cache/hosted/pub.dev/image_picker_android-0.8.7+4/","native_build":true,"dependencies":["flutter_plugin_android_lifecycle"]}],"macos":[{"name":"file_selector_macos","path":"/Users/kishor/.pub-cache/hosted/pub.dev/file_selector_macos-0.9.3+1/","native_build":true,"dependencies":[]},{"name":"image_picker_macos","path":"/Users/kishor/.pub-cache/hosted/pub.dev/image_picker_macos-0.2.1/","native_build":false,"dependencies":["file_selector_macos"]}],"linux":[{"name":"file_selector_linux","path":"/Users/kishor/.pub-cache/hosted/pub.dev/file_selector_linux-0.9.2/","native_build":true,"dependencies":[]},{"name":"image_picker_linux","path":"/Users/kishor/.pub-cache/hosted/pub.dev/image_picker_linux-0.2.1/","native_build":false,"dependencies":["file_selector_linux"]}],"windows":[{"name":"file_selector_windows","path":"/Users/kishor/.pub-cache/hosted/pub.dev/file_selector_windows-0.9.3/","native_build":true,"dependencies":[]},{"name":"image_picker_windows","path":"/Users/kishor/.pub-cache/hosted/pub.dev/image_picker_windows-0.2.1/","native_build":false,"dependencies":["file_selector_windows"]}],"web":[{"name":"file_picker","path":"/Users/kishor/.pub-cache/hosted/pub.dev/file_picker-5.5.0/","dependencies":[]},{"name":"image_picker_for_web","path":"/Users/kishor/.pub-cache/hosted/pub.dev/image_picker_for_web-3.0.0/","dependencies":[]}]},"dependencyGraph":[{"name":"file_picker","dependencies":["flutter_plugin_android_lifecycle"]},{"name":"file_selector_linux","dependencies":[]},{"name":"file_selector_macos","dependencies":[]},{"name":"file_selector_windows","dependencies":[]},{"name":"flutter_plugin_android_lifecycle","dependencies":[]},{"name":"image_picker","dependencies":["image_picker_android","image_picker_for_web","image_picker_ios","image_picker_linux","image_picker_macos","image_picker_windows"]},{"name":"image_picker_android","dependencies":["flutter_plugin_android_lifecycle"]},{"name":"image_picker_for_web","dependencies":[]},{"name":"image_picker_ios","dependencies":[]},{"name":"image_picker_linux","dependencies":["file_selector_linux"]},{"name":"image_picker_macos","dependencies":["file_selector_macos"]},{"name":"image_picker_windows","dependencies":["file_selector_windows"]}],"date_created":"2023-10-12 16:14:39.172015","version":"3.13.7"}
+{"info":"This is a generated file; do not edit or check into version control.","plugins":{"ios":[{"name":"file_picker","path":"/Users/kishor/.pub-cache/hosted/pub.dev/file_picker-6.0.0/","native_build":true,"dependencies":[]},{"name":"image_picker_ios","path":"/Users/kishor/.pub-cache/hosted/pub.dev/image_picker_ios-0.8.8/","native_build":true,"dependencies":[]}],"android":[{"name":"file_picker","path":"/Users/kishor/.pub-cache/hosted/pub.dev/file_picker-6.0.0/","native_build":true,"dependencies":["flutter_plugin_android_lifecycle"]},{"name":"flutter_plugin_android_lifecycle","path":"/Users/kishor/.pub-cache/hosted/pub.dev/flutter_plugin_android_lifecycle-2.0.15/","native_build":true,"dependencies":[]},{"name":"image_picker_android","path":"/Users/kishor/.pub-cache/hosted/pub.dev/image_picker_android-0.8.7+4/","native_build":true,"dependencies":["flutter_plugin_android_lifecycle"]}],"macos":[{"name":"file_selector_macos","path":"/Users/kishor/.pub-cache/hosted/pub.dev/file_selector_macos-0.9.3+1/","native_build":true,"dependencies":[]},{"name":"image_picker_macos","path":"/Users/kishor/.pub-cache/hosted/pub.dev/image_picker_macos-0.2.1/","native_build":false,"dependencies":["file_selector_macos"]}],"linux":[{"name":"file_selector_linux","path":"/Users/kishor/.pub-cache/hosted/pub.dev/file_selector_linux-0.9.2/","native_build":true,"dependencies":[]},{"name":"image_picker_linux","path":"/Users/kishor/.pub-cache/hosted/pub.dev/image_picker_linux-0.2.1/","native_build":false,"dependencies":["file_selector_linux"]}],"windows":[{"name":"file_selector_windows","path":"/Users/kishor/.pub-cache/hosted/pub.dev/file_selector_windows-0.9.3/","native_build":true,"dependencies":[]},{"name":"image_picker_windows","path":"/Users/kishor/.pub-cache/hosted/pub.dev/image_picker_windows-0.2.1/","native_build":false,"dependencies":["file_selector_windows"]}],"web":[{"name":"file_picker","path":"/Users/kishor/.pub-cache/hosted/pub.dev/file_picker-6.0.0/","dependencies":[]},{"name":"image_picker_for_web","path":"/Users/kishor/.pub-cache/hosted/pub.dev/image_picker_for_web-3.0.0/","dependencies":[]}]},"dependencyGraph":[{"name":"file_picker","dependencies":["flutter_plugin_android_lifecycle"]},{"name":"file_selector_linux","dependencies":[]},{"name":"file_selector_macos","dependencies":[]},{"name":"file_selector_windows","dependencies":[]},{"name":"flutter_plugin_android_lifecycle","dependencies":[]},{"name":"image_picker","dependencies":["image_picker_android","image_picker_for_web","image_picker_ios","image_picker_linux","image_picker_macos","image_picker_windows"]},{"name":"image_picker_android","dependencies":["flutter_plugin_android_lifecycle"]},{"name":"image_picker_for_web","dependencies":[]},{"name":"image_picker_ios","dependencies":[]},{"name":"image_picker_linux","dependencies":["file_selector_linux"]},{"name":"image_picker_macos","dependencies":["file_selector_macos"]},{"name":"image_picker_windows","dependencies":["file_selector_windows"]}],"date_created":"2023-10-16 16:34:55.130765","version":"3.13.7"}

CHANGELOG.md

@@ -1,5 +1,11 @@
+# 1.2.16
+- BREAKING CHANGES
+    - renamed `removeNextLine` to `replaceEscaped`
+- added `removeExtraSpace` string extension
+- added `initials` string extension to get initial letter of string
+
 # 1.2.15
-- added equalIgnoreCase and compareIgnoreCase extension on String
+- added `equalIgnoreCase` and `compareIgnoreCase` extension on String
 - updated field to support multiple match validator
 # 1.2.14
 - added gradient borders
@@ -11,7 +17,7 @@
     - ConstrainedScrollableColumn
     - PaddedSpacedRow
     - PaddedSpacedColumn
-    - SizedScrollableColumn
+    - SizedScrollableRow
 - added useSafeArea property to ScrollableColumn
 
 # 1.2.12

lib/src/extensions/string_extension.dart

@@ -78,6 +78,13 @@ extension StringX on String {
   /// uppercase
   String get uppercase => toUpperCase();
 
+  /// initials
+  /// returns the initials of the string
+  /// if the string is empty, returns an empty string
+  /// if the string has one word, returns the first two characters
+  /// if the string has two or more words, returns the first character of the first two words
+  String get initials => _ReCase(this).getInitial();
+
   /// equalsIgnoreCase
   /// equals two strings ignoring case
   bool equalsIgnoreCase(String match) {
@@ -110,20 +117,19 @@ extension StringX on String {
     return trim().replaceAll(' ', '');
   }
 
-  /// remove all \n from string
-  String get removeNextLine {
+  /// remove extra space from string
+  String get removeExtraSpace {
     if (isBlank) return this;
-    return trim().replaceAll('\n', '');
+    return replaceAll(RegExp(r"\s+"), " ");
   }
 
   /// remove all \n \r \t from string
-  String get replaceNextLine {
+  String replaceEscaped([String replacement = ' ']) {
     if (isBlank) return this;
     return trim()
-        .replaceAll('\n', ' ')
-        .replaceAll('\r', ' ')
-        .replaceAll('\t', ' ')
-        .trim();
+        .replaceAll(RegExp(r'[\t\n\r\v\f]'), replacement)
+        .trim()
+        .removeExtraSpace;
   }
 
   /// tries to parse as bool
@@ -337,6 +343,27 @@ class _ReCase {
   /// Title Case
   String get titleCase => _getPascalCase(separator: ' ');
 
+  /// Initials
+  /// returns the initials of the string
+  /// if the string is empty, returns an empty string
+  /// if the string has one word, returns the first two characters
+  /// if the string has two or more words, returns the first character of the first two words
+  String getInitial() {
+    if (_words.isEmpty) return '';
+    if (_words.length == 1) {
+      return '${_words.first[0].toUpperCase()}${_words.first[1].toUpperCase()}'
+          .trim();
+    }
+    if (_words.length > 2) {
+      return _words
+          .getRange(0, 2)
+          .map((word) => word[0].toUpperCase())
+          .join()
+          .trim();
+    }
+    return _words.map((word) => word[0].toUpperCase()).join().trim();
+  }
+
   String _getCamelCase({String separator = ''}) {
     List<String> words = _words.map(_upperCaseFirstLetter).toList();
     if (_words.isNotEmpty) {

pubspec.lock

@@ -205,10 +205,10 @@ packages:
     dependency: "direct main"
     description:
       name: file_picker
-      sha256: be325344c1f3070354a1d84a231a1ba75ea85d413774ec4bdf444c023342e030
+      sha256: "903dd4ba13eae7cef64acc480e91bf54c3ddd23b5b90b639c170f3911e489620"
       url: "https://pub.dev"
     source: hosted
-    version: "5.5.0"
+    version: "6.0.0"
   file_selector_linux:
     dependency: transitive
     description:
@@ -746,4 +746,4 @@ packages:
     version: "3.1.2"
 sdks:
   dart: ">=3.1.0-185.0.dev <4.0.0"
-  flutter: ">=3.7.0-0"
+  flutter: ">=3.7.0"

pubspec.yaml

@@ -1,6 +1,6 @@
 name: fp_util
 description: Utilities and Extensions for num,BuildContext,EdgeInsets,File,String. constants for horizontal and vertical spacing.
-version: 1.2.15
+version: 1.2.16
 
 homepage: https://mkcli.kishormainali.com/
 repository: https://github.com/kishormainali/fp_util
@@ -18,7 +18,7 @@ dependencies:
   image_picker: ">=1.0.0 <2.0.0"
 
   # file picker
-  file_picker: ^5.5.0
+  file_picker: ^6.0.0
 
   # svg
   flutter_svg: ^2.0.7