akka / akka-http-quickstart-scala.g8

Akka

The Akka family of projects is managed by teams at Lightbend with help from the community.

We believe that writing correct concurrent & distributed, resilient and elastic applications is too hard. Most of the time it's because we are using the wrong tools and the wrong level of abstraction.

Akka is here to change that.

Using the Actor Model we raise the abstraction level and provide a better platform to build correct concurrent and scalable applications. This model is a perfect match for the principles laid out in the Reactive Manifesto.

For resilience, we adopt the "Let it crash" model which the telecom industry has used with great success to build applications that self-heal and systems that never stop.

Actors also provide the abstraction for transparent distribution and the basis for truly scalable and fault-tolerant applications.

Learn more at akka.io.

Reference Documentation

The reference documentation is available at doc.akka.io, for Scala and Java.

Current versions of all Akka libraries

The current versions of all Akka libraries are listed on the Akka Dependencies page. Releases of the Akka core libraries in this repository are listed on the GitHub releases page.

Community

You can join these groups and chats to discuss and ask Akka related questions:

• Forums: discuss.akka.io
• Issue tracker:

In addition to that, you may enjoy following:

• The news section of the page, which is updated whenever a new version is released
• The Akka Team Blog
• The Akka articles in the Lightbend Blog
• Questions tagged #akka on StackOverflow

Contributing

Contributions are very welcome!

If you see an issue that you'd like to see fixed, or want to shape out some ideas, the best way to make it happen is to help out by submitting a pull request implementing it. We welcome contributions from all, even you are not yet familiar with this project, We are happy to get you started, and will guide you through the process once you've submitted your PR.

Refer to the CONTRIBUTING.md file for more details about the workflow, and general hints on how to prepare your pull request. You can also ask for clarifications or guidance in GitHub issues directly, or in the akka/dev chat if a more real time communication would be of benefit.

License

Akka is licensed under the Business Source License 1.1, please see the Akka License FAQ.

Tests and documentation are under a separate license, see the LICENSE file in each documentation and test root directory for details.

akka-http-quickstart-scala.g8's Issues

SBT Warning: Conflicting versions of akka-stream

Consider the following:

> sbt new https://github.com/akka/akka-http-scala-seed.g8

This is a seed project which creates a basic build for an Akka HTTP
application using Scala.

name [My Akka HTTP Project]:
scala_version [2.12.3]:
akka_http_version [10.0.10]:
akka_version [2.5.4]:
organization [com.example]:

Template applied in .\my-akka-http-project

> cd my-akka-http-project
> sbt update

[info] Done updating.
[warn] There may be incompatibilities among your library dependencies.
[warn] Here are some of the libraries that were evicted:
[warn]  * com.typesafe.akka:akka-stream_2.12:2.4.19 -> 2.5.4
[warn] Run 'evicted' to see detailed eviction warnings

How to get rid of the warning ?

Cf this related stackoverflow post.

Update to newer version of Akka HTTP when available

In the new version of Akka HTTP the HttpApp changed one signature from route to routes. Please adapt this as well, and add a comment stating that this was called route in previous versions. Just in case somebody wants to use the seed for different Akka HTTP versions.

add `sbt new` command to readme

I think it's convenient to be able to copy the full sbt new command from the readme.

sbt -Dsbt.version=0.13.15 new https://github.com/akka/akka-http-scala-seed.g8

Maybe the readme should have even more instructions, e.g. for inspiration: https://www.lagomframework.com/get-started-java-sbt.html

@jlprat can you fix this while you are touching things in these repos?

sbt run fails

He,
sbt run returns no main class detected.

Need to fix the config to make the instructions from README valid.

Waldemar Wosiński

Build project from template on Travis

It would be cool if travis could apply the template and run the tests of the resulting project when checking a PR.

Add sbt-revolver plugin + docs how to use it

When select AKKA 2.5.X is importing 2.4 testkits dependencies

In this moment, using akka 2.5.x import testkits for 2.4

As explain in https://doc.akka.io/docs/akka-http/current/scala/http/compatibility-guidelines.html#akka-http-10-0-x-with-akka-2-5-x, it's neccessary to add:

      "com.typesafe.akka" %% "akka-testkit" % akkaVersion % Test,
      "com.typesafe.akka" %% "akka-stream-testkit" % akkaVersion % Test,

Update to sbt 1

Update paths image

@patrox 3 days ago
Is there an option to update the image file (docs/src/main/paradox/images/hello-akka-http.png) so it reflects the Paths from here ?

Latest version of this quickstart isn't published

Looks like the download from https://developer.lightbend.com/start/?group=akka is still using an old Akka HTTP version: 10.0.11

Change download link

Per this marketing effort: https://docs.google.com/spreadsheets/d/1IJCclFJYD7SuxdIgYJ9wyHu-rDn-z5Rt-BKWgDOGfz0/edit?usp=sharing Project Starter is going to be removed from Techhub. Instead, the guide should point directly to the download:
https://example.lightbend.com/v1/download/akka-http-quickstart-scala?name=akka-http-quickstart-scala

Explain check section more, what attrs exist

Explain check section more, what attrs exist

Follow up to #12 (comment)

`sbt new` does not work

Hi,

In windows 10, it shows below error.

Exiting due to error in the template
File: C:\Users\TILAK~1.NAR\AppData\Local\Temp\giter8-331126442355577\src\main\g8\src\main\scala\com\lightbend\akka\http\sample\UserRegistryActor.scala, 30:53: 'created' came as a complete surprise to me

Add new branch 10.1.x

Add new branch 10.1.x and set this branch as default branch.

Add .bsp/ to .gitignore

Short description

add .bsp to .gitignore because of upgrading sbt version.

Details

https://users.scala-lang.org/t/solved-should-i-add-bsp-directory-in-gitignore/6921

quickstarter does not work with sbt 1.1.6 nexus & set credentials

scala sbt new akka/akka-quickstart-scala.g8 --name=be-scala-akka-ods2

08:23:00 |   |   | Getting org.scala-sbt sbt 1.1.6 (this may take some time)...
08:23:03 |   |   | :: retrieving :: org.scala-sbt#boot-app
08:23:03 |   |   | confs: [default]
08:23:03 |   |   | 76 artifacts copied, 0 already retrieved (27669kB/252ms)
08:23:04 |   |   | Getting Scala 2.12.6 (for sbt)...
08:23:04 |   |   | :: retrieving :: org.scala-sbt#boot-scala
08:23:04 |   |   | confs: [default]
08:23:04 |   |   | 5 artifacts copied, 0 already retrieved (19632kB/85ms)
08:23:17 |   |   | [info] Set current project to data (in build file:/data/)
08:23:18 |   |   | [info] Set current project to data (in build file:/data/)
08:23:22 |   |   | [error] Unable to find credentials for [Sonatype Nexus Repository Manager @ nexus3-.. ].
08:23:22 |   |   | [error] Unable to find credentials for [Sonatype Nexus Repository Manager @ nexus3-.. ].
08:23:22 |   |   | [warn] module not found: org.scala-sbt.sbt-giter8-resolver#sbt-giter8-resolver_2.12;0.1.3
08:23:22 |   |   | [warn] ==== local: tried
08:23:22 |   |   | [warn] /home/jenkins/.ivy2/local/org.scala-sbt.sbt-giter8-resolver/sbt-giter8-resolver_2.12/0.1.3/ivys/ivy.xml
08:23:22 |   |   | [warn] ==== my-ivy-proxy-releases: tried
08:23:22 |   |   | [warn] https://nexus3-... /repository/ivy-releases/org.scala-sbt.sbt-giter8-resolver/sbt-giter8-resolver_2.12/0.1.3/ivys/ivy.xml
08:23:22 |   |   | [warn] ==== my-maven-proxy-releases: tried
08:23:22 |   |   | [warn] https://nexus3-... /repository/maven-public/org/scala-sbt/sbt-giter8-resolver/sbt-giter8-resolver_2.12/0.1.3/sbt-giter8-resolver_2.12-0.1.3.pom
08:23:22 |   |   | [warn] ::::::::::::::::::::::::::::::::::::::::::::::
08:23:22 |   |   | [warn] :: UNRESOLVED DEPENDENCIES ::
08:23:22 |   |   | [warn] ::::::::::::::::::::::::::::::::::::::::::::::
08:23:22 |   |   | [warn] :: org.scala-sbt.sbt-giter8-resolver#sbt-giter8-resolver_2.12;0.1.3: not found
08:23:22 |   |   | [warn] ::::::::::::::::::::::::::::::::::::::::::::::
08:23:22 |   |   | [error] java.lang.RuntimeException: Retrieval of org.scala-sbt.sbt-giter8-resolver:sbt-giter8-resolver:0.1.3 failed.

Prior sbt run against plains scala file does work without issues

Unresolved dependency when building

Hi,

When I try to run the project I have the following message :
sbt.ResolveException: unresolved dependency: org.scalariform#sbt-scalariform;1.8.2: not found

Regards,
Arnaud

README.md needs to be updated to the reflect the current state of the Getting Started Guide

Hi,

There are no files by name WebServer or WebServerHttpApp.

Regards

Use giter8 maven properties

http://www.foundweekends.org/giter8/template.html

Travis fails to download MD5 files for sbt launcher

(from an internal chat):

adding -sbt-launch-repo https://repo1.maven.org/maven2 to sbt in travis seems to suffice