Merge 028d01341f into 8469c94c6a

* Add Bun example

* Fix Bun Windows example

README.md

@@ -157,6 +157,7 @@ Every programming language and framework has its own way of caching.
 
 See [Examples](examples.md) for a list of `actions/cache` implementations for use with:
 
+* [Bun](./examples.md#bun)
 * [C# - NuGet](./examples.md#c---nuget)
 * [Clojure - Lein Deps](./examples.md#clojure---lein-deps)
 * [D - DUB](./examples.md#d---dub)

examples.md

@@ -1,5 +1,6 @@
 # Examples
 
+- [Bun](#bun)
 - [C# - NuGet](#c---nuget)
 - [Clojure - Lein Deps](#clojure---lein-deps)
 - [D - DUB](#d---dub)
@@ -39,8 +40,29 @@
 - [Swift, Objective-C - CocoaPods](#swift-objective-c---cocoapods)
 - [Swift - Swift Package Manager](#swift---swift-package-manager)
 - [Swift - Mint](#swift---mint)
+- [* - ASDF](#---asdf)
 - [* - Bazel](#---bazel)
 
+## Bun
+
+```yaml
+- uses: actions/cache@v4
+  with:
+    path: |
+      ~/.bun/install/cache
+    key: ${{ runner.os }}-bun-${{ hashFiles('**/bun.lockb') }}
+```
+
+### Windows
+
+```yaml
+- uses: actions/cache@v4
+  with:
+    path: |
+      ~\.bun
+    key: ${{ runner.os }}-bun-${{ hashFiles('**/bun.lockb') }}
+```
+
 ## C# - NuGet
 
 Using [NuGet lock files](https://docs.microsoft.com/nuget/consume-packages/package-references-in-project-files#locking-dependencies):
@@ -660,6 +682,38 @@ steps:
         ${{ runner.os }}-mint-
 ```
 
+## * - ASDF
+
+[ASDF](https://asdf-vm.com), see [#235](https://github.com/asdf-vm/actions/issues/235):
+
+```yaml
+- name: Setup ASDF itself
+  uses: asdf-vm/actions/setup@v3
+
+- name: Cache ASDF
+  uses: actions/cache@v4
+  id: asdf-cache
+  with:
+    # https://github.com/asdf-vm/asdf/blob/master/.gitignore
+    path: |
+      ~/.asdf/installs
+      ~/.asdf/plugins
+      ~/.asdf/shims
+    key: ${{ runner.os }}-asdf-tools-${{ hashFiles('.tool-versions') }}
+    restore-keys: ${{ runner.os }}-asdf-tools-
+
+- name: Install ASDF plugins
+  uses: asdf-vm/actions/install@v3
+  # See https://github.com/asdf-vm/actions/issues/445
+  if: ${{ steps.asdf-cache.outputs.cache-hit != 'true' }}
+  with:
+    asdf_branch: v0.14.0
+
+- name: Reshim installed ASDF tools
+  shell: bash
+  run: asdf reshim
+```
+
 ## * - Bazel
 
 [`bazelisk`](https://github.com/bazelbuild/bazelisk) does not have be to separately downloaded and installed because it's already included in GitHub's `ubuntu-latest` and `macos-latest` base images.