aprog 1.1.1

aprog_dart is a lightweight developer toolkit for Dart and Flutter that provides pretty JSON dumps, ANSI-colored console output, stack trace helpers, and dd-style debugging.

📦 aprog

🇺🇦 Українська | 🇬🇧 English

---

🇺🇦 Опис

aprog_dart — це легкий утилітарний пакет для розробників на Dart та Flutter.

Пакет надає зручні хелпери для:

• кольорового та форматованого виводу в консоль
• красивого (pretty) виводу JSON
• debug-хелперів, подібних до dump() / dd() з PHP
• читабельного логування з інформацією про файл і рядок коду
• безпечного доступу до даних через AprogWrapper
• простого локального сховища (Storage)

Ідеально підходить для налагодження Flutter-додатків та Dart CLI-інструментів.

---

🇬🇧 Description

aprog_dart is a lightweight utility package for Dart and Flutter developers.

It provides convenient helpers for:

• colored and formatted console output
• pretty-printed JSON output
• debug helpers similar to PHP dump() / dd()
• readable logging with file and line information
• safe data access via AprogWrapper
• simple local storage helper (Storage)

Ideal for debugging Flutter applications and Dart CLI tools.

---

🚀 Можливості / Features

• 🎨 ANSI-кольори / ANSI colored output
• 🧱 Форматований текст / Styled text helpers
• 📦 Pretty JSON з відступами / Pretty JSON with indentation
• 🐞 dump() з контекстом файлу та рядка / stack-aware dump()
• 💀 dd() (dump & exit)
• 🧠 Безпечний вивід великих логів / chunked large logs
• 🧩 wrap() / AprogWrapper для безпечного доступу до даних
• 💾 Storage для локального сховища
• 📅 Функція date() за прикладом як у PHP

---

🛠 Початок роботи / Getting started

dart pub add aprog

🧩AprogWrapper — приклад / example

import 'package:aprog/aprog.dart';

final AprogWrapper config = wrap({
  'key': 'value',
  'key2': {
    'key3': 'value',
  },
});

print(config.get('key'));
print(config.path('key2.key3'));

💾 Storage — приклад / example

import 'package:aprog/aprog.dart';

await Storage.set('user', {
  'name': 'Oleksandr',
  'email': '[e-mail]',
});

final user = await Storage.get('user');

📅 date() - приклад / example

import 'package:aprog/aprog.dart';

// Поточна дата
print(date('Y-m-d H:i:s')); // Виведе: 2026-02-09 15:34:36

// Тільки рік та місяць
print(date('d.m.Y')); // Виведе: 09.02.2026

// Для конкретної дати (наприклад, день народження)
DateTime birthday = DateTime(1990, 10, 22);
print(date('d-m-Y', birthday)); // Виведе: 22-10-1990

© Copyright AlexProger 2026