https://github.com/baeldung/scala-tutorials
https://github.com/baeldung/scala-tutorials
Last synced: about 1 month ago
JSON representation
- Host: GitHub
- URL: https://github.com/baeldung/scala-tutorials
- Owner: Baeldung
- License: mit
- Created: 2019-11-30T20:17:15.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2024-04-11T22:44:46.000Z (about 1 year ago)
- Last Synced: 2024-04-12T05:55:38.904Z (about 1 year ago)
- Language: Scala
- Size: 3.29 MB
- Stars: 313
- Watchers: 25
- Forks: 204
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://scala-steward.org)
# scala-tutorials
This is the main repo for all the sample code used in the scala tutorials.
# Pre-requisites
Suggested JDK version : JDK 17
# Compiling and Running Tests
This repo uses a multi-module build with many sub modules.
To compile the entire module, you may use the command `sbt compile`. However, this loads all the modules and compiles all of them, which might take some time.
If you are interested in only a particular module, you can compile it by starting sbt shell and using the command `/compile`.
Similarly, you can run the tests per module as `/test`.
Here are some of the useful commands that can be used within tbe sbt shell
| SBT Command | Description | Example |
|-----------------------------|-------------------------------------------------------------------------------------------------------|--------------------|
| `project ` | Switch to a particular module. After this, the command `compile`, `test` etc runs only on that module | project scala_core |
| `/compile` | Compile only the provided module | scala_core/compile |
| `projects` | Lists all the sub modules | |
| `/run` | Run the main class within the sub-module | scala_core/run |
**Note: The project name may not be same as directory name. Instead, it is the `lay val` variable used to define each module**
# Test Naming Standards
In this repository, we have classified the tests in 4 categories.
| Category | Description |
| -- |---------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Unit Tests | Smallest unit of testing, that are not dependent on external tools or services |
| Integration Tests | IntegrationTests means those tests that use some automatic setup within our environment like in-memory Mongo, h2 database etc which don't need explicit setup |
| Live Tests | Tests that depends on some external services (like httpbin.org, or some internet-based links) or require a running component (eg: starting a Spring Boot application) |
| Manual Tests | The tests where we need to set up an environment explicitly(for e.g. docker), without which the tests can't be run |
Here is a table describing about the different categories of tests and how they can be executed in this project.
Note that these commands are defined at the root level of the project and hence are accessible only from the root project(not directly within each submodule).
| Category | Sbt command | Test class location | Test class name format |
|-------------------------|-------------------|----------------------------------------|-------------------------------------------------------------------------------------------------------------------------|
| Unit Tests | `sbt ci` | `src/test/scala` or `src/test/scala-2` | No particular format restriction, but as a standard, filename ends with `Test` |
| Integration Test (Only) | `sbt integrationTests` | `src/it/scala` or `src/it/scala-2` | No format restriction, but as a standard, filename ends with `IntegrationTest` |
| Unit & Integration Test | `sbt ciFull` | `src/it/scala` or `src/it/scala-2` | No format restriction, but as a standard, filename ends with `IntegrationTest`. These exclude manual and live tests |
| Live Test | `sbt liveTests` | `src/it/scala` or `src/it/scala-2` | Test class name must end with `LiveTest` |
| Manual Test | `sbt manualTests` | `src/it/scala` or `src/it/scala-2` | Test class name must end with `ManualTest` |
# Code formatting
Before creating a PR, run `sbt scalafmtAll` to automatically format the entire codebase. To check if there are any formatting issues(without fixing them), you may run `sbt scalafmtCheckAll`