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

---

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

28	public function __call(string $key, array $args): Query
29	{
30	$script = $this->getScript($key);
31
32	return $script->invoke(...$args);
33	}

Folder->__construct

15	public function __construct(Database $db, string $folder)
16	{
17	Util::assertPathSegment($folder, 'SQL folder name');
18
19	$this->db = $db;
20	$this->folder = $folder;
21	}

Folder->__get

23	public function __get(string $key): Script
24	{
25	return $this->getScript($key);
26	}

Folder->getScript

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

51	protected function getScript(string $key): Script
52	{
53	Util::assertPathSegment($key, 'SQL script name');
54
55	$script = $this->scriptPath($key, false);
56
57	if (is_string($script)) {
63	$dynStmt = $this->scriptPath($key, true);
64
65	if (is_string($dynStmt)) {
66	$loaded = $this->db->loadScript($dynStmt, true);
67
68	return new Script($this->db, $loaded, true);

51	protected function getScript(string $key): Script
52	{
53	Util::assertPathSegment($key, 'SQL script name');
54
55	$script = $this->scriptPath($key, false);
56
57	if (is_string($script)) {
63	$dynStmt = $this->scriptPath($key, true);
64
65	if (is_string($dynStmt)) {
71	throw new RuntimeException('SQL script does not exist');
72	}

Folder->scriptPath

35	protected function scriptPath(string $key, bool $isTemplate): bool|string
36	{
37	$ext = $isTemplate ? '.tpql' : '.sql';
37	$ext = $isTemplate ? '.tpql' : '.sql';
37	$ext = $isTemplate ? '.tpql' : '.sql';
38
39	foreach ($this->db->getSqlDirs() as $path) {
39	foreach ($this->db->getSqlDirs() as $path) {
40	assert(is_string($path), 'SQL directory path must be a string.');
41	$result = $path . DIRECTORY_SEPARATOR . $this->folder . DIRECTORY_SEPARATOR . $key . $ext;
42
43	if (is_file($result)) {
44	return $result;

35	protected function scriptPath(string $key, bool $isTemplate): bool|string
36	{
37	$ext = $isTemplate ? '.tpql' : '.sql';
37	$ext = $isTemplate ? '.tpql' : '.sql';
37	$ext = $isTemplate ? '.tpql' : '.sql';
38
39	foreach ($this->db->getSqlDirs() as $path) {
39	foreach ($this->db->getSqlDirs() as $path) {
40	assert(is_string($path), 'SQL directory path must be a string.');
41	$result = $path . DIRECTORY_SEPARATOR . $this->folder . DIRECTORY_SEPARATOR . $key . $ext;
42
43	if (is_file($result)) {
39	foreach ($this->db->getSqlDirs() as $path) {
39	foreach ($this->db->getSqlDirs() as $path) {
39	foreach ($this->db->getSqlDirs() as $path) {
40	assert(is_string($path), 'SQL directory path must be a string.');
41	$result = $path . DIRECTORY_SEPARATOR . $this->folder . DIRECTORY_SEPARATOR . $key . $ext;
42
43	if (is_file($result)) {
44	return $result;
45	}
46	}
47
48	return false;
49	}

35	protected function scriptPath(string $key, bool $isTemplate): bool|string
36	{
37	$ext = $isTemplate ? '.tpql' : '.sql';
37	$ext = $isTemplate ? '.tpql' : '.sql';
37	$ext = $isTemplate ? '.tpql' : '.sql';
38
39	foreach ($this->db->getSqlDirs() as $path) {
39	foreach ($this->db->getSqlDirs() as $path) {
39	foreach ($this->db->getSqlDirs() as $path) {
40	assert(is_string($path), 'SQL directory path must be a string.');
41	$result = $path . DIRECTORY_SEPARATOR . $this->folder . DIRECTORY_SEPARATOR . $key . $ext;
42
43	if (is_file($result)) {
44	return $result;
45	}
46	}
47
48	return false;
49	}

35	protected function scriptPath(string $key, bool $isTemplate): bool|string
36	{
37	$ext = $isTemplate ? '.tpql' : '.sql';
37	$ext = $isTemplate ? '.tpql' : '.sql';
37	$ext = $isTemplate ? '.tpql' : '.sql';
38
39	foreach ($this->db->getSqlDirs() as $path) {
39	foreach ($this->db->getSqlDirs() as $path) {
40	assert(is_string($path), 'SQL directory path must be a string.');
41	$result = $path . DIRECTORY_SEPARATOR . $this->folder . DIRECTORY_SEPARATOR . $key . $ext;
42
43	if (is_file($result)) {
44	return $result;
45	}
46	}
47
48	return false;
49	}

35	protected function scriptPath(string $key, bool $isTemplate): bool|string
36	{
37	$ext = $isTemplate ? '.tpql' : '.sql';
37	$ext = $isTemplate ? '.tpql' : '.sql';
37	$ext = $isTemplate ? '.tpql' : '.sql';
38
39	foreach ($this->db->getSqlDirs() as $path) {
39	foreach ($this->db->getSqlDirs() as $path) {
40	assert(is_string($path), 'SQL directory path must be a string.');
41	$result = $path . DIRECTORY_SEPARATOR . $this->folder . DIRECTORY_SEPARATOR . $key . $ext;
42
43	if (is_file($result)) {
44	return $result;

35	protected function scriptPath(string $key, bool $isTemplate): bool|string
36	{
37	$ext = $isTemplate ? '.tpql' : '.sql';
37	$ext = $isTemplate ? '.tpql' : '.sql';
37	$ext = $isTemplate ? '.tpql' : '.sql';
38
39	foreach ($this->db->getSqlDirs() as $path) {
39	foreach ($this->db->getSqlDirs() as $path) {
40	assert(is_string($path), 'SQL directory path must be a string.');
41	$result = $path . DIRECTORY_SEPARATOR . $this->folder . DIRECTORY_SEPARATOR . $key . $ext;
42
43	if (is_file($result)) {
39	foreach ($this->db->getSqlDirs() as $path) {
39	foreach ($this->db->getSqlDirs() as $path) {
39	foreach ($this->db->getSqlDirs() as $path) {
40	assert(is_string($path), 'SQL directory path must be a string.');
41	$result = $path . DIRECTORY_SEPARATOR . $this->folder . DIRECTORY_SEPARATOR . $key . $ext;
42
43	if (is_file($result)) {
44	return $result;
45	}
46	}
47
48	return false;
49	}

35	protected function scriptPath(string $key, bool $isTemplate): bool|string
36	{
37	$ext = $isTemplate ? '.tpql' : '.sql';
37	$ext = $isTemplate ? '.tpql' : '.sql';
37	$ext = $isTemplate ? '.tpql' : '.sql';
38
39	foreach ($this->db->getSqlDirs() as $path) {
39	foreach ($this->db->getSqlDirs() as $path) {
39	foreach ($this->db->getSqlDirs() as $path) {
40	assert(is_string($path), 'SQL directory path must be a string.');
41	$result = $path . DIRECTORY_SEPARATOR . $this->folder . DIRECTORY_SEPARATOR . $key . $ext;
42
43	if (is_file($result)) {
44	return $result;
45	}
46	}
47
48	return false;
49	}

35	protected function scriptPath(string $key, bool $isTemplate): bool|string
36	{
37	$ext = $isTemplate ? '.tpql' : '.sql';
37	$ext = $isTemplate ? '.tpql' : '.sql';
37	$ext = $isTemplate ? '.tpql' : '.sql';
38
39	foreach ($this->db->getSqlDirs() as $path) {
39	foreach ($this->db->getSqlDirs() as $path) {
40	assert(is_string($path), 'SQL directory path must be a string.');
41	$result = $path . DIRECTORY_SEPARATOR . $this->folder . DIRECTORY_SEPARATOR . $key . $ext;
42
43	if (is_file($result)) {
44	return $result;
45	}
46	}
47
48	return false;
49	}