izumi

README

---

---

What is it?

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

including the following components:

1. distage – Transparent and debuggable Dependency Injection framework for Pure FP Scala,
2. logstage – Automatic structural logs from Scala string interpolations,
3. idealingua – API Definition, Data Modeling and RPC Language, optimized for fast prototyping – like gRPC, but with a human face. Currently generates servers and clients for Go, TypeScript, C# and Scala,
4. 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)
5. 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 [EN] on Telegram
• Izumi User Group [RU] on Telegram

Slides:

• Hyper-pragmatic Pure FP Testing with distage-testkit
• distage: Staged Dependency Injection
• logstage: Zero-cost Structured Logging
• More slides

Videos:

• Hyper-pragmatic Pure FP Testing with distage-testkit, Functional Scala, London
• Livecoding: DIStage & Bifunctor Tagless Final on Youtube

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

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