Search by

gopromotional / siplog

nbkdevs

Daily water goal estimate and a simple hydration log with streaks.

Package info

github.com/nbkdevs/gopromotional-siplog-php

Homepage

Issues

pkg:composer/gopromotional/siplog

Security

Advisories: 0

Aikido package health analysis

Transparency log

Statistics

Installs: 1

Dependents: 0

Suggesters: 0

Stars: 0

v1.0.1 2026-10-20 07:46 UTC

Requires

  • php: >=8.1

Requires (Dev)

Suggests

None

Provides

None

Conflicts

None

Replaces

None

MIT bb2198d90cb728218622a37591e96450791aae13

healthtrackerwaterhydrationgopromotional

Published on Packagist.org on 2026-10-20 07:57 UTC

This package is auto-updated.

Last update: 2026-10-20 08:00:34 UTC

README

A small hydration tracker: estimate a daily water goal from weight, exercise and weather, log drinks in ml, cl, litres or US fl oz, and see today's progress, the last 7 days, your average and your streak. The log is a plain JSON file.

  • Daily goal estimate: weight × 33 ml + 12 ml per active minute (+500 ml in hot weather), rounded to 50 ml. A general guide, not medical advice.
  • Flexible amounts: 250, 500ml, 33cl, 0.5l, 16oz.
  • Progress, 7-day history, average and streak of days on target.
  • Undo the last entry, set your own goal.
  • Plain JSON log ({goal, entries:[{date, ml}]}), the same format in every language version.

Install

composer require gopromotional/siplog

Usage

use GoPromotional\SipLog\SipLog;

SipLog::dailyGoal(weightKg: 70, activityMinutes: 30, hot: true);  // 3150
SipLog::parseAmount('33cl');                                       // 330

$log = SipLog::fromJson(file_get_contents('log.json'));            // same file as the CLI versions
$log->add('500ml', '2026-10-19');
$log->progress('2026-10-19');  // ['date' => '2026-10-19', 'total' => 500, 'goal' => 2000, 'percent' => 25, ...]
$log->streak('2026-10-19');
file_put_contents('log.json', $log->toJson());

Pure PHP 8.1+, no dependencies. Run the tests with composer install && composer test.

Links