Go to file
Fedor Isakov 8b1788354f Move docs content in a subdir. Annotate all .md files with front matter meta data. 2018-08-14 12:24:14 +02:00
.idea Updated the git configuration 2015-12-28 10:36:45 +01:00
.mps Name solutions and models consistently in samples (mpscore). Drop empty obsolete test solution. 2018-07-22 14:48:13 +02:00
coderules Ensure terms are copied "properly" without breaking Path's contract. Pending optimization. 2018-08-07 11:50:05 +02:00
docs/content Move docs content in a subdir. Annotate all .md files with front matter meta data. 2018-08-14 12:24:14 +02:00
gradle/wrapper Add gradle wrapper. 2017-06-13 15:53:03 +02:00
reactor Cleanup reactor code, drop obsolete code: 2018-08-04 16:10:35 +02:00
samples Ensure terms are copied "properly" without breaking Path's contract. Pending optimization. 2018-08-07 11:50:05 +02:00
.gitattributes Initial import 2014-07-03 15:02:07 +02:00
.gitignore Ensure extracted baseLanguageExt stuff can be built from command line. 2018-07-17 15:09:47 +02:00
.travis.yml Configure the dependency on conreactor to be resolved through local maven repo. Make travis install reactor libs locally. 2018-07-19 10:52:03 +02:00
INSTALL.txt Update readme files. 2018-07-19 15:12:34 +02:00
README.md Update readme to show full MPS icon 2018-08-07 13:32:05 +02:00
build.gradle Configure the dependency on conreactor to be resolved through local maven repo. Make travis install reactor libs locally. 2018-07-19 10:52:03 +02:00
build.xml Switch to the latest version of reactor lib 0.9.1 2018-08-03 11:48:36 +02:00
gradle.properties Use MPS 2018.2 final release 2018-08-08 13:57:23 +02:00
gradlew Add gradle wrapper. 2017-06-13 15:53:03 +02:00
gradlew.bat Add gradle wrapper. 2017-06-13 15:53:03 +02:00
mps-full.svg Update readme to show full MPS icon 2018-08-07 13:32:05 +02:00
settings.gradle Add fitch sample to the common build. 2018-07-18 15:54:52 +02:00

README.md

Code Rules

An experimental feature of JetBrains MPS. Code rules allow to create various code analyses employing constraints handling. The examples are provided, including type checking and control flow analysis of code written using MPSs baseLanguage.

Status

Build Status

The status of this project is pre-release. Dont rely on any of the language features or the API to be stable. The purpose of this project is to show the new technology and collect early feedback.

Overview

This project is the result of ongoing research done within MPS team in the area of code analysis using constraints handling, in particular CHR.

Code rules serve as templates that produce constraint rules. Both transformation to constraint rules and evaluating is done in-memory at the time analysis is launched. Constraint rules are processed by the embedded engine.

Samples included with this project demonstrate how coderules can be used for solving concrete tasks connected with source code analysis.

Coderules allow for extensions to be provided by derived languages. Extensions have higher priority, so its easy to override the built-in behaviour.

The semantics of constraints handling is compatible with regular Java semantics, so coderules can be safely embedded into the user code. There also exists support for launching arbitrary code from when processing constraints.

Parallel or background execution of coderules is possible thanks to the reactive extensions, in particular rxjava, which is used by the implementation.

See implementation notes for more information.

Dependencies

The source code can be opened with the latest version of JetBrains MPS. The plugin that is created with the build script is also compatible with the same version of MPS.

Project structure

  • reactor - contains the implementation of constraint processing engine
  • coderules - implementation and tests
  • samples - sample projects using coderules

Installation

See INSTALL.txt.

License

Copyright 2014-2017 JetBrains s.r.o.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.