Google Git
Sign in
apache / pekko-http / refs/tags/v1.0.0-RC1
tag2c6909357f709872d29ecb98b06ff0c433b28fca
taggerPJ Fanning <pjfanning@users.noreply.github.com>Tue Jul 18 11:35:59 2023 +0100
objecte3cf801e3b337cb87b4bb48e7bff5f69e5b62720 
1.0.0-RC1
commite3cf801e3b337cb87b4bb48e7bff5f69e5b62720[log] [tgz]
authorMatthew de Detrich <matthew.dedetrich@aiven.io>Tue Jul 18 09:57:32 2023 +0200
committerMatthew de Detrich <mdedetrich@gmail.com>Tue Jul 18 10:24:46 2023 +0200
tree68be78015ee085bfafbe8f30711d5a37b2f9e84f
parent8ee9ed3c7e9f436d274fc5d88bed048cecdb6631 [diff]
Update latest pekko-sbt-paradox
1 file changed
tree: 68be78015ee085bfafbe8f30711d5a37b2f9e84f
  1. .github/
  2. docs/
  3. http/
  4. http-bench-jmh/
  5. http-caching/
  6. http-compatibility-tests/
  7. http-core/
  8. http-cors/
  9. http-marshallers-java/
  10. http-marshallers-scala/
  11. http-scalafix/
  12. http-testkit/
  13. http-tests/
  14. http2-tests/
  15. legal/
  16. parsing/
  17. project/
  18. scripts/
  19. .asf.yaml
  20. .git-blame-ignore-revs
  21. .gitattributes
  22. .gitignore
  23. .jvmopts
  24. .jvmopts-ci
  25. .scala-steward.conf
  26. .scalafmt.conf
  27. build.sbt
  28. CONTRIBUTING.md
  29. DISCLAIMER
  30. LICENSE
  31. NOTICE
  32. README.md
README.md

Apache Pekko HTTP

The Pekko HTTP modules implement a full server- and client-side HTTP stack on top of pekko-actor and pekko-stream. It's not a web-framework but rather a more general toolkit for providing and consuming HTTP-based services. While interaction with a browser is of course also in scope it is not the primary focus of Pekko HTTP.

Pekko HTTP is a fork of Akka HTTP 10.2.x release, prior to the Akka project's adoption of the Business Source License.

Pekko HTTP follows a rather open design and many times offers several different API levels for “doing the same thing”. You get to pick the API level of abstraction that is most suitable for your application. This means that, if you have trouble achieving something using a high-level API, there's a good chance that you can get it done with a low-level API, which offers more flexibility but might require you to write more application code.

Learn more at pekko.apache.org.

Documentation

The documentation is available at pekko.apache.org, for Scala and Java.

Building from Source

Prerequisites

  • Make sure you have installed a Java Development Kit (JDK) version 8 or later.
  • You will need Java Development Kit (JDK) version 11 or later when building the docs.
  • Make sure you have sbt installed.
  • Graphviz is needed for the scaladoc generation build task, which is part of the release.

Running the Build

  • Open a command window and change directory to your preferred base directory
  • Use git to clone the repo or download a source release from https://pekko.apache.org (and unzip or untar it, as appropriate)
  • Change directory to the directory where you installed the source (you should have a file called build.sbt in this directory)
  • sbt compile compiles the main source for project default version of Scala (2.13)
    • sbt +compile will compile for all supported versions of Scala
  • sbt test will compile the code and run the unit tests
  • sbt package will build the jars
    • the jars will built into target dirs of the various modules
    • for the the ‘http-core’ module, the jar will be built to http-core/target/scala-2.13/
  • sbt publishLocal will push the jars to your local Apache Ivy repository
  • sbt publishM2 will push the jars to your local Apache Maven repository
  • sbt docs/paradox will build the docs (the ones describing the module features)
    • requires JDK 11 or above
    • sbt docs/paradoxBrowse does the same but will open the docs in your browser when complete
    • the index.html file will appear in target/paradox/site/main/
  • sbt unidoc will build the Javadocs for all the modules and load them to one place (may require Graphviz, see Prerequisites above)
    • the index.html file will appear in target/scala-2.13/unidoc/
  • sbt sourceDistGenerate will generate source release to target/dist/
  • The version number that appears in filenames and docs is derived, by default. The derived version contains the most git commit id or the date/time (if the directory is not under git control).
    • You can set the version number explicitly when running sbt commands
      • eg sbt "set ThisBuild / version := \"1.0.0\"; sourceDistGenerate"
    • Or you can add a file called version.sbt to the same directory that has the build.sbt containing something like
      • ThisBuild / version := "1.0.0"

Community

If you have questions about the contribution process or discuss specific issues, please interact with the community using the following resources.

  • GitHub discussions: for questions and general discussion.
  • Pekko users mailing list: for Pekko development discussions.
  • Pekko dev mailing list: for Pekko development discussions.
  • GitHub issues: for bug reports and feature requests. Please search the existing issues before creating new ones. If you are unsure whether you have found a bug, consider asking in GitHub discussions or the mailing list first.

Contributing

Contributions are very welcome!

If you see an issue that you'd like to see fixed, the best way to make it happen is to help out by submitting a pull request. For ideas of where to contribute, tickets marked as “help wanted” are a good starting point.

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.

License

Apache Pekko HTTP is Open Source and available under the Apache 2 License.