@fluidframework/fluid-runner 2.1.0-281041 → 2.2.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 +8 -0
- package/README.md +61 -1
- package/package.json +13 -13
package/CHANGELOG.md
CHANGED
package/README.md
CHANGED
|
@@ -2,6 +2,40 @@
|
|
|
2
2
|
|
|
3
3
|
This package contains utility for running various functionality inside a Fluid Framework environment.
|
|
4
4
|
|
|
5
|
+
<!-- AUTO-GENERATED-CONTENT:START (LIBRARY_README_HEADER:apiDocs=FALSE) -->
|
|
6
|
+
|
|
7
|
+
<!-- prettier-ignore-start -->
|
|
8
|
+
<!-- NOTE: This section is automatically generated using @fluid-tools/markdown-magic. Do not update these generated contents directly. -->
|
|
9
|
+
|
|
10
|
+
## Using Fluid Framework libraries
|
|
11
|
+
|
|
12
|
+
When taking a dependency on a Fluid Framework library's public APIs, we recommend using a `^` (caret) version range, such as `^1.3.4`.
|
|
13
|
+
While Fluid Framework libraries may use different ranges with interdependencies between other Fluid Framework libraries,
|
|
14
|
+
library consumers should always prefer `^`.
|
|
15
|
+
|
|
16
|
+
If using any of Fluid Framework's unstable APIs (for example, its `beta` APIs), we recommend using a more constrained version range, such as `~`.
|
|
17
|
+
|
|
18
|
+
## Installation
|
|
19
|
+
|
|
20
|
+
To get started, install the package by running the following command:
|
|
21
|
+
|
|
22
|
+
```bash
|
|
23
|
+
npm i @fluidframework/fluid-runner
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
## Importing from this package
|
|
27
|
+
|
|
28
|
+
This package leverages [package.json exports](https://nodejs.org/api/packages.html#exports) to separate its APIs by support level.
|
|
29
|
+
For more information on the related support guarantees, see [API Support Levels](https://fluidframework.com/docs/build/releases-and-apitags/#api-support-levels).
|
|
30
|
+
|
|
31
|
+
To access the `public` ([SemVer](https://semver.org/)) APIs, import via `@fluidframework/fluid-runner` like normal.
|
|
32
|
+
|
|
33
|
+
To access the `legacy` APIs, import via `@fluidframework/fluid-runner/legacy`.
|
|
34
|
+
|
|
35
|
+
<!-- prettier-ignore-end -->
|
|
36
|
+
|
|
37
|
+
<!-- AUTO-GENERATED-CONTENT:END -->
|
|
38
|
+
|
|
5
39
|
## Export File
|
|
6
40
|
|
|
7
41
|
Allows some execution to be made on a container given a provided ODSP snapshot.
|
|
@@ -83,11 +117,37 @@ The code around `exportFile` can be consumed in multiple different layers. It is
|
|
|
83
117
|
|
|
84
118
|
For an example of a consumption path that differs slightly to [`exportFile(...)`](./src/exportFile.ts), see [`parseBundleAndExportFile(...)`](./src/parseBundleAndExportFile.ts). In addition to running the same logic as [`exportFile`](./src/exportFile.ts) method, it implements the logic around parsing a dynamically provided bundle path into an `IFluidFileConverter` object.
|
|
85
119
|
|
|
86
|
-
<!-- AUTO-GENERATED-CONTENT:START (
|
|
120
|
+
<!-- AUTO-GENERATED-CONTENT:START (README_FOOTER:clientRequirements=FALSE) -->
|
|
87
121
|
|
|
88
122
|
<!-- prettier-ignore-start -->
|
|
89
123
|
<!-- NOTE: This section is automatically generated using @fluid-tools/markdown-magic. Do not update these generated contents directly. -->
|
|
90
124
|
|
|
125
|
+
## Contribution Guidelines
|
|
126
|
+
|
|
127
|
+
There are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.
|
|
128
|
+
|
|
129
|
+
- Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).
|
|
130
|
+
- [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.
|
|
131
|
+
- Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).
|
|
132
|
+
- [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).
|
|
133
|
+
|
|
134
|
+
Detailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).
|
|
135
|
+
|
|
136
|
+
This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).
|
|
137
|
+
For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.
|
|
138
|
+
|
|
139
|
+
This project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.
|
|
140
|
+
Use of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).
|
|
141
|
+
Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.
|
|
142
|
+
|
|
143
|
+
## Help
|
|
144
|
+
|
|
145
|
+
Not finding what you're looking for in this README? Check out [fluidframework.com](https://fluidframework.com/docs/).
|
|
146
|
+
|
|
147
|
+
Still not finding what you're looking for? Please [file an issue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).
|
|
148
|
+
|
|
149
|
+
Thank you!
|
|
150
|
+
|
|
91
151
|
## Trademark
|
|
92
152
|
|
|
93
153
|
This project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@fluidframework/fluid-runner",
|
|
3
|
-
"version": "2.
|
|
3
|
+
"version": "2.2.0",
|
|
4
4
|
"description": "Utility for running various functionality inside a Fluid Framework environment",
|
|
5
5
|
"homepage": "https://fluidframework.com",
|
|
6
6
|
"repository": {
|
|
@@ -69,26 +69,26 @@
|
|
|
69
69
|
"temp-directory": "nyc/.nyc_output"
|
|
70
70
|
},
|
|
71
71
|
"dependencies": {
|
|
72
|
-
"@fluidframework/aqueduct": "2.
|
|
73
|
-
"@fluidframework/container-definitions": "2.
|
|
74
|
-
"@fluidframework/container-loader": "2.
|
|
75
|
-
"@fluidframework/core-interfaces": "2.
|
|
76
|
-
"@fluidframework/driver-definitions": "2.
|
|
77
|
-
"@fluidframework/odsp-driver": "2.
|
|
78
|
-
"@fluidframework/odsp-driver-definitions": "2.
|
|
79
|
-
"@fluidframework/telemetry-utils": "2.
|
|
72
|
+
"@fluidframework/aqueduct": "~2.2.0",
|
|
73
|
+
"@fluidframework/container-definitions": "~2.2.0",
|
|
74
|
+
"@fluidframework/container-loader": "~2.2.0",
|
|
75
|
+
"@fluidframework/core-interfaces": "~2.2.0",
|
|
76
|
+
"@fluidframework/driver-definitions": "~2.2.0",
|
|
77
|
+
"@fluidframework/odsp-driver": "~2.2.0",
|
|
78
|
+
"@fluidframework/odsp-driver-definitions": "~2.2.0",
|
|
79
|
+
"@fluidframework/telemetry-utils": "~2.2.0",
|
|
80
80
|
"json2csv": "^5.0.7",
|
|
81
81
|
"yargs": "17.7.2"
|
|
82
82
|
},
|
|
83
83
|
"devDependencies": {
|
|
84
84
|
"@arethetypeswrong/cli": "^0.15.2",
|
|
85
85
|
"@biomejs/biome": "~1.8.3",
|
|
86
|
-
"@fluid-internal/mocha-test-setup": "2.
|
|
87
|
-
"@fluid-tools/build-cli": "^0.
|
|
86
|
+
"@fluid-internal/mocha-test-setup": "~2.2.0",
|
|
87
|
+
"@fluid-tools/build-cli": "^0.43.0",
|
|
88
88
|
"@fluidframework/build-common": "^2.0.3",
|
|
89
|
-
"@fluidframework/build-tools": "^0.
|
|
89
|
+
"@fluidframework/build-tools": "^0.43.0",
|
|
90
90
|
"@fluidframework/eslint-config-fluid": "^5.3.0",
|
|
91
|
-
"@fluidframework/fluid-runner-previous": "npm:@fluidframework/fluid-runner@2.
|
|
91
|
+
"@fluidframework/fluid-runner-previous": "npm:@fluidframework/fluid-runner@2.1.0",
|
|
92
92
|
"@microsoft/api-extractor": "^7.45.1",
|
|
93
93
|
"@types/mocha": "^9.1.1",
|
|
94
94
|
"@types/node": "^18.19.0",
|