ogs-site/en/news/2025-03_cld_ctx-gen.md

Title: CLD: Context generation Date: 2025-03-11 00:00 Category: News Slug: cld_ctx-gen Lang: en

Context generation

In February I've updated the Cross-language dialect (CLD) translator to generate Context out of YML. The generated Contexts have already been used for the following projects:

• CLD (the CLD translator generated its own Context)
• LHA
• PSKOV

I never really took time to explain what Context is, so here's a very short explanation: Context is very close to Store in Redux. I'm afraid this is not yet the time to explain Context in detail because I don't yet have a good argument why you need Context. Once that time comes I do it.

Now let's get back to the Context generation. Here's how LHA's YML for Context looks like: (entities.yml):

# Application state context
Context:
    type: context
    fields:
        # Command line arguments
        arguments: [String]
        consoleOutput: String
        defaultDir: String
        didLaunch: Bool
        dir: String
        httpDefaultPort: Int
        httpLaunch: Bool
        httpPort: Int
        httpReply: String
        httpRequest: NetRequest

CLD translator converts it to the following code in Kotlin (entities.kt):

// Application state context
data class Context(
    // Command line arguments
    var arguments: Array<String> = arrayOf(),
    var consoleOutput: String = "",
    var defaultDir: String = "",
    var didLaunch: Boolean = false,
    var dir: String = "",
    var httpDefaultPort: Int = 0,
    var httpLaunch: Boolean = false,
    var httpPort: Int = 0,
    var httpReply: String = "",
    var httpRequest: NetRequest = NetRequest(),
    override var recentField: String = "",
): CLDContext {
    override fun <T> field(name: String): T {
        if (name == "arguments") {
            return arguments as T
        } else if (name == "consoleOutput") {
            return consoleOutput as T
        } else if (name == "defaultDir") {
            return defaultDir as T
        } else if (name == "didLaunch") {
            return didLaunch as T
        } else if (name == "dir") {
            return dir as T
        } else if (name == "httpDefaultPort") {
            return httpDefaultPort as T
        } else if (name == "httpLaunch") {
            return httpLaunch as T
        } else if (name == "httpPort") {
            return httpPort as T
        } else if (name == "httpReply") {
            return httpReply as T
        } else if (name == "httpRequest") {
            return httpRequest as T
        }
        return "unknown-field-name" as T
    }

    override fun selfCopy(): CLDContext {
        return this.copy()
    }

    override fun setField(
        name: String,
        value: Any?
    ) {
        if (name == "arguments") {
            arguments = value as Array<String>
        } else if (name == "consoleOutput") {
            consoleOutput = value as String
        } else if (name == "defaultDir") {
            defaultDir = value as String
        } else if (name == "didLaunch") {
            didLaunch = value as Boolean
        } else if (name == "dir") {
            dir = value as String
        } else if (name == "httpDefaultPort") {
            httpDefaultPort = value as Int
        } else if (name == "httpLaunch") {
            httpLaunch = value as Boolean
        } else if (name == "httpPort") {
            httpPort = value as Int
        } else if (name == "httpReply") {
            httpReply = value as String
        } else if (name == "httpRequest") {
            httpRequest = value as NetRequest
        }
    }
}

March

Kotlin is currently the anchor programming language of CLD. Thus, to use Kotlin, one would have to install related Java tools (Gradle, Android Studio or JVM itself). Such a requirement makes it impossible to have a web browser only development tool. And being able to code in a web browser is something I consider the key feature for code portability.

That's why in March I plan to create the draft of a tool running in a web browser.