Files
dgarcia a655a6f3ae
Tests / PHP 8.4 (push) Failing after 3m23s
feat(console): add bin/camelia-orm with seed and make commands
A command line for the library, kept deliberately small: no console
component, no dependency added to the consumer's tree.

- Application/Command/Input/Output: parsing, dispatch, exit codes and
  capturable output. Commands return an exit code instead of calling exit(),
  so every one is testable.
- seed: runs the registered SeederRunner inside one transaction, with
  --list and --only=name[,name].
- doctor: one round-trip that fails loudly when the DSN is wrong.
- make:model and make:seeder: live scaffolding into the consumer's code,
  sharing name validation, the overwrite guard and directory creation
  through MakeCommand.

The binary ships an empty runner; an application composes SeedCommand into
its own Application to register its seeders.
2026-11-15 13:31:14 -03:00

2.0 KiB

Changelog

All notable changes to this project are documented here. The format follows Keep a Changelog and the project adheres to Semantic Versioning.

[Unreleased]

Added

  • Camelia\Orm\Seeding: Seeder contract, AbstractSeeder with an idempotent seedOnce(), and SeederRunner, which runs an ordered batch inside one transaction and reports per-seeder counts. A failing seeder rolls the whole batch back.
  • Camelia\Orm\Console: a small CLI core (Application, Command, Input, Output) with no external dependency, plus bin/camelia-orm exposing seed, doctor, make:model and make:seeder. Commands return exit codes instead of calling exit(), and every command can be driven from a test through a stream-backed Output.
  • ConfigurationException::unknownSeeder().
  • docs/SEEDING.md.

[1.0.0] - 2026-11-15

Added

  • Attribute-driven metadata: TableName, PrimaryKey, AutoIncrement, Column, Guarded, Ignore, Required, Enum, Nullable, Length, Precision, Unique, UniqueGroup, Index, MaxLength.
  • Relationship mapping: BelongsTo, HasOne, HasMany, BelongsToMany, with batched eager loading (no N+1) and a hard 3-level depth limit.
  • Orm entry point with fromArray, fromPdo, fromEnv and nested transaction().
  • Repository read API: find, findFirst, findByPk, findByPkOrFail, findOrCreate, count, exists, sum, avg, max, min, page, query.
  • Repository write API: save, create, update, delete, patch, remove.
  • Immutable Query with Cond operators and GroupCond grouping.
  • Typed exception hierarchy rooted at OrmException.
  • AuditListener and PSR-3 LoggerInterface extension points.
  • TypeCaster with strict refusal of values that cannot be cast.

Notes

  • Model::hydrate() accepts property or column keys; the property name wins when both are present.
  • Page::$totalPages is always an int.
  • No global helper functions are registered.