Skip to content

Latest commit

 

History

History
181 lines (132 loc) · 9.5 KB

README.md

File metadata and controls

181 lines (132 loc) · 9.5 KB

Codely logo

🧬🌱 Codely Scala Basic Skeleton (powered by Giter 8)

Codely Open Source Codely Pro Courses License GitHub Repo stars Continuous Integration status

Template for bootstrapping your new Scala project following idiomatic best practices powered by Giter 8.

💡 Related resources | 🌟 Repository Stargazers

🚀 How to use

Run the following command and you're ready to go:

sbt new codelytv/scala-basic-skeleton.g8

You can now move to your project's directory, enter the SBT shell with the sbt command, and run the tests with test or t.

Project creation wizard

It will ask for some parameters like your desired project name or the organization to customize the generated project package name.

It will also ask for the version of some dependencies such as Scala (the language itself), SBT, or ScalaTest. If you do not know which version to choose for any of these dependencies, just go with the default one. These suggestions are dynamically generated based on the latest stable version available in Maven at the moment of creating your project 😊🤟

Pre-requisites

You only need the common tooling used for developing Scala applications:

Installing instructions for macOS with SDKMAN!

If you use macOS, we would recommend using SDKMAN! to manage different JDK versions and tooling:

  1. Install SDKMAN with homebrew
  2. Install the JDK you prefer. If you ask us, we will opt for:
    1. Check the latest Java LTS JDK version
    2. Check the latest Zulu distribution version for that LTS with:
      sdk list java
    3. Install it:
      sdk install java XX.YY.ZZ-zulu
  3. Install the latest SBT:
    sdk install sbt

💎 Features

  • Permissive LICENSE: Allow using projects created with this template for commercial and private purposes.
  • Continuous Integration for the template: Use GitHub Actions to validate every commit merging to main to guarantee correctness.
  • Complete README.md example: Include badges for CI status and other fancy stuff.
  • Latest versions of Scala, SBT and ScalaTest. Always: They are dynamically suggested based on the latest stable version available while creating your project.
  • Minimum dependencies: Just the most common for starting up, and you can delete them in your build.sbt once the project has been created:
    • ScalaTest: Test runner.
    • ScalaMock: Test doubles generator.
    • nscala-time: Commonly used library wrapping Joda Time offering a Scala-friendly API like: 2.hours + 45.minutes.
    • pprint: Much better than System.out.println(x.toString).
  • Other ecosystem tools already configured to follow idiomatic best practices:
  • Opinions:
    • Configured to avoid the scala/ default subdirectory because we don't want to split source code by programming language. That is, instead of having the src/main/scala/ and src/test/scala/ folders you will be able to code right in src/main/ and src/test/ ones.
    • .gitignore: Avoid including particular ignore rules for any specific IDE or OS. They must be included in your global Git config saving that noise from the project-specific rules.
    • Include SBT aliases for common tasks. You will be able to run your tests with t, compile with c, or run all the tasks needed to execute before doing a Git push (compile source and test, and check source and test code style) with prep

🤽‍ Pre-push Git hook

There's one Git hook included. It's inside the doc/hooks folder, and it will run the prep SBT task before pushing to any remote.

This prep task is intended to run all the checks you consider before pushing. At this very moment, it tries to compile and check the code style rules with ScalaFmt.

You can define what this task does by modifying the prep task in the build.sbt file. We like the approach of just having to run 1 single SBT task instead of multiple tasks because it's more efficient (the hook doesn't have to create multiple SBT sessions), and also because this way we can control the pre push tasks with the SBT alias defined at the build.sbt without altering the hooks.

If you want to install this hook, just cd doc/hooks and run ./install-hooks.sh.

💡 Related resources

🧑‍🎓 Related learning resources

🧑‍💻 Related skeleton repositories

🧬 Scala repositories

♨️ Java

🟪 Kotlin

🦈 C#

🟨 JavaScript

🔷 TypeScript

🐘 PHP

⚖️ License

See LICENSE.

🤝 Contributing

See CONTRIBUTING.md.

🤔 About

This hopefully helpful resource has been developed by Codely and contributors.

If you appreciate this contribution and want to show some support to our Open Source contributions, you have several options: