kadi-deploy 0.19.0

package/src/display/resources.ts

@@ -0,0 +1,234 @@
+/**
+ * Service Resources Display Utilities
+ *
+ * Formats and displays service resource allocations from deploy-ability's
+ * AkashDeploymentData.services field.
+ *
+ * @module display/resources
+ */
+
+import type { AkashDeploymentData } from '@kadi.build/deploy-ability/types';
+import { formatKeyValue, dim, bold, info } from '../cli/colors.js';
+
+/**
+ * Displays service resources in a formatted manner
+ *
+ * Shows both aggregated totals and detailed resource specs for each service.
+ *
+ * @param services - Services array from AkashDeploymentData
+ * @param indent - Indentation level (default: 2)
+ *
+ * @example
+ * ```typescript
+ * displayServiceResources(deploymentData.services);
+ * // Output:
+ * // Services:
+ * //   web (4 replicas):
+ * //     Total: 5.0 CPU, 10Gi RAM, 5Gi Storage
+ * //     Specs:
+ * //       - 3× 1.0 CPU, 2Gi RAM, 1Gi Storage
+ * //       - 1× 2.0 CPU, 4Gi RAM, 2Gi Storage
+ * ```
+ */
+export function displayServiceResources(
+  services: AkashDeploymentData['services'],
+  indent: number = 2
+): void {
+  if (!services || services.length === 0) {
+    return;
+  }
+
+  const prefix = ' '.repeat(indent);
+
+  for (const service of services) {
+    console.log(`${prefix}${bold(service.name)} ${dim(`(${service.replicaCount} ${service.replicaCount === 1 ? 'replica' : 'replicas'})`)}:`);
+
+    // Display aggregated totals
+    console.log(
+      `${prefix}  ${formatKeyValue('Total Resources', `${service.totalResources.cpu} CPU, ${service.totalResources.memory} RAM, ${service.totalResources.storage} Storage`)}`
+    );
+
+    // Display detailed specs if there are multiple configurations
+    if (service.resourceSpecs.length > 1) {
+      console.log(`${prefix}  ${dim('Resource Specs:')}`);
+      for (const spec of service.resourceSpecs) {
+        console.log(
+          `${prefix}    ${dim('•')} ${info(`${spec.count}×`)} ${spec.cpu} CPU, ${spec.memory} RAM, ${spec.storage} Storage`
+        );
+      }
+    } else if (service.resourceSpecs.length === 1) {
+      // Single spec - show replica configuration
+      const spec = service.resourceSpecs[0];
+      console.log(
+        `${prefix}  ${formatKeyValue('Per Replica', `${spec.cpu} CPU, ${spec.memory} RAM, ${spec.storage} Storage`)}`
+      );
+    }
+
+    console.log('');
+  }
+}
+
+/**
+ * Gets a compact one-line resource summary for a service
+ *
+ * Useful for displaying in summaries or lists.
+ *
+ * @param service - Service object from AkashDeploymentData.services
+ * @returns Formatted resource string
+ *
+ * @example
+ * ```typescript
+ * const summary = getResourceSummary(service);
+ * console.log(`web: ${summary}`);
+ * // Output: "web: 4 replicas • 5.0 CPU, 10Gi RAM, 5Gi Storage"
+ * ```
+ */
+export function getResourceSummary(
+  service: NonNullable<AkashDeploymentData['services']>[number]
+): string {
+  return `${service.replicaCount} ${service.replicaCount === 1 ? 'replica' : 'replicas'} • ${service.totalResources.cpu} CPU, ${service.totalResources.memory} RAM, ${service.totalResources.storage} Storage`;
+}
+
+/**
+ * Displays all services in a compact table format
+ *
+ * Shows service name, replica count, and total resources in a clean layout.
+ *
+ * @param services - Services array from AkashDeploymentData
+ * @param indent - Indentation level (default: 0)
+ *
+ * @example
+ * ```typescript
+ * displayServicesTable(deploymentData.services);
+ * // Output:
+ * // Services:
+ * //   web       4 replicas    5.0 CPU    10Gi RAM    5Gi Storage
+ * //   api       2 replicas    2.0 CPU     4Gi RAM    2Gi Storage
+ * ```
+ */
+export function displayServicesTable(
+  services: AkashDeploymentData['services'],
+  indent: number = 0
+): void {
+  if (!services || services.length === 0) {
+    return;
+  }
+
+  const prefix = ' '.repeat(indent);
+
+  console.log(`${prefix}${bold('Services:')}`);
+
+  // Calculate column widths
+  const nameWidth = Math.max(...services.map(s => s.name.length), 7);
+  const replicaWidth = 12;
+  const cpuWidth = 10;
+  const memWidth = 10;
+  const storageWidth = 12;
+
+  // Display each service
+  for (const service of services) {
+    const name = service.name.padEnd(nameWidth);
+    const replicas = `${service.replicaCount} ${service.replicaCount === 1 ? 'replica ' : 'replicas'}`.padEnd(replicaWidth);
+    const cpu = service.totalResources.cpu.padEnd(cpuWidth);
+    const mem = service.totalResources.memory.padEnd(memWidth);
+    const storage = service.totalResources.storage.padEnd(storageWidth);
+
+    console.log(
+      `${prefix}  ${name}  ${dim(replicas)}  ${info(cpu)}  ${info(mem)}  ${info(storage)}`
+    );
+  }
+
+  console.log('');
+}
+
+/**
+ * Calculates total resources across all services
+ *
+ * Useful for showing overall deployment resource usage.
+ *
+ * @param services - Services array from AkashDeploymentData
+ * @returns Total CPU, memory, and storage
+ *
+ * @example
+ * ```typescript
+ * const totals = calculateTotalResources(deploymentData.services);
+ * console.log(`Total: ${totals.cpu} CPU, ${totals.memory} RAM, ${totals.storage} Storage`);
+ * ```
+ */
+export function calculateTotalResources(
+  services: AkashDeploymentData['services']
+): { cpu: number; memory: number; storage: number } {
+  if (!services || services.length === 0) {
+    return { cpu: 0, memory: 0, storage: 0 };
+  }
+
+  let totalCpu = 0;
+  let totalMemory = 0;
+  let totalStorage = 0;
+
+  for (const service of services) {
+    // Parse CPU (e.g., "5.0" -> 5.0)
+    totalCpu += parseFloat(service.totalResources.cpu) || 0;
+
+    // Parse memory (e.g., "10Gi" -> bytes)
+    totalMemory += parseResourceValue(service.totalResources.memory);
+
+    // Parse storage (e.g., "5Gi" -> bytes)
+    totalStorage += parseResourceValue(service.totalResources.storage);
+  }
+
+  return {
+    cpu: totalCpu,
+    memory: totalMemory,
+    storage: totalStorage
+  };
+}
+
+/**
+ * Parses a resource string to bytes
+ *
+ * Converts strings like "10Gi", "512Mi", "1Ti" to byte values.
+ *
+ * @param value - Resource string
+ * @returns Value in bytes
+ */
+function parseResourceValue(value: string): number {
+  const match = value.match(/^([\d.]+)(Ki|Mi|Gi|Ti|Pi)?$/);
+  if (!match) return 0;
+
+  const num = parseFloat(match[1]);
+  const unit = match[2] || '';
+
+  const multipliers: Record<string, number> = {
+    '': 1,
+    'Ki': 1024,
+    'Mi': 1024 * 1024,
+    'Gi': 1024 * 1024 * 1024,
+    'Ti': 1024 * 1024 * 1024 * 1024,
+    'Pi': 1024 * 1024 * 1024 * 1024 * 1024
+  };
+
+  return num * (multipliers[unit] || 1);
+}
+
+/**
+ * Formats bytes to human-readable string
+ *
+ * @param bytes - Byte value
+ * @returns Formatted string (e.g., "10Gi", "512Mi")
+ */
+export function formatBytes(bytes: number): string {
+  if (bytes === 0) return '0';
+
+  const units = ['', 'Ki', 'Mi', 'Gi', 'Ti', 'Pi'];
+  let unitIndex = 0;
+  let value = bytes;
+
+  while (value >= 1024 && unitIndex < units.length - 1) {
+    value /= 1024;
+    unitIndex++;
+  }
+
+  const formatted = value.toFixed(2).replace(/\.?0+$/, '');
+  return `${formatted}${units[unitIndex]}`;
+}