1	<?php
2
3	declare(strict_types=1);
4
5	namespace Celema\Quma;
6
7	use RuntimeException;
8
9	/**
10	* @api
11	* @psalm-no-seal-properties
12	* @psalm-no-seal-methods
13	*/
14	class Folder
15	{
16	protected Database $db;
17	protected string $folder;
18
19	public function __construct(Database $db, string $folder)
20	{
21	Util::assertPathSegment($folder, 'SQL folder name');
22
23	$this->db = $db;
24	$this->folder = $folder;
25	}
26
27	public function __get(string $key): Script
28	{
29	return $this->getScript($key);
30	}
31
32	/** @param array<array-key, mixed> $args */
33	public function __call(string $key, array $args): Query
34	{
35	$script = $this->getScript($key);
36
37	return $script->invoke(...$args);
38	}
39
40	protected function scriptPath(string $key, bool $isTemplate): bool|string
41	{
42	$ext = $isTemplate ? '.tpql' : '.sql';
43
44	foreach ($this->db->getSqlDirs() as $path) {
45	$result = $path . DIRECTORY_SEPARATOR . $this->folder . DIRECTORY_SEPARATOR . $key . $ext;
46
47	if (is_file($result)) {
48	return $result;
49	}
50	}
51
52	return false;
53	}
54
55	protected function getScript(string $key): Script
56	{
57	Util::assertPathSegment($key, 'SQL script name');
58
59	$script = $this->scriptPath($key, false);
60
61	if (is_string($script)) {
62	$loaded = $this->db->loadScript($script, false);
63
64	return new Script($this->db, $loaded, false);
65	}
66
67	$dynStmt = $this->scriptPath($key, true);
68
69	if (is_string($dynStmt)) {
70	$loaded = $this->db->loadScript($dynStmt, true);
71
72	return new Script($this->db, $loaded, true);
73	}
74
75	throw new RuntimeException('SQL script does not exist');
76	}
77	}

---

Paths

Below are the source code lines that represent each code path as identified by Xdebug. Please note a path is not necessarily coterminous with a line, a line may contain multiple paths and therefore show up more than once. Please also be aware that some paths may include implicit rather than explicit branches, e.g. an if statement always has an else as part of its logical flow even if you didn't write one.

Folder->__call

33	public function __call(string $key, array $args): Query
34	{
35	$script = $this->getScript($key);
36
37	return $script->invoke(...$args);
38	}

Folder->__construct

19	public function __construct(Database $db, string $folder)
20	{
21	Util::assertPathSegment($folder, 'SQL folder name');
22
23	$this->db = $db;
24	$this->folder = $folder;
25	}

Folder->__get

27	public function __get(string $key): Script
28	{
29	return $this->getScript($key);
30	}

Folder->getScript

55	protected function getScript(string $key): Script
56	{
57	Util::assertPathSegment($key, 'SQL script name');
58
59	$script = $this->scriptPath($key, false);
60
61	if (is_string($script)) {
62	$loaded = $this->db->loadScript($script, false);
63
64	return new Script($this->db, $loaded, false);

55	protected function getScript(string $key): Script
56	{
57	Util::assertPathSegment($key, 'SQL script name');
58
59	$script = $this->scriptPath($key, false);
60
61	if (is_string($script)) {
67	$dynStmt = $this->scriptPath($key, true);
68
69	if (is_string($dynStmt)) {
70	$loaded = $this->db->loadScript($dynStmt, true);
71
72	return new Script($this->db, $loaded, true);

55	protected function getScript(string $key): Script
56	{
57	Util::assertPathSegment($key, 'SQL script name');
58
59	$script = $this->scriptPath($key, false);
60
61	if (is_string($script)) {
67	$dynStmt = $this->scriptPath($key, true);
68
69	if (is_string($dynStmt)) {
75	throw new RuntimeException('SQL script does not exist');
76	}

Folder->scriptPath

40	protected function scriptPath(string $key, bool $isTemplate): bool|string
41	{
42	$ext = $isTemplate ? '.tpql' : '.sql';
42	$ext = $isTemplate ? '.tpql' : '.sql';
42	$ext = $isTemplate ? '.tpql' : '.sql';
43
44	foreach ($this->db->getSqlDirs() as $path) {
44	foreach ($this->db->getSqlDirs() as $path) {
45	$result = $path . DIRECTORY_SEPARATOR . $this->folder . DIRECTORY_SEPARATOR . $key . $ext;
46
47	if (is_file($result)) {
48	return $result;

40	protected function scriptPath(string $key, bool $isTemplate): bool|string
41	{
42	$ext = $isTemplate ? '.tpql' : '.sql';
42	$ext = $isTemplate ? '.tpql' : '.sql';
42	$ext = $isTemplate ? '.tpql' : '.sql';
43
44	foreach ($this->db->getSqlDirs() as $path) {
44	foreach ($this->db->getSqlDirs() as $path) {
45	$result = $path . DIRECTORY_SEPARATOR . $this->folder . DIRECTORY_SEPARATOR . $key . $ext;
46
47	if (is_file($result)) {
44	foreach ($this->db->getSqlDirs() as $path) {
44	foreach ($this->db->getSqlDirs() as $path) {
44	foreach ($this->db->getSqlDirs() as $path) {
45	$result = $path . DIRECTORY_SEPARATOR . $this->folder . DIRECTORY_SEPARATOR . $key . $ext;
46
47	if (is_file($result)) {
48	return $result;
49	}
50	}
51
52	return false;
53	}

40	protected function scriptPath(string $key, bool $isTemplate): bool|string
41	{
42	$ext = $isTemplate ? '.tpql' : '.sql';
42	$ext = $isTemplate ? '.tpql' : '.sql';
42	$ext = $isTemplate ? '.tpql' : '.sql';
43
44	foreach ($this->db->getSqlDirs() as $path) {
44	foreach ($this->db->getSqlDirs() as $path) {
44	foreach ($this->db->getSqlDirs() as $path) {
45	$result = $path . DIRECTORY_SEPARATOR . $this->folder . DIRECTORY_SEPARATOR . $key . $ext;
46
47	if (is_file($result)) {
48	return $result;
49	}
50	}
51
52	return false;
53	}

40	protected function scriptPath(string $key, bool $isTemplate): bool|string
41	{
42	$ext = $isTemplate ? '.tpql' : '.sql';
42	$ext = $isTemplate ? '.tpql' : '.sql';
42	$ext = $isTemplate ? '.tpql' : '.sql';
43
44	foreach ($this->db->getSqlDirs() as $path) {
44	foreach ($this->db->getSqlDirs() as $path) {
45	$result = $path . DIRECTORY_SEPARATOR . $this->folder . DIRECTORY_SEPARATOR . $key . $ext;
46
47	if (is_file($result)) {
48	return $result;
49	}
50	}
51
52	return false;
53	}

40	protected function scriptPath(string $key, bool $isTemplate): bool|string
41	{
42	$ext = $isTemplate ? '.tpql' : '.sql';
42	$ext = $isTemplate ? '.tpql' : '.sql';
42	$ext = $isTemplate ? '.tpql' : '.sql';
43
44	foreach ($this->db->getSqlDirs() as $path) {
44	foreach ($this->db->getSqlDirs() as $path) {
45	$result = $path . DIRECTORY_SEPARATOR . $this->folder . DIRECTORY_SEPARATOR . $key . $ext;
46
47	if (is_file($result)) {
48	return $result;

40	protected function scriptPath(string $key, bool $isTemplate): bool|string
41	{
42	$ext = $isTemplate ? '.tpql' : '.sql';
42	$ext = $isTemplate ? '.tpql' : '.sql';
42	$ext = $isTemplate ? '.tpql' : '.sql';
43
44	foreach ($this->db->getSqlDirs() as $path) {
44	foreach ($this->db->getSqlDirs() as $path) {
45	$result = $path . DIRECTORY_SEPARATOR . $this->folder . DIRECTORY_SEPARATOR . $key . $ext;
46
47	if (is_file($result)) {
44	foreach ($this->db->getSqlDirs() as $path) {
44	foreach ($this->db->getSqlDirs() as $path) {
44	foreach ($this->db->getSqlDirs() as $path) {
45	$result = $path . DIRECTORY_SEPARATOR . $this->folder . DIRECTORY_SEPARATOR . $key . $ext;
46
47	if (is_file($result)) {
48	return $result;
49	}
50	}
51
52	return false;
53	}

40	protected function scriptPath(string $key, bool $isTemplate): bool|string
41	{
42	$ext = $isTemplate ? '.tpql' : '.sql';
42	$ext = $isTemplate ? '.tpql' : '.sql';
42	$ext = $isTemplate ? '.tpql' : '.sql';
43
44	foreach ($this->db->getSqlDirs() as $path) {
44	foreach ($this->db->getSqlDirs() as $path) {
44	foreach ($this->db->getSqlDirs() as $path) {
45	$result = $path . DIRECTORY_SEPARATOR . $this->folder . DIRECTORY_SEPARATOR . $key . $ext;
46
47	if (is_file($result)) {
48	return $result;
49	}
50	}
51
52	return false;
53	}

40	protected function scriptPath(string $key, bool $isTemplate): bool|string
41	{
42	$ext = $isTemplate ? '.tpql' : '.sql';
42	$ext = $isTemplate ? '.tpql' : '.sql';
42	$ext = $isTemplate ? '.tpql' : '.sql';
43
44	foreach ($this->db->getSqlDirs() as $path) {
44	foreach ($this->db->getSqlDirs() as $path) {
45	$result = $path . DIRECTORY_SEPARATOR . $this->folder . DIRECTORY_SEPARATOR . $key . $ext;
46
47	if (is_file($result)) {
48	return $result;
49	}
50	}
51
52	return false;
53	}