Upgrade to Pants 2.15.0 and use scie-pants. (#122)

Author: benjyw

.github/workflows/pants.yaml

@@ -24,14 +24,16 @@ jobs:
         python-version: [3.9]
     steps:
     - uses: actions/checkout@v3
-    - uses: pantsbuild/actions/init-pants@v2
+    - uses: actions/setup-python@v4
+      with:
+        python-version: ${{ matrix.python-version }}
+    - uses: pantsbuild/actions/init-pants@v4-scie-pants
       # This action bootstraps pants and manages 2-3 GHA caches.
       # See: github.com/pantsbuild/actions/tree/main/init-pants/
       with:
-        pants-python-version: ${{ matrix.python-version }}
-        # cache0 makes it easy to bust the cache if needed
+        # v0 makes it easy to bust the cache if needed
         # just increase the integer to start with a fresh cache
-        gha-cache-key: cache0-py${{ matrix.python-version }}
+        gha-cache-key: v0
         # The Python backend uses named_caches for Pip/PEX state,
         # so it is appropriate to invalidate on lockfile changes.
         named-caches-hash: ${{ hashFiles('python-default.lock') }}
@@ -47,18 +49,18 @@ jobs:
         # Alternatively you change gha-cache-key to ignore old caches.
     - name: Check BUILD files
       run:  |
-        ./pants tailor --check update-build-files --check ::
+        pants tailor --check update-build-files --check ::
     - name: Lint and typecheck
       run: | 
-        ./pants lint check ::
+        pants lint check ::
     - name: Test
       run: |
-        ./pants test ::
+        pants test ::
     - name: Package / Run
       run: |
         # We also smoke test that our release process will work by running `package`.
-        ./pants package ::
-        ./pants run helloworld/main.py
+        pants package ::
+        pants run helloworld/main.py
     - name: Upload pants log
       uses: actions/upload-artifact@v3
       with:

README.md

@@ -9,22 +9,24 @@ example layouts.
 
 # Running Pants
 
-You run Pants goals using the `./pants` wrapper script, which will bootstrap the
-configured version of Pants if necessary.
+You run Pants goals using the `pants` launcher binary, which will bootstrap the
+version of Pants configured for this repo if necessary.
 
-> :question: Running with Apple Silicon and/or MacOS? You will want to make changes to the `search_path` and
-`interpreter_constraints` values in `pants.toml` before running `./pants` - there is guidance in `pants.toml`
+See [here](https://www.pantsbuild.org/docs/installation) for how to install the `pants` binary.
+
+> :question: Running with Apple Silicon and/or macOS? You will want to make changes to the `search_path` and
+`interpreter_constraints` values in `pants.toml` before running `pants` - there is guidance in `pants.toml`
 for those settings.
 
-Use `./pants --version` to see the version of Pants configured for the repo (which you can also find
+Use `pants --version` to see the version of Pants configured for the repo (which you can also find
 in `pants.toml`).
 
 # Goals
 
 Pants commands are called _goals_. You can get a list of goals with
 
 ```
-./pants help goals
+pants help goals
 ```
 
 # Targets
@@ -41,52 +43,52 @@ In the latter case, Pants locates target metadata for the source files as needed
 Invoking goals on files is straightforward, e.g.,
 
 ```
-./pants test helloworld/greet/greeting_test.py
+pants test helloworld/greet/greeting_test.py
 ```
 
 You can use globs:
 
 ```
-./pants lint helloworld/greet/*.py
+pants lint helloworld/greet/*.py
 ```
 
 But note that these will be expanded by your shell, so this is equivalent to having used
 
 ```
-./pants lint helloworld/greet/__init__.py helloworld/greet/greeting.py helloworld/greet/greeting_test.py
+pants lint helloworld/greet/__init__.py helloworld/greet/greeting.py helloworld/greet/greeting_test.py
 ```
 
 If you want Pants itself to expand the globs (which is sometimes necessary), you must quote them in the shell:
 
 ```
-./pants lint 'helloworld/greet/*.py'
+pants lint 'helloworld/greet/*.py'
 ```
 
 You can run on all changed files:
 
 ```
-./pants --changed-since=HEAD lint
+pants --changed-since=HEAD lint
 ```
 
 You can run on all changed files, and any of their "dependees":
 
 ```
-./pants --changed-since=HEAD --changed-dependees=transitive test
+pants --changed-since=HEAD --changed-dependees=transitive test
 ```
 
 ## Target specifications
 
 Targets are referenced on the command line using their address, of the form `path/to/dir:name`, e.g.,
 
 ```
-./pants lint helloworld/greet:lib
+pants lint helloworld/greet:lib
 ```
 
 You can glob over all targets in a directory with a single trailing `:`, or over all targets in a directory
 and all its subdirectories with a double trailing `::`, e.g.,
 
 ```
-./pants lint helloworld::
+pants lint helloworld::
 ```
 
 ## Globbing semantics
@@ -96,7 +98,7 @@ For example, if you run the `test` goal over a set of files that includes non-te
 those, rather than error. So you can safely do things like
 
 ```
-./pants test ::
+pants test ::
 ```
 
 To run all tests.
@@ -108,67 +110,67 @@ Try these out in this repo!
 ## List targets
 
 ```
-./pants list ::  # All targets.
-./pants list 'helloworld/**/*.py'  # Just targets containing Python code.
+pants list ::  # All targets.
+pants list 'helloworld/**/*.py'  # Just targets containing Python code.
 ```
 
 ## Run linters and formatters
 
 ```
-./pants lint ::
-./pants fmt helloworld/greet::
+pants lint ::
+pants fmt helloworld/greet::
 ```
 
 ## Run MyPy
 
 ```
-./pants check ::
+pants check ::
 ```
 
 ## Run tests
 
 ```
-./pants test ::  # Run all tests in the repo.
-./pants test --output=all ::  # Run all tests in the repo and view pytest output even for tests that passed (you can set this permanently in pants.toml).
-./pants test helloworld/translator:tests  # Run all the tests in this target.
-./pants test helloworld/translator/translator_test.py  # Run just the tests in this file.
-./pants test helloworld/translator/translator_test.py -- -k test_unknown_phrase  # Run just this one test by passing through pytest args.
+pants test ::  # Run all tests in the repo.
+pants test --output=all ::  # Run all tests in the repo and view pytest output even for tests that passed (you can set this permanently in pants.toml).
+pants test helloworld/translator:tests  # Run all the tests in this target.
+pants test helloworld/translator/translator_test.py  # Run just the tests in this file.
+pants test helloworld/translator/translator_test.py -- -k test_unknown_phrase  # Run just this one test by passing through pytest args.
 ```
 
 ## Create a PEX binary
 
 ```
-./pants package helloworld/main.py
+pants package helloworld/main.py
 ```
 
 ## Run a binary directly
 
 ```
-./pants run helloworld/main.py
+pants run helloworld/main.py
 ```
 
 ## Open a REPL
 
 ```
-./pants repl helloworld/greet:lib  # The REPL will have all relevant code and dependencies on its sys.path.
-./pants repl --shell=ipython helloworld/greet:lib --no-pantsd  # To use IPython, you must disable Pantsd for now.
+pants repl helloworld/greet:lib  # The REPL will have all relevant code and dependencies on its sys.path.
+pants repl --shell=ipython helloworld/greet:lib --no-pantsd  # To use IPython, you must disable Pantsd for now.
 ```
 
 ## Build a wheel / generate `setup.py`
 
 This will build both a `.whl` bdist and a `.tar.gz` sdist.
 
 ```
-./pants package helloworld/translator:dist
+pants package helloworld/translator:dist
 ```
 
 ## Count lines of code
 
 ```
-./pants count-loc '**/*'
+pants count-loc '**/*'
 ```
 ## Create virtualenv for IDE integration
 
 ```
-./pants export ::
+pants export ::
 ```

helloworld/BUILD

@@ -7,7 +7,7 @@ python_sources(
 )
 
 # This target allows us to bundle our app into a PEX binary file via
-#  `./pants package`. We can also run it with `./pants run`. See
+#  `pants package`. We can also run it with `pants run`. See
 #  https://www.pantsbuild.org/docs/python-package-goal and
 #  https://www.pantsbuild.org/docs/python-run-goal.
 pex_binary(