100 Commits

Author SHA1 Message Date
Jan T. Sott
8469c94c6a
Add Bun example (#1456)
* Add Bun example

* Fix Bun Windows example
2024-10-08 19:53:09 +00:00
Bassem Dghaidi
c4ee99a3bd
Merge branch 'main' into todgru/v4-documentation-update 2024-08-14 12:09:56 +02:00
Oleg A.
e47d9f9ec8
Explicit use bash for Windows (#1377)
Co-authored-by: Josh Gross <joshmgross@github.com>
2024-07-31 16:52:21 +00:00
todgru
104f95683b update documentation to use <action>@v4 2024-01-26 14:08:22 -08:00
Michael Vorburger ⛑️
6f1f1e10f3
Clarify that macos-latest image has bazelisk 2023-03-13 14:26:31 +01:00
Michael Vorburger ⛑️
4b8460cbff
Create separate Linux/macOS examples for Bazel 2023-03-13 10:52:18 +01:00
Michael Vorburger
ef11f54eee Fix example for Bazel 2023-03-11 19:54:11 +01:00
David Bernard
4b381be638 Add example for Bazel 2023-03-11 19:21:37 +01:00
Josh Soref
22d3da765b
Rewrite readmes (#1085)
* Improve readmes

* Add markdown for default value

Co-authored-by: Sankalp Kotewar <98868223+kotewar@users.noreply.github.com>

---------

Co-authored-by: Sankalp Kotewar <98868223+kotewar@users.noreply.github.com>
2023-01-31 16:01:15 +05:30
Tanuj Kumar Mishra
003f5452bf
Merge branch 'main' into update-docs 2023-01-12 16:48:49 +05:30
uhooi
d6217569d5 Update Mint example 2022-12-29 22:28:56 +09:00
uhooi
84e54000da Merge remote-tracking branch 'origin/main' into feature/add_mint_example 2022-12-29 22:27:37 +09:00
SIGUI Kessé Emmanuel
d70353d8a4 📝 #1045 update using the set-output command is deprecated 2022-12-26 07:12:46 +01:00
A. Pascual
dc097e3bb9
Update examples.md (#1026)
According with the behavior description the id of "Get npm cache directory" must be "npm-cache-dir".

I checked it in my own project.
2022-12-11 12:49:22 +05:30
Deepak Dahiya
fb86cbf360
Updated node example (#1008)
* Updated node example

* Update examples.md
2022-12-07 14:55:01 +05:30
ysato
0ff0597934
Update examples.md (#920) 2022-09-29 10:27:49 +05:30
Shivam Arora
a0e530f115 feat: 🎸 add example for clojure lein project deps
In Clojure, Lein tool is used to generate template for various projects.
Lein project metadata (including project dependencies) are stored in
prject.clj (in root directory) file. Lein downloads dependencies in
classpath (~/.m2/repository). So here I am caching ~/.m2/repository path
for reusing cache in subsequent builds.
2022-06-26 00:39:24 +05:30
Mike Pilgrem
d25c51bbfd Adapt existing Haskell Stack example for Windows
The default `STACK_ROOT` is `~/.stack` only on Unix-like operating systems. On Windows, the default is `%APPDATA%/stack` (usually `%HOME%\AppData\Roaming\stack`).

On Unix-like OSs, Stack stores GHC and other tools in a `programs` directory in the `STACK_ROOT`. On Windows, Stack stores those tools and MSYS2 in `%LOCALAPPDATA%\Programs\stack` (usually `%HOME%\AppData\Local\Programs\stack`).
2022-06-21 13:15:08 +01:00
Leandro Ostera
acace7fa1b
Merge branch 'main' into patch-1 2022-06-06 14:26:51 +02:00
Tim Perry
ccaf2d8fb1 Tweak npm example description for cleaner links 2022-05-25 12:00:49 +02:00
Tim Perry
34f9efca11 Simplify the Node.js NPM caching example 2022-05-25 11:58:58 +02:00
Vipul
95f200e41c
Merge pull request #762 from magnetikonline/remove-win-load-app-data
Remove final incorrect instances of `%AppData%` / `%LocalAppData%` from Windows cache examples
2022-05-11 16:14:36 +05:30
Vipul
9c784e290b
Merge pull request #738 from kubo39/fix-dub
[D] Fix: should use dub.selections.json for cache
2022-05-11 16:13:29 +05:30
Ashwin Sangem
7799d864d9
Updated the usage and docs to the major version release. (#770) 2022-03-21 14:31:26 +05:30
Peter Mescalchin
3722efebf1 Remove final incorrect instances of %AppData% / %LocalAppData% for Windows cache examples 2022-03-10 10:44:10 +11:00
Vipul
deae296ab3
Merge pull request #651 from magnetikonline/fix-golang-windows-example
Fix Golang windows example - updated `README.md` test badge markdown.
2022-03-09 18:22:38 +05:30
Vipul
c7c46bcb6d
Merge pull request #707 from duxtland/main
Add Deno cache example
2022-02-24 15:51:48 +05:30
Peter Mescalchin
6535c5fb5f Regenerated examples.md TOC 2022-02-24 16:36:38 +11:00
Peter Mescalchin
341e6d75d9
Merge branch 'actions:main' into fix-golang-windows-example 2022-02-24 16:28:28 +11:00
Vipul
ab4bea262c
Merge pull request #567 from yuichkun/fix-typo-in-lerna-example
Fix typo of cache path in Lerna example
2022-02-23 11:24:07 +05:30
Yuichi Yogo
7772fcab79 remove unnecessary sub directory from search path 2022-02-23 12:39:46 +09:00
Malo Bourgon
2c7b30f330 Add example for Haskell Stack 2022-02-22 10:21:09 -08:00
Hiroki Noda
5074380beb [D] Fix: should use dub.selections.json for cache 2022-02-12 03:17:32 +09:00
Jheyson Saavedra
de7c17c6a9
chore: add Deno cache example 2022-01-15 19:33:29 -05:00
Joachim Breitner
c64c5261d3
Fix syntax 2021-12-30 11:54:15 +01:00
Joachim Breitner
4e8aa1cc93
Improve Haskell example
as proposed in https://github.com/actions/cache/issues/555
2021-12-29 20:50:37 +01:00
Manuel Roth
67b6d52d50
(R renv) Remove unused renv-cache-path variable (#663) 2021-10-22 11:32:54 -04:00
Manuel Roth
92f67a4829
(R renv) Fix Renv package cache location in examples (#660)
* (R renv) Fix Renv package cache location in examples

* (R env) Update getting Renv package cache location

* (R env) Set renv package cache location using RENV_PATHS_ROOT environment variable
2021-10-22 10:22:58 -04:00
Peter Mescalchin
447f0fd1d3 Chomp some markdown whitespace 2021-09-26 22:10:48 +10:00
Peter Mescalchin
795a8f09a9 Fixed Windows Golang cache paths in example 2021-09-26 22:05:48 +10:00
andrewdotn
5807af2642
Fix bugs in example of how to use with pipenv (#607)
* Fix bugs in example of how to use with pipenv

The current example of how to use `@actions/cache` with pipenv has two
problems:

 1. The cached virtualenv that pipenv creates has `bin/python` as a symlink
    into paths like `/opt/hostedtoolcache/Python/3.7.11` that explicitly
    include the patch version of python. When the cache is restored onto a
    machine running a slightly different version of python, e.g., when
    GitHub upgrades its runners from python 3.7.10 to 3.7.11, then any
    attempt to run python in the workflow mysteriously fails with errors
    like `Failed to load paths: /bin/sh: 1: /home/runner/.local/share/virtualenvs/myrepo-sOIMCiTO/bin/python: not found`.

    Therefore the patch version of python should be included in the cache
    key.

 2. `pipenv --install` has the unfortunate behaviour of not cleaning out
    any pre-existing packages. That is, if the `Pipfile` first contains
    dependencies on `foo` and `bar`, and then you remove `bar` from the
    `Pipfile` and run `pipenv install` again, `bar` is still included in
    the virtualenv.

    This can cause false-positive test failures: when a dependency is
    removed from the `Pipfile` but there is still code that relies on the
    removed dependency, tests can still pass if the dependency comes from
    the cache based on a previous revision of `Pipfile.lock`.

    Therefore `restore-keys` should not be set.

This PR attempts to address both of these issues.

* Explain why setup-python is included in example
2021-07-15 14:37:10 -04:00
Peter Mescalchin
0638051e9a
Golang example tweak - add go-build path - rebuild page TOC (#577) 2021-06-01 08:39:29 -05:00
Alex Tokarev
cc2d767a72
Update Rust directories recommended for caching (#433)
This commit applies the suggestion from The Cargo Book:
https://doc.rust-lang.org/cargo/guide/cargo-home.html#caching-the-cargo-home-in-ci
2021-05-21 12:41:57 -05:00
Daniel Kuschny
2fa955d825
Update examples.md (#588)
Extend gradle notes.
2021-05-13 14:40:34 -05:00
Yuichi Yogo
4762de4681 simplify path in lerna example 2021-04-21 02:47:03 +09:00
kalin
3a696372f2
elixir typo - stray parenthesis (#569) 2021-04-20 08:51:44 -05:00
Wojtek Mach
366e5ba022
Update cache key for Elixir (#568) 2021-04-19 08:42:01 -05:00
Yuichi Yogo
12ed05f49a Fix typo of cache path in Lerna example 2021-04-17 12:35:30 +09:00
Jonathan Clem
981fa981ed
Merge pull request #469 from ericmj/patch-1
Also cache _build for Elixir
2021-03-31 10:46:31 -04:00
Pradyun Gedam
4498c5b4d8
Drop the example based on using pip's internals (#519)
pip's documentation explicitly states to not use `import pip`:

> While it is implemented in Python, and so is available from your Python code via
> `import pip`, you must not use pip’s internal APIs in this way.

This example is in direct contradiction with the documentation's guidance and, thus, has
been removed.
2021-03-29 17:34:02 -04:00
Benoit Daloze
1bfe3accb3 Recommend ruby/setup-ruby's bundler-cache: true option
Manually caching gems has many issues:
* Not working if there is no Gemfile.lock but only a Gemfile
* Not having the OS version in the key, which might cause binary incompatibility with system libraries of different ABI version.
* Not taking the Ruby version in account.
* Not taking the Ruby ABI version of development builds into accounts, which cannot be done with a key, but needs the commit hash.
* Using restore-keys would grow the cache over time and have extra gems in the cache.
* Those reasons are summarized in https://github.com/marketplace/actions/setup-ruby-jruby-and-truffleruby#caching-bundle-install-manually
2021-01-28 12:52:25 +01:00
Konrad Pabjan
354332455a
Merge pull request #434 from DanielHabenicht/patch-1
Update examples.md for NPM
2021-01-14 17:22:53 +01:00
Odín del Río
e64ab303d1
Improved gradle cache key calculation example 2021-01-13 22:09:00 +01:00
Chris Patterson
72f66cfa6d
Added a cache example when using matrix 2021-01-12 13:29:18 -05:00
Leandro Ostera
009fe4e01c
Add sample cache for Erlang with Rebar3 2020-12-29 13:33:30 +01:00
Eric Meadows-Jönsson
62a4d75442
Also cache _build for Elixir 2020-11-24 15:52:21 +01:00
Guillermo Eijo
4557c6a937 Add example for python pipenv 2020-10-22 21:35:30 -03:00
DanielHabenicht
19530ba135
Update examples.md 2020-10-14 02:51:53 +02:00
Shafiq Jetha
8b407f7777
Grammar fix (#405) 2020-09-08 13:10:51 -04:00
Noam Tamim
59a8d125e7
Fix indentation in last pip example 2020-08-05 12:29:52 +03:00
uhooi
35f35f44e8
Update examples.md 2020-07-19 19:52:18 +09:00
Aiqiao Yan
4978dc4f31
Merge pull request #358 from gaerfield/patch-1
fixes actions/cache#244
2020-07-16 15:48:28 -04:00
Aiqiao Yan
5c77066753
Merge pull request #359 from JLHwung/patch-1
add Yarn 2 cache example
2020-07-16 15:41:08 -04:00
Aiqiao Yan
4aa79d91d3 Rename master to main 2020-07-15 10:36:12 -04:00
Huáng Jùnliàng
5474af707f
add Yarn 2 cache example 2020-07-02 09:43:52 -04:00
gaerfield
591646a21e
fixes actions/cache#244 2020-07-01 10:30:03 +02:00
Marcono1234
eed9cfe64d
Add name for Maven example (#341) 2020-06-18 13:37:50 -04:00
Josh Gross
984ce638f0
Add note about using setup-node before cache (#351) 2020-06-15 15:55:57 -04:00
Aiqiao Yan
e6c708b5ce React to feedback 2020-05-26 15:31:33 -04:00
Aiqiao Yan
581312be20 Update readme and examples to use v2 2020-05-26 12:48:39 -04:00
Shigeki Karita
ddc4681e8d
Add D example. (#303) 2020-05-11 10:24:05 -04:00
Hugo van Kemenade
ccf9619480
Add Python example using 'pip cache dir' to get cache location (#285)
* Fix existing example

* Add Python example using 'pip cache dir' to get cache location

* Let users decide how they install pip 20.1+
2020-04-29 14:58:19 -04:00
Josh Gross
f60097cd16
Fix Lerna Example (#242)
* Fix lerna example

* Fix yaml spacing
2020-04-02 10:35:07 -04:00
Ethan Dennis
eb78578266
Cache multiple paths and add glob pattern support (#212)
* Allow for multiple line-delimited paths to cache

* Add initial minimatch support

* Use @actions/glob for pattern matching

* Cache multiple entries using --files-from tar input

remove known failing test

Quote tar paths

Add salt to test cache

Try reading input files from manifest

bump salt

Run test on macos

more testing

Run caching tests on 3 platforms

Run tests on self-hosted

Apparently cant reference hosted runners by name

Bump salt

wait for some time after save

more timing out

smarter waiting

Cache in tmp dir that won't be deleted

Use child_process instead of actions/exec

Revert tempDir hack

bump salt

more logging

More console logging

Use filepath to with cacheHttpClient

Test cache restoration

Revert temp dir hack

debug logging

clean up cache.yml testing

Bump salt

change debug output

build actions

* unit test coverage for caching multiple dirs

* Ensure there's a locateable test folder at homedir

* Clean up code

* Version cache with all inputs

* Unit test getCacheVersion

* Include keys in getCacheEntry request

* Clean import orders

* Use fs promises in actionUtils tests

* Update import order for to fix linter errors

* Fix remaining linter error

* Remove platform-specific test code

* Add lerna example for caching multiple dirs

* Lerna example updated to v2

Co-Authored-By: Josh Gross <joshmgross@github.com>

Co-authored-by: Josh Gross <joshmgross@github.com>
2020-03-20 16:02:11 -04:00
Dylan Musil
22d71e33ad
Update Node Windows example to find the npm cache (#223) 2020-03-18 22:05:56 -04:00
Jeremy Loy
af8651e0c5
Include Kotlinscript Gradle files (#216)
Tested this with my own repo which uses a mix of `build.gradle` and `build.gradle.kts` files and this glob seems to be working correctly.

As an aside, please checkout #215 as it would make the process of verifying these globs easier!
2020-03-18 09:40:55 -04:00
Sacha Ayoun
826785142a
Adding examples for OCaml/esy (#199)
* Adding examples for esy as a workflow for OCaml files

* track v1 instead of v1.1.2

Co-Authored-By: Josh Gross <joshmgross@github.com>

* add link in the readme for ocaml-esy

* ocaml -> ocaml/reason

* link in readme says ocaml/reason

Co-authored-by: Josh Gross <joshmgross@github.com>
2020-02-26 17:43:11 -05:00
Kipras Melnikovas
e8230b28a9
Use different IDs for 1) getting the directory of yarn cache 2) the cache itself (#178)
* Use different IDs for 1) getting the directory of yarn cache 2) the cache itself

Using the current example + https://github.com/actions/cache#skipping-steps-based-on-cache-hit,

I came to a wrong conclusion that I could skip a step
if the `cache-hit` was `true` -
the ID I used was from the wrong step -
the `get yarn cache directory` step,
instead of the `get yarn cache itself` step.

I've updated the example in hopes that it'll be clearer for others aswell!

Signed-off-by: Kipras Melnikovas <kipras@kipras.org>

* Explain which ID to use for `cache-hit` in yarn's example

Signed-off-by: Kipras Melnikovas <kipras@kipras.org>
2020-02-14 09:50:11 -05:00
Florian Kostenzer
e43776276f
Add Swift Package Manager (SPM) example (#159)
* Add Swift - SPM to examples

* Add link SPM example link to readme

* remove extra newline

* remove another extra newline
2020-01-29 11:13:59 -05:00
Shinya Uryu
b6d538e2aa Add renv examples (#151)
* Add renv examples

* Add link in main readme.md
2020-01-21 19:22:40 -05:00
Mike Coutermarsh
6c11532937 Update Ruby docs. "Gem" -> "Bundler" (#150)
* Use "Bundler" which is the package manager

"Gem" isn't wrong, but not typically what a Ruby developer would think of.

* Update links

* Update links
2020-01-12 18:48:43 -05:00
Daniel Shuy
c33bff8d72 Add Scala - SBT example (#134)
* Add Scala - SBT example

* Add Scala - SBT example to README
2020-01-10 17:09:06 -05:00
Flavio Corpa
d1991bb4c5 Add Haskell - Cabal example (#148)
* Add Haskell - Cabal example

* Add link in main readme.md
2020-01-10 17:07:52 -05:00
Nogic
decbafc350
Update examples.md
Co-Authored-By: Chris Patterson <chrispat@github.com>
2019-12-16 09:45:29 +09:00
Nogic
0188dffc5a
Revert original C# Example
* Treat "Use Personal Cache Folder" way as another C# example
* Describe the situation in which another example should be used
2019-12-13 10:03:43 +09:00
Nogic
002d3a77f4
Use Personal Cache Folder in C# Example
Ref: #115
2019-12-10 09:21:47 +09:00
Evan Cloutier
3d01b4eb53 Update Ruby example in documentation to specify bundler path (#113)
* Update Ruby example to specify bundler path

* Fix spacing
2019-11-23 14:13:50 -05:00
Josh Gross
7e7aef2963
Add pip examples (#86) 2019-11-13 10:55:05 -05:00
Josh Gross
50a2fdee6f
Update yarn cache example (#70)
* Update yarn cache example

* Update examples.md

Co-Authored-By: Eric Taylor <erictaylor89@gmail.com>
2019-11-13 10:18:47 -05:00
Josh Gross
bc821d0c12
Remove recommendation to cache node_modules (#69)
* Update npm caching examples

* Fix output name

* Remove extra details tag
2019-11-07 21:04:46 -05:00
Kai Neuwerth
ecf6eea708 Add PHP Composer example (#32) 2019-11-05 16:18:49 -05:00
Hugo van Kemenade
5f4d4d4555 Alphabetise examples (#52) 2019-11-05 12:04:07 -05:00
Koen Punt
5d3ad75a2b Update example formatting (#57)
* adjust formatting of Carthage example

* enable syntax highlighting for Cargo example
2019-11-05 11:03:56 -05:00
Josh Gross
f66a56e59e
Bump version to v1 (#51) 2019-11-04 16:40:33 -05:00
Linda_pp
57f889e86e Add cargo example for Rust project (#8)
* Add cargo example

* Add hash of Cargo.lock to keys of caches

* Move Rust example to examples.md
2019-11-04 10:15:02 -05:00
Ishizaka Tomoya
8c4c641fa0 Add Elixir Mix example (#42)
* Add Elixir Mix example

* Fix typo
2019-11-03 22:44:06 -05:00
CrazyMax
87c0185d27 Add Go modules example (#18)
* Add Go modules example

* Fix TOC
2019-11-01 15:27:43 -04:00
Zach Renner
287ee0671b Add trailing dash to Maven fallback key (#19) 2019-10-31 15:08:09 -04:00
Zach Renner
c401b561b2 Link to NuGet lock files documentation (#20) 2019-10-31 15:06:47 -04:00
Josh Gross
3743276c66
Move examples to their own page (#13) 2019-10-31 11:36:50 -04:00