Logically v0.1.0

logically v0.1.0 — Initial Experimental Release

Release date: 22-02-2026

Status: Experimental

Part of: Leraniode X (x-py projects)

---

Overview

This is the first experimental release of logically, a logic-construction toolkit for building clean, composable, and inspectable logical systems in Python.

logically introduces explicit, structured logic primitives that separate logical intent from execution, side effects, and runtime concerns.

It enables developers to define logic as inspectable, reusable, and composable units.

---

Core Features

Condition

Encapsulates a single logical check.

Condition(name="age", rule=lambda v: v >= 18)

---

Rule

Groups conditions and evaluates them into a boolean outcome.

Rule(name="adult_rule", conditions=[is_adult])

---

Decision

Associates rules with optional actions.

Decision(
    name="grant_access",
    rule=rule,
    action=lambda ctx: "Access granted"
)

---

Intent

Represents explicit logical intent as a structured object.

Useful for describing logic meaning independent of execution.

---

Graph

Provides directed graph structures for composing logical flows.

Supports:

• Node creation

• Edge linking

• Flow inspection

---

Errors

Dedicated exception hierarchy:

• LogicallyError
• ConditionError
• RuleError
• DecisionError

---

Strict typing support

Fully compatible with:

• mypy strict mode

• Python 3.10+ typing

• Immutable logical structures

---

Design Goals

logically is designed with these principles:

• Explicit logic definition

• No hidden execution

• No runtime coupling

• No framework lock-in

• Fully composable

• Fully inspectable

logically does not execute workflows. It defines logical structure.

Execution is controlled by the user or external systems.

---

Installation

From workspace:

pip install git+https://github.com/leraniode/x-py.git#subdirectory=logically

Development install:

pip install -e logically

---

Stability

This is an experimental release.

APIs may evolve.

However, core primitives (Condition, Rule, Decision, Intent, Graph) are considered foundational and unlikely to undergo breaking conceptual changes.

---

Compatibility

Supported Python versions:

• 3.10

• 3.11

• 3.12

---

Roadmap

Planned future improvements:

• Graph validation utilities

• Logic inspection helpers

• Debug and visualization tools

• Extended intent modeling

• Choco Usage Support

• Go implementation (logically-go)

---

Version

v0.1.0 marks the first experimental release and establishes the foundation of logically.

Choco v0.1.0

Initial public release of Choco 🍫

• Fast, minimal Python event system
• Wildcard events
• Decorator-based handlers
• Zero dependencies

An experimental leraniode project.