balena-image-fs 7.6.0-build-add-explore-partition-7c064f69c611250a9ec08c355c9b6fab69b27d0e-1 → 7.6.0
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.
- package/CHANGELOG.md +1 -1
- package/README.md +5 -13
- package/build/index.d.ts +4 -15
- package/build/index.js +7 -23
- package/build/index.js.map +1 -1
- package/package.json +2 -2
package/CHANGELOG.md
CHANGED
|
@@ -6,7 +6,7 @@ This project adheres to [Semantic Versioning](http://semver.org/).
|
|
|
6
6
|
|
|
7
7
|
## 7.6.0 - 2026-01-13
|
|
8
8
|
|
|
9
|
-
* Add `explorePartition` function for exploring
|
|
9
|
+
* Add `explorePartition` function for exploring partitions of an image [Matthew Yarmolinsky]
|
|
10
10
|
|
|
11
11
|
## 7.5.3 - 2025-04-09
|
|
12
12
|
|
package/README.md
CHANGED
|
@@ -29,17 +29,9 @@ Documentation
|
|
|
29
29
|
|
|
30
30
|
|
|
31
31
|
* [imagefs](#module_imagefs)
|
|
32
|
-
* [~BalenaPartition](#module_imagefs..BalenaPartition)
|
|
33
32
|
* [~interact()](#module_imagefs..interact)
|
|
34
|
-
* [~explorePartition(imagePath,
|
|
33
|
+
* [~explorePartition(imagePath, partitionNames, exploreFn)](#module_imagefs..explorePartition) ⇒ <code>T</code>
|
|
35
34
|
|
|
36
|
-
<a name="module_imagefs..BalenaPartition"></a>
|
|
37
|
-
|
|
38
|
-
### imagefs~BalenaPartition
|
|
39
|
-
Values are the base name for a partition on disk
|
|
40
|
-
|
|
41
|
-
**Kind**: inner property of [<code>imagefs</code>](#module_imagefs)
|
|
42
|
-
**Summary**: IDs for the standard balenaOS partitions
|
|
43
35
|
<a name="module_imagefs..interact"></a>
|
|
44
36
|
|
|
45
37
|
### imagefs~interact()
|
|
@@ -54,15 +46,15 @@ console.log(contents);
|
|
|
54
46
|
```
|
|
55
47
|
<a name="module_imagefs..explorePartition"></a>
|
|
56
48
|
|
|
57
|
-
### imagefs~explorePartition(imagePath,
|
|
49
|
+
### imagefs~explorePartition(imagePath, partitionNames, exploreFn) ⇒ <code>T</code>
|
|
58
50
|
**Kind**: inner method of [<code>imagefs</code>](#module_imagefs)
|
|
59
|
-
**Summary**: Allow a provided function to explore the contents of
|
|
60
|
-
|
|
51
|
+
**Summary**: Allow a provided function to explore the contents of the
|
|
52
|
+
first found partition of an image
|
|
61
53
|
|
|
62
54
|
| Param | Type | Description |
|
|
63
55
|
| --- | --- | --- |
|
|
64
56
|
| imagePath | <code>string</code> | pathname of image for search |
|
|
65
|
-
|
|
|
57
|
+
| partitionNames | <code>Array.<string></code> | partitions to find |
|
|
66
58
|
| exploreFn | <code>function</code> | function for exploration |
|
|
67
59
|
|
|
68
60
|
|
package/build/index.d.ts
CHANGED
|
@@ -15,23 +15,12 @@ export { findPartition, FindPartitionResult } from './utils';
|
|
|
15
15
|
*/
|
|
16
16
|
export declare function interact<T>(disk: Disk | string, partition: number | undefined, fn: (fs: typeof Fs) => Promise<T>): Promise<T>;
|
|
17
17
|
/**
|
|
18
|
-
* @summary
|
|
19
|
-
*
|
|
20
|
-
*/
|
|
21
|
-
export declare enum BalenaPartition {
|
|
22
|
-
BOOT = "boot",
|
|
23
|
-
ROOTA = "rootA",
|
|
24
|
-
ROOTB = "rootB",
|
|
25
|
-
STATE = "state",
|
|
26
|
-
DATA = "data"
|
|
27
|
-
}
|
|
28
|
-
/**
|
|
29
|
-
* @summary Allow a provided function to explore the contents of one of the well-known
|
|
30
|
-
* partitions of a balenaOS image
|
|
18
|
+
* @summary Allow a provided function to explore the contents of the
|
|
19
|
+
* first found partition of an image
|
|
31
20
|
*
|
|
32
21
|
* @param {string} imagePath - pathname of image for search
|
|
33
|
-
* @param {
|
|
22
|
+
* @param {string[]} partitionNames - partitions to find
|
|
34
23
|
* @param {function(fs): Promise<T>} - function for exploration
|
|
35
24
|
* @returns {T}
|
|
36
25
|
*/
|
|
37
|
-
export declare function explorePartition<T>(imagePath: string,
|
|
26
|
+
export declare function explorePartition<T>(imagePath: string, partitionNames: string[], exploreFn: (fs: typeof Fs) => Promise<T>): Promise<T>;
|
package/build/index.js
CHANGED
|
@@ -15,7 +15,7 @@ See the License for the specific language governing permissions and
|
|
|
15
15
|
limitations under the License.
|
|
16
16
|
*/
|
|
17
17
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
18
|
-
exports.
|
|
18
|
+
exports.findPartition = exports.LabelNotFound = exports.getFsLabel = void 0;
|
|
19
19
|
exports.interact = interact;
|
|
20
20
|
exports.explorePartition = explorePartition;
|
|
21
21
|
/**
|
|
@@ -167,40 +167,24 @@ async function interact(disk, partition, fn) {
|
|
|
167
167
|
}
|
|
168
168
|
}
|
|
169
169
|
/**
|
|
170
|
-
* @summary
|
|
171
|
-
*
|
|
172
|
-
*/
|
|
173
|
-
var BalenaPartition;
|
|
174
|
-
(function (BalenaPartition) {
|
|
175
|
-
BalenaPartition["BOOT"] = "boot";
|
|
176
|
-
BalenaPartition["ROOTA"] = "rootA";
|
|
177
|
-
BalenaPartition["ROOTB"] = "rootB";
|
|
178
|
-
BalenaPartition["STATE"] = "state";
|
|
179
|
-
BalenaPartition["DATA"] = "data";
|
|
180
|
-
})(BalenaPartition || (exports.BalenaPartition = BalenaPartition = {}));
|
|
181
|
-
/**
|
|
182
|
-
* @summary Allow a provided function to explore the contents of one of the well-known
|
|
183
|
-
* partitions of a balenaOS image
|
|
170
|
+
* @summary Allow a provided function to explore the contents of the
|
|
171
|
+
* first found partition of an image
|
|
184
172
|
*
|
|
185
173
|
* @param {string} imagePath - pathname of image for search
|
|
186
|
-
* @param {
|
|
174
|
+
* @param {string[]} partitionNames - partitions to find
|
|
187
175
|
* @param {function(fs): Promise<T>} - function for exploration
|
|
188
176
|
* @returns {T}
|
|
189
177
|
*/
|
|
190
|
-
async function explorePartition(imagePath,
|
|
178
|
+
async function explorePartition(imagePath, partitionNames, exploreFn) {
|
|
191
179
|
return await (0, file_disk_1.withOpenFile)(imagePath, 'r', async (handle) => {
|
|
192
180
|
const disk = new file_disk_1.FileDisk(handle, true, false, false);
|
|
193
181
|
const partitionInfo = await partitioninfo.getPartitions(disk, {
|
|
194
182
|
includeExtended: false,
|
|
195
183
|
getLogical: true,
|
|
196
184
|
});
|
|
197
|
-
const findResult = await (0, utils_1.findPartition)(disk, partitionInfo,
|
|
198
|
-
`resin-${partitionId}`,
|
|
199
|
-
`flash-${partitionId}`,
|
|
200
|
-
`balena-${partitionId}`,
|
|
201
|
-
]);
|
|
185
|
+
const findResult = await (0, utils_1.findPartition)(disk, partitionInfo, partitionNames);
|
|
202
186
|
if (findResult == null) {
|
|
203
|
-
throw new Error(`Can't find partition for ${
|
|
187
|
+
throw new Error(`Can't find partition for ${partitionNames}`);
|
|
204
188
|
}
|
|
205
189
|
return await interact(disk, findResult.index, exploreFn);
|
|
206
190
|
});
|
package/build/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../lib/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;EAcE;;;AAmLF,4BAeC;
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../lib/index.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "balena-image-fs",
|
|
3
|
-
"version": "7.6.0
|
|
3
|
+
"version": "7.6.0",
|
|
4
4
|
"description": "Image filesystem manipulation utilities",
|
|
5
5
|
"main": "build/index.js",
|
|
6
6
|
"homepage": "https://github.com/balena-io-modules/balena-image-fs",
|
|
@@ -59,6 +59,6 @@
|
|
|
59
59
|
"node": ">=16"
|
|
60
60
|
},
|
|
61
61
|
"versionist": {
|
|
62
|
-
"publishedAt": "2026-01-13T16:
|
|
62
|
+
"publishedAt": "2026-01-13T16:36:25.194Z"
|
|
63
63
|
}
|
|
64
64
|
}
|