devctl 1.0.0__py3-none-any.whl

devctl/templates/spring/dto/Response.java.j2

@@ -0,0 +1,22 @@
+package {{ base_package }}.dto.response;
+
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+/**
+ * Data Transfer Object for sending {{ entity_name }} details in a response.
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class {{ entity_name }}Response {
+
+    private Long id;
+
+{% for field in fields %}
+    private {{ field.java_type }} {{ field.name }};
+{% endfor %}
+}

devctl/templates/spring/mapper/Mapper.java.j2

@@ -0,0 +1,30 @@
+package {{ base_package }}.mapper;
+
+import {{ base_package }}.entity.{{ entity_name }}Entity;
+import {{ base_package }}.dto.request.{{ entity_name }}Request;
+import {{ base_package }}.dto.response.{{ entity_name }}Response;
+import org.mapstruct.Mapper;
+import org.mapstruct.MappingTarget;
+import org.mapstruct.ReportingPolicy;
+
+/**
+ * Mapper interface for converting between {{ entity_name }} Entity and DTOs.
+ */
+@Mapper(componentModel = "spring", unmappedTargetPolicy = ReportingPolicy.IGNORE)
+public interface {{ entity_name }}Mapper {
+
+    /**
+     * Converts a {{ entity_name }}Entity entity to a {{ entity_name }}Response DTO.
+     */
+    {{ entity_name }}Response toResponse({{ entity_name }}Entity entity);
+
+    /**
+     * Converts a {{ entity_name }}Request DTO to a {{ entity_name }}Entity entity.
+     */
+    {{ entity_name }}Entity toEntity({{ entity_name }}Request request);
+
+    /**
+     * Updates an existing {{ entity_name }}Entity entity from a {{ entity_name }}Request DTO.
+     */
+    void updateEntityFromRequest({{ entity_name }}Request request, @MappingTarget {{ entity_name }}Entity entity);
+}

devctl/templates/vue/config/App.vue.j2

@@ -0,0 +1,35 @@
+<script setup lang="ts">
+// Le layout principal de l'application
+</script>
+
+<template>
+  <div id="app">
+    <header>
+      <nav>
+        <router-link to="/">Accueil</router-link>
+      </nav>
+    </header>
+
+    <main class="container">
+      <router-view />
+    </main>
+  </div>
+</template>
+
+<style scoped>
+header {
+  padding: 1rem;
+  background-color: #f8f9fa;
+  border-bottom: 1px solid #e9ecef;
+  margin-bottom: 2rem;
+}
+nav {
+  display: flex;
+  gap: 1rem;
+}
+.container {
+  max-width: 1200px;
+  margin: 0 auto;
+  padding: 0 1rem;
+}
+</style>

devctl/templates/vue/config/main.ts.j2

@@ -0,0 +1,9 @@
+import { createApp } from 'vue'
+import './style.css'
+import App from './App.vue'
+import router from './router'
+
+const app = createApp(App)
+
+app.use(router)
+app.mount('#app')

devctl/templates/vue/config/router.ts.j2

@@ -0,0 +1,18 @@
+import { createRouter, createWebHistory } from 'vue-router'
+
+// --- DEBUT DES ROUTES DEVCTL ---
+// Les routes générées par 'devctl add resource' seront importées ici
+// --- FIN DES ROUTES DEVCTL ---
+
+const router = createRouter({
+  history: createWebHistory(import.meta.env.BASE_URL),
+  routes: [
+    {
+      path: '/',
+      name: 'home',
+      component: () => import('../components/HelloWorld.vue') // La page d'accueil par défaut de Vite
+    }
+  ]
+})
+
+export default router

devctl/templates/vue/config/vite.config.ts.j2

@@ -0,0 +1,16 @@
+import { defineConfig } from 'vite'
+import vue from '@vitejs/plugin-vue'
+
+// https://vitejs.dev/config/
+export default defineConfig({
+  plugins: [vue()],
+  server: {
+    proxy: {
+      '/api': {
+        target: 'http://localhost:8080',
+        changeOrigin: true,
+        secure: false,
+      }
+    }
+  }
+})

devctl/templates/vue/feature/Form.vue.j2

@@ -0,0 +1,162 @@
+<script setup lang="ts">
+import { ref, onMounted } from 'vue'
+import { useRouter, useRoute } from 'vue-router'
+import { {{ entity_name }}Service } from '../services/{{ entity_name }}Service'
+import type { {{ entity_name }}Request } from '../models/{{ entity_name }}Models'
+
+const router = useRouter()
+const route = useRoute()
+const isEdit = ref(false)
+const id = ref<number | null>(null)
+
+const form = ref<{{ entity_name }}Request>({
+  {% for field in fields -%}
+  {{ field.name }}: {% if field.ts_type == 'number' %}0{% elif field.ts_type == 'boolean' %}false{% else %}''{% endif %},
+  {% endfor -%}
+})
+
+const loading = ref(false)
+const error = ref('')
+
+onMounted(async () => {
+  const paramId = route.params.id
+  if (paramId) {
+    isEdit.value = true
+    id.value = parseInt(paramId as string)
+    loading.value = true
+    try {
+      const data = await {{ entity_name }}Service.getById(id.value)
+      form.value = {
+        {% for field in fields -%}
+        {{ field.name }}: data.{{ field.name }},
+        {% endfor -%}
+      }
+    } catch (err: any) {
+      error.value = err.message || 'Failed to load item.'
+    } finally {
+      loading.value = false
+    }
+  }
+})
+
+const save = async () => {
+  loading.value = true
+  error.value = ''
+  try {
+    if (isEdit.value && id.value !== null) {
+      await {{ entity_name }}Service.update(id.value, form.value)
+    } else {
+      await {{ entity_name }}Service.create(form.value)
+    }
+    router.push('/{{ resource_name_lower }}s')
+  } catch (err: any) {
+    error.value = err.message || 'Failed to save item.'
+  } finally {
+    loading.value = false
+  }
+}
+
+const cancel = () => {
+  router.push('/{{ resource_name_lower }}s')
+}
+</script>
+
+<template>
+  <div class="form-container">
+    <h1>{{"{{"}} isEdit ? 'Edit' : 'Create' {{"}}"}} {{ entity_name }}</h1>
+
+    <div v-if="error" class="error-message">{{ error }}</div>
+
+    <form @submit.prevent="save" class="form">
+      {% for field in fields -%}
+      <div class="form-group">
+        <label for="{{ field.name }}">{{ field.name | capitalize }}</label>
+        {% if field.ts_type == 'boolean' -%}
+        <input type="checkbox" id="{{ field.name }}" v-model="form.{{ field.name }}" />
+        {%- elif field.ts_type == 'number' -%}
+        <input type="number" id="{{ field.name }}" v-model.number="form.{{ field.name }}" required />
+        {%- else -%}
+        <input type="text" id="{{ field.name }}" v-model="form.{{ field.name }}" required />
+        {%- endif %}
+      </div>
+      {% endfor -%}
+
+      <div class="form-actions">
+        <button type="button" @click="cancel" class="btn btn-secondary" :disabled="loading">Cancel</button>
+        <button type="submit" class="btn btn-primary" :disabled="loading">
+          {{"{{"}} loading ? 'Saving...' : 'Save' {{"}}"}}
+        </button>
+      </div>
+    </form>
+  </div>
+</template>
+
+<style scoped>
+.form-container {
+  max-width: 600px;
+  margin: 0 auto;
+  padding: 1.5rem;
+  background: white;
+  border-radius: 8px;
+  box-shadow: 0 4px 6px -1px rgba(0, 0, 0, 0.1), 0 2px 4px -1px rgba(0, 0, 0, 0.06);
+}
+.form {
+  display: flex;
+  flex-direction: column;
+  gap: 1.25rem;
+  margin-top: 1.5rem;
+}
+.form-group {
+  display: flex;
+  flex-direction: column;
+  gap: 0.5rem;
+}
+.form-group label {
+  font-weight: 500;
+  color: #374151;
+}
+.form-group input[type="text"],
+.form-group input[type="number"] {
+  padding: 0.5rem;
+  border: 1px solid #d1d5db;
+  border-radius: 4px;
+}
+.form-group input[type="checkbox"] {
+  width: fit-content;
+}
+.form-actions {
+  display: flex;
+  justify-content: flex-end;
+  gap: 0.75rem;
+  margin-top: 1rem;
+}
+.btn {
+  padding: 0.5rem 1rem;
+  border: none;
+  border-radius: 4px;
+  cursor: pointer;
+  font-weight: 500;
+}
+.btn-primary {
+  background-color: #4f46e5;
+  color: white;
+}
+.btn-primary:disabled {
+  background-color: #a5b4fc;
+}
+.btn-secondary {
+  background-color: #6b7280;
+  color: white;
+}
+.btn-secondary:disabled {
+  background-color: #e5e7eb;
+  color: #9ca3af;
+}
+.error-message {
+  padding: 1rem;
+  background-color: #fee2e2;
+  color: #ef4444;
+  border-radius: 4px;
+  margin-bottom: 1rem;
+}
+</style>

devctl/templates/vue/feature/List.vue.j2

@@ -0,0 +1,155 @@
+<script setup lang="ts">
+import { ref, onMounted } from 'vue'
+import { useRouter } from 'vue-router'
+import { {{ entity_name }}Service } from '../services/{{ entity_name }}Service'
+import type { {{ entity_name }}Response } from '../models/{{ entity_name }}Models'
+
+const router = useRouter()
+const items = ref<{{ entity_name }}Response[]>([])
+const loading = ref(false)
+const error = ref('')
+
+const loadItems = async () => {
+  loading.value = true
+  error.value = ''
+  try {
+    items.value = await {{ entity_name }}Service.getAll()
+  } catch (err: any) {
+    error.value = err.message || 'An error occurred while loading data.'
+  } finally {
+    loading.value = false
+  }
+}
+
+const deleteItem = async (id: number) => {
+  if (!confirm('Are you sure you want to delete this item?')) return
+  try {
+    await {{ entity_name }}Service.delete(id)
+    await loadItems()
+  } catch (err: any) {
+    alert(err.message || 'Failed to delete item.')
+  }
+}
+
+const editItem = (id: number) => {
+  router.push(`/{{ resource_name_lower }}s/${id}/edit`)
+}
+
+const createNew = () => {
+  router.push('/{{ resource_name_lower }}s/new')
+}
+
+onMounted(() => {
+  loadItems()
+})
+</script>
+
+<template>
+  <div class="list-container">
+    <div class="list-header">
+      <h1>List of {{ entity_name }}s</h1>
+      <button @click="createNew" class="btn btn-primary">Create New</button>
+    </div>
+
+    <div v-if="loading" class="loading">Loading...</div>
+    <div v-else-if="error" class="error-message">{{ error }}</div>
+    <div v-else class="table-responsive">
+      <table class="table">
+        <thead>
+          <tr>
+            <th>ID</th>
+            {% for field in fields -%}
+            <th>{{ field.name | capitalize }}</th>
+            {% endfor -%}
+            <th>Actions</th>
+          </tr>
+        </thead>
+        <tbody>
+          <tr v-for="item in items" :key="item.id">
+            <td>{{"{{"}} item.id {{"}}"}}</td>
+            {% for field in fields -%}
+            <td>{{"{{"}} item.{{ field.name }} {{"}}"}}</td>
+            {% endfor -%}
+            <td class="actions">
+              <button @click="editItem(item.id)" class="btn btn-sm btn-secondary">Edit</button>
+              <button @click="deleteItem(item.id)" class="btn btn-sm btn-danger">Delete</button>
+            </td>
+          </tr>
+          <tr v-if="items.length === 0">
+            <td :colspan="{{ fields | length + 2 }}" class="text-center">No items found.</td>
+          </tr>
+        </tbody>
+      </table>
+    </div>
+  </div>
+</template>
+
+<style scoped>
+.list-container {
+  padding: 1.5rem;
+  background: white;
+  border-radius: 8px;
+  box-shadow: 0 4px 6px -1px rgba(0, 0, 0, 0.1), 0 2px 4px -1px rgba(0, 0, 0, 0.06);
+}
+.list-header {
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+  margin-bottom: 1.5rem;
+}
+.btn {
+  padding: 0.5rem 1rem;
+  border: none;
+  border-radius: 4px;
+  cursor: pointer;
+  font-weight: 500;
+}
+.btn-primary {
+  background-color: #4f46e5;
+  color: white;
+}
+.btn-secondary {
+  background-color: #6b7280;
+  color: white;
+}
+.btn-danger {
+  background-color: #ef4444;
+  color: white;
+}
+.btn-sm {
+  padding: 0.25rem 0.5rem;
+  font-size: 0.875rem;
+}
+.table-responsive {
+  overflow-x: auto;
+}
+.table {
+  width: 100%;
+  border-collapse: collapse;
+  margin-top: 1rem;
+}
+.table th, .table td {
+  padding: 0.75rem;
+  text-align: left;
+  border-bottom: 1px solid #e5e7eb;
+}
+.table th {
+  background-color: #f9fafb;
+  font-weight: 600;
+}
+.actions {
+  display: flex;
+  gap: 0.5rem;
+}
+.loading, .error-message {
+  padding: 2rem;
+  text-align: center;
+  font-size: 1.125rem;
+}
+.error-message {
+  color: #ef4444;
+}
+.text-center {
+  text-align: center;
+}
+</style>

devctl/templates/vue/feature/models.ts.j2

@@ -0,0 +1,12 @@
+export interface {{ entity_name }}Request {
+  {% for field in fields -%}
+  {{ field.name }}: {{ field.ts_type }};
+  {% endfor -%}
+}
+
+export interface {{ entity_name }}Response {
+  id: number;
+  {% for field in fields -%}
+  {{ field.name }}: {{ field.ts_type }};
+  {% endfor -%}
+}

devctl/templates/vue/feature/routes.ts.j2

@@ -0,0 +1,19 @@
+import type { RouteRecordRaw } from 'vue-router'
+
+export const {{ resource_name_lower }}Routes: RouteRecordRaw[] = [
+  {
+    path: '/{{ resource_name_lower }}s',
+    name: '{{ resource_name_lower }}-list',
+    component: () => import('./views/{{ entity_name }}List.vue')
+  },
+  {
+    path: '/{{ resource_name_lower }}s/new',
+    name: '{{ resource_name_lower }}-new',
+    component: () => import('./views/{{ entity_name }}Form.vue')
+  },
+  {
+    path: '/{{ resource_name_lower }}s/:id/edit',
+    name: '{{ resource_name_lower }}-edit',
+    component: () => import('./views/{{ entity_name }}Form.vue')
+  }
+]

devctl/templates/vue/feature/service.ts.j2

@@ -0,0 +1,44 @@
+import type { {{ entity_name }}Request, {{ entity_name }}Response } from '../models/{{ entity_name }}Models'
+
+export class {{ entity_name }}Service {
+  private static baseUrl = '/api/{{ resource_name_lower }}s'
+
+  static async getAll(): Promise<{{ entity_name }}Response[]> {
+    const res = await fetch(this.baseUrl)
+    if (!res.ok) throw new Error('Failed to fetch {{ resource_name_lower }}s')
+    return res.json()
+  }
+
+  static async getById(id: number): Promise<{{ entity_name }}Response> {
+    const res = await fetch(`${this.baseUrl}/${id}`)
+    if (!res.ok) throw new Error('Failed to fetch {{ resource_name_lower }}')
+    return res.json()
+  }
+
+  static async create(data: {{ entity_name }}Request): Promise<{{ entity_name }}Response> {
+    const res = await fetch(this.baseUrl, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify(data)
+    })
+    if (!res.ok) throw new Error('Failed to create {{ resource_name_lower }}')
+    return res.json()
+  }
+
+  static async update(id: number, data: {{ entity_name }}Request): Promise<{{ entity_name }}Response> {
+    const res = await fetch(`${this.baseUrl}/${id}`, {
+      method: 'PUT',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify(data)
+    })
+    if (!res.ok) throw new Error('Failed to update {{ resource_name_lower }}')
+    return res.json()
+  }
+
+  static async delete(id: number): Promise<void> {
+    const res = await fetch(`${this.baseUrl}/${id}`, {
+      method: 'DELETE'
+    })
+    if (!res.ok) throw new Error('Failed to delete {{ resource_name_lower }}')
+  }
+}

devctl/utils/__init__.py

@@ -0,0 +1,3 @@
+"""
+General utility functions and helpers.
+"""

devctl/utils/dependencies.py

@@ -0,0 +1,36 @@
+"""
+Utility functions for checking system dependencies.
+Verifies if required tools like Docker, NPM, and Java are installed.
+"""
+
+import shutil
+
+import typer
+
+
+def check_tool(tool_name: str, required_for: str = "this operation"):
+    """
+    Check if a tool is available in the system PATH.
+    If not, print a friendly error message and exit.
+    """
+    if shutil.which(tool_name) is None:
+        typer.secho(
+            f"\nError: '{tool_name}' is not installed or not in your PATH.",
+            fg=typer.colors.RED,
+            bold=True,
+        )
+        typer.echo(f"It is required for {required_for}.")
+
+        # Provide helpful hints for common tools
+        hints = {
+            "docker": "Visit https://docs.docker.com/get-docker/",
+            "npm": "Install Node.js from https://nodejs.org/",
+            "java": "Install OpenJDK (e.g., version 17) from your package manager.",
+            "mvnw": "Ensure you are in a Spring Boot project root with the 'mvnw' wrapper.",
+            "ng": "Install Angular CLI using 'npm install -g @angular/cli'.",
+        }
+
+        if tool_name in hints:
+            typer.echo(f"Hint: {hints[tool_name]}")
+
+        raise typer.Exit(code=1)

devctl/utils/env_loader.py

@@ -0,0 +1,57 @@
+"""
+Utility for loading environment variables from .env files.
+"""
+
+import os
+from pathlib import Path
+from typing import Dict
+
+
+def load_env_file(project_path: Path) -> Dict[str, str]:
+    """
+    Reads a .env file in the given path and returns a dictionary of variables.
+    Does not override existing environment variables in os.environ by default
+    when used for process injection, but provides the mapping for merge.
+    """
+    env_vars = {}
+    env_path = project_path / ".env"
+
+    if not env_path.exists():
+        return env_vars
+
+    try:
+        with open(env_path, "r", encoding="utf-8") as f:
+            for line in f:
+                line = line.strip()
+                # Skip comments and empty lines
+                if not line or line.startswith("#"):
+                    continue
+
+                if "=" in line:
+                    key, value = line.split("=", 1)
+                    # Clean key and value
+                    key = key.strip()
+                    value = value.strip()
+
+                    # Remove quotes if present
+                    if (value.startswith('"') and value.endswith('"')) or (
+                        value.startswith("'") and value.endswith("'")
+                    ):
+                        value = value[1:-1]
+
+                    env_vars[key] = value
+    except Exception:
+        # Fail silently to not break the runner if .env is malformed
+        pass
+
+    return env_vars
+
+
+def get_project_env(project_path: Path) -> Dict[str, str]:
+    """
+    Returns a full environment dictionary merging system env and .env file.
+    """
+    env = os.environ.copy()
+    dot_env = load_env_file(project_path)
+    env.update(dot_env)
+    return env