@agilecustoms/envctl 0.25.0 → 0.27.0

package/README.md

@@ -7,8 +7,8 @@
 
 ```shell
 terraform init -backend-config=key=laxa1986
-# TODO: remove --env in next minor release
-envctl deploy --env laxa1986 -var-file=versions.tfvars -var="log_level=debug"
+envctl deploy -var-file=versions.tfvars -var="log_level=debug"
+envctl delete
 ```
 
 ## setup/update

package/dist/client/CliHelper.js

@@ -1,12 +1,7 @@
 import path from 'path';
 import inquirer from 'inquirer';
-import { KnownException } from '../exceptions.js';
-import { ConfigService } from '../service/index.js';
 export class CliHelper {
-    configService;
-    constructor(configService) {
-        this.configService = configService;
-    }
+    constructor() { }
     async promptYesNo(message, defaultValue = false) {
         const { answer } = await inquirer.prompt([{
                 type: 'confirm',
@@ -16,34 +11,8 @@ export class CliHelper {
             }]);
         return answer;
     }
-    ensureEnv(key) {
-        if (key) {
-            return key;
-        }
-        const owner = this.configService.getOwner();
-        if (!owner) {
-            throw new KnownException('--key argument is not provided\n'
-                + 'default to owner from local configuration, but it is not configured\n'
-                + 'please call with --key argument or run \'envctl configure\' to configure owner');
-        }
-        console.log(`Key is not provided, default to owner name ${owner}`);
-        return owner;
-    }
-    ensureOwner(owner) {
-        if (!owner) {
-            owner = this.configService.getOwner();
-            if (!owner) {
-                throw new KnownException('when called without --owner option, first call \'envctl configure\'');
-            }
-            console.log(`Owner not provided, default to configured owner ${owner}`);
-        }
-        return owner;
-    }
-    ensureKind(kind, cwd) {
-        if (kind) {
-            return kind;
-        }
-        kind = getDirName(cwd);
+    getKind(cwd) {
+        const kind = getDirName(cwd);
         console.log(`Inferred kind from directory name: ${kind}`);
         return kind;
     }

package/dist/client/ProcessRunner.js

@@ -1,14 +1,7 @@
 import { spawn } from 'child_process';
-import path from 'path';
 import * as readline from 'readline';
-import { fileURLToPath } from 'url';
 import { ProcessException } from '../exceptions.js';
 export class ProcessRunner {
-    async runScript(script, args = [], cwd, scanner) {
-        const __dirname = path.dirname(fileURLToPath(import.meta.url));
-        const scriptPath = path.join(__dirname, `../../scripts/${script}`);
-        await this.run(scriptPath, args, cwd, scanner);
-    }
     async run(command, args, cwd, out_scanner, in_scanner) {
         const spawnOptions = {
             stdio: ['pipe', 'pipe', 'pipe'],

package/dist/client/TerraformAdapter.js

@@ -14,6 +14,38 @@ export class TerraformAdapter {
         this.processRunner = processRunner;
         this.cliHelper = cliHelper;
     }
+    getKey(cwd) {
+        const dir = cwd ?? process.cwd();
+        const statePath = path.join(dir, '.terraform', 'terraform.tfstate');
+        if (!fs.existsSync(statePath)) {
+            throw new KnownException(`Terraform state file not found at: ${statePath}`);
+        }
+        let content;
+        try {
+            content = fs.readFileSync(statePath, 'utf8');
+        }
+        catch (err) {
+            throw new KnownException(`Failed to read terraform state file: ${statePath}`, { cause: err });
+        }
+        let tfstate;
+        try {
+            tfstate = JSON.parse(content);
+        }
+        catch (err) {
+            throw new KnownException(`Failed to parse terraform state file: ${statePath}`, { cause: err });
+        }
+        const backend = tfstate.backend;
+        const type = backend?.type;
+        if (type !== 's3') {
+            throw new KnownException(`Unsupported terraform backend type: ${type}. Only 's3' is supported for key inference`);
+        }
+        const config = backend?.config;
+        const key = config?.key;
+        if (!key) {
+            throw new KnownException(`Terraform backend config does not contain 'key' attribute`);
+        }
+        return key;
+    }
     printTime() {
         const now = new Date();
         const utc = now.toISOString();
@@ -22,50 +54,6 @@ export class TerraformAdapter {
         });
         console.log(`\nTime EST: ${est},  UTC: ${utc}\n`);
     }
-    async init(key, cwd, upgrade = false) {
-        let accAlias = '';
-        const accAliasScanner = (line) => {
-            accAlias = line;
-        };
-        await this.processRunner.runScript('get-acc-alias.sh', [], cwd, accAliasScanner);
-        console.log('Run terraform init to download providers, this doesn\'t create any resources in AWS even S3 object');
-        let emptyDir = false;
-        const scanner = (line) => {
-            if (line.includes('Terraform initialized in an empty directory!')) {
-                emptyDir = true;
-            }
-        };
-        const bucket = `agilecustoms-${accAlias}-tf-state`;
-        const args = [
-            'init',
-            '-reconfigure',
-            `-backend-config=bucket=${bucket}`,
-            `-backend-config=key=${key}`
-        ];
-        if (upgrade) {
-            args.push('-upgrade');
-        }
-        this.printTime();
-        try {
-            await this.processRunner.run('terraform', args, cwd, scanner);
-            this.printTime();
-        }
-        catch (error) {
-            if (error instanceof ProcessException) {
-                if (!upgrade && error.message.includes('Failed to query available provider packages')) {
-                    args.push('-upgrade');
-                    await this.processRunner.run('terraform', args, cwd);
-                    this.printTime();
-                    return;
-                }
-                throw new KnownException(`terraform init failed with code ${error.code}:\n${error.message}`, { cause: error });
-            }
-            throw error;
-        }
-        if (emptyDir) {
-            throw new KnownException('Can not find terraform files. Command needs to be run in a directory with terraform files');
-        }
-    }
     tfArgs(env, cwd) {
         const varDefs = this.getVarDefs(cwd);
         const argVars = this.getArgVars(env.args);

package/dist/commands/delete.js

@@ -1,5 +1,5 @@
 import { Command } from 'commander';
-import { cliHelper, envCtl } from '../container.js';
+import { envCtl } from '../container.js';
 import { _keys } from './_keys.js';
 import { wrap } from './_utils.js';
 export function deleteIt(program) {
@@ -13,6 +13,5 @@ export function deleteIt(program) {
 }
 async function handler(options) {
     const { key, force, cwd } = options;
-    const theKey = cliHelper.ensureEnv(key);
-    await envCtl.delete(theKey, Boolean(force), cwd);
+    await envCtl.delete(Boolean(force), key, cwd);
 }

package/dist/commands/deploy.js

@@ -6,9 +6,6 @@ export function deploy(program) {
     program
         .command('deploy')
         .description('Create new or update existing dev environment')
-        .option('--key <key>', _keys.KEY)
-        .option('--owner <owner>', _keys.OWNER)
-        .option('--kind <kind>', _keys.KIND)
         .option('--cwd <cwd>', _keys.CWD)
         .allowUnknownOption(true)
         .argument('[args...]')
@@ -16,6 +13,6 @@ export function deploy(program) {
 }
 async function handler(tfArgs, options) {
     await awsCredsHelper.ensureCredentials();
-    const { cwd, ...envDto } = options;
-    await envCtl.deploy(envDto, tfArgs, cwd);
+    const { cwd } = options;
+    await envCtl.deploy(tfArgs, cwd);
 }

package/dist/commands/destroy.js

@@ -1,5 +1,5 @@
 import { Command } from 'commander';
-import { cliHelper, envCtl } from '../container.js';
+import { envCtl } from '../container.js';
 import { _keys } from './_keys.js';
 import { wrap } from './_utils.js';
 export function destroy(program) {
@@ -7,8 +7,8 @@ export function destroy(program) {
         .command('destroy')
         .description('Destroy environment resources. This is thin wrapper for terraform destroy.'
         + ' Unlike "delete" command (which just schedule deletion) this command deletes resources synchronously.'
+        + ' Unlike "delete" command, this command doesn\'t have --key option, it can only delete env after key you provided during terraform init.'
         + ' Main use case - test deletion process, basically that you have enough permissions to delete resources')
-        .option('--key <key>', _keys.KEY)
         .option('--force', _keys.FORCE)
         .option('--cwd <cwd>', _keys.CWD)
         .allowUnknownOption(true)
@@ -16,7 +16,6 @@ export function destroy(program) {
         .action(wrap(handler));
 }
 async function handler(tfArgs, options) {
-    const { key, force, cwd } = options;
-    const theKey = cliHelper.ensureEnv(key);
-    await envCtl.destroy(theKey, tfArgs, Boolean(force), cwd);
+    const { force, cwd } = options;
+    await envCtl.destroy(tfArgs, Boolean(force), cwd);
 }

package/dist/commands/index.js

@@ -3,6 +3,5 @@ export { createEphemeral } from './createEphemeral.js';
 export { deleteIt } from './delete.js';
 export { deploy } from './deploy.js';
 export { destroy } from './destroy.js';
-export { init } from './init.js';
 export { plan } from './plan.js';
 export { status } from './status.js';

package/dist/commands/plan.js

@@ -7,8 +7,6 @@ export function plan(program) {
         .command('plan')
         .description('High level wrapper for terraform plan. Compliments deploy command: if you plan to deploy env with envctl deploy,'
         + ' then it is recommended to do plan with envctl plan to guarantee consistent behavior')
-        .option('--key <key>', _keys.KEY)
-        .option('--owner <owner>', _keys.OWNER)
         .option('--cwd <cwd>', _keys.CWD)
         .allowUnknownOption(true)
         .argument('[args...]')
@@ -16,6 +14,6 @@ export function plan(program) {
 }
 async function handler(tfArgs, options) {
     await awsCredsHelper.ensureCredentials();
-    const { cwd, ...envDto } = options;
-    await envCtl.plan(envDto, tfArgs, cwd);
+    const { cwd } = options;
+    await envCtl.plan(tfArgs, cwd);
 }

package/dist/commands/status.js

@@ -1,5 +1,5 @@
 import { Command } from 'commander';
-import { cliHelper, envCtl } from '../container.js';
+import { envCtl } from '../container.js';
 import { _keys } from './_keys.js';
 import { wrap } from './_utils.js';
 export function status(program) {
@@ -12,6 +12,5 @@ export function status(program) {
 }
 async function handler(options) {
     const { key, cwd } = options;
-    const theKey = cliHelper.ensureEnv(key);
-    await envCtl.status(theKey, cwd);
+    await envCtl.status(key, cwd);
 }

package/dist/container.js

@@ -2,12 +2,12 @@ import { AwsCredsHelper } from './client/AwsCredsHelper.js';
 import { CliHelper, EnvApiClient, HttpClient, TerraformAdapter } from './client/index.js';
 import { ProcessRunner } from './client/ProcessRunner.js';
 import { ConfigService, EnvCtl } from './service/index.js';
-const configService = new ConfigService();
-const cliHelper = new CliHelper(configService);
+const cliHelper = new CliHelper();
 const awsCredsHelper = new AwsCredsHelper();
 const httpClient = new HttpClient(awsCredsHelper);
 const envApiClient = new EnvApiClient(httpClient);
 const processRunner = new ProcessRunner();
 const terraformAdapter = new TerraformAdapter(processRunner, cliHelper);
-const envCtl = new EnvCtl(cliHelper, envApiClient, terraformAdapter);
+const configService = new ConfigService();
+const envCtl = new EnvCtl(cliHelper, envApiClient, terraformAdapter, configService);
 export { awsCredsHelper, cliHelper, configService, envCtl };

package/dist/index.js

@@ -2,7 +2,7 @@
 import { createRequire } from 'module';
 import { Command } from 'commander';
 import updateNotifier from 'update-notifier';
-import { configure, createEphemeral, deleteIt, deploy, destroy, init, plan, status } from './commands/index.js';
+import { configure, createEphemeral, deleteIt, deploy, destroy, plan, status } from './commands/index.js';
 const require = createRequire(import.meta.url);
 const pkg = require('../package.json');
 updateNotifier({ pkg, updateCheckInterval: 0 }).notify();
@@ -16,7 +16,6 @@ createEphemeral(program);
 deleteIt(program);
 deploy(program);
 destroy(program);
-init(program);
 plan(program);
 status(program);
 program.parse(process.argv);

package/dist/service/ConfigService.js

@@ -1,6 +1,7 @@
 import * as fs from 'node:fs';
 import * as os from 'node:os';
 import path from 'path';
+import { KnownException } from '../exceptions.js';
 const CONFIG_PATH = path.join(os.homedir(), '.envctl', 'config.json');
 export class ConfigService {
     config;
@@ -23,6 +24,10 @@ export class ConfigService {
         return this.config;
     }
     getOwner() {
-        return this.loadConfig()?.owner;
+        const owner = this.loadConfig()?.owner;
+        if (!owner) {
+            throw new KnownException('please first set owner via calling \'envctl configure\'');
+        }
+        return owner;
     }
 }

package/dist/service/EnvCtl.js

@@ -4,32 +4,37 @@ export class EnvCtl {
     cliHelper;
     envApi;
     terraformAdapter;
-    constructor(cliHelper, envApi, terraformAdapter) {
+    configService;
+    constructor(cliHelper, envApi, terraformAdapter, configService) {
         this.cliHelper = cliHelper;
         this.envApi = envApi;
         this.terraformAdapter = terraformAdapter;
+        this.configService = configService;
+    }
+    getKey(key, cwd) {
+        if (!key) {
+            console.log('Key is not provided, inferring from .terraform/terraform.tfstate file');
+            key = this.terraformAdapter.getKey(cwd);
+        }
+        return key;
     }
     async status(key, cwd) {
+        key = this.getKey(key, cwd);
         console.log(`Retrieve env ${key}`);
         const env = await this.envApi.get(key);
         if (env === null) {
             console.log(`Env ${key} does not exist`);
             return;
         }
-        const kind = env.kind ? this.cliHelper.ensureKind(undefined, cwd) : undefined;
         console.log(`Env ${key} status: ${env.status}`);
-        if (env.kind && env.kind !== kind) {
-            console.warn(`Env ${key} kind (dir-name): ${env.kind} - looks like this env was deployed from a different directory`);
+        if (env.kind) {
+            const kind = this.cliHelper.getKind(cwd);
+            if (env.kind !== kind) {
+                console.warn(`Env ${key} kind (dir-name): ${env.kind} - looks like this env was deployed from a different directory`);
+            }
         }
     }
-    async tryGetEnv(input) {
-        let key = input.key;
-        let owner = input.owner;
-        if (!key) {
-            owner = this.cliHelper.ensureOwner(owner);
-            console.log(`Env name not provided, default to owner name ${owner}`);
-            key = owner;
-        }
+    async tryGetEnv(key) {
         console.log(`Check if env ${key} already exists`);
         const env = await this.envApi.get(key);
         if (env) {
@@ -38,15 +43,17 @@ export class EnvCtl {
         else {
             console.log(`Env ${key} does not exist`);
         }
-        return { anOwner: owner, key, env };
+        return env;
     }
-    checkInput(env, input, cwd) {
-        if (input.owner && env.owner !== input.owner) {
-            throw new KnownException(`Can not change env owner ${env.owner} -> ${input.owner}`);
-        }
-        const kind = this.cliHelper.ensureKind(input.kind, cwd);
-        if ((input.kind || env.kind) && kind !== env.kind) {
-            throw new KnownException(`Can not change env kind ${env.kind} -> ${kind}`);
+    checkInput(env, owner, cwd) {
+        if (env.owner !== owner) {
+            throw new KnownException(`Can not change env owner ${env.owner} -> ${owner}`);
+        }
+        if (env.kind) {
+            const kind = this.cliHelper.getKind(cwd);
+            if (kind !== env.kind) {
+                throw new KnownException(`Can not change env kind ${env.kind} -> ${kind}`);
+            }
         }
     }
     checkStatus(env, availableStatuses = [EnvStatus.Init, EnvStatus.Deploying, EnvStatus.Active, EnvStatus.Updating]) {
@@ -58,18 +65,16 @@ export class EnvCtl {
         }
         throw new KnownException(`Env ${env.key} status is ${env.status}, can not run this command`);
     }
-    async init(key, cwd) {
-        await this.terraformAdapter.init(key, cwd, true);
-    }
-    async plan(input, tfArgs, cwd) {
-        const { anOwner, key, env } = await this.tryGetEnv(input);
+    async plan(tfArgs, cwd) {
+        const key = this.terraformAdapter.getKey(cwd);
+        const owner = this.configService.getOwner();
+        const env = await this.tryGetEnv(key);
         if (env == null) {
-            const owner = this.cliHelper.ensureOwner(anOwner);
-            await this.runPlan(key, owner, tfArgs, undefined, cwd);
+            const vars = undefined;
+            await this.runPlan(key, owner, tfArgs, vars, cwd);
             return;
         }
-        this.checkInput(env, input, cwd);
-        const owner = env.owner;
+        this.checkInput(env, owner, cwd);
         this.checkStatus(env);
         await this.promptUnlock(env);
         if (env.status !== EnvStatus.Active) {
@@ -79,7 +84,6 @@ export class EnvCtl {
     }
     async runPlan(key, owner, args, vars, cwd) {
         const envTerraform = { key, ephemeral: false, owner, args, vars };
-        await this.terraformAdapter.init(key, cwd);
         await this.terraformAdapter.plan(envTerraform, cwd);
     }
     async createEphemeral(key, owner) {
@@ -90,17 +94,18 @@ export class EnvCtl {
         const createEnv = { key, owner };
         return await this.envApi.createEphemeral(createEnv);
     }
-    async deploy(input, tfArgs, cwd) {
-        const { anOwner, key, env } = await this.tryGetEnv(input);
+    async deploy(tfArgs, cwd) {
+        const key = this.terraformAdapter.getKey(cwd);
+        const owner = this.configService.getOwner();
+        const env = await this.tryGetEnv(key);
         if (env === null) {
-            const owner = this.cliHelper.ensureOwner(anOwner);
-            const kind = this.cliHelper.ensureKind(input.kind, cwd);
-            console.log('Creating env tracking record in DynamoDB');
+            const kind = this.cliHelper.getKind(cwd);
+            console.log('Creating env metadata');
             const createEnv = { key, owner, kind };
             const newEnv = await this.envApi.create(createEnv);
             return await this.runDeploy(newEnv, key, tfArgs, cwd);
         }
-        this.checkInput(env, input, cwd);
+        this.checkInput(env, owner, cwd);
         this.checkStatus(env);
         if (env.status === EnvStatus.Init) {
             await this.envApi.lockForUpdate(env);
@@ -120,7 +125,6 @@ export class EnvCtl {
         await this.runDeploy(env, key, tfArgs, cwd);
     }
     async runDeploy(env, key, tfArgs, cwd) {
-        await this.terraformAdapter.init(env.key, cwd);
         console.log('Deploying resources');
         const { ephemeral, vars } = env;
         const envTerraform = { key, ephemeral, owner: env.owner || 'system', args: tfArgs, vars };
@@ -139,7 +143,8 @@ export class EnvCtl {
         console.log('Activating env (to finish creation)');
         await this.envApi.activate(env);
     }
-    async delete(key, force, cwd) {
+    async delete(force, key, cwd) {
+        key = this.getKey(key, cwd);
         const env = await this.get(key);
         if (!force) {
             this.checkStatus(env);
@@ -148,7 +153,7 @@ export class EnvCtl {
                 console.log(`Env ${env.key} is deleted`);
                 return;
             }
-            const kind = this.cliHelper.ensureKind(undefined, cwd);
+            const kind = this.cliHelper.getKind(cwd);
             if (env.kind && env.kind !== kind) {
                 const answerYes = await this.cliHelper.promptYesNo(`Env ${env.key} kind (dir-name): ${env.kind}\n`
                     + 'You\'re deleting env deployed from different dir\n'
@@ -167,7 +172,8 @@ export class EnvCtl {
         const message = await this.envApi.delete(env);
         console.log(message);
     }
-    async destroy(key, tfArgs, force, cwd) {
+    async destroy(tfArgs, force, cwd) {
+        const key = this.terraformAdapter.getKey(cwd);
         const env = await this.get(key);
         this.checkStatus(env);
         if (env.status === EnvStatus.Init) {
@@ -175,7 +181,7 @@ export class EnvCtl {
             return;
         }
         if (!force) {
-            const kind = this.cliHelper.ensureKind(undefined, cwd);
+            const kind = this.cliHelper.getKind(cwd);
             if (env.kind && env.kind !== kind) {
                 throw new KnownException(`Env ${env.key} kind (dir-name): ${env.kind} - make sure you run destroy from the same directory`);
             }
@@ -191,7 +197,6 @@ export class EnvCtl {
         const { ephemeral, owner, vars } = env;
         const envTerraform = { key, ephemeral, owner: owner || 'system', args: tfArgs, vars };
         console.log('Destroying env resources');
-        await this.terraformAdapter.init(env.key, cwd);
         await this.terraformAdapter.destroy(envTerraform, force, cwd);
         console.log('Unlock env');
         await this.envApi.activate(env);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@agilecustoms/envctl",
   "description": "node.js CLI client for manage environments",
-  "version": "0.25.0",
+  "version": "0.27.0",
   "author": "Alex Chekulaev",
   "type": "module",
   "bin": {
@@ -30,19 +30,18 @@
     "run-configure": "tsc --sourceMap true && npm run run -- configure",
     "~": "",
     "run-init": "cd ../tt-core && terraform init -backend-config=key=laxa1986 -upgrade",
-    "*": "",
     "run-status": " tsc --sourceMap true && npm run run -- status  --cwd ../tt-core",
     "run-plan": "   tsc --sourceMap true && npm run run -- plan    --cwd ../tt-core",
     "run-deploy": " tsc --sourceMap true && npm run run -- deploy  --cwd ../tt-core -var=\"env_size=min\"",
     "run-delete": " tsc --sourceMap true && npm run run -- delete  --cwd ../tt-core",
     "run-destroy": "tsc --sourceMap true && npm run run -- destroy --cwd ../tt-core",
     "-": "",
-    "run-ephemeral-create": " tsc --sourceMap true && npm run run -- create-ephemeral --env test",
-    "run-ephemeral-status": " tsc --sourceMap true && npm run run -- status  --env test",
-    "run-ephemeral-init": "   tsc --sourceMap true && npm run run -- init    --env test --cwd ../tt-gitops",
-    "run-ephemeral-deploy": " tsc --sourceMap true && npm run run -- deploy  --env test --cwd ../tt-gitops -var-file=versions.tfvars",
-    "run-ephemeral-delete": " tsc --sourceMap true && npm run run -- delete  --env test --cwd ../tt-gitops --force",
-    "run-ephemeral-destroy": "tsc --sourceMap true && npm run run -- destroy --env test --cwd ../tt-gitops --force -var-file=versions.tfvars"
+    "run-ephemeral-init": "cd ../tt-gitops && terraform init -backend-config=key=test",
+    "run-ephemeral-create": " tsc --sourceMap true && npm run run -- create-ephemeral",
+    "run-ephemeral-status": " tsc --sourceMap true && npm run run -- status --key test",
+    "run-ephemeral-deploy": " tsc --sourceMap true && npm run run -- deploy  --cwd ../tt-gitops -var-file=versions.tfvars",
+    "run-ephemeral-delete": " tsc --sourceMap true && npm run run -- delete  --cwd ../tt-gitops --force",
+    "run-ephemeral-destroy": "tsc --sourceMap true && npm run run -- destroy --cwd ../tt-gitops --force -var-file=versions.tfvars"
   },
   "dependencies": {
     "@aws-sdk/client-sts": "^3.716.0",

package/dist/commands/init.js

@@ -1,17 +0,0 @@
-import { Command } from 'commander';
-import { cliHelper, envCtl } from '../container.js';
-import { _keys } from './_keys.js';
-import { wrap } from './_utils.js';
-export function init(program) {
-    program
-        .command('init')
-        .description('Terraform init wrapper')
-        .option('--key <key>', _keys.KEY)
-        .option('--cwd <cwd>', _keys.CWD)
-        .action(wrap(handler));
-}
-async function handler(options) {
-    const { key, cwd } = options;
-    const theKey = cliHelper.ensureEnv(key);
-    await envCtl.init(theKey, cwd);
-}

package/scripts/get-acc-alias.sh

@@ -1,8 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-
-# TF state is stored in S3 in format: {company}-{acc-alias}-tf-state/{key}
-# (for non ephemeral environments the {key} typically has form of {project-code}-{env-name} like tt-dev)
-# Retrieve AWS account information
-acc_id=$(aws sts get-caller-identity --query "Account" --output text)
-aws organizations list-tags-for-resource --resource-id "$acc_id" --query "Tags[?Key=='Alias'].Value" --output text