django-handyhelpers 0.3.19__py3-none-any.whl → 0.3.35__py3-none-any.whl

handyhelpers/static/node_modules/relateurl/README.md

@@ -0,0 +1,159 @@
+# relateurl [![NPM Version][npm-image]][npm-url] [![Build Status][travis-image]][travis-url] [![Dependency Status][david-image]][david-url]
+
+> Minify URLs by converting them from absolute to relative.
+
+If you were to use this library on a website like `http://example.com/dir1/dir1-1/`, you would get results such as:
+
+| Before                                      | After                                |
+| :------------------------------------------ | :----------------------------------- |
+| `http://example.com/dir1/dir1-2/index.html` | `../dir1-2/`                         |
+| `http://example.com/dir2/dir2-1/`           | `/dir2/dir2-1/`                      |
+| `http://example.com/dir1/dir1-1/`           | ` `                                  |
+| `https://example.com/dir1/dir1-1/`          | `https://example.com/dir1/dir1-1/`   |
+| `http://google.com:80/dir/`                 | `//google.com/dir/`                  |
+| `../../../../../../../../#anchor`           | `/#anchor`                           |
+
+**All string parsing.** *No* directory browsing. It is thoroughly tested, very fast and lightweight with zero external dependencies.
+
+## Getting Started
+
+This utility requires [Node.js](http://nodejs.org/) `>= 0.10`. To install, type this at the command line:
+```
+npm install relateurl --save-dev
+```
+
+### Options
+
+#### options.defaultPorts
+Type: `Object`   
+Default value: `{ftp:21, http:80, https:443}`  
+
+Extend the list with any ports you need. Any URLs containing these default ports will have them removed. Example: `http://example.com:80/` will become `http://example.com/`.
+
+#### options.directoryIndexes
+Type: `Array`   
+Default value: `["index.html"]`  
+
+Extend the list with any resources you need. Works with [`options.removeDirectoryIndexes`](#options.removeDirectoryIndexes).
+
+#### options.ignore_www
+Type: `Boolean`  
+Default value: `false`  
+
+This will, for example, consider any domains containing `http://www.example.com/` to be related to any that contain `http://example.com/`.
+
+#### options.output
+Type: constant or `String`  
+Choices: `RelateUrl.ABSOLUTE`,`RelateUrl.PATH_RELATIVE`,`RelateUrl.ROOT_RELATIVE`,`RelateUrl.SHORTEST`  
+Choices: `"absolute"`,`"pathRelative"`,`"rootRelative"`,`"shortest"`  
+Default value: `RelateUrl.SHORTEST`  
+
+`RelateUrl.ABSOLUTE` will produce an absolute URL. Overrides [`options.schemeRelative`](#options.schemeRelative) with a value of `false`.  
+`RelateUrl.PATH_RELATIVE` will produce something like `../child-of-parent/etc/`.  
+`RelateUrl.ROOT_RELATIVE` will produce something like `/child-of-root/etc/`.  
+`RelateUrl.SHORTEST` will choose whichever is shortest between root- and path-relative.  
+
+#### options.rejectedSchemes
+Type: `Array`   
+Default value: `["data","javascript","mailto"]`  
+
+Extend the list with any additional schemes. Example: `javascript:something` will not be modified.
+
+#### options.removeAuth
+Type: `Boolean`   
+Default value: `false`  
+
+Remove user authentication information from the output URL.
+
+#### options.removeDirectoryIndexes
+Type: `Boolean`   
+Default value: `true`  
+
+Remove any resources that match any found in [`options.directoryIndexes`](#options.directoryIndexes).
+
+#### options.removeEmptyQueries
+Type: `Boolean`   
+Default value: `false`  
+
+Remove empty query variables. Example: `http://domain.com/?var1&var2=&var3=asdf` will become `http://domain.com/?var3=adsf`. This does not apply to unrelated URLs (with other protocols, auths, hosts and/or ports).
+
+#### options.removeRootTrailingSlash
+Type: `Boolean`   
+Default value: `true`  
+
+Remove trailing slashes from root paths. Example: `http://domain.com/?var` will become `http://domain.com?var` while `http://domain.com/dir/?var` will not be modified.
+
+#### options.schemeRelative
+Type: `Boolean`   
+Default value: `true`  
+
+Output URLs relative to the scheme. Example: `http://example.com/` will become `//example.com/`.
+
+#### options.site
+Type: `String`   
+Default value: `undefined`  
+
+An options-based version of the [`from`](#examples) argument. If both are specified, `from` takes priority.
+
+#### options.slashesDenoteHost
+Type: `Boolean`   
+Default value: `true`  
+
+Passed to Node's [`url.parse`](http://nodejs.org/api/url.html#url_url_parse_urlstr_parsequerystring_slashesdenotehost).
+
+### Examples
+This library can be used as a [function for single-use](#single-instance) or as a [class for multiple conversions](#reusable-instances).
+
+Upon successful conversion, a `String` will be returned. If an issue is encountered while parsing `from`, an error will be thrown.
+
+#### Single Instance
+```js
+var RelateUrl = require("relateurl");
+
+var result = RelateUrl.relate(from, to, options);
+```
+
+#### Reusable Instances
+```js
+var RelateUrl = require("relateurl");
+
+var instance = new RelateUrl(from, options);
+
+var result1 = instance.relate(to1);
+var result2 = instance.relate(to2, customOptions);
+var result3 = instance.relate(to3);
+```
+
+## FAQ
+1. **Why bother writing/using this?**  
+To aid in further minifying HTML, mainly for the purpose of faster page loads and SEO. It's been integrated into [HTMLMinifier](https://github.com/kangax/html-minifier).
+
+2. **Why not just use Node's `url.parse`, `url.resolve` and `path.relative`?**  
+`url.parse` *is* used, but `url.resolve` and `path.relative` are both slower and less powerful than this library.
+
+
+## Release History
+* 0.2.7 Node v6 support
+* 0.2.6 minor enhancements
+* 0.2.5 added `options.removeRootTrailingSlash`
+* 0.2.4 added `options.site`
+* 0.2.3 added browserify npm-script
+* 0.2.2 removed task runner
+* 0.2.1 shorten resource- and query-relative URLs, test variations list with other site URLs
+* 0.2.0 code cleanup, `options.removeEmptyQueries=true` only applied to unrelated URLs
+* 0.1.0 initial release
+
+
+## Roadmap
+* 0.2.8 check if queries are the same, regardless of param order
+* 0.2.8 possible [scheme exclusions](http://www.iana.org/assignments/uri-schemes/uri-schemes.xhtml) such as `tel:`
+* 0.2.8 decipher and return invalid input (special cases) to complete test suite
+* 0.3.0 test `options.slashesDenoteHost=false`, add something like `options.externalDirectoryIndexes=[]` for external sites
+
+
+[npm-image]: https://img.shields.io/npm/v/relateurl.svg
+[npm-url]: https://npmjs.org/package/relateurl
+[travis-image]: https://img.shields.io/travis/stevenvachon/relateurl.svg
+[travis-url]: https://travis-ci.org/stevenvachon/relateurl
+[david-image]: https://img.shields.io/david/stevenvachon/relateurl.svg
+[david-url]: https://david-dm.org/stevenvachon/relateurl

handyhelpers/static/node_modules/relateurl/license

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) Steven Vachon <contact@svachon.com> (svachon.com)
+
+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.

handyhelpers/static/node_modules/relateurl/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "relateurl",
+  "description": "Minify URLs by converting them from absolute to relative.",
+  "version": "0.2.7",
+  "license": "MIT",
+  "homepage": "https://github.com/stevenvachon/relateurl",
+  "author": {
+    "name": "Steven Vachon",
+    "email": "contact@svachon.com",
+    "url": "http://www.svachon.com/"
+  },
+  "main": "lib",
+  "repository": {
+    "type": "git",
+    "url": "git://github.com/stevenvachon/relateurl.git"
+  },
+  "bugs": {
+    "url": "https://github.com/stevenvachon/relateurl/issues"
+  },
+  "devDependencies": {
+    "browserify": "^13.0.1",
+    "chai": "^3.5.0",
+    "mocha": "^2.5.3",
+    "uglify-js": "^2.7.0"
+  },
+  "engines": {
+    "node": ">= 0.10"
+  },
+  "scripts": {
+    "browserify": "browserify lib/ --standalone RelateUrl | uglifyjs --compress --mangle -o relateurl-browser.js",
+    "test": "mocha test/ --bail --reporter spec --check-leaks"
+  },
+  "files": [
+    "lib",
+    "license"
+  ],
+  "keywords": [
+    "uri",
+    "url",
+    "minifier",
+    "minify",
+    "lint",
+    "relative",
+    "absolute"
+  ]
+}

handyhelpers/static/node_modules/simport/ChangeLog

@@ -0,0 +1,77 @@
+2021.04.20, v1.2.0
+feature:
+- (simport) add support of function constructors
+- (package) eslint-plugin-putout v7.4.0
+- (package) supertape v5.1.0
+- (package) putout v16.7.0
+
+
+2021.01.25, v1.1.3
+
+fix:
+- (simport) default is frozen object (#1)
+- (simport) default is frozen function (#1)
+
+
+2021.01.25, v1.1.2
+
+feature:
+- (simport) add importAbsolute
+
+
+2021.01.23, v1.1.1
+
+fix:
+- (simport) namespaced imports
+
+
+2021.01.22, v1.1.0
+
+feature:
+- (simport) improve windows support
+
+
+2021.01.21, v1.0.7
+
+fix:
+- (simport) json support
+
+feature:
+- (package) putout v13.8.0
+
+
+2021.01.20, v1.0.6
+
+fix:
+- (simport) ability to handle windows paths (coderaiser/cloudcmd#317)
+
+
+2021.01.12, v1.0.5
+
+fix:
+- (simport) url processing
+
+
+2020.12.28, v1.0.4
+
+fix:
+- (package) main: super-impomrt -> simport
+
+
+2020.12.25, v1.0.3
+
+fix:
+- (simport) createSimport
+
+
+2020.12.25, v1.0.2
+
+fix:
+- (package) rm lib
+
+
+2020.12.25, v1.0.1
+
+feature:
+- (simport) add readjson
+

handyhelpers/static/node_modules/simport/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) coderaiser
+
+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.

handyhelpers/static/node_modules/simport/README.md

@@ -0,0 +1,81 @@
+# Simport [![License][LicenseIMGURL]][LicenseURL] [![NPM version][NPMIMGURL]][NPMURL] [![Dependency Status][DependencyStatusIMGURL]][DependencyStatusURL] [![Build Status][BuildStatusIMGURL]][BuildStatusURL] [![Coverage Status][CoverageIMGURL]][CoverageURL]
+
+Use [dynamic imports](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/import#Dynamic_Imports) just like plain old [require](https://nodejs.org/api/esm.html#esm_require).
+
+With simport you can:
+
+- get `require`
+- get `__filename` or `__dirname`
+- load json
+- avoid extensions
+- avoid destructuring default
+- pass `simport` into functions like [tryCatch](https://github.com/coderaiser/try-to-catch)
+- use [absolute path in windows](https://github.com/nodejs/node/issues/31710#issuecomment-587434048)
+
+## Install
+
+`npm i simport`
+
+## API
+
+### createSimport
+
+Commonjs:
+
+```js
+const {createSimport} = require('simport');
+const simport = createSimport(__filename);
+```
+
+ESM:
+
+```js
+import {createSimport} from 'simport';
+const simport = createSimport(import.meta.url);
+
+// you can import json
+await simport('./package.json');
+// returns
+({
+    name: simport,
+});
+
+// you can avoid .js extension
+await simport('./server');
+
+// you can avoid destructure default
+const validate = await simport('./validate');
+// same as
+const {default: validate2} = await import('./validate.js');
+```
+
+### createCommons
+
+```js
+import {createCommons} from 'simport';
+
+const {
+    __filename,
+    __dirname,
+    require,
+} = createCommons(import.meta.url);
+
+// now you have plain old CommonJS variables
+```
+
+
+## License
+
+MIT
+
+[NPMIMGURL]:                https://img.shields.io/npm/v/simport.svg?style=flat
+[BuildStatusIMGURL]:        https://travis-ci.com/coderaiser/simport.svg?branch=master
+[DependencyStatusIMGURL]:   https://img.shields.io/david/coderaiser/simport.svg?style=flat
+[LicenseIMGURL]:            https://img.shields.io/badge/license-MIT-317BF9.svg?style=flat
+[NPMURL]:                   https://npmjs.org/package/simport "npm"
+[BuildStatusURL]:           https://travis-ci.com/coderaiser/simport  "Build Status"
+[DependencyStatusURL]:      https://david-dm.org/coderaiser/simport "Dependency Status"
+[LicenseURL]:               https://tldrlegal.com/license/mit-license "MIT License"
+
+[CoverageURL]:              https://coveralls.io/github/coderaiser/simport?branch=master
+[CoverageIMGURL]:           https://coveralls.io/repos/coderaiser/simport/badge.svg?branch=master&service=github

handyhelpers/static/node_modules/simport/fixture/context.js

@@ -0,0 +1,3 @@
+module.exports = function() {
+    return this.Compiler;
+}

handyhelpers/static/node_modules/simport/fixture/default-frozen-function.mjs

@@ -0,0 +1,2 @@
+export default Object.freeze((arg) => arg);
+export const bar = "baz";

handyhelpers/static/node_modules/simport/fixture/default-frozen-object.mjs

@@ -0,0 +1,2 @@
+export default Object.freeze(Object.create(null));
+export const foo = 123;

handyhelpers/static/node_modules/simport/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "simport",
+  "version": "1.2.0",
+  "author": "coderaiser <mnemonic.enemy@gmail.com> (https://github.com/coderaiser)",
+  "description": "import like require but async",
+  "homepage": "http://github.com/coderaiser/simport",
+  "main": "simport.js",
+  "exports": {
+    ".": {
+      "node": {
+        "require": "./simport.js",
+        "import": "./simport.mjs"
+      },
+      "default": "./simiport.js"
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "git://github.com/coderaiser/simport.git"
+  },
+  "keywords": [
+    "dynamic",
+    "import",
+    "require",
+    "commonjs",
+    "esm"
+  ],
+  "scripts": {
+    "test": "madrun test",
+    "coverage": "madrun coverage",
+    "lint": "madrun lint",
+    "fix:lint": "madrun fix:lint",
+    "report": "madrun report",
+    "watcher": "madrun watcher",
+    "watch:test": "madrun watch:test",
+    "watch:lint": "madrun watch:lint",
+    "watch:tape": "madrun watch:tape",
+    "watch:coverage:base": "madrun watch:coverage:base",
+    "watch:coverage:tape": "madrun watch:coverage:tape",
+    "watch:coverage": "madrun watch:coverage"
+  },
+  "dependencies": {
+    "readjson": "^2.2.0",
+    "try-to-catch": "^3.0.0"
+  },
+  "license": "MIT",
+  "devDependencies": {
+    "@cloudcmd/stub": "^3.3.0",
+    "c8": "^7.3.5",
+    "coveralls": "^3.0.2",
+    "eslint": "^7.0.0",
+    "eslint-plugin-node": "^11.0.0",
+    "eslint-plugin-putout": "^7.4.0",
+    "madrun": "^8.2.0",
+    "nodemon": "^2.0.2",
+    "putout": "^16.7.0",
+    "supertape": "^5.1.0"
+  },
+  "engines": {
+    "node": ">=12.2"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

handyhelpers/static/node_modules/simport/simport.js

@@ -0,0 +1,84 @@
+'use strict';
+
+const {pathToFileURL} = require('url');
+const readjson = require('readjson');
+const tryToCatch = require('try-to-catch');
+
+const {assign} = Object;
+const isFn = (a) => typeof a === 'function';
+const isObject = (a) => typeof a === 'object';
+
+const maybeFrozenFunction = (a) => !isFn(a) ? a : function(...args) {
+    return a.apply(this, args);
+};
+
+const maybeFrozenObject = (a) => !isObject(a) ? a : assign({}, a);
+
+const importWithExt = async (a, ext = '') => await import(`${a}${ext}`);
+const extensions = [
+    '.js',
+    '.cjs',
+    '.mjs',
+];
+
+module.exports.createSimport = (url) => {
+    url = url.includes('file://') ? url : pathToFileURL(url);
+    
+    return async (name) => {
+        let resolved = name;
+        const isRelative = /^\./.test(name);
+        
+        if (isRelative) {
+            resolved = new URL(name, url);
+        }
+        
+        if (/\.json$/.test(resolved))
+            return await readjson(resolved);
+        
+        if (/\.(js|mjs|cjs)$/.test(name)) {
+            const processed = resolved.href || `file://${resolved}`;
+            const imported = await import(processed);
+            
+            return buildExports(imported);
+        }
+        
+        let imported;
+        let error;
+        
+        if (/^[@a-z]/.test(name)) {
+            imported = await importWithExt(resolved);
+        }
+        
+        if (!imported)
+            [error, imported] = await importAbsolute(resolved);
+        
+        if (error)
+            throw error;
+        
+        return buildExports(imported);
+    };
+};
+
+async function importAbsolute(resolved) {
+    let error;
+    let imported;
+    
+    for (const ext of extensions) {
+        [error, imported] = await tryToCatch(importWithExt, resolved, ext);
+        
+        if (imported)
+            break;
+    }
+    
+    return [error, imported];
+}
+
+function buildExports(imported) {
+    let {default: exports = {}} = imported;
+    
+    exports = maybeFrozenFunction(exports);
+    exports = maybeFrozenObject(exports);
+    
+    return assign(exports, imported);
+}
+

handyhelpers/static/node_modules/simport/simport.mjs

@@ -0,0 +1,22 @@
+import {createRequire} from 'module';
+import {fileURLToPath} from 'url';
+import {dirname} from 'path';
+
+import {createSimport} from './simport.js';
+
+export {
+    createSimport,
+};
+
+export const createCommons = (url) => {
+    const require = createRequire(url);
+    const __filename = fileURLToPath(url);
+    const __dirname = dirname(__filename);
+    
+    return {
+        require,
+        __filename,
+        __dirname,
+    };
+};
+