grootfarm 0.1.0

Core Python library for the Grootfarm platform.

grootfarm-lib

Core Python library for the Grootfarm platform.

grootfarm-lib provides helper modules to work with brokers, sensors, wellbeing rules, and database operations in Grootfarm services.

Install

pip install grootfarm

Quick Start

import grootfarm
from grootfarm.broker import Broker

print(grootfarm.__version__)

Main Components

Sensor

from grootfarm.sensor import Sensor

sensor = Sensor("temperature", "celsius", -60, 60)
sensor.set_type("temperature")
print(sensor.get_range())  # (-60, 60)

Wellbeing Rules

from grootfarm.sense import PlantFacts

facts = PlantFacts(
	"temperature",
	sensor_range=(-60, 60),
	plant_range=(20, 25),
	tolerance=5,
)

print(facts.get_wellbeing(24))
# {'status': 'good', 'comparison': 'good'}

Message Processing

from grootfarm.utils import Utils

raw = '{"timestamp":"2026-07-07T10:00:00Z","type":"temperature","value":23,"name":"sensor-a"}'
msg = Utils.process_message(raw)
print(msg)

SQLite Configuration Database

from grootfarm.db import SQLite3

db = SQLite3(":memory:")
db.connect()
db.add_metric("2026-07-07T10:00:00Z", "temperature", 23)
print(db.get_metric("temperature"))
db.close()

Development

Run tests:

PYTHONPATH=src python -m pytest -q

Modules

• grootfarm.broker
• grootfarm.db
• grootfarm.sense
• grootfarm.sensor
• grootfarm.utils