pythonlib 2.0.0 → 2.0.1

package/README.md

@@ -1,5 +1,9 @@
 # pythonlib
 
+<div align="center">
+
+**Python's Beloved Standard Library — Now in TypeScript**
+
 [![npm version](https://img.shields.io/npm/v/pythonlib.svg)](https://www.npmjs.com/package/pythonlib)
 [![npm downloads](https://img.shields.io/npm/dm/pythonlib.svg)](https://www.npmjs.com/package/pythonlib)
 [![Zero Dependencies](https://img.shields.io/badge/dependencies-0-brightgreen)](https://www.npmjs.com/package/pythonlib?activeTab=dependencies)
@@ -8,80 +12,148 @@
 [![Bun](https://img.shields.io/badge/Bun-compatible-f9f1e1?logo=bun&logoColor=black)](https://bun.sh/)
 [![License](https://img.shields.io/npm/l/pythonlib.svg)](https://github.com/sebastian-software/python2ts/blob/main/LICENSE)
 
-**Python's powerful standard library, TypeScript's familiar style** — itertools, functools,
-collections, and more.
+</div>
+
+---
 
-> Zero dependencies · Full TypeScript support · Tree-shakeable · camelCase API · Works everywhere JS
-> runs
+Miss `itertools.combinations`? Love `collections.Counter`? Wish you had `functools.lru_cache` in
+JavaScript?
 
-## Quick Start
+**pythonlib** brings Python's most powerful utilities to TypeScript — zero dependencies, full type
+safety, tree-shakeable.
+
+## Install
 
 ```bash
 npm install pythonlib
 ```
 
+## Why pythonlib?
+
+| What You Get                | Why It Matters                                    |
+| --------------------------- | ------------------------------------------------- |
+| **Zero dependencies**       | No supply chain bloat, minimal attack surface     |
+| **Full TypeScript support** | Generics, type inference, autocomplete everywhere |
+| **Tree-shakeable**          | Bundle only what you use                          |
+| **camelCase API**           | Feels native in TypeScript                        |
+| **Works everywhere**        | Browsers, Node.js, Deno, Bun, Workers             |
+
+## Quick Examples
+
+### itertools — Combinatorics Made Easy
+
 ```typescript
-import { range, enumerate, sorted } from "pythonlib"
-import { combinations } from "pythonlib/itertools"
-import { Counter } from "pythonlib/collections"
-import { lruCache } from "pythonlib/functools"
-
-// Python-style iteration
-for (const i of range(10)) {
-  console.log(i)
-}
+import { combinations, permutations, product } from "pythonlib/itertools"
 
-// Combinatorics
-for (const combo of combinations([1, 2, 3], 2)) {
-  console.log(combo) // [1,2], [1,3], [2,3]
-}
+// All 2-element combinations
+[...combinations([1, 2, 3], 2)]
+// → [[1, 2], [1, 3], [2, 3]]
+
+// Cartesian product
+[...product(["a", "b"], [1, 2])]
+// → [["a", 1], ["a", 2], ["b", 1], ["b", 2]]
+```
+
+### collections — Data Structures That Just Work
 
-// Count occurrences
-const counter = new Counter("mississippi")
-counter.mostCommon(2) // [["i", 4], ["s", 4]]
+```typescript
+import { Counter, defaultdict, deque } from "pythonlib/collections"
+
+// Count anything
+const votes = new Counter(["alice", "bob", "alice", "alice"])
+votes.mostCommon(1) // → [["alice", 3]]
 
-// Memoization
+// No more "undefined" checks
+const graph = defaultdict(() => [])
+graph.get("node1").push("node2") // Just works!
+
+// Double-ended queue with O(1) operations
+const dq = new deque([1, 2, 3])
+dq.appendLeft(0) // [0, 1, 2, 3]
+dq.pop() // [0, 1, 2]
+```
+
+### functools — Functional Programming Utilities
+
+```typescript
+import { lruCache, partial, reduce } from "pythonlib/functools"
+
+// Memoization with one line
 const fib = lruCache((n: number): number => (n <= 1 ? n : fib(n - 1) + fib(n - 2)))
+fib(100) // Instant, even for large values
+
+// Partial application
+const greet = (greeting: string, name: string) => `${greeting}, ${name}!`
+const sayHello = partial(greet, "Hello")
+sayHello("World") // → "Hello, World!"
 ```
 
-## Available Modules
+### Builtins — Python's Greatest Hits
 
-| Import Path             | Contents                                           | API Docs                                                                 |
-| ----------------------- | -------------------------------------------------- | ------------------------------------------------------------------------ |
-| `pythonlib`             | Builtins: `len`, `range`, `sorted`, `enumerate`... | [→](https://sebastian-software.github.io/python2ts/docs/api/index)       |
-| `pythonlib/itertools`   | `chain`, `combinations`, `zipLongest`, `takeWhile` | [→](https://sebastian-software.github.io/python2ts/docs/api/itertools)   |
-| `pythonlib/functools`   | `partial`, `reduce`, `lruCache`, `pipe`            | [→](https://sebastian-software.github.io/python2ts/docs/api/functools)   |
-| `pythonlib/collections` | `Counter`, `defaultdict`, `deque`                  | [→](https://sebastian-software.github.io/python2ts/docs/api/collections) |
-| `pythonlib/math`        | `sqrt`, `floor`, `ceil`, `factorial`, `pi`, `e`    | [→](https://sebastian-software.github.io/python2ts/docs/api/math)        |
-| `pythonlib/random`      | `randInt`, `choice`, `shuffle`, `sample`           | [→](https://sebastian-software.github.io/python2ts/docs/api/random)      |
-| `pythonlib/datetime`    | `datetime`, `date`, `time`, `timedelta`            | [→](https://sebastian-software.github.io/python2ts/docs/api/datetime)    |
-| `pythonlib/json`        | `loads`, `dumps`                                   | [→](https://sebastian-software.github.io/python2ts/docs/api/json)        |
-| `pythonlib/re`          | `search`, `match`, `findAll`, `sub`, `compile`     | [→](https://sebastian-software.github.io/python2ts/docs/api/re)          |
-| `pythonlib/string`      | `Template`, `capWords`, `asciiLowercase`           | [→](https://sebastian-software.github.io/python2ts/docs/api/string)      |
-
-> All function names use **camelCase** to feel native in TypeScript.
+```typescript
+import { range, enumerate, zip, sorted, reversed } from "pythonlib"
 
-## Documentation
+// Python-style range
+for (const i of range(5)) {
+} // 0, 1, 2, 3, 4
+for (const i of range(1, 10, 2)) {
+} // 1, 3, 5, 7, 9
 
-**[📚 View Full Documentation](https://sebastian-software.github.io/python2ts/)**
+// Enumerate with index
+for (const [i, item] of enumerate(["a", "b", "c"])) {
+  console.log(i, item) // 0 "a", 1 "b", 2 "c"
+}
+
+// Zip multiple iterables
+;[...zip([1, 2, 3], ["a", "b", "c"])]
+// → [[1, "a"], [2, "b"], [3, "c"]]
+```
+
+## Available Modules
 
-| Resource                                                                       | Description                                 |
-| ------------------------------------------------------------------------------ | ------------------------------------------- |
-| [Homepage](https://sebastian-software.github.io/python2ts/)                    | Project overview, features, and quick start |
-| [Runtime Guide](https://sebastian-software.github.io/python2ts/docs/runtime)   | How to use pythonlib in your projects       |
-| [API Reference](https://sebastian-software.github.io/python2ts/docs/api)       | Complete API documentation for all modules  |
-| [Syntax Reference](https://sebastian-software.github.io/python2ts/docs/syntax) | Python → TypeScript transformation rules    |
+| Module                  | Highlights                                                  | Docs                                                                     |
+| ----------------------- | ----------------------------------------------------------- | ------------------------------------------------------------------------ |
+| `pythonlib`             | `range`, `enumerate`, `zip`, `sorted`, `len`, `min`, `max`  | [→](https://sebastian-software.github.io/python2ts/docs/api/index)       |
+| `pythonlib/itertools`   | `chain`, `combinations`, `permutations`, `product`, `cycle` | [→](https://sebastian-software.github.io/python2ts/docs/api/itertools)   |
+| `pythonlib/functools`   | `lruCache`, `partial`, `reduce`, `pipe`, `compose`          | [→](https://sebastian-software.github.io/python2ts/docs/api/functools)   |
+| `pythonlib/collections` | `Counter`, `defaultdict`, `deque`, `OrderedDict`            | [→](https://sebastian-software.github.io/python2ts/docs/api/collections) |
+| `pythonlib/math`        | `sqrt`, `floor`, `ceil`, `factorial`, `gcd`, `pi`           | [→](https://sebastian-software.github.io/python2ts/docs/api/math)        |
+| `pythonlib/random`      | `randInt`, `choice`, `shuffle`, `sample`, `random`          | [→](https://sebastian-software.github.io/python2ts/docs/api/random)      |
+| `pythonlib/datetime`    | `datetime`, `date`, `time`, `timedelta`                     | [→](https://sebastian-software.github.io/python2ts/docs/api/datetime)    |
+| `pythonlib/re`          | `search`, `match`, `findAll`, `sub`, `compile`              | [→](https://sebastian-software.github.io/python2ts/docs/api/re)          |
+| `pythonlib/json`        | `loads`, `dumps` with Python semantics                      | [→](https://sebastian-software.github.io/python2ts/docs/api/json)        |
+| `pythonlib/string`      | `Template`, `capWords`, `ascii_lowercase`                   | [→](https://sebastian-software.github.io/python2ts/docs/api/string)      |
+| `pythonlib/os`          | `path.join`, `environ`, `getcwd`                            | [→](https://sebastian-software.github.io/python2ts/docs/api/os)          |
+| `pythonlib/pathlib`     | `Path` class for filesystem operations                      | [→](https://sebastian-software.github.io/python2ts/docs/api/pathlib)     |
+| `pythonlib/glob`        | File pattern matching                                       | [→](https://sebastian-software.github.io/python2ts/docs/api/glob)        |
+| `pythonlib/hashlib`     | `md5`, `sha256`, `sha512` hashing                           | [→](https://sebastian-software.github.io/python2ts/docs/api/hashlib)     |
+| `pythonlib/base64`      | Base64 encoding/decoding                                    | [→](https://sebastian-software.github.io/python2ts/docs/api/base64)      |
+| `pythonlib/uuid`        | UUID generation                                             | [→](https://sebastian-software.github.io/python2ts/docs/api/uuid)        |
 
 ## Runtime Support
 
-Tested on every commit: **Node.js** (v22, v24) · **Bun** · **Deno** · **Browsers**
+Works everywhere JavaScript runs:
+
+- **Node.js** (v22, v24)
+- **Bun**
+- **Deno**
+- **Browsers** (Chrome, Firefox, Safari)
+- **Edge** (Cloudflare Workers, Vercel, AWS Lambda)
+
+## Documentation
 
-Also works in Cloudflare Workers, AWS Lambda, and other JS environments.
+| Resource                                                                     | Description                                |
+| ---------------------------------------------------------------------------- | ------------------------------------------ |
+| [Homepage](https://sebastian-software.github.io/python2ts/)                  | Project overview and quick start           |
+| [Runtime Guide](https://sebastian-software.github.io/python2ts/docs/runtime) | Detailed usage guide                       |
+| [API Reference](https://sebastian-software.github.io/python2ts/docs/api)     | Complete API documentation for all modules |
 
 ## Related
 
 - [**python2ts**](https://www.npmjs.com/package/python2ts) — Transpile Python to TypeScript
-- [**GitHub**](https://github.com/sebastian-software/python2ts) — Source code and issue tracker
+  automatically
+- [**GitHub**](https://github.com/sebastian-software/python2ts) — Source code, issues, contributions
+  welcome
 
 ## License
 

package/dist/base64.js

@@ -15,7 +15,7 @@ import {
   standardB64encode,
   urlsafeB64decode,
   urlsafeB64encode
-} from "./chunk-3CLXPGAB.js";
+} from "./chunk-HTCQ4OO5.js";
 import "./chunk-MLKGABMK.js";
 export {
   a85decode,

package/dist/{chunk-FCJ7E4OE.js → chunk-2QEMKE7U.js}

@@ -248,3 +248,5 @@ export {
   NAMESPACE_X500,
   uuid_exports
 };
+/* v8 ignore start -- fallback for environments without crypto.randomUUID @preserve */
+/* v8 ignore start -- fallback for environments without crypto @preserve */

package/dist/{chunk-PWA3YQZU.js → chunk-3HQSBCEC.js}

@@ -106,12 +106,14 @@ var FileHandler = class extends Handler {
     this.filename = filename;
     this.mode = mode;
   }
+  /* v8 ignore start -- async file writing is tested via integration @preserve */
   emit(record) {
     const msg = this.format(record) + "\n";
     import("fs/promises").then((fs) => fs.appendFile(this.filename, msg)).catch(() => {
       console.log(msg);
     });
   }
+  /* v8 ignore stop */
 };
 var Formatter = class {
   fmt;

package/dist/{chunk-5VAHUJNC.js → chunk-CANUXHVB.js}

@@ -346,3 +346,4 @@ export {
   shutdown,
   logging_browser_exports
 };
+/* v8 ignore start -- browser version tested via browser tests @preserve */

package/dist/{chunk-3CLXPGAB.js → chunk-HTCQ4OO5.js}

@@ -235,3 +235,4 @@ export {
   decodeString,
   base64_exports
 };
+/* v8 ignore start -- browser fallback @preserve */

package/dist/{chunk-B5AUEOAH.js → chunk-JVTQM7CI.js}

@@ -191,3 +191,5 @@ export {
   unpackArchive,
   shutil_node_exports
 };
+/* v8 ignore next 3 -- Windows-specific check @preserve */
+/* v8 ignore start -- stream operations are tested via integration @preserve */

package/dist/{chunk-KKHKTQNN.js → chunk-MEEU4SH5.js}

@@ -359,3 +359,4 @@ export {
   threadTimeNs,
   time_exports
 };
+/* v8 ignore next -- browser fallback @preserve */

package/dist/{chunk-U4X5DEIP.js → chunk-PVK4F3ME.js}

@@ -186,3 +186,9 @@ export {
   hashInfo,
   sys_exports
 };
+/* v8 ignore next -- browser fallback @preserve */
+/* v8 ignore next 5 -- always returns empty array @preserve */
+/* v8 ignore next 2 -- browser fallback @preserve */
+/* v8 ignore next 3 -- always runs in Node.js @preserve */
+/* v8 ignore start -- Set branch tested via getSizeOf(new Set()) @preserve */
+/* v8 ignore next -- unreachable after typeof checks @preserve */

package/dist/{chunk-LTXTS7RP.js → chunk-RRSOZXZE.js}

@@ -152,3 +152,4 @@ export {
   deepcopy,
   copy_exports
 };
+/* v8 ignore start -- fallback for environments without structuredClone @preserve */

package/dist/{chunk-LLZFLQS6.js → chunk-THMJVAK6.js}

@@ -219,6 +219,7 @@ var Popen = class {
     await this.wait();
     return [this._stdout, this._stderr];
   }
+  /* v8 ignore start -- process control methods are hard to test reliably @preserve */
   /**
    * Send a signal to the process.
    */
@@ -237,6 +238,7 @@ var Popen = class {
   kill() {
     return this.process.kill("SIGKILL");
   }
+  /* v8 ignore stop */
   /**
    * The process ID.
    */

package/dist/{chunk-JJKTRIVO.js → chunk-YONWJHJU.js}

@@ -260,3 +260,6 @@ export {
   fileDigest,
   hashlib_exports
 };
+/* v8 ignore start -- browser Web Crypto API path @preserve */
+/* v8 ignore next 3 -- browser error path @preserve */
+/* v8 ignore start -- browser fallback path @preserve */

package/dist/copy.js

@@ -1,7 +1,7 @@
 import {
   copy,
   deepcopy
-} from "./chunk-LTXTS7RP.js";
+} from "./chunk-RRSOZXZE.js";
 import "./chunk-MLKGABMK.js";
 export {
   copy,

package/dist/hashlib.js

@@ -16,7 +16,7 @@ import {
   sha3_256,
   sha3_512,
   sha512
-} from "./chunk-JJKTRIVO.js";
+} from "./chunk-YONWJHJU.js";
 import "./chunk-MLKGABMK.js";
 export {
   algorithmsAvailable,

package/dist/index.browser.js

@@ -63,19 +63,19 @@ import {
 } from "./chunk-5OKGPZBQ.js";
 import {
   subprocess_exports
-} from "./chunk-LLZFLQS6.js";
+} from "./chunk-THMJVAK6.js";
 import {
   sys_exports
-} from "./chunk-U4X5DEIP.js";
+} from "./chunk-PVK4F3ME.js";
 import {
   time_exports
-} from "./chunk-KKHKTQNN.js";
+} from "./chunk-MEEU4SH5.js";
 import {
   urllib_exports
 } from "./chunk-IANXD4D4.js";
 import {
   uuid_exports
-} from "./chunk-FCJ7E4OE.js";
+} from "./chunk-2QEMKE7U.js";
 import {
   random_exports
 } from "./chunk-3M3PB4RO.js";
@@ -104,7 +104,7 @@ import {
 } from "./chunk-JAUU3HMH.js";
 import {
   logging_browser_exports
-} from "./chunk-5VAHUJNC.js";
+} from "./chunk-CANUXHVB.js";
 import {
   math_exports
 } from "./chunk-QKJBQKPY.js";
@@ -114,13 +114,13 @@ import {
 import "./chunk-LHPQS75Z.js";
 import {
   base64_exports
-} from "./chunk-3CLXPGAB.js";
+} from "./chunk-HTCQ4OO5.js";
 import {
   collections_exports
 } from "./chunk-MFKIEN7N.js";
 import {
   copy_exports
-} from "./chunk-LTXTS7RP.js";
+} from "./chunk-RRSOZXZE.js";
 import {
   datetime_exports
 } from "./chunk-LK2L2TFG.js";
@@ -132,7 +132,7 @@ import {
 } from "./chunk-B5LQJODJ.js";
 import {
   hashlib_exports
-} from "./chunk-JJKTRIVO.js";
+} from "./chunk-YONWJHJU.js";
 import "./chunk-MLKGABMK.js";
 
 // src/index.browser.ts
@@ -302,3 +302,4 @@ export {
   uuid,
   zip2 as zip
 };
+/* v8 ignore start -- browser version tested via browser tests @preserve */

package/dist/index.js

@@ -9,7 +9,7 @@ import {
 } from "./chunk-KKJHGY4C.js";
 import {
   shutil_node_exports
-} from "./chunk-B5AUEOAH.js";
+} from "./chunk-JVTQM7CI.js";
 import {
   abs,
   all,
@@ -66,19 +66,19 @@ import {
 } from "./chunk-5OKGPZBQ.js";
 import {
   subprocess_exports
-} from "./chunk-LLZFLQS6.js";
+} from "./chunk-THMJVAK6.js";
 import {
   sys_exports
-} from "./chunk-U4X5DEIP.js";
+} from "./chunk-PVK4F3ME.js";
 import {
   time_exports
-} from "./chunk-KKHKTQNN.js";
+} from "./chunk-MEEU4SH5.js";
 import {
   urllib_exports
 } from "./chunk-IANXD4D4.js";
 import {
   uuid_exports
-} from "./chunk-FCJ7E4OE.js";
+} from "./chunk-2QEMKE7U.js";
 import {
   random_exports
 } from "./chunk-3M3PB4RO.js";
@@ -107,20 +107,20 @@ import {
 } from "./chunk-JAUU3HMH.js";
 import {
   logging_node_exports
-} from "./chunk-PWA3YQZU.js";
+} from "./chunk-3HQSBCEC.js";
 import {
   math_exports
 } from "./chunk-QKJBQKPY.js";
 import "./chunk-LHPQS75Z.js";
 import {
   base64_exports
-} from "./chunk-3CLXPGAB.js";
+} from "./chunk-HTCQ4OO5.js";
 import {
   collections_exports
 } from "./chunk-MFKIEN7N.js";
 import {
   copy_exports
-} from "./chunk-LTXTS7RP.js";
+} from "./chunk-RRSOZXZE.js";
 import {
   datetime_exports
 } from "./chunk-LK2L2TFG.js";
@@ -132,7 +132,7 @@ import {
 } from "./chunk-RB6BYCIQ.js";
 import {
   hashlib_exports
-} from "./chunk-JJKTRIVO.js";
+} from "./chunk-YONWJHJU.js";
 import "./chunk-MLKGABMK.js";
 
 // src/index.ts

package/dist/logging.browser.js

@@ -28,7 +28,7 @@ import {
   shutdown,
   warn,
   warning
-} from "./chunk-5VAHUJNC.js";
+} from "./chunk-CANUXHVB.js";
 import "./chunk-MLKGABMK.js";
 export {
   CRITICAL,

package/dist/logging.node.js

@@ -27,7 +27,7 @@ import {
   shutdown,
   warn,
   warning
-} from "./chunk-PWA3YQZU.js";
+} from "./chunk-3HQSBCEC.js";
 import "./chunk-MLKGABMK.js";
 export {
   CRITICAL,

package/dist/shutil.node.js

@@ -13,7 +13,7 @@ import {
   rmtree,
   unpackArchive,
   which
-} from "./chunk-B5AUEOAH.js";
+} from "./chunk-JVTQM7CI.js";
 import "./chunk-MLKGABMK.js";
 export {
   copy,

package/dist/subprocess.js

@@ -11,7 +11,7 @@ import {
   getoutput,
   getstatusoutput,
   run
-} from "./chunk-LLZFLQS6.js";
+} from "./chunk-THMJVAK6.js";
 import "./chunk-MLKGABMK.js";
 export {
   CalledProcessError,

package/dist/sys.js

@@ -22,7 +22,7 @@ import {
   stdout,
   version,
   versionInfo
-} from "./chunk-U4X5DEIP.js";
+} from "./chunk-PVK4F3ME.js";
 import "./chunk-MLKGABMK.js";
 export {
   apiVersion,

package/dist/time.js

@@ -21,7 +21,7 @@ import {
   timeNs,
   timezone,
   tzname
-} from "./chunk-KKHKTQNN.js";
+} from "./chunk-MEEU4SH5.js";
 import "./chunk-MLKGABMK.js";
 export {
   altzone,

package/dist/uuid.js

@@ -8,7 +8,7 @@ import {
   uuid3,
   uuid4,
   uuid5
-} from "./chunk-FCJ7E4OE.js";
+} from "./chunk-2QEMKE7U.js";
 import "./chunk-MLKGABMK.js";
 export {
   NAMESPACE_DNS,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pythonlib",
-  "version": "2.0.0",
+  "version": "2.0.1",
   "description": "Python standard library for TypeScript - itertools, functools, collections, datetime, re, and more. Zero dependencies. Full TypeScript support.",
   "homepage": "https://sebastian-software.github.io/python2ts/",
   "repository": {
@@ -16,6 +16,7 @@
     "url": "https://github.com/sponsors/sebastian-software"
   },
   "type": "module",
+  "sideEffects": false,
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "exports": {