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
}
- 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
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
Structure of the Code
Top level repository (concerto), with sub packages. Each sub-package is published as an independent npm module using lerna
:
- concerto-cli : command-line interface for Concerto
- concerto-core : core library for model management/parsing/validation/serialization
- concerto-tools : model converters and tools for Concerto model files
- concerto-util : contains utility functions used in other parts of the code and fundamentally independent from Concerto as a modeling language
- concerto-metamodel : contains utility functions for accessing and manipulating the new Concerto metamodel
- 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:
[](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.