From bbe739ea397107ec0370d2f3f912d6655a6a6f83 Mon Sep 17 00:00:00 2001
From: Rowan Molony <rowan.molony@mainstreamrp.com>
Date: Fri, 17 Feb 2023 15:12:54 +0000
Subject: [PATCH] Add poetry example

---
 README.md   |  1 +
 examples.md | 96 +++++++++++++++++++++++++++++++----------------------
 2 files changed, 58 insertions(+), 39 deletions(-)

diff --git a/README.md b/README.md
index 35df207..fe62238 100644
--- a/README.md
+++ b/README.md
@@ -168,6 +168,7 @@ See [Examples](examples.md) for a list of `actions/cache` implementations for us
 * [PHP - Composer](./examples.md#php---composer)
 * [Python - pip](./examples.md#python---pip)
 * [Python - pipenv](./examples.md#python---pipenv)
+* [Python - poetry](./examples.md#python---poetry)
 * [R - renv](./examples.md#r---renv)
 * [Ruby - Bundler](./examples.md#ruby---bundler)
 * [Rust - Cargo](./examples.md#rust---cargo)
diff --git a/examples.md b/examples.md
index 05482ce..3e236c9 100644
--- a/examples.md
+++ b/examples.md
@@ -1,44 +1,51 @@
 # Examples
 
-- [C# - NuGet](#c---nuget)
-- [Clojure - Lein Deps](#clojure---lein-deps)
-- [D - DUB](#d---dub)
-  - [POSIX](#posix)
-  - [Windows](#windows)
-- [Deno](#deno)
-  - [Linux](#linux)
-  - [macOS](#macos)
-  - [Windows](#windows-1)
-- [Elixir - Mix](#elixir---mix)
-- [Erlang - Rebar3](#erlang--rebar3)
-- [Go - Modules](#go---modules)
-  - [Linux](#linux-1)
-  - [macOS](#macos-1)
-  - [Windows](#windows-2)
-- [Haskell - Cabal](#haskell---cabal)
-- [Haskell - Stack](#haskell---stack)
-- [Java - Gradle](#java---gradle)
-- [Java - Maven](#java---maven)
-- [Node - npm](#node---npm)
-- [Node - Lerna](#node---lerna)
-- [Node - Yarn](#node---yarn)
-- [Node - Yarn 2](#node---yarn-2)
-- [OCaml/Reason - esy](#ocamlreason---esy)
-- [PHP - Composer](#php---composer)
-- [Python - pip](#python---pip)
-  - [Simple example](#simple-example)
-  - [Multiple OS's in a workflow](#multiple-oss-in-a-workflow)
-  - [Multiple OS's in a workflow with a matrix](#multiple-oss-in-a-workflow-with-a-matrix)
-  - [Using pip to get cache location](#using-pip-to-get-cache-location)
-- [Python - pipenv](#python---pipenv)
-- [R - renv](#r---renv)
-- [Ruby - Bundler](#ruby---bundler)
-- [Rust - Cargo](#rust---cargo)
-- [Scala - SBT](#scala---sbt)
-- [Swift, Objective-C - Carthage](#swift-objective-c---carthage)
-- [Swift, Objective-C - CocoaPods](#swift-objective-c---cocoapods)
-- [Swift - Swift Package Manager](#swift---swift-package-manager)
-- [Swift - Mint](#swift---mint)
+- [Examples](#examples)
+  - [C# - NuGet](#c---nuget)
+  - [Clojure - Lein Deps](#clojure---lein-deps)
+  - [D - DUB](#d---dub)
+    - [POSIX](#posix)
+    - [Windows](#windows)
+  - [Deno](#deno)
+    - [Linux](#linux)
+    - [macOS](#macos)
+    - [Windows](#windows-1)
+  - [Elixir - Mix](#elixir---mix)
+  - [Erlang - Rebar3](#erlang---rebar3)
+  - [Go - Modules](#go---modules)
+    - [Linux](#linux-1)
+    - [macOS](#macos-1)
+    - [Windows](#windows-2)
+  - [Haskell - Cabal](#haskell---cabal)
+  - [Haskell - Stack](#haskell---stack)
+    - [Linux or macOS](#linux-or-macos)
+    - [Windows](#windows-3)
+  - [Java - Gradle](#java---gradle)
+  - [Java - Maven](#java---maven)
+  - [Node - npm](#node---npm)
+    - [**Get npm cache directory using same shell**](#get-npm-cache-directory-using-same-shell)
+    - [Bash shell](#bash-shell)
+    - [PWSH shell](#pwsh-shell)
+  - [Node - Lerna](#node---lerna)
+  - [Node - Yarn](#node---yarn)
+  - [Node - Yarn 2](#node---yarn-2)
+  - [OCaml/Reason - esy](#ocamlreason---esy)
+  - [PHP - Composer](#php---composer)
+  - [Python - pip](#python---pip)
+    - [Simple example](#simple-example)
+    - [Multiple OS's in a workflow](#multiple-oss-in-a-workflow)
+    - [Multiple OS's in a workflow with a matrix](#multiple-oss-in-a-workflow-with-a-matrix)
+    - [Using pip to get cache location](#using-pip-to-get-cache-location)
+  - [Python - pipenv](#python---pipenv)
+  - [Python - poetry](#python---poetry)
+  - [R - renv](#r---renv)
+  - [Ruby - Bundler](#ruby---bundler)
+  - [Rust - Cargo](#rust---cargo)
+  - [Scala - SBT](#scala---sbt)
+  - [Swift, Objective-C - Carthage](#swift-objective-c---carthage)
+  - [Swift, Objective-C - CocoaPods](#swift-objective-c---cocoapods)
+  - [Swift - Swift Package Manager](#swift---swift-package-manager)
+  - [Swift - Mint](#swift---mint)
 
 ## C# - NuGet
 
@@ -540,6 +547,17 @@ jobs:
     key: ${{ runner.os }}-python-${{ steps.setup-python.outputs.python-version }}-pipenv-${{ hashFiles('Pipfile.lock') }}
 ```
 
+## Python - poetry
+
+```yaml
+- uses: actions/cache@v3
+  with:
+    path: ~/.cache/pypoetry
+    key: ${{ runner.os }}-poetry-${{ hashFiles('**/poetry.lock') }}
+    restore-keys: |
+      ${{ runner.os }}-poetry-
+```
+
 ## R - renv
 
 For renv, the cache directory will vary by OS. The `RENV_PATHS_ROOT` environment variable is used to set the cache location. Have a look at https://rstudio.github.io/renv/reference/paths.html#details for more details.