codelytv / scala-basic-skeleton.g8

ƛ🚀 Starting point if you want to bootstrap a project in Scala

🚀 CodelyTV Scala Bootstrap (g8 template)

ℹ️ Introduction

This is a Giter8 template intended to serve as a starting point if you want to bootstrap a project in Scala.

It could be useful if you want to start a kata, a little exercise or project from scratch. The idea is that you don't have to worry about the boilerplate, just run sbt new codelytv/scala-basic-skeleton.g8 and you're ready to go:

• Latest versions of Scala, SBT and ScalaTest in order to practice with them
• Best practices applied:
  • README.md (badges included)
  • LICENSE
  • build.sbt
  • .scalafmt.conf
  • .gitignore
  • .editorconfig
  • .travis.yml

☝️ How To Start

Video screencast (in Spanish)

1. Install the JDK & SBT tools
2. Create your new project: sbt new codelytv/scala-basic-skeleton.g8
3. Set your project parameters. When you run the previous command, you'll be asked for the project parameters such as the Scala language version, the project name and package, and so on.
4. Move to your project folder and start coding! The template will leave you an example class just to get started quicker in the src/main directory (we avoid the scala default subdirectory because we don't want to split by programming language).
5. Done! 🎉🦄🌈

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

🤽‍ 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 try to compile and check the code style rules with ScalaFmt.

You can define what this task does modifying the prep task in the build.sbt file. We like the approach of just running 1 single SBT task as the hook instead of multiple tasks because it's more efficient (the hook doesn't have to run SBT multiple times), 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.

☕🐘 Other programming languages

• Java
• PHP
• Scala: This other skeleton is not based in the Gitter8 template system. So you can actually clone the repo and just start coding.

❓ About

This hopefully helpful utility has been developed by CodelyTV and contributors.

We'll try to maintain this project as simple as possible, but Pull Requests are welcome!

⚖️ License

The MIT License (MIT). Please see License File for more information.

scala-basic-skeleton.g8's Issues

Error generating template

There is an error with the Travis File

Doc folder disappears when doing sbt new

Expected: when I do sbt new codelytv/scala-bootstrap-template.g8, I expect a doc folder to be created with the hooks.

Actual: when I do sbt new codelytv/scala-bootstrap-template.g8, a doc folder is not created.

Steps to reproduce:

1. sbt new codelytv/scala-bootstrap-template.g8
2. accept defaults
3. cd scala-bootstrap
4. ls

Error using default versions

Hi!
I've tried to run this basic bootstrap skeleton given the default values but I get an error when doing sbt command:

[error] (Compile / compileIncremental) java.io.IOError: java.lang.RuntimeException: /packages cannot be represented as URI

Used entries:

sbt_version 1.2.6
scala_version 2.12.7
name Scala bootstrap
version 1.0
organization tv.codely
package tv.codely.scala_bootstrap

If I replace scala and sbt versions with latest ones it works properly:

sbt_version 1.3.8
scala_version 2.13.1

Creating a project with underscore in the name doesn't follow Scala file and class naming conventions

Expected: when I create a project and put "poker_api" in the name, I expect a class named PokerApi.scala to be created

Actual: a class called Poker_api.scala is created instead (as can be seen in lambtors/poker-api@6f62383)