Full configuration

This page covers the advanced topics for Greed, like template definition, hidden config keys, custom renderers.

A word for the configuration format

Greed uses a 3rd-party config library typesafe-config. It's a very powerful config library with a flexible DSL for the users. For advanced config file writing, refer to its documentation and the default.conf in Greed.

Miscellaneous configurations

Each of Greed's configuration key corresponds to a class in the source file, which is kind of like ORM mapping, and is a new feature in the backend of 2.0. I'll point to the class in each of the following section for you to better understand the configuration semantics.

Logging

Class: greed.conf.schema.LoggingConfig

Greed has a mechanism for logging, which is turned off by default.

You can turn it on by setting greed.logging.logLevel = INFO and it will log to the Logs directory under your workspace by default. You can also see the logs from the java console, when the arena starts. The way to enable the console is through java control panel, usually.

Template definition

Class: greed.conf.schema.TemplateConfig

Greed gives the users power to define their own templates, according to the following schema. Let's continue with the templateDef config key and start with an example.

greed.language.java.templateDef {
  unittest {
    override = false
    templateFile = "builtin unittest/junit.java.tmpl"
    outputKey = UnitTestCode
    outputFile = "${Contest.Name}/${Problem.Name}-WrongName"
    transformers = [ empty-block, cont-blank-line ]

    afterFileGen {
      execute = mv
      arguments = [ "${GeneratedFileName}", "${Contest.Name}/${Problem.Name}Test.java" ]
    }
    options {
           key = value
    }
  }
}

This example may look somewhat stupid, because it gives the output a wrong name and then rename it. But it covers all the possible keys of a template def.

• override, if false, greed will skip the file if already exists.
  However, if user click Regenerate code in the UI, it will be force override. Don't worry, the old files will be backuped.
• templateFile specify the path to the template file use by the template engine to render to the output.
  The prefix builtin shows that this template is located in the distributed jar of Greed, in greed.jar:/templates.
• If outputKey is set, the rendered output will be bound to a key, in this case UnitTestCode, and available for the later templates (in the templates sequence) to use as a key in their template files. Note this does not conflict with outputFile.
• outputFile and [ outputFileName, outputFileExtension ] conflict with each other and must not be set at the same time! Or Greed will raise an error of config exception. The former set the whole name while the latter specify the two parts of the file name separately.
• transformers specify a list of actions to transform the code after the code is generated. Right now there're only two available.
  • empty-block removes empty cutting block (surrounded by cutBegin and cutEnd) to cleanup the output code.
  • cont-blank-line merges continuous blank lines to single one blank line.
• afterFileGen is an external command executed after the file is generated (no output file, no action!). You can specify any scripts or programs to run.
  BTW, this is corresponding to the class greed.conf.schema.CommandConfig
• options: Support for options that are specific to the template. The values inside this section are of the format: key = value. Inside the template, you call them as ${Options.value} to insert custom text or in an if condition like: ${if Options.value} which would be false if the option key does not exist or is set to false. Many of the templates included by default come with template options which will be described below:

You have seen a lot of ${key} in the config, this data will be substituted and rendered by the template engine (or the config library, and they're different). To see which keys are available, read the section about key-values in the next tutorial.

Template file and engine

This part is basically the details of the template engine, and is covered separately in another page Play with templates.

If you're interested in customizing your own template, go ahead!

Template options for provided templates.

problem-desc options

The problem-desc template is the template used for the problem statement. It has the following options:

option	allowed values	default	Description
gridArrays	false, true	false	If true, Show String[] argument values in examples using multiple lines and making them look like a grid when possible.
fancyExampleNumber	false, true	true	When true it decorates the example numbers inside a circle.
resizeImages	false, width values	200px	If set to false, images aren't modified. Else images will be resized and the resizeImages value will be used as width.
showVariableNames	false, true	true	When true it adds variable names to example data.
showTags	false, true	true	When true it shows input, output and comment tags in example data.
colorThemeBlack	false, true	false	When true, the color scheme becomes black background with white letters, similar to the Arena default.
colorThemeBlue	false, true	false	When true, the color scheme becomes blue background with white letters, similar to the problem statements in TopCoder site.
colorThemeLowContrast	false, true	false	This color scheme is dark gray background with light gray letters, easy on the eyes.

For example, try the following:

greed {
 shared {
  templateDef {
   problem-desc {
    options {
        colorThemeBlue = true
        showTags = false
        gridArrays = true
        fancyExampleNumber = true
        resizeImages = false
    }

The result is: TBlocks.html