From fa0eacda380ec403af0db6a19ebf368e92144d41 Mon Sep 17 00:00:00 2001 From: Olga Naumenko <64418523+olganaumenko@users.noreply.github.com> Date: Fri, 19 Aug 2022 09:42:57 +0300 Subject: [PATCH 1/2] SysReq and minor updates to README added --- README.md | 45 ++++++++++++++++++++++++------------------- SystemRequirements.md | 11 +++++++++++ 2 files changed, 36 insertions(+), 20 deletions(-) create mode 100644 SystemRequirements.md diff --git a/README.md b/README.md index e316ca62a5..a7ee463b78 100644 --- a/README.md +++ b/README.md @@ -1,32 +1,37 @@ -[![UTBot Java: build and run tests](https://github.com/UnitTestBot/UTBotJava/actions/workflows/build-and-run-tests.yml/badge.svg)](https://github.com/UnitTestBot/UTBotJava/actions/workflows/build-and-run-tests.yml) +[![UnitTestBot: build and run tests](https://github.com/UnitTestBot/UTBotJava/actions/workflows/build-and-run-tests.yml/badge.svg)](https://github.com/UnitTestBot/UTBotJava/actions/workflows/build-and-run-tests.yml) [![Plugin and CLI: publish as archives](https://github.com/UnitTestBot/UTBotJava/actions/workflows/publish-plugin-and-cli.yml/badge.svg)](https://github.com/UnitTestBot/UTBotJava/actions/workflows/publish-plugin-and-cli.yml) -👉 Find UTBot Java on [JetBrains Marketplace](https://plugins.jetbrains.com/plugin/19445-unittestbot). +👉 Find UnitTestBot on [JetBrains Marketplace](https://plugins.jetbrains.com/plugin/19445-unittestbot). -👉 Visit the [official UTBot website](https://www.utbot.org/). +👉 Visit the [official UnitTestBot website](https://www.utbot.org/). -# What is UTBot Java? -UTBot Java is the tool for **automated unit test generation**. It produces ready-to-use test cases for Java — with valid inputs and comments. It can even predict whether the tests fail or pass. You can analyze them, run them, show coverage — as if you've created them personally. +# What is UnitTestBot? +UnitTestBot is the tool for **automated unit test generation** and **precise code analysis**. It produces ready-to-use +test +cases for +Java — with +valid inputs and comments. It can even predict whether the tests fail or pass. You can analyze them, run them, show coverage — as if you've created them personally. -The **symbolic execution engine** paired with a **smart fuzzing technique** constitutes the core of UTBot Java. It helps to **find errors** and **prevent regressions** in the code in a much more efficient way — UTBot Java **maximizes path coverage** while **minimizing the number of tests and false positives**. +The **symbolic execution engine** paired with a **smart fuzzing technique** constitutes the core of UnitTestBot. It helps to **find errors** and **prevent regressions** in the code in a much more efficient way — UnitTestBot **maximizes path coverage** while **minimizing the number of tests and false positives**. -UTBot Java represents all the test summaries in a **human-readable format**. The intelligible test method names and comments help you to control the whole testing process. Test failed? The summary refers you to the related branch or the condition under test. +UnitTestBot represents all the test summaries in a **human-readable format**. The intelligible test method names and comments help you to control the whole testing process. Test failed? The summary refers you to the related branch or the condition under test. # Get started Try the **[online demo](https://www.utbot.org/utbot/)** to generate unit tests with one click. -Get to know the **full version** of UTBot Java plugin with this quick guide: +Get to know the **full version** of UnitTestBot plugin with this quick guide:
- Install UTBot Java plugin for IntelliJ IDEA + Install UnitTestBot plugin for IntelliJ IDEA -Try the most straightforward path to start using UTBot plugin. -1. Open your IntelliJ IDEA. If you don't have one, get it from [JetBrains](https://www.jetbrains.com/idea/download/#section=windows). -2. Go to **File → Settings... → Plugins → Marketplace**. -3. In the search field type *UTBot* — you'll see the UnitTestBot plugin page. -4. Press the **Install** button and wait until it changes to **Installed**, then click **OK**. +Try the most straightforward path to start using UnitTestBot plugin. +1. Please check the [system requirements](SystemRequirements.md). +2. Open your IntelliJ IDEA. +3. Go to **File → Settings... → Plugins → Marketplace**. +4. In the search field type *UnitTestBot* — you'll see the UnitTestBot plugin page. +5. Press the **Install** button and wait until it changes to **Installed**, then click **OK**. -Now you can find the UTBot plugin enabled in the **File → Settings → Plugins** window. +Now you can find the UnitTestBot plugin enabled in the **File → Settings → Plugins** window. ____________
@@ -73,8 +78,8 @@ Right-click the test class, choose **More Run/Debug → Run ... with Coverage**. ____________ -# Contribute to UTBot Java -UTBot Java is an open source project. We welcome everyone who wants to make UTBot Java better — introduce a new feature or report a bug. We have only one kind request for our contributors: we expect you to prove the necessity and quality of the suggested changes. +# Contribute to UnitTestBot +UnitTestBot is an open source project. We welcome everyone who wants to make UnitTestBot better — introduce a new feature or report a bug. We have only one kind request for our contributors: we expect you to prove the necessity and quality of the suggested changes. How can you do this? Refer to our [Contributing guide](https://github.com/UnitTestBot/UTBotJava/blob/main/CONTRIBUTING.md). @@ -83,9 +88,9 @@ Feel free to join the [Discussions](https://github.com/UnitTestBot/UTBotJava/dis And thank you for your time and effort! ⭐ # Find support -Having troubles with using UTBot Java? Contact us [directly](https://www.utbot.org/contact). +Having troubles with using UnitTestBot? Contact us [directly](https://www.utbot.org/contact). -# Find more UTBot products -[UTBot Cpp](https://github.com/UnitTestBot/UTBotCpp) — try it yourself and tell your friends: it is the tool for automated unit test generation developed especially for C/C++. +# Find more UnitTestBot products +You can also try [UnitTestBot](https://github.com/UnitTestBot/UTBotCpp) developed especially for C/C++. You are welcome to [contribute](https://github.com/UnitTestBot/UTBotCpp/blob/main/CONTRIBUTING.md) to it too! diff --git a/SystemRequirements.md b/SystemRequirements.md new file mode 100644 index 0000000000..b604544008 --- /dev/null +++ b/SystemRequirements.md @@ -0,0 +1,11 @@ +# System requirements + +Before starting to work with UnitTestBot please check if that your system satisfies the following requirements. + +* JDK 8—11 is installed. + +* IntelliJ IDEA from 2020.2 to 2022.1.4 is installed. + +* JAVA_HOME environment variable contains the correct path to the necessary JDK installation directory (JDK 8—11). + +* PATH environment variable contains the path to the bin folder of the same JDK installation directory. \ No newline at end of file From 99307da4be3b40080cf005055f795889a9ad6946 Mon Sep 17 00:00:00 2001 From: Olga Naumenko <64418523+olganaumenko@users.noreply.github.com> Date: Thu, 25 Aug 2022 16:47:35 +0300 Subject: [PATCH 2/2] SysReq: for users and devs separately --- SystemRequirements.md | 27 ++++++++++++++++++++++----- 1 file changed, 22 insertions(+), 5 deletions(-) diff --git a/SystemRequirements.md b/SystemRequirements.md index b604544008..c43e59778d 100644 --- a/SystemRequirements.md +++ b/SystemRequirements.md @@ -1,11 +1,28 @@ # System requirements -Before starting to work with UnitTestBot please check if that your system satisfies the following requirements. +--- -* JDK 8—11 is installed. +### To generate tests with UnitTestBot: -* IntelliJ IDEA from 2020.2 to 2022.1.4 is installed. +you have to install IntelliJ IDEA (versions from 2022.1 to 2022.1.4 are supported). -* JAVA_HOME environment variable contains the correct path to the necessary JDK installation directory (JDK 8—11). +### To contribute to UnitTestBot: -* PATH environment variable contains the path to the bin folder of the same JDK installation directory. \ No newline at end of file +you have to install + +- IntelliJ IDEA (versions from 2022.1 to 2022.1.4 are supported); + +- JDK 11; + +- Kotlin 1.7.0 or later; + +you also have to check if + +- ```JAVA_HOME``` environment variable contains the path to JDK 11 installation directory; + +- ```PATH``` environment variable contains the path to the ```bin``` folder of JDK 11 installation directory; + +- ```KOTLIN_HOME``` environment variable contains the path to the ```kotlinc``` folder of Kotlin (1.7.0 or later) installation + directory. + +Please note: if the environment variables lead to unsupported JDK or Kotlin versions, you won't be able to build the UnitTestBot project.