@mangos/filepath 0.0.8 → 1.0.0

package/CHANGELOG.md

@@ -1,59 +0,0 @@
-## current
-
-
-## "0.0.8"
-  ### fixes
-    - corrected a link in package/filepath/readme.md
-
-
-
-## "0.0.7"
-
- ### fixes
- - corrected homepage property in package.json, points now to valid readme of the package "filelist" in the mono-repo "mangos".
-
-## "0.0.6"
- ### changes
- - The functions `inferPathType` and `lexPath` return the same Pathobject.
-   - `inferPathType` returns an iterator of PathObject
-   - `lextPath` returns a singular PathObject 
- - README adjusted
-
-## "0.0.5"
-
-use globalThis and optional chainging to make platform detection agnostic in node and browser (globalhis.navigator.platform)
-
-## "0.0.4"
-
-Initial release
-
-Added eslint for typechecking
-Zero dependency package
-internals adjusted for use in  @mangos/validator package
-
-
-## 1.0.10
-
-Released 13 Mar 2020
-Mitiate Circular references by adding an "ignore" argument to the jxpath
-Updated documentation to documentation
-
-## 1.0.5
-
-Released Feb 7 2020
-Added "internal" sub-module
-
-## 1.0.4
-
-Released Feb 7 2020
-- Fixed trailing '/' should not cause a exception
-
-## 0.0.2
-
-Released Jan 15, 2020
- - Development and testing done
-
-## 0.0.1
-
-Released dec 28, 2019
- - initial release

package/CODE_OF_CONDUCT.md

@@ -1,69 +0,0 @@
-# Contributor Covenant Code of Conduct
-
-## Our Pledge
-
-In the interest of fostering an open and welcoming environment, we as
-contributors and maintainers pledge to making participation in our project and
-our community a harassment-free experience for everyone, regardless of age, body
-size, disability, ethnicity, sex characteristics, gender identity and expression,
-level of experience, education, socio-economic status, nationality, personal
-appearance, race, religion, or sexual identity and orientation.
-
-## Our Standards
-
-Examples of behavior that contributes to creating a positive environment
-include:
-
-* Using welcoming and inclusive language
-* Being respectful of differing viewpoints and experiences
-* Gracefully accepting constructive criticism
-* Focusing on what is best for the community
-* Showing empathy towards other community members
-
-Examples of unacceptable behavior by participants include:
-
-* The use of sexualized language or imagery and unwelcome sexual attention or
-  advances
-* Trolling, insulting/derogatory comments, and personal or political attacks
-* Public or private harassment
-* Publishing others' private information, such as a physical or electronic
-  address, without explicit permission
-* Other conduct which could reasonably be considered inappropriate in a
-  professional setting
-
-## Our Responsibilities
-
-Project maintainers are responsible for clarifying the standards of acceptable
-behavior and are expected to take appropriate and fair corrective action in
-response to any instances of unacceptable behavior.
-
-Project maintainers have the right and responsibility to remove, edit, or
-reject comments, commits, code, wiki edits, issues, and other contributions
-that are not aligned to this Code of Conduct, or to block temporarily or
-permanently any contributor for other behaviors that they deem inappropriate,
-threatening, offensive, or harmful.
-
-## Scope
-
-This Code of Conduct applies both within project spaces and in public spaces
-when an individual is representing the project or its community. Examples of
-representing a project or community include using an official project e-mail
-address, posting via an official social media account, or acting as an appointed
-representative at an online or offline event. Representation of a project may be
-further defined and clarified by project maintainers.
-
-## Enforcement
-
-Instances of abusive, harassing, or otherwise unacceptable behavior may be
-reported by contacting the project team at info@mail.jacob-bogers.com. All
-complaints will be reviewed and investigated and will result in a response that
-is deemed necessary and appropriate to the circumstances. The project team is
-obligated to maintain confidentiality with regard to the reporter of an incident.
-Further details of specific enforcement policies may be posted separately.
-
-## Attribution
-
-This Code of Conduct is adapted from the [Contributor Covenant][homepage],
-version 1.4, available at https://www.contributor-covenant.org/version/1/4/
-
-[homepage]: http://contributor-covenant.org

package/CONTRIBUTING_GUIDELINES.md

@@ -1,9 +0,0 @@
-Thanks for taking the time to contribute to "@mangos/filepath" Follow these guidelines to make the process smoother:
-
-1. One feature per pull request. Each PR should have one focus, and all the code changes should be supporting that one feature or bug fix. Using a [separate branch](https://guides.github.com/introduction/flow/index.html) for each feature should help you manage developing multiple features at once.
-
-2. Follow the style of the file when it comes to syntax like curly braces and indents.
-
-3. Add a test for the feature or fix, if possible. See the `test` directory for existing tests and README describing how to run these tests.
-
-https://r.js.org/

package/index.js

@@ -1,23 +0,0 @@
-const { inferPathType, lexPath, resolve } = require('./lib/parser');
-const { tokens, rootTokens } = require('./lib/tokenizer');
-
-function invertObject(o) {
-    const rc = {};
-    Object.entries(o).reduce((c, [key,value]) => {
-        c[value] = key;
-        return c;
-    }, rc);
-    return rc;
-}
-
-module.exports = {
-    inferPathType,
-    lexPath,
-    resolve,
-    $tokens: {
-        root: rootTokens,
-        rootValues: invertObject(rootTokens),
-        other: tokens,
-        values: invertObject(tokens)
-    }
-};

package/lib/parser.js

@@ -1,191 +0,0 @@
-const {
-    posixAbsorber,
-    tdpAbsorber,
-    uncAbsorber,
-    ddpAbsorber,
-    tokens,
-    rootTokenValues,
-    getCWD
-} = require('./tokenizer');
-
-const absorberMapping = {
-    unc: uncAbsorber,
-    dos: tdpAbsorber,
-    devicePath: ddpAbsorber,
-    posix: posixAbsorber
-}
-
-// order of importance
-const allNamespaces = ['devicePath', 'unc', 'dos', 'posix'];
-
-function lexPath(path = '', options = {}) {
-    if (typeof path !== 'string') {
-        return path;
-    }
-    const iterator = inferPathType(path, options);
-    const step = iterator.next(); // only get the first one (is also the most likely one)
-    if (step.done) {
-        return undefined;
-    }
-    return step.value;
-}
-
-function filterErr(t) {
-    return t.error !== undefined;
-}
-
-function clonePath(path) {
-    return Array.from({ length: path.length }, (v, i) => Object.assign({}, path[i]));
-}
-
-function createPathProcessor(path) {
-    return function (ns, absorber) {
-        // get all path tokens at once
-        const _tokens = Array.from(absorber(path));
-        if (_tokens.length === 0) return;
-        const rc = { type: ns, path: _tokens };
-        const firstError = _tokens.find(filterErr);
-        if (firstError) {
-            rc.firstError = firstError;
-        }
-        return rc;
-    };
-}
-
-function getErrors(path) {
-    return path.filter(v => v.error).map(v => v.error).join('|');
-}
-
-function last(arr) {
-    return arr[arr.length - 1];
-}
-
-function upp(path) {
-    let _last;
-    for (_last = last(path); _last.token === tokens.SEP; _last = last(path)) {
-        path.pop();
-    }
-    // there is a root?
-    if (!(_last.token in rootTokenValues)) {
-        path.pop();
-    }
-}
-
-function add(_tokens, token) {
-    if (token.token === tokens.SEP) {
-        return; // skip this
-    }
-    let _last = last(_tokens);
-    // normalize
-    for (; _last === tokens.SEP; _last = last(_tokens).token) {
-        tokens.pop();
-    }
-    _tokens.push({
-        token: tokens.SEP,
-        start: _last.end + 1,
-        end: _last.end + 1,
-        value: getSeperator()
-    });
-    _tokens.push({
-        token: token.token,
-        start: _last.end + 2,
-        end: _last.end + +2 + token.end,
-        value: token.value
-    });
-}
-
-function resolve(_from, ..._to) {
-    _from = lexPath(_from);
-    if (_from && _from.firstError) {
-        throw TypeError(`"from" path contains errors: ${getErrors(_from)}`)
-    }
-    if (_from === undefined) {
-        _from = lexPath(getCWD());
-    }
-    if (!(_from.path[0].token in rootTokenValues)) {
-        _to.unshift(_from);
-        _from = lexPath(getCWD());
-    }
-    let to = _to.shift()
-    to = lexPath(to);
-    if (to && to.firstError) {
-        throw TypeError(`"to" path contains errors: ${getErrors(to)}`)
-    }
-    if (to === undefined) {
-        return _from;
-    }
-    if (to.path && to.path[0].token in rootTokenValues) {
-        _from = to;
-        if (_to.length === 0) {
-            return _from;
-        }
-        return resolve(to, ..._to);
-    }
-    // "_from" is guaranteed to me from root and "to" is guaranteed not to be from "root"
-    const working = clonePath(_from.path);
-    for (const token of to.path) {
-        switch (token.token) {
-            case tokens.SEP:
-            case tokens.CURRENT:
-                break;
-            case tokens.PARENT:
-                upp(working);
-                break;
-            case tokens.PATHELT:
-                add(working, token);
-                break;
-            default:
-        }
-    }
-    // finished processing all tokens
-    const rc = { path: working, type: _from.type };
-    if (_to.length === 0) { // efficiency+
-        return rc;
-    }
-    return resolve(rc, ..._to)
-}
-
-function getSeperator() {
-    const platform = globalThis?.navigator?.platform || globalThis?.process?.platform || 'posix';
-    if (platform === 'win32') {
-        return '\\';
-    }
-    return '/';
-}
-
-function defaultOptions(options = {}) {
-    if (Object.keys(options).filter(f => allNamespaces.includes(f)).length === 0) {
-        const platform = globalThis?.navigator?.platform || globalThis?.process?.platform || 'posix';
-        Object.assign(options, {
-            unc: platform === 'win32',
-            dos: platform === 'win32',
-            devicePath: platform === 'win32',
-            posix: platform !== 'win32'
-        });
-    }
-    return options;
-}
-
-
-
-
-function* inferPathType(path, options = {}) {
-    defaultOptions(options);
-    const processor = createPathProcessor(path);
-    const filtered = allNamespaces.filter(f => options[f])
-    for (const ns of filtered) {
-        const result = processor(ns, absorberMapping[ns]);
-        if (result) {
-            yield result;
-        }
-    }
-    return;
-}
-
-
-
-module.exports = {
-    inferPathType,
-    lexPath,
-    resolve
-}