openvalidation.io | playground.openvalidation.io | docs.openvalidation.io

a natural language (no-code) compiler for validation rules

• introduction
• install
  • npm
  • jar
  • docker image
• run
  • npm
  • jar
  • docker container
  • result
  • cli parameters
• integrate
• samples
• understand
• try
• contribute
• contact
• license

openVALIDATION enables programming validation rules using natural languages, such as German or English.

The rules recorded in natural language are readable not only by humans but also by machines and therefore no longer need to be programmed by a software developer. This task is now taken over by openVALIDATION compiler. With integrated code generators, corresponding source code in the desired programming language can be generated automatically, such as Java, C#, JavaScript or Python, with more to come. This code can then be integrated into any application (services, frontends, middleware).

Write once, DONT CODE and run everywhere!

install via npm as global cli command

npm i openvalidation -g

or just download the executable jar here or via curl:

curl 'https://downloadarchive.blob.core.windows.net/openvalidation-generator/openvalidation.jar' --output openvalidation.jar

docker pull openvalidation/openvalidation-rest

openvalidation -r "user's age should not be less than 18 years" -s "{age:0}" -c en -l javascript

java -jar openvalidation.jar -r "user's age should not be less than 18 years" -s "{age : 0}"  -c en -l javascript

docker run -p 7070:80  openvalidation/openvalidation-rest

curl -X POST -H "Content-Type: application/json" -d "{\"rule\":\"user's age should not be less than 18 years\",\"culture\":\"en\",\"language\":\"JavaScript\",\"schema\":\"{age:0}\"}" http://localhost:7070/

The following JavaScript code will be generated:

var HUMLValidator = function() {
    var huml = new HUMLFramework();
    
        huml.appendRule("",
            ["age"],
            "user's age should not be less than 18 years",
            function(model) { 
                return huml.LESS_THAN(model.age, 18.0);
            },
            false
        );

    this.validate = function(model){
        return huml.validate(model);
    }
}

The generated code does not depend on 3'rd party libraries at all. Therefore, a custom framework is generated in addition to the rules. This framework contains a basic architecture to integrate the generated validation rules more easily into other systems.

-r (--rule)

validation rule in a natural language

-s (--schema)

schema in JSON Schema or JSON Object format

-c (--culture)

culture code of the natural language. For example de for German or en for English. The culture of current system will be used as Default if the parameter -c was not specified. en is the absolute fallback if specified culture not supported by openVALIDATION.

-l (--language)

the programming language of the generation output. Java is a default language. Available: Java, JavaScript, CSharp, (Python and Rust are still in development)

-o (--output)

The Output option defines a directory where the generated code files are stored. Without specifying the output parameter, the generated code is only displayed in the console. If no output directory is specified, the result will only be displayed in the console.

See more CLI Options... at docs.openvalidation.io

The first step is to generate a rule in e.g. nodejs. To generate code files, the output directory must be defined with the parameter -o.

openvalidation -r "user's age should not be less than 18 years" -s "{age:0}" -c en -l node -o ./

the compiler generates 2 code files OpenValidation.js (the actual rules) and HUMLFramework.js (the generic framework)

Now you can integrate the generated code into a NodeJS application:

var openVALIDATION = require('./OpenValidation.js');

var data = {name:'Alex', age:17};

var validationRESULT = openVALIDATION.validate(data);

if (validationRESULT.hasErrors) {
  console.log(validationRESULT.errors);
} else {
  console.log("this data is valid!");
}

Further integration examples can be found here.

Here are examples of different validation rules:

openVALIDATION enables programming of validation rules using natural languages, such as German or English and many more. The rules recorded in natural language are readable not only by humans but also by the computer and therefore no longer need to be programmed by a software developer.

The grammar

The Grammar of openVALIDATION based on a natural language is both formal and natural. This distinguishes this grammar from other programming languages or DSL's. It allows the use of additional semantic or grammatical content. The additional content is only relevant for human readability. The machine, on the other hand, ignores this addition. Thus it is possible to express the rules in a grammatically correct way on the one hand and to give them a semantic context on the other. This all makes the rules easier to understand. Rules formulated with openVALIDATION are thus at the same time a formal, machine-processable specification, but also a documentation that is easy for humans to understand.

For more details check out our documentation and guides

try it out directly in the browser on the playground

We still have 2 zeros in the version 0.0.X of openVALIDATION, so there is still a lot to do. If you want to join us, you are more than welcome to participate!

Check our contribution guide.

Even if you're not a developer or don't fully understand the technical part of openVALIDATION yet, it doesn't matter. There are many different ways to join the project.

Check our contribution guide especially for beginners

Thank you to all the people and bots who already contributed to openVALIDATION!

You can write an E-Mail, mention our twitter account @openVALIDATION or message us at our Instagram account @openvalidation_.

openVALIDATION was initially developed as part of a research project at BROCKHAUS AG in Dortmund.

Only an Open Source solution can unfold its true potential. That's why we released it on GitHub as an open-source project under the Apache 2.0 license.

See LICENSE.txt