diff --git a/java/gradle/wrapper/gradle-wrapper.properties b/java/gradle/wrapper/gradle-wrapper.properties index 0aaefbc..df97d72 100644 --- a/java/gradle/wrapper/gradle-wrapper.properties +++ b/java/gradle/wrapper/gradle-wrapper.properties @@ -1,6 +1,6 @@ distributionBase=GRADLE_USER_HOME distributionPath=wrapper/dists -distributionUrl=https\://services.gradle.org/distributions/gradle-8.10.1-bin.zip +distributionUrl=https\://services.gradle.org/distributions/gradle-8.10.2-bin.zip networkTimeout=10000 validateDistributionUrl=true zipStoreBase=GRADLE_USER_HOME diff --git a/java/pom.xml b/java/pom.xml index f470ba5..cb14062 100644 --- a/java/pom.xml +++ b/java/pom.xml @@ -51,7 +51,7 @@ com.approvaltests approvaltests - 24.4.0 + 24.6.0 test --> diff --git a/typescript/GETTING_STARTED.md b/typescript/GETTING_STARTED.md index be64c43..f6b9f2e 100644 --- a/typescript/GETTING_STARTED.md +++ b/typescript/GETTING_STARTED.md @@ -29,9 +29,11 @@ cd Kata-PascalTriangle/typescript ### 3 - Download dependencies -The kata uses `corepack` when configuring `yarn` as -the package manager to be used. You may need to run the -following command beforehand to enable it: +The kata uses `corepack` when configuring `yarn` as the package manager to be used. +You may need to run the following command beforehand to enable it: + +> ***Note***: depending on your environment you may need to run this command +> as an administrator (Windows) or with sudo (Linux and macOS) ```shell corepack enable @@ -49,19 +51,25 @@ You can run the kata from the command line or from your IDE of choice. You may also run it using [TCR](../tcr/TCR.md) if you want to add a bit of spice. -- [From a terminal with Yarn](#running-the-kata-from-a-terminal-with-yarn) +- [From a terminal](#running-the-kata-from-a-terminal) - [From a terminal with TCR](#running-the-kata-from-a-terminal-with-tcr) +- [From WebStorm](#running-the-kata-from-webstorm) +- [From WebStorm with TCR](#running-the-kata-from-webstorm-with-tcr) +- [From IntelliJ](#running-the-kata-from-intellij) +- [From IntelliJ with TCR](#running-the-kata-from-intellij-with-tcr) +- [From Visual Studio Code](#running-the-kata-from-visual-studio-code) +- [From Visual Studio Code with TCR](#running-the-kata-from-visual-studio-code-with-tcr) - + -### Running the kata from a terminal with Yarn +### Running the kata from a terminal > ***Reminder***: the command below should be run from [Kata-PascalTriangle/typescript](.) directory -The kata comes with a Yarn test target pre-configured. Just type the following to run it. +To run the tests: ```shell -yarn test +yarn jest ``` @@ -69,7 +77,7 @@ yarn test ### Running the kata from a terminal with TCR > ***Note to Windows users*** -> +> > Use a **git bash** terminal for running the command below. > _Windows CMD and PowerShell are not supported_ @@ -81,6 +89,222 @@ Type the following to start TCR: Refer to [Using TCR](#using-tcr) section for additional details about TCR and available options. + + +### Running the kata from WebStorm + +Open WebStorm and select: + +`File` > `Open` > `Kata-PascalTriangle` > `typescript` + +Run all the tests in the project. + +The "**Run**" tool window should display all the executed tests. + + + +### Running the kata from WebStorm with TCR + +TCR is provided as a command line utility running in a terminal. +You can run it from WebStorm directly, through leveraging on its built-in terminal. + +#### 1. Open the kata + +Open WebStorm and select: + +`File` > `Open` > `Kata-PascalTriangle` > `typescript` + +#### 2. Turn off auto-save + +TCR is constantly watching the filesystem for changes. +For this reason you need to turn off WebStorm's auto-save in order for it to behave as expected. + +`File` > `Settings` > `Appearance & Behavior` > `System Settings` + +Under `Autosave` section, uncheck the 2 following options: + +- [ ] Save files if the IDE is idle for ___ seconds +- [ ] Save files when switching to a different application or a built-in terminal + +#### 3. Configure the built-in terminal to run git bash + +> ***Windows Only*** +> +> Skip this step if you're on macOS or Linux + +WebStorm for Windows is usually set up to run PowerShell by default in its built-in terminal. +TCR does not run in PowerShell. + +`File` > `Settings` > `Tools` > `Terminal` + +Under `Application Settings` section, set the `Shell path` to `C:\Program Files\Git\bin\bash.exe` + +The above path is for a default git installation location. You may need to adjust it in case you have installed git at a +different location. + +#### 4. Open a built-in terminal + +`View` > `Tool Windows` > `Terminal` + +#### 5. Launch TCR + +> ***Reminder***: the command below should be run from [Kata-PascalTriangle/typescript](.) directory + +From the built-in terminal: + +```shell +./tcrw +``` + +Refer to [Using TCR](#using-tcr) section for additional details about TCR and available options. + + + +### Running the kata from IntelliJ + +> ***Important***: This requires to have `IntelliJ IDEA Ultimate` edition. +> +> IntelliJ's Javascript and Typescript plugin is not available with the Community edition. +> You can still use it as an editor for Typescript files, but you will not +> be able to use the benefits brought by the Javascript and Typescript plugin, such as syntax highlighting, +> code refactoring or integration with IntelliJ's test navigator. + +Open IntelliJ and select: + +`File` > `Open` > `Kata-PascalTriangle` > `typescript` + +Run all the tests in the project. + +The "**Run**" tool window should display all the executed tests. + + + +### Running the kata from IntelliJ with TCR + +> ***Important***: This requires to have `IntelliJ IDEA Ultimate` edition. +> +> IntelliJ's Javascript and Typescript plugin is not available with the Community edition. +> You can still use it as an editor for Typescript files, but you will not +> be able to use the benefits brought by the Javascript and Typescript plugin, such as syntax highlighting, +> code refactoring or integration with IntelliJ's test navigator. + +TCR is provided as a command line utility running in a terminal. +You can run it from IntelliJ directly, through leveraging on its built-in terminal. + +#### 1. Open the kata + +Open IntelliJ and select: + +`File` > `Open` > `Kata-PascalTriangle` > `typescript` + +#### 2. Turn off auto-save + +TCR is constantly watching the filesystem for changes. +For this reason you need to turn off IntelliJ's auto-save in order for it to behave as expected. + +`File` > `Settings` > `Appearance & Behavior` > `System Settings` + +Under `Autosave` section, uncheck the 2 following options: + +- [ ] Save files if the IDE is idle for ___ seconds +- [ ] Save files when switching to a different application or a built-in terminal + +#### 3. Configure the built-in terminal to run git bash + +> ***Windows Only*** +> +> Skip this step if you're on macOS or Linux + +IntelliJ for Windows is usually set up to run PowerShell by default in its built-in terminal. +TCR does not run in PowerShell. + +`File` > `Settings` > `Tools` > `Terminal` + +Under `Application Settings` section, set the `Shell path` to `C:\Program Files\Git\bin\bash.exe` + +The above path is for a default git installation location. You may need to adjust it in case you have installed git at a +different location. + +#### 4. Open a built-in terminal + +`View` > `Tool Windows` > `Terminal` + +#### 5. Launch TCR + +> ***Reminder***: the command below should be run from [Kata-PascalTriangle/typescript](.) directory + +From the built-in terminal: + +```shell +./tcrw +``` + +Refer to [Using TCR](#using-tcr) section for additional details about TCR and available options. + + + +### Running the kata from Visual Studio Code + +Open Visual Studio Code, choose `Open Folder`, navigate to `Kata-PascalTriangle` / `typescript` +then click `Select Folder`. + +In order to run the tests, select `View` > `Testing`, then click on the `Play` button. + + + +### Running the kata from Visual Studio Code with TCR + +TCR is provided as a command line utility running in a terminal. +You can run it from Visual Studio Code directly, through leveraging on its built-in terminal. + +#### 1. Open the kata + +Open Visual Studio Code, choose `Open Folder`, navigate to `Kata-PascalTriangle` / `typescript` +then click `Select Folder`. + +#### 2. Turn off auto-save + +TCR is constantly watching the filesystem for changes. +For this reason you need to make sure that Visual Studio Code's auto-save is turned off +in order for TCR to behave as expected. + +`File` > `Preferences` > `Settings` + +In `Text Editor` > `Files` section, make sure that `Auto Save` setting is set to `off` + +#### 3. Configure the built-in terminal to run git bash + +> ***Windows Only*** +> +> Skip this step if you're on macOS or Linux + +Visual Studio Code for Windows is usually set up to run PowerShell by default in its built-in terminal. +TCR does not run in PowerShell. + +`File` > `Preferences` > `Settings` + +In `Features` > `Terminal` section, set `External: Windows Exec` +to `C:\Program Files\Git\bin\bash.exe` + +The above path is for a default git installation location. You may need to adjust it in case you have installed git at a +different location. + +#### 4. Open a built-in terminal + +`Terminal` > `New Terminal` + +#### 5. Launch TCR + +> ***Reminder***: the command below should be run from [Kata-PascalTriangle/typescript](.) directory + +From the built-in terminal: + +```shell +./tcrw +``` + +Refer to [Using TCR](#using-tcr) section for additional details about TCR and available options. + ## Using TCR diff --git a/typescript/package.json b/typescript/package.json index 4f4aaff..cab8c7e 100644 --- a/typescript/package.json +++ b/typescript/package.json @@ -17,5 +17,5 @@ "jest-junit": { "outputDirectory": "./test_results" }, - "packageManager": "yarn@4.4.1" + "packageManager": "yarn@4.5.0" } diff --git a/typescript/yarn.lock b/typescript/yarn.lock index 0c0bd83..0153d62 100644 --- a/typescript/yarn.lock +++ b/typescript/yarn.lock @@ -852,11 +852,11 @@ __metadata: linkType: hard "@types/node@npm:*": - version: 22.5.4 - resolution: "@types/node@npm:22.5.4" + version: 22.6.1 + resolution: "@types/node@npm:22.6.1" dependencies: undici-types: "npm:~6.19.2" - checksum: 10c0/b445daa7eecd761ad4d778b882d6ff7bcc3b4baad2086ea9804db7c5d4a4ab0298b00d7f5315fc640a73b5a1d52bbf9628e09c9fec0cf44dbf9b4df674a8717d + checksum: 10c0/79fdb14f268070eb21d25f3e81811b73c10dfcc65a638a6546fd97aa3e7dfe473f31a547fd21c43b8559a435b6ab26057066a47b5453bd1b1cdffe14430ac399 languageName: node linkType: hard @@ -1185,9 +1185,9 @@ __metadata: linkType: hard "caniuse-lite@npm:^1.0.30001646": - version: 1.0.30001660 - resolution: "caniuse-lite@npm:1.0.30001660" - checksum: 10c0/d28900b56c597176d515c3175ca75c454f2d30cb2c09a44d7bdb009bb0c4d8a2557905adb77642889bbe9feb85fbfe9d974c8b8e53521fb4b50ee16ab246104e + version: 1.0.30001663 + resolution: "caniuse-lite@npm:1.0.30001663" + checksum: 10c0/6508e27bf7fdec657f26f318b1ab64ace6e1208ef9fedaf0975bc89046e0c683bfba837f108840ada1686ff09b8ffd01e05ac791dcf598b8f16eefb636875cf2 languageName: node linkType: hard @@ -1410,9 +1410,9 @@ __metadata: linkType: hard "electron-to-chromium@npm:^1.5.4": - version: 1.5.20 - resolution: "electron-to-chromium@npm:1.5.20" - checksum: 10c0/d119ccebcb415dc6341072b4a2bd0c9052d94eccf93776d47f5781b9c28393407f9e30718380ee59cb2a280db6b2e36943ffe4a7cdac9e432246380a24f48fa1 + version: 1.5.28 + resolution: "electron-to-chromium@npm:1.5.28" + checksum: 10c0/6e2f4150ba03ce53ca128955c7d2da071d3774362a10c68848a85b71c29857915e2256cb53cd2de17fdbf0f56bf76ec174d24965abef7430d8c414ec733030b2 languageName: node linkType: hard