packages/sql-semantics-mysql/resources/models/Value/GrantUserWithUserIdentifiedSymByPasswordTextString_5edfa118.php

1<?php
2
3declare(strict_types=1);
4
5namespace SqlSemantics\Statement\Model\MySql\Value;
6
7/**
8 * The grant_user SQL value; generated by bin/build-models.php.
9 *
10 * @visibility public
11 * @example Accept a structured SQL value
12 *     $write = static fn (\SqlSemantics\Statement\Model\MySql\Value\GrantUserWithUserIdentifiedSymByPasswordTextString_5edfa118 $value): string => \SqlSemantics\Statement\Writer::render($value);
13 *     $write instanceof \Closure // => true
14 */
15final class GrantUserWithUserIdentifiedSymByPasswordTextString_5edfa118 implements \SqlSemantics\Statement\Model\MySql\Role\GrantListForm, \SqlSemantics\Statement\Model\MySql\Role\GrantUserForm
16{
17    use \SqlSemantics\Statement\Assertion;
18
19    /**
20     * Supplies the SQL values of this form; comments are kept by the position of the symbol each precedes.
21     */
22    public function __construct(
23        public readonly \SqlSemantics\Statement\Model\MySql\Role\UserForm $user,
24        public readonly string $value,
25        public readonly \SqlSemantics\Statement\Comments $comments = new \SqlSemantics\Statement\Comments(),
26    ) {
27        $this->assert(\SqlSemantics\Statement\Model\MySql\Contract\Contracts::contains($user), 'The user must be a generated immutable SQL value.');
28        $this->assertMatchesPattern($value, \SqlSemantics\Statement\Model\MySql\Contract\Contracts::SPELLINGS['TEXT_STRING'], 'The value must be a complete TEXT_STRING lexical spelling.');
29    }
30
31    /**
32     * Writes SQL entirely from this value's fields.
33     */
34    public function write(\SqlSemantics\Statement\Writer $writer): void
35    {
36        $writer->comments($this->comments, 0);
37        $this->user->write($writer);
38        $writer->comments($this->comments, 1);
39        $writer->append('IDENTIFIED');
40        $writer->comments($this->comments, 2);
41        $writer->append('BY');
42        $writer->comments($this->comments, 3);
43        $writer->append('PASSWORD');
44        $writer->comments($this->comments, 4);
45        $writer->append($this->value);
46    }
47
48    /**
49     * Returns a copy with a new user, preserving every other field.
50     */
51    public function withUser(\SqlSemantics\Statement\Model\MySql\Role\UserForm $user): self
52    {
53        return new self($user, $this->value, $this->comments);
54    }
55
56    /**
57     * Returns a copy with a new value, preserving every other field.
58     */
59    public function withValue(string $value): self
60    {
61        return new self($this->user, $value, $this->comments);
62    }
63
64    /**
65     * Returns a copy with a new comments, preserving every other field.
66     */
67    public function withComments(\SqlSemantics\Statement\Comments $comments): self
68    {
69        return new self($this->user, $this->value, $comments);
70    }
71}
72