TaioTrans

Generate Taio Action with JS/TS

Installation

npm i taiotrans

# if you are using typescript
npm i -D @types/node

Usage

create new action

import * as taio from 'taiotrans'

const action1 = taio.newTaioAction({
    name: 'Example Action',
})

const action2 = taio.newTaioAction({
    name: 'Dropbox Sync',
    summary: 'sync files with your dropbox account',
    icon: 'shippingbox.fill',
    iconColor: '#13247B',
})

variables

built-in variables

action.builtIn('Last Result')
action.builtIn('Clipboard')
action.builtIn('Current Date', {
    dateStyle: 'Full Style',
    timeStyle: 'No Style',
})
action.builtIn('Current Date', 'yyyy')
action.builtIn('File Name')
action.builtIn('File Extension')
action.builtIn('Full Text')
action.builtIn('Selected Text')
action.builtIn('Selected Location')
action.builtIn('Selected Length')

variables usage

// varaible allocate
const peach = action.setVariable('peach', 'peach')

// default
action.showText()
action.showText(action.builtIn('Last Result'))

// variable
action.showText(peach)

// string
action.showText('')
action.showText(`i love ${peach}`)

// boolean
action.showText(true)
action.showText(false)

// object
action.showText({
    'Fruit-Type': peach,
})

// array
action.showText(['apple', 'pear', peach])

condition

const x = action.setVariable('x', Math.floor(Math.random() * 5).toString())
action
    .If(
        {
            leftHandSide: x,
            rightHandSide: '0',
            condition: 'Equal to',
        },
        () => {
            action.showText('x is equal to 0', 'result')
        }
    )
    .ElseIf(
        {
            leftHandSide: x,
            rightHandSide: '1',
            condition: 'Equal to',
        },
        () => {
            action.showText('x is equal to 1', 'result')
        }
    )
    .ElseIf(
        {
            leftHandSide: x,
            rightHandSide: '2',
            condition: 'Equal to',
        },
        () => {
            action.showText('x is equal to 1', 'result')
        }
    )
    .ElseIf(
        {
            leftHandSide: x,
            rightHandSide: '3',
            condition: 'Equal to',
        },
        () => {
            action.showText('x is equal to 3', 'result')
        }
    )
    .Else(() => {
        action.showText('x is larger than 3', 'result')
    })
action.showText(`x is ${x}`, 'final')

embedding JS code

action.runJavaScript(() => {
    // Get input
    const text = $actions.inputValue

    // Resolve with output
    $actions.resolve('Result')

    // Exception handling:
    //  $actions.reject("Error");
    //  $actions.finish();
})

// alternative method: embedding code file
import { readFileSync } from 'fs'
action.runJavaScript(readFileSync('code.js', { encoding: 'utf-8' }))

declaration of built-in methods

import { $actions, $app } from 'taiotrans/dist/builtIn'

export to file

import { writeFileSync } from 'fs'
writeFileSync('action.json', action.toString())

Import to Taio

local testing

Import to Taio by using url-scheme

const http = require('http')
const fs = require('fs')

const port = 9000

http.createServer((_, res) => {
    res.writeHead(200, { 'Content-Type': 'application/json' })
    res.end(fs.readFileSync('actions.json'))
}).listen(port, () => {
    console.log(`server start at ${port}`)
})

then visit the url below in safari on your device

taio://actions?action=import&url=http%3A%2F%2F<your_ip:port>

submit to official sharing community

You can find how to submit your actions file in this page.

License

MIT © MamoruDS