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

node_modules/@eslint-community/regexpp/README.md

@@ -0,0 +1,177 @@
+# @eslint-community/regexpp
+
+[![npm version](https://img.shields.io/npm/v/@eslint-community/regexpp.svg)](https://www.npmjs.com/package/@eslint-community/regexpp)
+[![Downloads/month](https://img.shields.io/npm/dm/@eslint-community/regexpp.svg)](http://www.npmtrends.com/@eslint-community/regexpp)
+[![Build Status](https://github.com/eslint-community/regexpp/workflows/CI/badge.svg)](https://github.com/eslint-community/regexpp/actions)
+[![codecov](https://codecov.io/gh/eslint-community/regexpp/branch/main/graph/badge.svg)](https://codecov.io/gh/eslint-community/regexpp)
+
+A regular expression parser for ECMAScript.
+
+## 💿 Installation
+
+```bash
+$ npm install @eslint-community/regexpp
+```
+
+- require Node@^12.0.0 || ^14.0.0 || >=16.0.0.
+
+## 📖 Usage
+
+```ts
+import {
+    AST,
+    RegExpParser,
+    RegExpValidator,
+    RegExpVisitor,
+    parseRegExpLiteral,
+    validateRegExpLiteral,
+    visitRegExpAST
+} from "@eslint-community/regexpp"
+```
+
+### parseRegExpLiteral(source, options?)
+
+Parse a given regular expression literal then make AST object.
+
+This is equivalent to `new RegExpParser(options).parseLiteral(source)`.
+
+- **Parameters:**
+    - `source` (`string | RegExp`) The source code to parse.
+    - `options?` ([`RegExpParser.Options`]) The options to parse.
+- **Return:**
+    - The AST of the regular expression.
+
+### validateRegExpLiteral(source, options?)
+
+Validate a given regular expression literal.
+
+This is equivalent to `new RegExpValidator(options).validateLiteral(source)`.
+
+- **Parameters:**
+    - `source` (`string`) The source code to validate.
+    - `options?` ([`RegExpValidator.Options`]) The options to validate.
+
+### visitRegExpAST(ast, handlers)
+
+Visit each node of a given AST.
+
+This is equivalent to `new RegExpVisitor(handlers).visit(ast)`.
+
+- **Parameters:**
+    - `ast` ([`AST.Node`]) The AST to visit.
+    - `handlers` ([`RegExpVisitor.Handlers`]) The callbacks.
+
+### RegExpParser
+
+#### new RegExpParser(options?)
+
+- **Parameters:**
+    - `options?` ([`RegExpParser.Options`]) The options to parse.
+
+#### parser.parseLiteral(source, start?, end?)
+
+Parse a regular expression literal.
+
+- **Parameters:**
+    - `source` (`string`) The source code to parse. E.g. `"/abc/g"`.
+    - `start?` (`number`) The start index in the source code. Default is `0`.
+    - `end?` (`number`) The end index in the source code. Default is `source.length`.
+- **Return:**
+    - The AST of the regular expression.
+
+#### parser.parsePattern(source, start?, end?, flags?)
+
+Parse a regular expression pattern.
+
+- **Parameters:**
+    - `source` (`string`) The source code to parse. E.g. `"abc"`.
+    - `start?` (`number`) The start index in the source code. Default is `0`.
+    - `end?` (`number`) The end index in the source code. Default is `source.length`.
+    - `flags?` (`{ unicode?: boolean, unicodeSets?: boolean }`) The flags to enable Unicode mode, and Unicode Set mode.
+- **Return:**
+    - The AST of the regular expression pattern.
+
+#### parser.parseFlags(source, start?, end?)
+
+Parse a regular expression flags.
+
+- **Parameters:**
+    - `source` (`string`) The source code to parse. E.g. `"gim"`.
+    - `start?` (`number`) The start index in the source code. Default is `0`.
+    - `end?` (`number`) The end index in the source code. Default is `source.length`.
+- **Return:**
+    - The AST of the regular expression flags.
+
+### RegExpValidator
+
+#### new RegExpValidator(options)
+
+- **Parameters:**
+    - `options` ([`RegExpValidator.Options`]) The options to validate.
+
+#### validator.validateLiteral(source, start, end)
+
+Validate a regular expression literal.
+
+- **Parameters:**
+    - `source` (`string`) The source code to validate.
+    - `start?` (`number`) The start index in the source code. Default is `0`.
+    - `end?` (`number`) The end index in the source code. Default is `source.length`.
+
+#### validator.validatePattern(source, start, end, flags)
+
+Validate a regular expression pattern.
+
+- **Parameters:**
+    - `source` (`string`) The source code to validate.
+    - `start?` (`number`) The start index in the source code. Default is `0`.
+    - `end?` (`number`) The end index in the source code. Default is `source.length`.
+    - `flags?` (`{ unicode?: boolean, unicodeSets?: boolean }`) The flags to enable Unicode mode, and Unicode Set mode.
+
+#### validator.validateFlags(source, start, end)
+
+Validate a regular expression flags.
+
+- **Parameters:**
+    - `source` (`string`) The source code to validate.
+    - `start?` (`number`) The start index in the source code. Default is `0`.
+    - `end?` (`number`) The end index in the source code. Default is `source.length`.
+
+### RegExpVisitor
+
+#### new RegExpVisitor(handlers)
+
+- **Parameters:**
+    - `handlers` ([`RegExpVisitor.Handlers`]) The callbacks.
+
+#### visitor.visit(ast)
+
+Validate a regular expression literal.
+
+- **Parameters:**
+    - `ast` ([`AST.Node`]) The AST to visit.
+
+## 📰 Changelog
+
+- [GitHub Releases](https://github.com/eslint-community/regexpp/releases)
+
+## 🍻 Contributing
+
+Welcome contributing!
+
+Please use GitHub's Issues/PRs.
+
+### Development Tools
+
+- `npm test` runs tests and measures coverage.
+- `npm run build` compiles TypeScript source code to `index.js`, `index.js.map`, and `index.d.ts`.
+- `npm run clean` removes the temporary files which are created by `npm test` and `npm run build`.
+- `npm run lint` runs ESLint.
+- `npm run update:test` updates test fixtures.
+- `npm run update:ids` updates `src/unicode/ids.ts`.
+- `npm run watch` runs tests with `--watch` option.
+
+[`AST.Node`]: src/ast.ts#L4
+[`RegExpParser.Options`]: src/parser.ts#L743
+[`RegExpValidator.Options`]: src/validator.ts#L220
+[`RegExpVisitor.Handlers`]: src/visitor.ts#L291

node_modules/@humanfs/core/README.md

@@ -0,0 +1,140 @@
+# `@humanfs/core`
+
+by [Nicholas C. Zakas](https://humanwhocodes.com)
+
+If you find this useful, please consider supporting my work with a [donation](https://humanwhocodes.com/donate) or [nominate me](https://stars.github.com/nominate/) for a GitHub Star.
+
+## Description
+
+The core functionality for humanfs that is shared across all implementations for all runtimes. The contents of this package are intentionally runtime agnostic and are not intended to be used alone.
+
+Currently, this package simply exports the `Hfs` class, which is an abstract base class intended to be inherited from in runtime-specific hfs packages (like `@humanfs/node`).
+
+> [!WARNING]
+> This project is **experimental** and may change significantly before v1.0.0. Use at your own caution and definitely not in production!
+
+## Installation
+
+### Node.js
+
+Install using your favorite package manager for Node.js:
+
+```shell
+npm install @humanfs/core
+
+# or
+
+pnpm install @humanfs/core
+
+# or
+
+yarn add @humanfs/core
+
+# or
+
+bun install @humanfs/core
+```
+
+Then you can import the `Hfs` and `Path` classes like this:
+
+```js
+import { Hfs, Path } from "@humanfs/core";
+```
+
+### Deno
+
+Install using [JSR](https://jsr.io):
+
+```shell
+deno add @humanfs/core
+
+# or
+
+jsr add @humanfs/core
+```
+
+Then you can import the `Hfs` class like this:
+
+```js
+import { Hfs, Path } from "@humanfs/core";
+```
+
+### Browser
+
+It's recommended to import the minified version to save bandwidth:
+
+```js
+import { Hfs, Path } from "https://cdn.skypack.dev/@humanfs/core?min";
+```
+
+However, you can also import the unminified version for debugging purposes:
+
+```js
+import { Hfs, Path } from "https://cdn.skypack.dev/@humanfs/core";
+```
+
+## Usage
+
+### `Hfs` Class
+
+The `Hfs` class contains all of the basic functionality for an `Hfs` instance *without* a predefined impl. This class is mostly used for creating runtime-specific impls, such as `NodeHfs` and `DenoHfs`.
+
+You can create your own instance by providing an `impl` directly:
+
+```js
+const hfs = new Hfs({ impl: { async text() {} }});
+```
+
+The specified `impl` becomes the base impl for the instance, meaning you can always reset back to it using `resetImpl()`.
+
+You can also inherit from `Hfs` to create your own class with a preconfigured impl, such as:
+
+```js
+class MyHfs extends Hfs {
+	constructor() {
+		super({
+			impl: myImpl
+		});
+	}
+}
+```
+
+### `Path` Class
+
+The `Path` class represents the path to a directory or file within a file system. It's an abstract representation that can be used even outside of traditional file systems where string paths might not make sense.
+
+```js
+const myPath = new Path(["dir", "subdir"]);
+console.log(myPath.toString());		// "dir/subdir"
+
+// add another step
+myPath.push("file.txt");
+console.log(myPath.toString());		// "dir/subdir/file.txt"
+
+// get just the last step
+console.log(myPath.name);			// "file.txt"
+
+// change just the last step
+myPath.name = "file.json";
+console.log(myPath.name);			// "file.json"
+console.log(myPath.toString());		// "dir/subdir/file.json"
+
+// get the size of the path
+console.log(myPath.size);			// 3
+
+// remove the last step
+myPath.pop();
+console.log(myPath.toString());		// "dir/subdir"
+
+// iterate over the steps
+for (const step of myPath) {
+	// do something
+}
+
+// create a new path from a string
+const newPath = Path.fromString("/foo/bar");
+```
+
+## License
+
+Apache 2.0

node_modules/@humanfs/node/README.md

@@ -0,0 +1,141 @@
+# `@humanfs/node`
+
+by [Nicholas C. Zakas](https://humanwhocodes.com)
+
+If you find this useful, please consider supporting my work with a [donation](https://humanwhocodes.com/donate) or [nominate me](https://stars.github.com/nominate/) for a GitHub Star.
+
+## Description
+
+The `hfs` bindings for use in Node.js and Node.js-compatible runtimes.
+
+> [!WARNING]
+> This project is **experimental** and may change significantly before v1.0.0. Use at your own caution and definitely not in production!
+
+## Installation
+
+Install using your favorite package manager:
+
+```shell
+npm install @humanfs/node
+
+# or
+
+pnpm install @humanfs/node
+
+# or
+
+yarn add @humanfs/node
+
+# or
+
+bun install @humanfs/node
+```
+
+## Usage
+
+The easiest way to use hfs in your project is to import the `hfs` object:
+
+```js
+import { hfs } from "@humanfs/node";
+```
+
+Then, you can use the API methods:
+
+```js
+// 1. Files
+
+// read from a text file
+const text = await hfs.text("file.txt");
+
+// read from a JSON file
+const json = await hfs.json("file.json");
+
+// read raw bytes from a text file
+const arrayBuffer = await hfs.arrayBuffer("file.txt");
+
+// write text to a file
+await hfs.write("file.txt", "Hello world!");
+
+// write bytes to a file
+await hfs.write("file.txt", new TextEncoder().encode("Hello world!"));
+
+// append text to a file
+await hfs.append("file.txt", "Hello world!");
+
+// append bytes to a file
+await hfs.append("file.txt", new TextEncoder().encode("Hello world!"));
+
+// does the file exist?
+const found = await hfs.isFile("file.txt");
+
+// how big is the file?
+const size = await hfs.size("file.txt");
+
+// when was the file modified?
+const mtime = await hfs.lastModified("file.txt");
+
+// copy a file from one location to another
+await hfs.copy("file.txt", "file-copy.txt");
+
+// move a file from one location to another
+await hfs.move("file.txt", "renamed.txt");
+
+// delete a file
+await hfs.delete("file.txt");
+
+// 2. Directories
+
+// create a directory
+await hfs.createDirectory("dir");
+
+// create a directory recursively
+await hfs.createDirectory("dir/subdir");
+
+// does the directory exist?
+const dirFound = await hfs.isDirectory("dir");
+
+// copy the entire directory
+hfs.copyAll("from-dir", "to-dir");
+
+// move the entire directory
+hfs.moveAll("from-dir", "to-dir");
+
+// delete a directory
+await hfs.delete("dir");
+
+// delete a non-empty directory
+await hfs.deleteAll("dir");
+```
+
+If you'd like to create your own instance, import the `NodeHfs` constructor:
+
+```js
+import { NodeHfs } from "@humanfs/node";
+import fsp from "fs/promises";
+
+const hfs = new NodeHfs();
+
+// optionally specify the fs/promises object to use
+const hfs = new NodeHfs({ fsp });
+```
+
+If you'd like to use just the impl, import the `NodeHfsImpl` constructor:
+
+```js
+import { NodeHfsImpl } from "@humanfs/node";
+import fsp from "fs/promises";
+
+const hfs = new NodeHfsImpl();
+
+// optionally specify the fs/promises object to use
+const hfs = new NodeHfsImpl({ fsp });
+```
+
+## Errors Handled
+
+* `ENOENT` - in most cases, these errors are handled silently.
+* `ENFILE` and `EMFILE` - calls that result in these errors are retried for up to 60 seconds before giving up for good.
+
+## License
+
+Apache 2.0

node_modules/@humanfs/node/node_modules/@humanwhocodes/retry/README.md

@@ -0,0 +1,138 @@
+# Retry utility
+
+by [Nicholas C. Zakas](https://humanwhocodes.com)
+
+If you find this useful, please consider supporting my work with a [donation](https://humanwhocodes.com/donate) or [nominate me](https://stars.github.com/nominate/) for a GitHub Star.
+
+## Description
+
+A utility for retrying failed async JavaScript calls based on the error returned.
+
+## Usage
+
+### Node.js
+
+Install using [npm][npm] or [yarn][yarn]:
+
+```
+npm install @humanwhocodes/retry
+
+# or
+
+yarn add @humanwhocodes/retry
+```
+
+Import into your Node.js project:
+
+```js
+// CommonJS
+const { Retrier } = require("@humanwhocodes/retry");
+
+// ESM
+import { Retrier } from "@humanwhocodes/retry";
+```
+
+### Deno
+
+Install using [JSR](https://jsr.io):
+
+```shell
+deno add @humanwhocodes/retry
+
+#or
+
+jsr add @humanwhocodes/retry
+```
+
+Then import into your Deno project:
+
+```js
+import { Retrier } from "@humanwhocodes/retry";
+```
+
+### Bun
+
+Install using this command:
+
+```
+bun add @humanwhocodes/retry
+```
+
+Import into your Bun project:
+
+```js
+import { Retrier } from "@humanwhocodes/retry";
+```
+
+### Browser
+
+It's recommended to import the minified version to save bandwidth:
+
+```js
+import { Retrier } from "https://cdn.skypack.dev/@humanwhocodes/retry?min";
+```
+
+However, you can also import the unminified version for debugging purposes:
+
+```js
+import { Retrier } from "https://cdn.skypack.dev/@humanwhocodes/retry";
+```
+
+## API
+
+After importing, create a new instance of `Retrier` and specify the function to run on the error. This function should return `true` if you want the call retried and `false` if not.
+
+```js
+// this instance will retry if the specific error code is found
+const retrier = new Retrier(error => {
+    return error.code === "ENFILE" || error.code === "EMFILE";
+});
+```
+
+Then, call the `retry()` method around the function you'd like to retry, such as:
+
+```js
+import fs from "fs/promises";
+
+const retrier = new Retrier(error => {
+    return error.code === "ENFILE" || error.code === "EMFILE";
+});
+
+const text = await retrier.retry(() => fs.readFile("README.md", "utf8"));
+```
+
+The `retry()` method will either pass through the result on success or wait and retry on failure. Any error that isn't caught by the retrier is automatically rejected so the end result is a transparent passing through of both success and failure.
+
+You can also pass an `AbortSignal` to cancel a retry:
+
+```js
+import fs from "fs/promises";
+
+const controller = new AbortController();
+const retrier = new Retrier(error => {
+    return error.code === "ENFILE" || error.code === "EMFILE";
+});
+
+const text = await retrier.retry(
+    () => fs.readFile("README.md", "utf8"),
+    { signal: controller.signal }
+);
+```
+
+## Developer Setup
+
+1. Fork the repository
+2. Clone your fork
+3. Run `npm install` to setup dependencies
+4. Run `npm test` to run tests
+
+## License
+
+Apache 2.0
+
+## Prior Art
+
+This utility is inspired by, and contains code from [`graceful-fs`](https://github.com/isaacs/node-graceful-fs).
+
+[npm]: https://npmjs.com/
+[yarn]: https://yarnpkg.com/

node_modules/@humanwhocodes/module-importer/README.md

@@ -0,0 +1,80 @@
+# ModuleImporter
+
+by [Nicholas C. Zakas](https://humanwhocodes.com)
+
+If you find this useful, please consider supporting my work with a [donation](https://humanwhocodes.com/donate).
+
+## Description
+
+A utility for seamlessly importing modules in Node.js regardless if they are CommonJS or ESM format. Under the hood, this uses `import()` and relies on Node.js's CommonJS compatibility to work correctly. This ensures that the correct locations and formats are used for CommonJS so you can call one method and not worry about any compatibility issues.
+
+The problem with the default `import()` is that it always resolves relative to the file location in which it is called. If you want to resolve from a different location, you need to jump through a few hoops to achieve that. This package makes it easy to both resolve and import modules from any directory.
+
+## Usage
+
+### Node.js
+
+Install using [npm][npm] or [yarn][yarn]:
+
+```
+npm install @humanwhocodes/module-importer
+
+# or
+
+yarn add @humanwhocodes/module-importer
+```
+
+Import into your Node.js project:
+
+```js
+// CommonJS
+const { ModuleImporter } = require("@humanwhocodes/module-importer");
+
+// ESM
+import { ModuleImporter } from "@humanwhocodes/module-importer";
+```
+
+### Bun
+
+Install using this command:
+
+```
+bun add @humanwhocodes/module-importer
+```
+
+Import into your Bun project:
+
+```js
+import { ModuleImporter } from "@humanwhocodes/module-importer";
+```
+
+## API
+
+After importing, create a new instance of `ModuleImporter` to start emitting events:
+
+```js
+// cwd can be omitted to use process.cwd()
+const importer = new ModuleImporter(cwd);
+
+// you can resolve the location of any package
+const location = importer.resolve("./some-file.cjs");
+
+// you can also import directly
+const module = importer.import("./some-file.cjs");
+```
+
+For both `resolve()` and `import()`, you can pass in package names and filenames.
+
+## Developer Setup
+
+1. Fork the repository
+2. Clone your fork
+3. Run `npm install` to setup dependencies
+4. Run `npm test` to run tests
+
+## License
+
+Apache 2.0
+
+[npm]: https://npmjs.com/
+[yarn]: https://yarnpkg.com/