mirror of
https://github.com/arthur-pbty/portfolio2023.git
synced 2026-06-13 23:58:21 +02:00
modified
This commit is contained in:
Tutur33
-19
@@ -1,19 +0,0 @@
|
||||
Copyright (C) 2011 by Roly Fentanes
|
||||
|
||||
Permission is hereby granted, free of charge, to any person obtaining a copy
|
||||
of this software and associated documentation files (the "Software"), to deal
|
||||
in the Software without restriction, including without limitation the rights
|
||||
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
||||
copies of the Software, and to permit persons to whom the Software is
|
||||
furnished to do so, subject to the following conditions:
|
||||
|
||||
The above copyright notice and this permission notice shall be included in
|
||||
all copies or substantial portions of the Software.
|
||||
|
||||
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.
|
||||
-183
@@ -1,183 +0,0 @@
|
||||
# Regular Expression Tokenizer
|
||||
|
||||
Tokenizes strings that represent a regular expressions.
|
||||
|
||||
[](http://travis-ci.org/fent/ret.js)
|
||||
[](https://david-dm.org/fent/ret.js)
|
||||
[](https://codecov.io/gh/fent/ret.js)
|
||||
|
||||
# Usage
|
||||
|
||||
```js
|
||||
var ret = require('ret');
|
||||
|
||||
var tokens = ret(/foo|bar/.source);
|
||||
```
|
||||
|
||||
`tokens` will contain the following object
|
||||
|
||||
```js
|
||||
{
|
||||
"type": ret.types.ROOT
|
||||
"options": [
|
||||
[ { "type": ret.types.CHAR, "value", 102 },
|
||||
{ "type": ret.types.CHAR, "value", 111 },
|
||||
{ "type": ret.types.CHAR, "value", 111 } ],
|
||||
[ { "type": ret.types.CHAR, "value", 98 },
|
||||
{ "type": ret.types.CHAR, "value", 97 },
|
||||
{ "type": ret.types.CHAR, "value", 114 } ]
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
# Token Types
|
||||
|
||||
`ret.types` is a collection of the various token types exported by ret.
|
||||
|
||||
### ROOT
|
||||
|
||||
Only used in the root of the regexp. This is needed due to the posibility of the root containing a pipe `|` character. In that case, the token will have an `options` key that will be an array of arrays of tokens. If not, it will contain a `stack` key that is an array of tokens.
|
||||
|
||||
```js
|
||||
{
|
||||
"type": ret.types.ROOT,
|
||||
"stack": [token1, token2...],
|
||||
}
|
||||
```
|
||||
|
||||
```js
|
||||
{
|
||||
"type": ret.types.ROOT,
|
||||
"options" [
|
||||
[token1, token2...],
|
||||
[othertoken1, othertoken2...]
|
||||
...
|
||||
],
|
||||
}
|
||||
```
|
||||
|
||||
### GROUP
|
||||
|
||||
Groups contain tokens that are inside of a parenthesis. If the group begins with `?` followed by another character, it's a special type of group. A ':' tells the group not to be remembered when `exec` is used. '=' means the previous token matches only if followed by this group, and '!' means the previous token matches only if NOT followed.
|
||||
|
||||
Like root, it can contain an `options` key instead of `stack` if there is a pipe.
|
||||
|
||||
```js
|
||||
{
|
||||
"type": ret.types.GROUP,
|
||||
"remember" true,
|
||||
"followedBy": false,
|
||||
"notFollowedBy": false,
|
||||
"stack": [token1, token2...],
|
||||
}
|
||||
```
|
||||
|
||||
```js
|
||||
{
|
||||
"type": ret.types.GROUP,
|
||||
"remember" true,
|
||||
"followedBy": false,
|
||||
"notFollowedBy": false,
|
||||
"options" [
|
||||
[token1, token2...],
|
||||
[othertoken1, othertoken2...]
|
||||
...
|
||||
],
|
||||
}
|
||||
```
|
||||
|
||||
### POSITION
|
||||
|
||||
`\b`, `\B`, `^`, and `$` specify positions in the regexp.
|
||||
|
||||
```js
|
||||
{
|
||||
"type": ret.types.POSITION,
|
||||
"value": "^",
|
||||
}
|
||||
```
|
||||
|
||||
### SET
|
||||
|
||||
Contains a key `set` specifying what tokens are allowed and a key `not` specifying if the set should be negated. A set can contain other sets, ranges, and characters.
|
||||
|
||||
```js
|
||||
{
|
||||
"type": ret.types.SET,
|
||||
"set": [token1, token2...],
|
||||
"not": false,
|
||||
}
|
||||
```
|
||||
|
||||
### RANGE
|
||||
|
||||
Used in set tokens to specify a character range. `from` and `to` are character codes.
|
||||
|
||||
```js
|
||||
{
|
||||
"type": ret.types.RANGE,
|
||||
"from": 97,
|
||||
"to": 122,
|
||||
}
|
||||
```
|
||||
|
||||
### REPETITION
|
||||
|
||||
```js
|
||||
{
|
||||
"type": ret.types.REPETITION,
|
||||
"min": 0,
|
||||
"max": Infinity,
|
||||
"value": token,
|
||||
}
|
||||
```
|
||||
|
||||
### REFERENCE
|
||||
|
||||
References a group token. `value` is 1-9.
|
||||
|
||||
```js
|
||||
{
|
||||
"type": ret.types.REFERENCE,
|
||||
"value": 1,
|
||||
}
|
||||
```
|
||||
|
||||
### CHAR
|
||||
|
||||
Represents a single character token. `value` is the character code. This might seem a bit cluttering instead of concatenating characters together. But since repetition tokens only repeat the last token and not the last clause like the pipe, it's simpler to do it this way.
|
||||
|
||||
```js
|
||||
{
|
||||
"type": ret.types.CHAR,
|
||||
"value": 123,
|
||||
}
|
||||
```
|
||||
|
||||
## Errors
|
||||
|
||||
ret.js will throw errors if given a string with an invalid regular expression. All possible errors are
|
||||
|
||||
* Invalid group. When a group with an immediate `?` character is followed by an invalid character. It can only be followed by `!`, `=`, or `:`. Example: `/(?_abc)/`
|
||||
* Nothing to repeat. Thrown when a repetitional token is used as the first token in the current clause, as in right in the beginning of the regexp or group, or right after a pipe. Example: `/foo|?bar/`, `/{1,3}foo|bar/`, `/foo(+bar)/`
|
||||
* Unmatched ). A group was not opened, but was closed. Example: `/hello)2u/`
|
||||
* Unterminated group. A group was not closed. Example: `/(1(23)4/`
|
||||
* Unterminated character class. A custom character set was not closed. Example: `/[abc/`
|
||||
|
||||
|
||||
# Install
|
||||
|
||||
npm install ret
|
||||
|
||||
|
||||
# Tests
|
||||
|
||||
Tests are written with [vows](http://vowsjs.org/)
|
||||
|
||||
```bash
|
||||
npm test
|
||||
```
|
||||
|
||||
# License
|
||||
|
||||
MIT
|
||||
-35
@@ -1,35 +0,0 @@
|
||||
{
|
||||
"name": "ret",
|
||||
"description": "Tokenizes a string that represents a regular expression.",
|
||||
"keywords": [
|
||||
"regex",
|
||||
"regexp",
|
||||
"regular expression",
|
||||
"parser",
|
||||
"tokenizer"
|
||||
],
|
||||
"version": "0.1.15",
|
||||
"repository": {
|
||||
"type": "git",
|
||||
"url": "git://github.com/fent/ret.js.git"
|
||||
},
|
||||
"author": "Roly Fentanes (https://github.com/fent)",
|
||||
"main": "./lib/index.js",
|
||||
"files": [
|
||||
"lib"
|
||||
],
|
||||
"scripts": {
|
||||
"test": "istanbul cover vows -- --spec test/*-test.js"
|
||||
},
|
||||
"directories": {
|
||||
"lib": "./lib"
|
||||
},
|
||||
"devDependencies": {
|
||||
"istanbul": "*",
|
||||
"vows": "*"
|
||||
},
|
||||
"engines": {
|
||||
"node": ">=0.12"
|
||||
},
|
||||
"license": "MIT"
|
||||
}
|
||||
Reference in New Issue
Block a user