feat: initial commit of camelia/orm

Attribute-mapped Active Record ORM for MariaDB/MySQL over PDO.

- 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 and a 3-level depth limit.
- Orm entry point with fromArray, fromPdo, fromEnv and nested transactions.
- Immutable Query with Cond operators and GroupCond grouping.
- Repository read and write API, pagination, and typed exception hierarchy.
- Declares PHP >=8.3; Mago and PHPStan pin the parser to 8.3.
- MIT license.
This commit is contained in:
dgarcia committed 2026-11-15 10:14:22 -03:00
commit 66e93e3070
97 files changed
+12188

No files matched your search

+177
View File
@@ -0,0 +1,177 @@
<?php
declare(strict_types=1);
namespace Camelia\Orm\Tests\Unit;
use Camelia\Orm\Exception\PartialModelException;
use Camelia\Orm\Exception\ValidationException;
use Camelia\Orm\Persistence\AuditListener;
use Camelia\Orm\Persistence\Persister;
use Camelia\Orm\Query\MySqlDialect;
use Camelia\Orm\Query\QueryBuilder;
use Camelia\Orm\Tests\Fixture\Usuario;
use Camelia\Orm\Tests\Support\FakeConnection;
use PHPUnit\Framework\Attributes\Test;
use PHPUnit\Framework\TestCase;
final class PersisterTest extends TestCase
{
private FakeConnection $connection;
private Persister $persister;
protected function setUp(): void
{
$this->connection = new FakeConnection();
$this->persister = new Persister($this->connection, new QueryBuilder(new MySqlDialect()));
}
#[Test]
public function it_inserts_and_assigns_the_generated_key(): void
{
$this->connection->lastInsertId = '42';
$usuario = (new Usuario())->hydrate(['nombre' => 'Ana', 'clave' => 'abc']);
$key = $this->persister->insert($usuario);
self::assertSame(42, $key);
self::assertSame(42, $usuario->codigo);
self::assertStringStartsWith('INSERT INTO `usuarios`', $this->connection->lastSql());
}
#[Test]
public function it_only_writes_writable_columns(): void
{
$this->connection->lastInsertId = '1';
$usuario = (new Usuario())->hydrate(['nombre' => 'Ana', 'clave' => 'abc']);
$this->persister->insert($usuario);
$sql = $this->connection->lastSql();
self::assertStringNotContainsString('`codigo`', $sql);
self::assertStringContainsString('`password_hash`', $sql);
}
#[Test]
public function it_saves_as_update_when_the_key_is_present(): void
{
$usuario = (new Usuario())->hydrate(['nombre' => 'Ana', 'clave' => 'abc']);
$usuario->codigo = 9;
$this->persister->save($usuario);
self::assertStringStartsWith('UPDATE `usuarios`', $this->connection->lastSql());
}
#[Test]
public function it_saves_as_insert_when_the_key_is_absent(): void
{
$this->connection->lastInsertId = '3';
$usuario = (new Usuario())->hydrate(['nombre' => 'Ana', 'clave' => 'abc']);
$this->persister->save($usuario);
self::assertStringStartsWith('INSERT INTO `usuarios`', $this->connection->lastSql());
}
#[Test]
public function it_refuses_an_invalid_model(): void
{
$this->expectException(ValidationException::class);
$this->persister->insert((new Usuario())->hydrate(['nombre' => 'Ana']));
}
#[Test]
public function it_refuses_to_write_a_partial_model(): void
{
$usuario = (new Usuario())->hydrate(['nombre' => 'Ana', 'clave' => 'abc']);
$usuario->codigo = 1;
$usuario->markPartial();
$this->expectException(PartialModelException::class);
$this->persister->update($usuario);
}
#[Test]
public function it_patches_only_the_given_columns(): void
{
$this->persister->patch(new Usuario(), 5, ['nombre' => 'Bea']);
self::assertSame(
'UPDATE `usuarios` SET `nombre` = ? WHERE `codigo` = ?',
$this->connection->lastSql(),
);
}
#[Test]
public function it_removes_by_primary_key(): void
{
$removed = $this->persister->remove(new Usuario(), 5);
self::assertTrue($removed);
self::assertSame('DELETE FROM `usuarios` WHERE `codigo` = ?', $this->connection->lastSql());
}
#[Test]
public function it_returns_false_when_nothing_was_removed(): void
{
$this->connection->affected = 0;
self::assertFalse($this->persister->remove(new Usuario(), 5));
}
#[Test]
public function it_notifies_the_audit_listener(): void
{
$listener = new class() implements AuditListener {
/** @var list<array{action: string, pk: int|string}> */
public array $calls = [];
public function onWrite(
string $table,
int|string $pk,
string $action,
?array $before,
array $after,
): void {
$this->calls[] = ['action' => $action, 'pk' => $pk];
}
};
$this->connection->lastInsertId = '7';
$persister = new Persister(
$this->connection,
new QueryBuilder(new MySqlDialect()),
$listener,
);
$persister->insert((new Usuario())->hydrate(['nombre' => 'Ana', 'clave' => 'abc']));
self::assertSame([['action' => 'insert', 'pk' => 7]], $listener->calls);
}
#[Test]
public function it_invokes_the_before_insert_hook(): void
{
$model = new \Camelia\Orm\Tests\Fixture\ConHooks();
$this->persister->insert($model);
self::assertSame('insert', $model->creadoPorHook);
}
#[Test]
public function it_invokes_the_before_update_hook(): void
{
$model = new \Camelia\Orm\Tests\Fixture\ConHooks();
$model->codigo = 3;
$this->persister->update($model);
self::assertSame('update', $model->creadoPorHook);
}
}