Add a demo

.gitattributes

@@ -17,6 +17,7 @@
 /rector.php             export-ignore
 /webpack.config.js      export-ignore
 /yarn.lock              export-ignore
+/demo                   export-ignore
 /doc                    export-ignore
 /tests                  export-ignore
 /tools                  export-ignore

.github/workflows/ci.yml

@@ -19,6 +19,9 @@ jobs:
       - name: Setup castor
         uses: castor-php/setup-castor@v0.1.0
 
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v2
+
       - name: Login to GitHub Container Registry
         uses: docker/login-action@v3
         with:

.php-cs-fixer.dist.php

@@ -8,6 +8,7 @@
         __FILE__,
     ])
     ->notPath([
+        'demo',
         'src/Bridge/EasyAdmin/src/JoliMediaEasyAdminBundle.php',
         'src/Bridge/SonataAdmin/src/JoliMediaSonataAdminBundle.php',
         'src/JoliMediaBundle.php',

castor.php

@@ -1,5 +1,7 @@
 <?php
 
 use function Castor\import;
+use function Castor\mount;
 
 import(__DIR__ . '/.castor');
+mount(__DIR__ . '/demo', 'demo');

demo/.castor/context.php

@@ -0,0 +1,99 @@
+<?php
+
+namespace demo\docker;
+
+use Castor\Attribute\AsContext;
+use Castor\Context;
+use Symfony\Component\Process\Process;
+
+use function Castor\log;
+
+#[AsContext(default: true)]
+function create_default_context(): Context
+{
+    $data = create_default_variables() + [
+        'project_name' => 'app',
+        'root_domain' => 'app.test',
+        'extra_domains' => [],
+        'php_version' => '8.4',
+        'docker_compose_files' => [
+            'docker-compose.yml',
+            'docker-compose.dev.yml',
+        ],
+        'docker_compose_run_environment' => [],
+        'macos' => false,
+        'power_shell' => false,
+        // check if posix_geteuid is available, if not, use getmyuid (windows)
+        'user_id' => \function_exists('posix_geteuid') ? posix_geteuid() : getmyuid(),
+        'root_dir' => \dirname(__DIR__),
+    ];
+
+    if (file_exists($data['root_dir'] . '/infrastructure/docker/docker-compose.override.yml')) {
+        $data['docker_compose_files'][] = 'docker-compose.override.yml';
+    }
+
+    $platform = strtolower(php_uname('s'));
+    if (str_contains($platform, 'darwin')) {
+        $data['macos'] = true;
+    } elseif (\in_array($platform, ['win32', 'win64', 'windows nt'])) {
+        $data['power_shell'] = true;
+    }
+
+    //                                                   2³² - 1
+    if (false === $data['user_id'] || $data['user_id'] > 4294967295) {
+        $data['user_id'] = 1000;
+    }
+
+    if (0 === $data['user_id']) {
+        log('Running as root? Fallback to fake user id.', 'warning');
+        $data['user_id'] = 1000;
+    }
+
+    return new Context(
+        $data,
+        pty: Process::isPtySupported(),
+        environment: [
+            'BUILDKIT_PROGRESS' => 'plain',
+        ]
+    );
+}
+
+#[AsContext(name: 'test')]
+function create_test_context(): Context
+{
+    $c = create_default_context();
+
+    return $c
+        ->withData([
+            'docker_compose_run_environment' => [
+                'APP_ENV' => 'test',
+            ],
+        ])
+    ;
+}
+
+#[AsContext(name: 'ci')]
+function create_ci_context(): Context
+{
+    $c = create_test_context();
+
+    return $c
+        ->withData([
+            // override the default context here
+        ])
+        ->withData(
+            [
+                'docker_compose_files' => [
+                    'docker-compose.yml',
+                    // Usually, the following service is not be needed in the CI
+                    'docker-compose.dev.yml',
+                    // 'docker-compose.ci.yml',
+                ],
+            ],
+            recursive: false
+        )
+        ->withEnvironment([
+            'COMPOSE_ANSI' => 'never',
+        ])
+    ;
+}

demo/.castor/database.php

@@ -0,0 +1,17 @@
+<?php
+
+namespace demo\db;
+
+use Castor\Attribute\AsTask;
+
+use function Castor\context;
+use function Castor\io;
+use function demo\docker\docker_compose;
+
+#[AsTask(description: 'Connect to the PostgreSQL database', name: 'client', namespace: 'db')]
+function postgres_client(): void
+{
+    io()->title('Connecting to the PostgreSQL database');
+
+    docker_compose(['exec', 'postgres', 'psql', '-U', 'app', 'app'], context()->toInteractive());
+}