@mks2508/bundlp 0.1.0 → 0.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +48 -1
  2. package/package.json +5 -3
package/README.md CHANGED
@@ -432,10 +432,57 @@ bun run cli formats https://youtube.com/watch?v=dQw4w9WgXcQ
432
432
  # Debug extraction
433
433
  bun run cli debug https://youtube.com/watch?v=dQw4w9WgXcQ
434
434
 
435
- # Run benchmarks
435
+ # Run benchmarks (bundlp only)
436
436
  bun run cli benchmark
437
437
  ```
438
438
 
439
+ ## Benchmarking
440
+
441
+ Compare bundlp performance against other libraries (yt-dlp, YouTube.js).
442
+
443
+ ### Compare Libraries
444
+
445
+ ```bash
446
+ # Compare all three libraries on a single video
447
+ bun run cli benchmark compare <url>
448
+
449
+ # Compare specific libraries
450
+ bun run cli benchmark compare <url> -l bundlp,yt-dlp
451
+
452
+ # Specify output format
453
+ bun run cli benchmark compare <url> -o json -f results.json
454
+
455
+ # With warmup and multiple iterations
456
+ bun run cli benchmark compare <url> -w 2 -i 3
457
+ ```
458
+
459
+ **Options:**
460
+ - `-l, --libraries <libs>` - Libraries to compare (default: bundlp,yt-dlp,YouTube.js)
461
+ - `-w, --warmup <count>` - Warmup iterations (default: 1)
462
+ - `-i, --iterations <count>` - Measurement iterations (default: 1)
463
+ - `--no-validate` - Skip URL playability validation
464
+ - `-o, --output <format>` - Output format: console|json|all (default: console)
465
+ - `-f, --file <path>` - Output file path for JSON
466
+
467
+ ### Export JSON
468
+
469
+ Export video information in yt-dlp compatible JSON format.
470
+
471
+ ```bash
472
+ # Export to JSON with auto-generated filename
473
+ bun run cli benchmark export-json <url>
474
+
475
+ # Specify output file
476
+ bun run cli benchmark export-json <url> -o my-video.json
477
+ ```
478
+
479
+ The JSON includes:
480
+ - Basic video info (id, title, duration, view count)
481
+ - Format count and breakdown (video/audio/combined)
482
+ - Highest quality available
483
+ - URL playability rate
484
+ - bundlp metadata (version, extraction time, comparison results)
485
+
439
486
  ## Performance
440
487
 
441
488
  | Operation | Time (cached) | Time (fresh) |
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mks2508/bundlp",
3
- "version": "0.1.0",
3
+ "version": "0.1.1",
4
4
  "private": false,
5
5
  "description": "Bun-native YouTube video/music resolver library",
6
6
  "type": "module",
@@ -33,16 +33,18 @@
33
33
  "cli": "bun cli/index.ts"
34
34
  },
35
35
  "dependencies": {
36
+ "@types/figlet": "^1.7.0",
36
37
  "arktype": "^2.0.0",
37
38
  "boxen": "^8.0.1",
38
- "bundlp": "../bundlp",
39
39
  "chalk": "^5.6.2",
40
40
  "cli-table3": "^0.6.5",
41
41
  "commander": "^14.0.2",
42
+ "figlet": "^1.9.4",
42
43
  "figures": "^6.1.0",
43
44
  "jsdom": "^27.4.0",
44
45
  "meriyah": "^6.1.4",
45
- "ora": "^9.0.0"
46
+ "ora": "^9.0.0",
47
+ "youtubei.js": "^16.0.1"
46
48
  },
47
49
  "devDependencies": {
48
50
  "@types/bun": "latest",