commons_lang

Description:

commons lang

Commons Lang #
Commons Lang provides a host of helper utilities for Dart / Flutter applications, most notably String manipulation methods and basic numerical methods.
Table of Contents #

Commons Lang

Table of Contents
About The Project

Features


Getting Started

Installation
Import Package


Usage
Roadmap
Contributing
License
Contact
Acknowledgments
Limitation of Liability



About The Project #
Features #

Extremely powerful and flexible String interpolation.
Utility methods for working with Strings.
Utility method for working with bool.

Getting Started #
Add the package as a dependency.
Installation #
Add the package to your dependencies.
pub add commons_lang
copied to clipboard
Import Package #
Import the library in your code.
import 'package:commons_lang/commons_lang.dart';
copied to clipboard
Usage #
See the User Guide for detailed information.
StrSubstitutor (String Interpolation) #
The StrSubstitutor provides extremely powerful and flexible interpolation for advanced use cases. It supports nested variables, recursive lookup and escaping variables.
Consider the following example:
Map map = {
"animal": "\${critter}",
"target": "\${pet}",
"pet": "\${petCharacteristic} dog",
"petCharacteristic": "lazy",
"critter": "\${critterSpeed} \${critterColor} \${critterType}",
"critterSpeed": "quick",
"critterColor": "brown",
"critterType": "fox",
};
StrSubstitutor sub = StrSubstitutor.fromMap(map);

print(sub.replace('The \${animal} jumps over the \${target}.'));
copied to clipboard
The output from the above will be
The quick brown fox jumps over the lazy dog.
copied to clipboard
Now consider this variable that is also escaped (the default escape character is $).
print(sub.replace('The \$\${\${animal}} jumps over the \${target}.'));
copied to clipboard
The output from the above will be
The \${quick brown fox} jumps over the lazy dog.
copied to clipboard
This demonstrates the true power and flexibility of the interpolation provided here. For full details see the User Guide.
Roadmap #
See the open issues for a full list of proposed features (and known issues).
Contributing #
Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.
If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement".
Don't forget to give the project a star! Thanks again!

Fork the Project
Create your Feature Branch (git checkout -b feature/AmazingFeature)
Commit your Changes (git commit -m 'Add some AmazingFeature')
Push to the Branch (git push origin feature/AmazingFeature)
Open a Pull Request

License #
Distributed under the MIT License. See LICENSE for more information.
Contact #
Limeslice Software Foundation https://limeslice.org
Acknowledgments #
We would like to thank the authors of the Apache Commons Lang package which has formed the basis of this package.
Limitation of Liability #
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.