neomaclin / izumi

Productivity-oriented collection of lightweight fancy stuff for Scala toolchain

---

---

What is it?

Izumi (jp. 泉水, spring) is an ecosystem of independent libraries and frameworks allowing you to significantly increase productivity of your Scala development.

including the following components:

1. distage – Compile-time safe, transparent and debuggable Dependency Injection framework for pure FP Scala,
2. distage-testkit – Hyper-pragmatic pure FP Test framework. Shares heavy resources globally across all test suites; lets you easily swap implementations of component; uses your effect type for parallelism.
3. distage-framework-docker – A distage extension for using docker containers in tests or for local application runs, comes with example Postgres, Cassandra, Kafka & DynamoDB containers.
4. LogStage – Automatic structural logs from Scala string interpolations,
5. BIO - A typeclass hierarchy for tagless final style with Bifunctor and Trifunctor effect types. Focused on ergonomics and ease of use with zero boilerplate.
6. izumi-reflect (moved to zio/izumi-reflect) - Portable, lightweight and kind-polymorphic alternative to scala-reflect's Typetag for Scala, Scala.js, Scala Native and Dotty
7. IdeaLingua (moved to 7mind/idealingua-v1) – API Definition, Data Modeling and RPC language, optimized for fast prototyping – like gRPC or Swagger, but with a human face. Generates RPC servers and clients for Go, TypeScript, C# and Scala,
8. Opinionated SBT plugins (moved to 7mind/sbtgen) – Reduces verbosity of SBT builds and introduces new features – inter-project shared test scopes and BOM plugins (from Maven)
9. Percept-Plan-Execute-Repeat (PPER) – A pattern that enables modeling very complex domains and orchestrate deadly complex processes a lot easier than you're used to.

Docs

• Documentation
• Scaladoc

Example projects:

• DIStage Example Project
• Idealingua Example Project with TypeScript and Scala

Support Chats:

• Izumi on Gitter
• Izumi User Group [RU] on Telegram
• Izumi User Group [EN] on Telegram
• Discussions on Github

Videos:

• Izumi 1.0: Your Next Scala Stack
• Scala, Functional Programming and Team Productivity
• Hyper-pragmatic Pure FP Testing with distage-testkit
• Livecoding: DIStage & Bifunctor Tagless Final
• DevInsideYou — Tagless Final with BIO

Slides:

• Izumi 1.0: Your Next Scala Stack
• Scala, Functional Programming and Team Productivity
• Hyper-pragmatic Pure FP Testing with distage-testkit
• distage: Staged Dependency Injection
• LogStage: Zero-cost Structured Logging
• More slides

Key goals

We aim to provide tools that:

1. Boost productivity and reduce code bloat
2. Are as non-invasive as possible
3. Are introspectable
4. Are better than anything else out there :3

Current state and future plans

We are looking for early adopters, contributors and sponsors.

This project is currently a work in progress.

In the future we are going to (or may) implement more tools based on PPER approach:

1. Best in the world build system
2. Best in the world cluster orchestration tool
3. Best in the world load testing/macro-benchmark tool

Adopters

Are you using Izumi? Please consider opening a pull request to list your organization here:

Projects powered by Izumi

• d4s - "Dynamo DB Database done Scala way". A library that allows accessing the DynamoDB in a purely-functional way.

Credits

YourKit supports open source projects with innovative and intelligent tools for monitoring and profiling Java and .NET applications. YourKit is the creator of YourKit Java Profiler, YourKit .NET Profiler and YourKit YouMonitor.

Triplequote Hydra is the world’s only parallel compiler for the Scala language. Hydra works by parallelizing all of the Scala compiler phases, taking full advantage of the many cores available in modern hardware.

Contributors

• Run ./sbtgen.sc to generate a JVM-only sbt project, run ./sbtgen.sc --js to generate a JVM+JS sbt crossproject

See:

• Build notes
• Project flow