string_extensions 0.6.13

string_extensions: ^0.6.13 copied to clipboard

• Removes Flutter from dependencies
• Improves documentation

• nullIf(String? comparisonString) : Returns null if String equals comparisonString. Otherwise return the String as is.
• emptyIf(String? comparisonString) : Returns empty String if it equalts to comparisonString. Otherwise return the String as is.
• replaceFirst(String pattern, String replacement) : Returns a new string with the first occurrence of the given pattern replaced with the replacement string.
• replaceLast(String pattern, String replacement) : Returns a new string with the last occurrence of the given pattern replaced with the replacement string.

• insertAt : Inserts a String at a specified index
• splitLines : Splits the String into a List of lines ('\r\n' or '\n')
• isJson : Returns true if the String is a valid JSON string

• Bumps SDK constraint from 3.0.0 to 4.0.0
• Adds screenshots in project

New methods

• hasWhitespace : Checks whether the String has any whitespace
• isLettersOnly : Checks whether the String is consisted of only letters (Latin & Greek atm)

New methods

• greekTimeLiteralToEnglish : Transforms the Greek μ.μ. time literal to the equivalent English PM
• containsAnyGreekCharacters : Checks whether a String contains any Greek character
• isUnique : Checks whether the String is consisted of unique characters
• commonCharacters : Returns a Set of common characters between two Strings
• uncommonCharacters: Returns a Set of uncommon characters between two Strings
• containsAllCharacters : Checks whether the String contains all characters

• Improves mostFrequent() method's performance. Also adds ignoreSpaces flag to ignore whitespace from character count
• Fixes removeWhitespace method to properly remove all spaces
• Fixes toGreekUppercase method missing letter "omicron - Ό" from mapping

New methods

• isSwiftCode : A static method to check whether the provided String is a valid Swift code. Source
• digitCount : A static method to count (if any) digits in the String
• isAscii : A static method to check whether a String is consisted only from ASCII characters
• isAnagramOf(String s) : A static method to check whether the provided s String is anagram of the extended String
• isPalindrome : A static method to check whether the String is palindrome
• isMixedCase : A static method to check whether the String is consisted of both upper & lower case letters

Optimized methods

• Optimizes replaceGreek method
• Optimizes toGreekUppercase method
• Optimizes getLevenshtein by using Wagner-Fisher algorithm

• isIban : A static method to check whether the provided String is a valid IBAN. Source
• isGreekId : A static method to check whether the provided String is a valid Greek Identification Number. Source
• isLowerCase : Checks whether the String is in upper case
• isUpperCase : Checks whether the String is in lower case
• swapCase() : Swaps the case in the String.

String foo = 'Hello World';
String swapped = foo.swapCase(); // returns 'hELLO wORLD'

Updates project dependencies, to improve pub.dev score.

• toGreekUpperCase() : Properly uppercases Greek letters, removing the tones.

String greek = 'Τι κάνεις πώς τα περνάς φίλτατέ μου';
String wrongUpperCase = greek.toUpperCase(); // returns 'ΤΙ ΚΆΝΕΙΣ ΠΏΣ ΤΑ ΠΕΡΝΆΣ ΦΊΛΤΑΤΈ ΜΟΥ'
String correctUpperCase = greek.toGreekUpperCase(); // returns 'ΤΙ ΚΑΝΕΙΣ ΠΩΣ ΤΑ ΠΕΡΝΑΣ ΦΙΛΤΑΤΕ ΜΟΥ'

• Fixes truncate(length) method. If the String is equal to length then the String should be returned as it is.

• toLeet : Transform the String to 1337 alphabet. The letters are randomized since each letter can have multiple variations.

String foo = 'esentis';
String leet = foo.toLeet ; // returns '€5£п+!$'

• isCreditCard : Checks if the provided String is a valid credit card number using Luhn algorithm
• removeWhiteSpace : Removes all white space from the provided String.

• formatFileSize : Formats a String representing bytes to show the proper file size.

String foo = '24117248';
String formatted = foo.formatFileSize; // returns '23 MB'

• replaceAtIndex(index,replacement) : Adds a [replacement] at the [index] of the String.
• removeSpecial : Removes all special characters from the String. Issue #22
• onlyLetters : Removes everything but characters from the String.Issue #21

• Project depends on crypto (3.0.2) due to new md5 method wich returns the MD5 hash of the String.
• Bug fixes for various methods, after, before, toTitleCase, openCloseWrappers, removeFirstAndLastAny.
• Various improvements.

• Fixes titleCase not trimming whitespaces.

• All methods will now trim the String before operations.
• toSnakeCase : Converts a String to snake case format.

• addAfter : Adds a String after the first occurence of a specific pattern.
• addBefore : Adds a String before the first occurence of a specific pattern.

• removeAfter : Removes everything after the first occurence of a specific pattern.

• removeBefore : Removes everything before the first occurence of a specific pattern.

Thanks to zonaro

• wrap : Wraps a String between two Strings.

• getOppositeChar : Returns the opposite wrap char of the String.

• isOpenWrapChar : Check if String is a open wrap char: <, {, [, ", '.

• isCloseWrapChar : Checks if String is a close wrap char: >, }, ], ", '.

• removeFirstAny : Continuously removes from the beginning of a String any String contained in [patterns].

• removeLastAny : Continuously removes from the end of a String any String contained in [patterns].

• removeFirstAndLastAny : Continuously removes from the beggining and end of a String any String contained in [patterns].

• removeLastEqual : Remove a String from the end of other string if equal [pattern].

• removeFirstEqual : Remove a String in the beginning of other string if equal [pattern].

• removeFirstAndLastEqual : Remove String from the beginning and the end of String if equal [pattern].

• containsAny : Check if String contains any Strings of [list].

• containsAll : Check if String contains all Strings of [list].

Thanks to zonaro

• isBlank : Checks if a String is null empty or contains only whitespaces.

• isNotBlank : Checks if a String is NOT null empty or contains only whitespaces.

• asIf : Compares a String to another and returns the first if equal, otherwise returns the second one.

• ifBlank(String default) : Checks if a String is blank and gives it a default value.

• Returns the String after a character / word.

after(String pattern)

• Returns the String before a character / word.

before(String pattern)

• Gets Jaro distance to check String similarity. The higher the number the similar the two Strings/

getJaro(String wordToCompare)

• Converts the String to a bool value if possible.

tooBool

Breaking changes #

Following extension methods are now created using get and can now being accessed without ().

• capitalize
• countWords
• removeNumbers
• onlyLatin
• onlyGreek
• isNull
• isIpv4
• isIpv6
• isUrl
• isDate
• isMail
• isNumber
• isStrongPassword
• isGuid
• isLatin
• isGreek
• onlyNumbers
• removeLetters
• charOccurences
• mostFrequent
• reverse
• toSlug
• toCamelCase
• toTitleCase
• toArray
• replaceGreek
• stripHtml
• hasSameCharacters
• shuffle

New Extensions

• Truncates String with "..." when more than n characters.

truncate(int maxChars)

• Truncates String in the middle with "..." keeping max n characters.

truncateMiddle(int maxChars)

• Quotes a String adding " at the start & at the end.

quote

• Trims leading and trailing spaces, so as extra spaces in between words.

trimAll

• Returns the month name of the DateTime (in String format).

getMonthFromDate(locale:'en')

• Returns the first day of the month from the provided DateTime (in String format).

firstDayOfMonth(locale:'en')

• Returns the last day of the month from the provided DateTime (in String format).

latsDayOfMonth(locale:'en')

• Returns left side of the String starting from char.

leftOf(String char)

• Returns right side of the String starting from char.

rightOf(String char)

• formatWithMask now accepts optional parameter specialChar which defaults to '#'

• Add a String at the beginning of your String.

prepend(String prefix)

• Adds - operator subtracting a text from a String
• Returns the day name of the DateTime (in String format).

String date = '2021-10-23';
String day = date.getDayFromDate(); // returns 'Saturday'
String grDay = date.getDayFromDate(locale:'el'); // returns 'Σάββατο'

• Removes the first n characters of the String.

removeFirst(int n)

• Removes the last n characters of the String.

removeLast(int n)

• Trims the String to have exactly n characters. If n is larger than the String length, the same String is returned.

maxChars(int n)

• Reverses slash provided the slash direction (int). 0 for / to \ and 1 for \ to /.

reverseSlash(int direction)

• Returns the character at index.

charAt(int index)

• Checks if a string is null.

isNull()

• Do something if a string is null.

ifNull(Function())

• Provide default value if a string is null.

defaultValue(String defaultValue)

• Append a String at the end of your String.

append(String suffix)

• Formats the String to properly show currency amount.

toPriceFormat({String? currencySymbol})

Bug fixes & New Extensions #

• Returns only the Greek characters of the String.

onlyGreek()

• Checkes whether the String has only Latin characters.

isLatin()

• Checkes whether the String has only Greek characters.

isGreek()

• onlyLetters() is now onlyLatin() characters.
• The countWords extension now correctly counts only words, excluding numbers and symbols from words. For example, Hello 5 2asd friend ! word count will return 3 words.

• Added String? operators >, >=, <, <= to compare String lengths.

• isIn(Iterable<String>), checks if a given String is in an Iterable<String>.

• formatWithMask(String mask), formats a String with a specific mask.

Successfully converts library to extend String? from String. Further code optimization and bug fixes.

New extensions

• Converts the String to a num value if possible, else returns null.

toNum()

• Converts the String to int if possible, else returns null.

toInt()

• Converts the String to double if possible, else returns null.

toDouble()

Improves and renames toStringArray (toArray now)

Adds a new extension that counts specific charater occurences in a String.

charCount(String char)

• Squeezes a String to a character

squeeze(String x);

• Check if the String is consisted of same characters.

hasSameCharacters();

• Shuffles the word's letters.

shuffle();

• Gets the Levenshtein distance of two String

getLevenshtein();

• Checks if a String is a valid Url.

isUrl();

• Checks if a String is a valid Date.

isDate();

• Repeats a String x times

repeat(int x);

• Check if the String is a valid Ipv6

isIpv6();

• Check if the String is a num

isNumber();

• An extension that makes easier handling empty strings.

ifEmpty(()=>print('The string is empty'));

Some projects were breaking due to they depending on test_api:3.0.0 version.

Method to check whether a String is a valid Guid.

isGuid()

• Method to get a List<String> from a String.

toStringArray()

• Method to strip all HTML code from a String.

stripHtml()

• Method to check whether a String is a strong password.

isStrongPassword()

• Adds isEmpty checks on all extensions.

• Given a String and a pattern, finds the starting indices of all occurrences of the pattern in the String.

  findPattern({required String pattern})
  

Useful method to normalize greek text for more performant text searches.

replaceGreek()

first({int count})

last({int count})

toSlug()

News #

Migrates library to null safety.

Extension added :

toTitleCase()

Bug fixes #

• Methods now correctly remove trailing and leading whitespaces from strings.

New extensions #

toCamelCase()

onlyNumbers()

removeLetters()

charOccurences()

mostFrequent()

reverse()

isIpv4()

Extension methods #

readTime()

isMail()

capitalize()

removeNumbers()

onlyLetters()

countWords()