picata 0.0.6__py3-none-any.whl → 0.0.7__py3-none-any.whl

node_modules/terser-webpack-plugin/node_modules/jest-worker/README.md

@@ -0,0 +1,247 @@
+# jest-worker
+
+Module for executing heavy tasks under forked processes in parallel, by providing a `Promise` based interface, minimum overhead, and bound workers.
+
+The module works by providing an absolute path of the module to be loaded in all forked processes. Files relative to a node module are also accepted. All methods are exposed on the parent process as promises, so they can be `await`'ed. Child (worker) methods can either be synchronous or asynchronous.
+
+The module also implements support for bound workers. Binding a worker means that, based on certain parameters, the same task will always be executed by the same worker. The way bound workers work is by using the returned string of the `computeWorkerKey` method. If the string was used before for a task, the call will be queued to the related worker that processed the task earlier; if not, it will be executed by the first available worker, then sticked to the worker that executed it; so the next time it will be processed by the same worker. If you have no preference on the worker executing the task, but you have defined a `computeWorkerKey` method because you want _some_ of the tasks to be sticked, you can return `null` from it.
+
+The list of exposed methods can be explicitly provided via the `exposedMethods` option. If it is not provided, it will be obtained by requiring the child module into the main process, and analyzed via reflection. Check the "minimal example" section for a valid one.
+
+## Install
+
+```sh
+$ yarn add jest-worker
+```
+
+## Example
+
+This example covers the minimal usage:
+
+### File `parent.js`
+
+```javascript
+import {Worker as JestWorker} from 'jest-worker';
+
+async function main() {
+  const worker = new JestWorker(require.resolve('./Worker'));
+  const result = await worker.hello('Alice'); // "Hello, Alice"
+}
+
+main();
+```
+
+### File `worker.js`
+
+```javascript
+export function hello(param) {
+  return 'Hello, ' + param;
+}
+```
+
+## Experimental worker
+
+Node 10 shipped with [worker-threads](https://nodejs.org/api/worker_threads.html), a "threading API" that uses SharedArrayBuffers to communicate between the main process and its child threads. This experimental Node feature can significantly improve the communication time between parent and child processes in `jest-worker`.
+
+Since `worker_threads` are considered experimental in Node, you have to opt-in to this behavior by passing `enableWorkerThreads: true` when instantiating the worker. While the feature was unflagged in Node 11.7.0, you'll need to run the Node process with the `--experimental-worker` flag for Node 10.
+
+## API
+
+The `Worker` export is a constructor that is initialized by passing the worker path, plus an options object.
+
+### `workerPath: string` (required)
+
+Node module name or absolute path of the file to be loaded in the child processes. Use `require.resolve` to transform a relative path into an absolute one.
+
+### `options: Object` (optional)
+
+#### `exposedMethods: $ReadOnlyArray<string>` (optional)
+
+List of method names that can be called on the child processes from the parent process. You cannot expose any method named like a public `Worker` method, or starting with `_`. If you use method auto-discovery, then these methods will not be exposed, even if they exist.
+
+#### `numWorkers: number` (optional)
+
+Amount of workers to spawn. Defaults to the number of CPUs minus 1.
+
+#### `maxRetries: number` (optional)
+
+Maximum amount of times that a dead child can be re-spawned, per call. Defaults to `3`, pass `Infinity` to allow endless retries.
+
+#### `forkOptions: Object` (optional)
+
+Allow customizing all options passed to `childProcess.fork`. By default, some values are set (`cwd`, `env` and `execArgv`), but you can override them and customize the rest. For a list of valid values, check [the Node documentation](https://nodejs.org/api/child_process.html#child_process_child_process_fork_modulepath_args_options).
+
+#### `computeWorkerKey: (method: string, ...args: Array<any>) => ?string` (optional)
+
+Every time a method exposed via the API is called, `computeWorkerKey` is also called in order to bound the call to a worker. This is useful for workers that are able to cache the result or part of it. You bound calls to a worker by making `computeWorkerKey` return the same identifier for all different calls. If you do not want to bind the call to any worker, return `null`.
+
+The callback you provide is called with the method name, plus all the rest of the arguments of the call. Thus, you have full control to decide what to return. Check a practical example on bound workers under the "bound worker usage" section.
+
+By default, no process is bound to any worker.
+
+#### `setupArgs: Array<mixed>` (optional)
+
+The arguments that will be passed to the `setup` method during initialization.
+
+#### `WorkerPool: (workerPath: string, options?: WorkerPoolOptions) => WorkerPoolInterface` (optional)
+
+Provide a custom worker pool to be used for spawning child processes. By default, Jest will use a node thread pool if available and fall back to child process threads.
+
+#### `enableWorkerThreads: boolean` (optional)
+
+`jest-worker` will automatically detect if `worker_threads` are available, but will not use them unless passed `enableWorkerThreads: true`.
+
+### `workerSchedulingPolicy: 'round-robin' | 'in-order'` (optional)
+
+Specifies the policy how tasks are assigned to workers if multiple workers are _idle_:
+
+- `round-robin` (default): The task will be sequentially distributed onto the workers. The first task is assigned to the worker 1, the second to the worker 2, to ensure that the work is distributed across workers.
+- `in-order`: The task will be assigned to the first free worker starting with worker 1 and only assign the work to worker 2 if the worker 1 is busy.
+
+Tasks are always assigned to the first free worker as soon as tasks start to queue up. The scheduling policy does not define the task scheduling which is always first-in, first-out.
+
+### `taskQueue`: TaskQueue` (optional)
+
+The task queue defines in which order tasks (method calls) are processed by the workers. `jest-worker` ships with a `FifoQueue` and `PriorityQueue`:
+
+- `FifoQueue` (default): Processes the method calls (tasks) in the call order.
+- `PriorityQueue`: Processes the method calls by a computed priority in natural ordering (lower priorities first). Tasks with the same priority are processed in any order (FIFO not guaranteed). The constructor accepts a single argument, the function that is passed the name of the called function and the arguments and returns a numerical value for the priority: `new require('jest-worker').PriorityQueue((method, filename) => filename.length)`.
+
+## JestWorker
+
+### Methods
+
+The returned `JestWorker` instance has all the exposed methods, plus some additional ones to interact with the workers itself:
+
+#### `getStdout(): Readable`
+
+Returns a `ReadableStream` where the standard output of all workers is piped. Note that the `silent` option of the child workers must be set to `true` to make it work. This is the default set by `jest-worker`, but keep it in mind when overriding options through `forkOptions`.
+
+#### `getStderr(): Readable`
+
+Returns a `ReadableStream` where the standard error of all workers is piped. Note that the `silent` option of the child workers must be set to `true` to make it work. This is the default set by `jest-worker`, but keep it in mind when overriding options through `forkOptions`.
+
+#### `end()`
+
+Finishes the workers by killing all workers. No further calls can be done to the `Worker` instance.
+
+Returns a Promise that resolves with `{ forceExited: boolean }` once all workers are dead. If `forceExited` is `true`, at least one of the workers did not exit gracefully, which likely happened because it executed a leaky task that left handles open. This should be avoided, force exiting workers is a last resort to prevent creating lots of orphans.
+
+**Note:**
+
+`await`ing the `end()` Promise immediately after the workers are no longer needed before proceeding to do other useful things in your program may not be a good idea. If workers have to be force exited, `jest-worker` may go through multiple stages of force exiting (e.g. SIGTERM, later SIGKILL) and give the worker overall around 1 second time to exit on its own. During this time, your program will wait, even though it may not be necessary that all workers are dead before continuing execution.
+
+Consider deliberately leaving this Promise floating (unhandled resolution). After your program has done the rest of its work and is about to exit, the Node process will wait for the Promise to resolve after all workers are dead as the last event loop task. That way you parallelized computation time of your program and waiting time and you didn't delay the outputs of your program unnecessarily.
+
+### Worker IDs
+
+Each worker has a unique id (index that starts with `1`), which is available inside the worker as `process.env.JEST_WORKER_ID`.
+
+## Setting up and tearing down the child process
+
+The child process can define two special methods (both of them can be asynchronous):
+
+- `setup()`: If defined, it's executed before the first call to any method in the child.
+- `teardown()`: If defined, it's executed when the farm ends.
+
+# More examples
+
+## Standard usage
+
+This example covers the standard usage:
+
+### File `parent.js`
+
+```javascript
+import {Worker as JestWorker} from 'jest-worker';
+
+async function main() {
+  const myWorker = new JestWorker(require.resolve('./Worker'), {
+    exposedMethods: ['foo', 'bar', 'getWorkerId'],
+    numWorkers: 4,
+  });
+
+  console.log(await myWorker.foo('Alice')); // "Hello from foo: Alice"
+  console.log(await myWorker.bar('Bob')); // "Hello from bar: Bob"
+  console.log(await myWorker.getWorkerId()); // "3" -> this message has sent from the 3rd worker
+
+  const {forceExited} = await myWorker.end();
+  if (forceExited) {
+    console.error('Workers failed to exit gracefully');
+  }
+}
+
+main();
+```
+
+### File `worker.js`
+
+```javascript
+export function foo(param) {
+  return 'Hello from foo: ' + param;
+}
+
+export function bar(param) {
+  return 'Hello from bar: ' + param;
+}
+
+export function getWorkerId() {
+  return process.env.JEST_WORKER_ID;
+}
+```
+
+## Bound worker usage:
+
+This example covers the usage with a `computeWorkerKey` method:
+
+### File `parent.js`
+
+```javascript
+import {Worker as JestWorker} from 'jest-worker';
+
+async function main() {
+  const myWorker = new JestWorker(require.resolve('./Worker'), {
+    computeWorkerKey: (method, filename) => filename,
+  });
+
+  // Transform the given file, within the first available worker.
+  console.log(await myWorker.transform('/tmp/foo.js'));
+
+  // Wait a bit.
+  await sleep(10000);
+
+  // Transform the same file again. Will immediately return because the
+  // transformed file is cached in the worker, and `computeWorkerKey` ensures
+  // the same worker that processed the file the first time will process it now.
+  console.log(await myWorker.transform('/tmp/foo.js'));
+
+  const {forceExited} = await myWorker.end();
+  if (forceExited) {
+    console.error('Workers failed to exit gracefully');
+  }
+}
+
+main();
+```
+
+### File `worker.js`
+
+```javascript
+import babel from '@babel/core';
+
+const cache = Object.create(null);
+
+export function transform(filename) {
+  if (cache[filename]) {
+    return cache[filename];
+  }
+
+  // jest-worker can handle both immediate results and thenables. If a
+  // thenable is returned, it will be await'ed until it resolves.
+  return babel.transformFileAsync(filename).then(result => {
+    cache[filename] = result;
+
+    return result;
+  });
+}
+```

node_modules/theme-change/README.md

@@ -0,0 +1,376 @@
+# 🎨 CSS Theme Change
+
+- A tiny JS script to handle CSS themes
+- Change CSS theme using `button`, `toggle` or a `<select>`
+- It saves chosen theme in browser and uses it again when page reloads
+
+[![][build]][build-url] [![][install-size]][install-size-url] [![][js]][js-url]  
+[![][npm]][npm-url] [![][dl]][npm-url] [![][commit]][gh-url]
+
+# 🖥 Demo
+
+- See example code on [codepen](https://codepen.io/saadeghi/pen/OJypbNM)
+- See Sample site on [Netlify](https://css-theme-changer.netlify.app/)
+- See Vue Example on [Vercel](https://vue-3-theme.vercel.app)
+
+[![image](https://user-images.githubusercontent.com/7342023/80218042-e3c67e00-8655-11ea-94e8-925d0dcbfd57.gif)](#)
+
+# 💿 Use
+
+## JS
+
+Use CDN:
+
+```html
+<script src="https://cdn.jsdelivr.net/npm/theme-change@2.0.2/index.js"></script>
+```
+
+<details>
+<summary>
+  Or use NPM: 
+</summary>
+
+Install: `npm i theme-change --save` and use it in your js file:
+
+```js
+import { themeChange } from 'theme-change'
+themeChange()
+```
+
+</details>
+<details>
+<summary>
+  or if it's a React project: 
+</summary>
+
+Install: `npm i theme-change --save` and use it in your js file:
+
+```js
+import { useEffect } from 'react'
+import { themeChange } from 'theme-change'
+
+useEffect(() => {
+  themeChange(false)
+  // 👆 false parameter is required for react project
+}, [])
+```
+
+</details>
+<details>
+<summary>
+  or if it's a Vue 3 project (using composition API): 
+</summary>
+
+Install: `npm i theme-change --save` and use it in your js file:
+
+```js
+import { onMounted } from 'vue'
+import { themeChange } from 'theme-change'
+
+export default {
+  setup() {
+    onMounted(() => {
+      themeChange(false)
+    })
+  },
+}
+```
+
+</details>
+<details>
+<summary>
+  or if it's a Vue 2 project (using options API): 
+</summary>
+
+Install: `npm i theme-change --save` and use it in your js file:
+
+```js
+import { themeChange } from 'theme-change'
+
+export default {
+  mounted: function () {
+    themeChange(false)
+  },
+}
+```
+
+</details>
+<details>
+<summary>
+  or if it's a Svelte project: 
+</summary>
+
+Install: `npm i theme-change --save` and use it in your svelte component that uses one theme-change attributes:
+
+```js
+import { onMount } from 'svelte'
+import { themeChange } from 'theme-change'
+
+// NOTE: the element that is using one of the theme attributes must be in the DOM on mount
+onMount(() => {
+  themeChange(false)
+  // 👆 false parameter is required for svelte
+})
+```
+
+</details>
+<details>
+<summary>
+  or if it's a SolidJS project: 
+</summary>
+
+Install: `npm i theme-change --save` and use it in your js/jsx/tsx file:
+
+```js
+import { onMount } from 'solid-js'
+import { themeChange } from 'theme-change'
+onMount(async () => {
+  themeChange();
+})
+```
+
+
+</details>
+<details>
+<summary>
+  or if it's a Astro project: 
+</summary>
+
+Install: `npm i theme-change --save` and use it in your .astro file(s):
+
+Astro is a bit tricky because of how is rendering html page as a MPA (Multiple Pages Application)
+Astro projects are therefore subject to [FART](https://css-tricks.com/flash-of-inaccurate-color-theme-fart/) problem. To prevent this we will use the [is:inline](https://docs.astro.build/en/reference/directives-reference/#isinline) astro directive.
+
+If you want to apply themes on a single [astro page](https://docs.astro.build/en/core-concepts/astro-pages/) (remember Astro is an MPA framework) :
+
+`src/pages/mypage.astro`
+
+```js
+---
+---
+
+<html lang="en">
+  <head>
+  <script is:inline>
+      // ☝️ This script prevent the FART effect.
+      if (localStorage.getItem("theme") === null) {
+        document.documentElement.setAttribute("data-theme", "light");
+      } else
+      document.documentElement.setAttribute("data-theme",localStorage.getItem("theme"));
+      // "theme" LocalStorage value is set by the package to remember user preference.
+      // The value is checked and applyed before rendering anything.
+  </script>
+  <script>
+      import { themeChange } from "theme-change";
+      themeChange();
+       // 👆 you could import the CDN directly instead of these two lines
+    </script>
+    <title>My crazy credit page</title>
+  </head>
+  <body>
+    <h1>Welcome to my credit page!</h1>
+  </body>
+</html>
+```
+
+If you want to apply themes to all your [astro pages](https://docs.astro.build/en/core-concepts/astro-pages/), you need to execute both scripts in a Astro [layout](https://docs.astro.build/en/core-concepts/layouts/#sample-layout), it would need to wrap all your astro pages like so:
+
+`src/layouts/MyCrazyLayout.astro`
+
+```html
+---
+---
+
+<html lang="en">
+  <head>
+    <script is:inline>
+      // ☝️ This script prevent the FART effect.
+      if (localStorage.getItem("theme") === null) {
+        document.documentElement.setAttribute("data-theme", "light");
+      } else
+        document.documentElement.setAttribute(
+          "data-theme",
+          localStorage.getItem("theme")
+        );
+      // "theme" LocalStorage value is set by the package to remember user preference.
+      // The value is checked and applyed before rendering anything.
+    </script>
+    <script>
+      import { themeChange } from 'theme-change';
+      themeChange();
+      // 👆 you could import the CDN directly instead of these two lines
+    </script>
+    <meta charset="utf-8" />
+    <title>My Cool Astro Layout Wraping All My Pages</title>
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+  </head>
+  <body>
+    <nav>
+      <a href="#">Home</a>
+      <a href="#">Posts</a>
+      <a href="#">Contact</a>
+    </nav>
+    <article>
+      <slot />
+      <!-- your content from src/pages/index.astro is injected here -->
+    </article>
+  </body>
+</html>
+```
+
+`src/pages/index.astro`
+
+```js
+---
+import MyCrazyLayout from '../layouts/MyCrazyLayout.astro';
+---
+<MySiteLayout>
+  <p>My page content, wrapped in a layout!</p>
+</MySiteLayout>
+```
+
+</details>
+
+## CSS
+
+Set your themeable style as custom properties in CSS like this:
+
+```css
+:root {
+  --my-color: #fff;
+  /* or any other variables/style */
+}
+[data-theme='dark'] {
+  --my-color: #000;
+}
+[data-theme='pink'] {
+  --my-color: #ffabc8;
+}
+```
+
+then use your variables on any element
+
+```css
+body {
+  background-color: var(--my-color);
+}
+```
+
+## HTML
+
+There are 3 options:
+
+- ### Using buttons to set a theme
+
+  [![btn](https://user-images.githubusercontent.com/7342023/101527827-c0adcc00-39a3-11eb-9e41-24bfa91ea96c.gif)](#)
+
+  Clicking on these buttons, sets the chosen theme and also adds the `ACTIVECLASS` to the chosen button
+
+  ```
+  <button data-set-theme="" data-act-class="ACTIVECLASS"></button>
+  <button data-set-theme="dark" data-act-class="ACTIVECLASS"></button>
+  <button data-set-theme="pink" data-act-class="ACTIVECLASS"></button>
+  ```
+
+- ### Toggle between two themes
+
+  [![toggle](https://user-images.githubusercontent.com/7342023/101527821-bf7c9f00-39a3-11eb-822b-7751265a18a5.gif)](#)
+
+  Clicking on this element, toggles between `dark` and `light` theme and also adds the `ACTIVECLASS` to the element
+
+  ```
+  <button data-toggle-theme="dark,light" data-act-class="ACTIVECLASS"></button>
+  ```
+
+- ### `<select>` menu
+
+  [![select](https://user-images.githubusercontent.com/7342023/101527790-b4297380-39a3-11eb-9173-bc909549d160.gif)](#)
+
+  ```
+  <select data-choose-theme>
+    <option value="">Default</option>
+    <option value="dark">Dark</option>
+    <option value="pink">Pink</option>
+  </select>
+  ```
+
+# Advance use
+
+<details>
+<summary>
+  Set theme based on OS color-scheme
+</summary>
+
+```css
+@media (prefers-color-scheme: dark){
+  :root{
+    --my-color: #252b30;
+  }
+}
+```
+
+</details>
+
+<details>
+<summary>
+  Use with PurgeCSS
+</summary>
+
+If you're using [Purge CSS](https://purgecss.com/), you might need to [safe list](https://purgecss.com/safelisting.html#in-the-css-directly) your CSS using the comments below because your secondary themes will be purged
+
+- Safelist `[data-theme]` on postcss config
+
+  ```js
+  module.exports = {
+    purge: {
+      options: {
+        safelist: [/data-theme$/],
+      },
+    },
+  }
+  ```
+
+- Safelist inside CSS file
+
+  ```css
+  /*! purgecss start ignore */
+
+  [data-theme='dark'] {
+    --my-color: #252b30;
+  }
+
+  /*! purgecss end ignore */
+  ```
+
+</details>
+
+<details>
+<summary>
+  Using custom localStorage key
+</summary>
+
+If you want to use a custom localStorage key, you can add it to the `data-key` attribute like this:
+
+```html
+<select data-choose-theme data-key="admin-panel">
+
+<button data-key="front-page" data-set-theme="">
+
+<span data-key="premium-user-theme" data-toggle-theme="dark">
+```
+
+</details>
+
+---
+
+[install-size]: https://badgen.net/bundlephobia/minzip/theme-change?label=bundle%20size&color=purple
+[js]: https://badgen.net/badgesize/normal/https/unpkg.com/theme-change/index.js?label=file%20size&color=purple
+[npm]: https://badgen.net/npm/v/theme-change?label=version&color=purple
+[dl]: https://badgen.net/npm/dt/theme-change?icon=npm&color=purple
+[commit]: https://badgen.net/github/last-commit/saadeghi/theme-change?icon=github&color=purple
+[build]: https://badgen.net/github/checks/saadeghi/theme-change?label=build
+[build-url]: https://github.com/saadeghi/theme-change/actions
+[install-size-url]: https://bundlephobia.com/result?p=theme-change
+[js-url]: https://unpkg.com/theme-change@latest/index.js
+[npm-url]: https://www.npmjs.com/package/theme-change
+[gh-url]: https://github.com/saadeghi/theme-change