Concerto

A lightweight schema language and runtime for business concepts.

concept Person identified by name  {
  o String name
  o Address address optional
  @description("Height (cm)")
  o Double height range=[0,]
  o DateTime dateOfBirth 
}

🏢 Concerto gives you “just enough” expressivity to capture real-world business models, while remaining easy to map to most runtime environments.

⛳ An object-oriented language that is much easier to read and write than JSON/XML Schema, XMI or equivalents.

📄 Serialize your instances to JSON

🍪 Deserialize (and validate) instances from JSON

🔎 Introspect the model using a powerful set of APIs

🎛 Convert the model to other formats:

• JSON Schema
• XML Schema
• OData CDSL
• GraphQL Schema
• Java Classes
• Go Types
• C# Classes
• TypeScript Classes
• Protobuf Messages
• PlantUML Diagrams
• Mermaid UML Diagrams
• Markdown (with embedded Mermaid)
• OpenAPI v3 specification document
• Apache Avro

🕸 Publish your reusable models to any website, including the Accord Project model repository

Infer models from other formats:

• JSON document
• JSON Schema
• OpenAPI v3 specification document

Getting Started

• Install the Command Line Tool
• Read the Concerto specification

$ npm i -g @accordproject/concerto-cli
$ concerto compare --old model.cto --new model-with-changes.cto 
[required-field-added]: The required field "weight" was added to the concept "Person" (major) 

• Open VSCode (on the web, on your machine)

• Add to your Node.js project
• Add to your .NET project

Install Concerto Skills

npx skills add accordproject/skills

Structure of the Code

Top level repository (concerto), with sub packages. Each sub-package is published as an independent npm module using npm workspaces:

• concerto-core : core library for model management/parsing/validation/serialization
• concerto-util : contains utility functions used in other parts of the code and fundamentally independent from Concerto as a modeling language
• concerto-cto : contains the parser for the .cto syntax for Concerto. The parser now outputs a proper Concerto object, instance of the metamodel rather than a custom JSON object.
• concerto-vocabulary : functionality to handle model vocabularies and localization
• concerto-analysis : tools for comparing model files
• concerto-types : TypeScript type definitions for Concerto
• concerto-dotnet : .NET type definitions for Concerto, and serialization tools

---

Accord Project is an open source, non-profit, initiative working to transform contract management and contract automation by digitizing contracts. Accord Project operates under the umbrella of the Linux Foundation. The technical charter for the Accord Project can be found here.

Learn More About Accord Project

Overview

Documentation

Contributing

The Accord Project technology is being developed as open source. All the software packages are being actively maintained on GitHub and we encourage organizations and individuals to contribute requirements, documentation, issues, new templates, and code.

Find out what’s coming on our blog.

Join the Accord Project Technology Working Group Discord Community to get involved!

For code contributions, read our CONTRIBUTING guide and information for DEVELOPERS.

README Badge

Using Accord Project? Add a README badge to let everyone know:

[![accord project](https://img.shields.io/badge/powered%20by-accord%20project-19C6C8.svg)](https://www.accordproject.org/)

License

Accord Project source code files are made available under the Apache License, Version 2.0. Accord Project documentation files are made available under the Creative Commons Attribution 4.0 International License (CC-BY-4.0).

Copyright 2018-2019 Clause, Inc. All trademarks are the property of their respective owners. See LF Projects Trademark Policy.