Tutorials

Welcome to the Katharos tutorials! These step-by-step guides will help you understand how katharos helps you write more robust and maintainable Python code.

Tutorials are learning-oriented. They take you by the hand through a series of steps to complete a project. The goal here is not to cover every detail exhaustively, but rather make you comfortable with the core concepts and patterns that katharos provides so you can start writing functional Python with confidence.

Available Tutorials

Covered topics

These tutorials cover:

  • Installing and setting up katharos for your project

  • Handling optional values safely with the Maybe type

  • Graceful error handling using the Result type

  • Composing operations with Functors and Monads

  • Working effectively with immutable data structures

Prerequisites

These tutorials assume you have:

  • Basic Python knowledge (functions, classes, type hints)

  • Python 3.13 or later installed

  • Familiarity with pip for package installation