re-tree

WebJar for re-tree

License

License

MIT
Categories

Categories

Github Development Tools Version Controls
GroupId

GroupId

org.webjars.bower
ArtifactId

ArtifactId

github-com-srfrnk-re-tree
Last Version

Last Version

0.0.2
Release Date

Release Date

Type

Type

jar
Description

Description

re-tree
WebJar for re-tree
Project URL

Project URL

http://webjars.org
Source Code Management

Source Code Management

https://github.com/srfrnk/re-tree

Download github-com-srfrnk-re-tree

How to add to project

<!-- https://jarcasting.com/artifacts/org.webjars.bower/github-com-srfrnk-re-tree/ -->
<dependency>
    <groupId>org.webjars.bower</groupId>
    <artifactId>github-com-srfrnk-re-tree</artifactId>
    <version>0.0.2</version>
</dependency>
// https://jarcasting.com/artifacts/org.webjars.bower/github-com-srfrnk-re-tree/
implementation 'org.webjars.bower:github-com-srfrnk-re-tree:0.0.2'
// https://jarcasting.com/artifacts/org.webjars.bower/github-com-srfrnk-re-tree/
implementation ("org.webjars.bower:github-com-srfrnk-re-tree:0.0.2")
'org.webjars.bower:github-com-srfrnk-re-tree:jar:0.0.2'
<dependency org="org.webjars.bower" name="github-com-srfrnk-re-tree" rev="0.0.2">
  <artifact name="github-com-srfrnk-re-tree" type="jar" />
</dependency>
@Grapes(
@Grab(group='org.webjars.bower', module='github-com-srfrnk-re-tree', version='0.0.2')
)
libraryDependencies += "org.webjars.bower" % "github-com-srfrnk-re-tree" % "0.0.2"
[org.webjars.bower/github-com-srfrnk-re-tree "0.0.2"]

Dependencies

There are no dependencies for this project. It is a standalone project that does not depend on any other jars.

Project Modules

There are no modules declared in this project.

re-tree

JavaScript Extended regular expression engine - client side, server side and 'angular side' ready.

Build Status GitHub issues Known Vulnerabilities Open Source Helpers

GitHub license npm npm npm

Commitizen friendly Semver

Sometimes you get to a point where your regular expressions get so complex it's a nightmare to maintain. Sometimes it's just easier to split these expressions into smaller - simpler - expression and use flow logic to handle the complex cases. This is where re-tree comes and helps.

Consider the user-agent use case - you need to identify when you're in chrome... using the user-agent string.

  • User agent string for chrome might look like that: Mozilla/5.0 (Windows NT 6.3; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/37.0.2049.0 Safari/537.36
  • But a Safari UA might look light that: Mozilla/5.0 (iPad; CPU OS 6_0 like Mac OS X) AppleWebKit/536.26 (KHTML, like Gecko) Version/6.0 Mobile/10A5355d Safari/8536.25
  • And an Opera UA might look light that: Mozilla/5.0 (Windows NT 6.3; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/42.0.2311.90 Safari/537.36 OPR/29.0.1795.47

So you need a very complex RE expression to detect chrome and only chrome. Or you might choose to create a simple RE to detect chrome ('CH'), then a simple RE to detect Safari ('SF') and a simple RE to detect Opera ('OP') and use the following:

var inChrome=CH.test(UA) && !(SF.test(UA) || OP.test(UA));

which is simpler to read and maintain.

This would be the equivalent of using re-tree like that:

var reTree-require('re-tree');
var inChrome=reTree.test(UA,{and:[CH,{not:{or:[SF,OP]}}]});

Even simpler - right?!

Install

$ bower i re-tree -S

Server-Side Usage

var reTree=require('re-tree');

Client-Side Usage

Add script load to HTML:<script type="text/javascript" src=".../re-tree.js"></script>

To use from angular: Add module to your app dependencies: ...angular.module("...", [..."reTree"...])...

API

reTree has two functions:

test(string,exp) : Boolean : return true iff exp matches the string. exec(string,re | array_of_re) : Array : return the results of executing the first matching RE on the string.

The exec function will handle a single RE or an array of RE items. It will find the first matching RE and return the value of execution of the RE on the string.

The test function can test for a full re-tree expression. An re-expression can take one of the following forms:

  1. A string containing a correct RE string
  2. A RegExp instance
  3. An object { not: EXP } where EXP is an re-tree expression
  4. An object { or: [EXP1,EXP2,...] } where EXP1,EXP2... are re-tree expressions
  5. An object { and: [EXP1,EXP2,...] } where EXP1,EXP2... are re-tree expressions

Example:

// This matches Chrome but not Safari and Opera
var re = {
    and: [
        {
            or: [
                /\bChrome\b/,
                /\bCriOS\b/
            ]
        },
        {not: /\bOPR\b/}
    ]
};

Support

Pull-requests with new stuff will be highly appreciated :)

License

MIT License

Versions

Version
0.0.2