@guanghechen/filepart 1.0.0-alpha.1

package/CHANGELOG.md

@@ -0,0 +1,15 @@
+# Change Log
+
+All notable changes to this project will be documented in this file.
+See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
+
+# 1.0.0-alpha.1 (2023-12-10)
+
+
+### Performance Improvements
+
+* 🎨 export const DEFAULT_FILEPART_CODE_PREFIX from @guanghechen/filepart.types ([d6d2b1d](https://github.com/guanghechen/sora/commit/d6d2b1d960a9a02b3315c4cbd32cdc1fa53cccc3))
+* 🎨 export new method 'calcFilePartNamesByCount' ([dbd16b6](https://github.com/guanghechen/sora/commit/dbd16b65610088e38ac84e39d66196e67b33446f))
+* 🎨 make methods return iterator instead of array ([1fddedd](https://github.com/guanghechen/sora/commit/1fddedd8a8de6b21c0431bdacf2a7d8a17bd2c86))
+* 🎨 move filepart related code from @guanghechen/file-split to new package @guanghechen/filepart ([833aa10](https://github.com/guanghechen/sora/commit/833aa10f4eee38b09a375b221a0a763f96d8fd4c))
+* 🎨 refactor virtual file system to support filesplit case ([d520715](https://github.com/guanghechen/sora/commit/d520715e1195169914e9a4563fc8c2b1cd035b27))

package/lib/cjs/index.cjs

@@ -0,0 +1,97 @@
+'use strict';
+
+var filepart_types = require('@guanghechen/filepart.types');
+
+const isProduction = process.env.NODE_ENV === 'production';
+const prefix = 'Invariant failed';
+function invariant(condition, message) {
+    if (condition)
+        return;
+    if (isProduction)
+        throw new Error(prefix);
+    if (message == null)
+        throw new Error(prefix + ': ');
+    throw new Error(prefix + ': ' + (message instanceof Function ? message() : message));
+}
+
+function* calcFilePartItemsBySize(fileSize, partSize) {
+    invariant(partSize >= 1 && Number.isInteger(partSize), 'Part size should be a positive integer!');
+    if (fileSize <= 0) {
+        yield { sid: 1, start: 0, end: 0 };
+        return;
+    }
+    if (fileSize <= partSize) {
+        yield { sid: 1, start: 0, end: fileSize };
+        return;
+    }
+    const partTotal = Math.ceil(fileSize / partSize);
+    invariant(partTotal > 0, 'Part size is too small!');
+    for (let i = 0; i < partTotal; ++i) {
+        const part = {
+            sid: i + 1,
+            start: i * partSize,
+            end: i + 1 === partTotal ? fileSize : (i + 1) * partSize,
+        };
+        yield part;
+    }
+}
+function* calcFilePartItemsByCount(fileSize, partTotal) {
+    invariant(partTotal >= 1 && Number.isInteger(partTotal), 'Total of part should be a positive integer!');
+    if (fileSize <= 0) {
+        yield { sid: 1, start: 0, end: 0 };
+        return;
+    }
+    if (partTotal === 1) {
+        yield { sid: 1, start: 0, end: fileSize };
+        return;
+    }
+    const partSize = Math.ceil(fileSize / partTotal);
+    invariant(partSize > 0, 'Part size is too small!');
+    for (let i = 0; i < partTotal; ++i) {
+        const part = {
+            sid: i + 1,
+            start: i * partSize,
+            end: i + 1 === partTotal ? fileSize : (i + 1) * partSize,
+        };
+        yield part;
+    }
+}
+function* calcFilePartNames(parts, partCodePrefix) {
+    if (parts.length === 0)
+        return;
+    if (parts.length === 1) {
+        yield '';
+        return;
+    }
+    const maxPaddingCount = String(parts.length).length;
+    for (const part of parts) {
+        const partCode = String(part.sid).padStart(maxPaddingCount, '0');
+        const partName = partCodePrefix + partCode;
+        yield partName;
+    }
+}
+function* calcFilePartNamesByCount(partTotal, partCodePrefix) {
+    if (partTotal <= 0)
+        return;
+    if (partTotal === 1) {
+        yield '';
+        return;
+    }
+    const maxPaddingCount = String(partTotal).length;
+    for (let sid = 1; sid <= partTotal; ++sid) {
+        const partCode = String(sid).padStart(maxPaddingCount, '0');
+        const partName = partCodePrefix + partCode;
+        yield partName;
+    }
+}
+
+exports.calcFilePartItemsByCount = calcFilePartItemsByCount;
+exports.calcFilePartItemsBySize = calcFilePartItemsBySize;
+exports.calcFilePartNames = calcFilePartNames;
+exports.calcFilePartNamesByCount = calcFilePartNamesByCount;
+Object.keys(filepart_types).forEach(function (k) {
+    if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
+        enumerable: true,
+        get: function () { return filepart_types[k]; }
+    });
+});

package/lib/esm/index.mjs

@@ -0,0 +1,87 @@
+import 'node:fs';
+export * from '@guanghechen/filepart.types';
+
+const isProduction = process.env.NODE_ENV === 'production';
+const prefix = 'Invariant failed';
+function invariant(condition, message) {
+    if (condition)
+        return;
+    if (isProduction)
+        throw new Error(prefix);
+    if (message == null)
+        throw new Error(prefix + ': ');
+    throw new Error(prefix + ': ' + (message instanceof Function ? message() : message));
+}
+
+function* calcFilePartItemsBySize(fileSize, partSize) {
+    invariant(partSize >= 1 && Number.isInteger(partSize), 'Part size should be a positive integer!');
+    if (fileSize <= 0) {
+        yield { sid: 1, start: 0, end: 0 };
+        return;
+    }
+    if (fileSize <= partSize) {
+        yield { sid: 1, start: 0, end: fileSize };
+        return;
+    }
+    const partTotal = Math.ceil(fileSize / partSize);
+    invariant(partTotal > 0, 'Part size is too small!');
+    for (let i = 0; i < partTotal; ++i) {
+        const part = {
+            sid: i + 1,
+            start: i * partSize,
+            end: i + 1 === partTotal ? fileSize : (i + 1) * partSize,
+        };
+        yield part;
+    }
+}
+function* calcFilePartItemsByCount(fileSize, partTotal) {
+    invariant(partTotal >= 1 && Number.isInteger(partTotal), 'Total of part should be a positive integer!');
+    if (fileSize <= 0) {
+        yield { sid: 1, start: 0, end: 0 };
+        return;
+    }
+    if (partTotal === 1) {
+        yield { sid: 1, start: 0, end: fileSize };
+        return;
+    }
+    const partSize = Math.ceil(fileSize / partTotal);
+    invariant(partSize > 0, 'Part size is too small!');
+    for (let i = 0; i < partTotal; ++i) {
+        const part = {
+            sid: i + 1,
+            start: i * partSize,
+            end: i + 1 === partTotal ? fileSize : (i + 1) * partSize,
+        };
+        yield part;
+    }
+}
+function* calcFilePartNames(parts, partCodePrefix) {
+    if (parts.length === 0)
+        return;
+    if (parts.length === 1) {
+        yield '';
+        return;
+    }
+    const maxPaddingCount = String(parts.length).length;
+    for (const part of parts) {
+        const partCode = String(part.sid).padStart(maxPaddingCount, '0');
+        const partName = partCodePrefix + partCode;
+        yield partName;
+    }
+}
+function* calcFilePartNamesByCount(partTotal, partCodePrefix) {
+    if (partTotal <= 0)
+        return;
+    if (partTotal === 1) {
+        yield '';
+        return;
+    }
+    const maxPaddingCount = String(partTotal).length;
+    for (let sid = 1; sid <= partTotal; ++sid) {
+        const partCode = String(sid).padStart(maxPaddingCount, '0');
+        const partName = partCodePrefix + partCode;
+        yield partName;
+    }
+}
+
+export { calcFilePartItemsByCount, calcFilePartItemsBySize, calcFilePartNames, calcFilePartNamesByCount };

package/lib/types/index.d.ts

@@ -0,0 +1,30 @@
+import { IFilePartItem } from '@guanghechen/filepart.types';
+export * from '@guanghechen/filepart.types';
+
+/**
+ * Generate file part items by part size.
+ *
+ * @param fileSize
+ * @param _partSize
+ * @returns
+ */
+declare function calcFilePartItemsBySize(fileSize: number, partSize: number): IterableIterator<IFilePartItem>;
+/**
+ * Generate file part items by total of parts.
+ *
+ * @param filepath
+ * @param partTotal
+ * @returns
+ */
+declare function calcFilePartItemsByCount(fileSize: number, partTotal: number): IterableIterator<IFilePartItem>;
+/**
+ * Calculate names of parts of sourcefile respectively.
+ *
+ * @param parts
+ * @param partCodePrefix
+ * @returns
+ */
+declare function calcFilePartNames(parts: ReadonlyArray<Pick<IFilePartItem, 'sid'>>, partCodePrefix: string): IterableIterator<string>;
+declare function calcFilePartNamesByCount(partTotal: number, partCodePrefix: string): IterableIterator<string>;
+
+export { calcFilePartItemsByCount, calcFilePartItemsBySize, calcFilePartNames, calcFilePartNamesByCount };

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@guanghechen/filepart",
+  "version": "1.0.0-alpha.1",
+  "description": "File helper",
+  "author": {
+    "name": "guanghechen",
+    "url": "https://github.com/guanghechen/"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/guanghechen/sora/tree/@guanghechen/filepart@1.0.0-alpha.0",
+    "directory": "packages/filepart"
+  },
+  "homepage": "https://github.com/guanghechen/sora/tree/@guanghechen/filepart@1.0.0-alpha.0/packages/filepart#readme",
+  "keywords": [
+    "file helper",
+    "split file",
+    "merge streams"
+  ],
+  "type": "module",
+  "exports": {
+    ".": {
+      "source": "./src/index.ts",
+      "import": "./lib/esm/index.mjs",
+      "require": "./lib/cjs/index.cjs",
+      "types": "./lib/types/index.d.ts"
+    }
+  },
+  "source": "./src/index.ts",
+  "main": "./lib/cjs/index.cjs",
+  "module": "./lib/esm/index.mjs",
+  "types": "./lib/types/index.d.ts",
+  "license": "MIT",
+  "files": [
+    "lib/",
+    "!lib/**/*.map",
+    "package.json",
+    "CHANGELOG.md",
+    "LICENSE",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "../../node_modules/.bin/rimraf lib/ && ../../node_modules/.bin/cross-env NODE_ENV=production ../../node_modules/.bin/rollup -c ../../rollup.config.mjs",
+    "prepublishOnly": "yarn build",
+    "test": "node --experimental-vm-modules ../../node_modules/.bin/jest --config ../../jest.config.mjs --rootDir ."
+  },
+  "dependencies": {
+    "@guanghechen/filepart.types": "^1.0.0-alpha.1"
+  },
+  "devDependencies": {
+    "@guanghechen/internal": "^1.0.0-alpha.0"
+  },
+  "gitHead": "77612b01152880c3f7b5c123fb7a2e32d7d43885"
+}