|
2 | 2 |
|
3 | 3 | ## Machine Setup (Mac)
|
4 | 4 |
|
5 |
| -- [ ] Docker for Mac |
6 |
| -- [ ] XCode or command-line tools for Xcode or however Mac OS does this in the future (installs git too) |
7 |
| -- [ ] Git setup - prob SSL key/cert, username, etc. |
8 |
| -- [ ] NVM |
9 |
| -- [ ] Node through NVM |
10 |
| -- [ ] Text Editor / IDE |
| 5 | +- [ ] [Docker for Mac](https://docs.docker.com/desktop/install/mac-install/) |
| 6 | +- [ ] [Homebrew](https://brew.sh/) (`/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)`) |
| 7 | +- [ ] XCode (`xcode-select --install`) or command-line tools for XCode or however Mac OS does this in the future |
| 8 | +- [ ] Git setup: `brew install git`, then SSL key/certificate, username, etc. ([SSH help](https://docs.github.com/en/enterprise/2.15/user/articles/adding-a-new-ssh-key-to-your-github-account)) |
| 9 | +- [ ] NVM (`curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash`, check [here](https://github.com/nvm-sh/nvm) for latest version) |
| 10 | +- [ ] [Node though NVM](https://nodejs.org/en/download/package-manager) (`nvm install 20`, or latest version instead of 20) |
11 | 11 | - [ ] `brew install postgresql` (c library required for pg-native tests)
|
12 |
| -- [ ] Swap OpenSSL (if necessary) |
| 12 | +- [ ] Text Editor / IDE |
| 13 | +- [ ] Swap OpenSSL (if necessary, see below) |
13 | 14 |
|
14 | 15 | ### Swapping OpenSSL for LibreSSL
|
15 | 16 |
|
16 | 17 | LibreSSL doesn’t seem to work w/ our make/tests that rely on OpenSSL functionality.
|
17 | 18 |
|
18 | 19 | To fix:
|
19 | 20 |
|
20 |
| -1. Install openssl via homebrew (brew install) |
21 |
| -2. Execute brew info openssl |
| 21 | +1. Install openssl via homebrew (`brew install openssl`) |
| 22 | +2. Execute `brew info openssl` |
22 | 23 | 3. Copy/Paste instructions for "If you need to have this software first in your PATH run:..." section.
|
23 | 24 |
|
24 | 25 | ## How We Work
|
@@ -51,12 +52,12 @@ a set of "versioned" integration style tests. See the [package.json](../package.
|
51 | 52 | for the full set of scripts, but a short list of common scenarios is:
|
52 | 53 |
|
53 | 54 | + `npm run versioned:internal` - to run all versioned tests across all supported
|
54 |
| -versions of each instrumented module. |
| 55 | + versions of each instrumented module. |
55 | 56 | + `npm run versioned:internal:major` - to run all versioned tests for each
|
56 |
| -current major release of each instrumented module. |
| 57 | + current major release of each instrumented module. |
57 | 58 | + `npm run versioned:internal:major foo` - to run a specific versioned test
|
58 |
| -for the latest major version of the instrumented module named "foo" (as an |
59 |
| -example). |
| 59 | + for the latest major version of the instrumented module named "foo" (as an |
| 60 | + example). |
60 | 61 |
|
61 | 62 | Note: when running the versioned test suite on a macOS system, the application
|
62 | 63 | firewall is likely to issue multiple requests to authorize the `node` binary
|
|
0 commit comments