Rhetos 6.0.0

Rhetos - A DSL platform

Rhetos is a DSL platform for Enterprise Application Development. It extends the modern .NET technology stack with advanced programming paradigms: declarative programming, metaprogramming and AOP.

• Rhetos enables developers to create a Domain-Specific Programming Language and use it to write their applications.
• There are libraries available with ready-to-use implementations of many standard business and design patterns or technology integrations.

Rhetos works as a compiler that generates C# code, SQL, and other source files, from the application model written in the DSL scripts.

• The generated application is a standard business application based on Microsoft .NET technology stack.
• Rhetos is focused on the back-end development: It generates the business logic layer (C# object model), the database and the web API (REST, SOAP, etc.).
• The database is not generated from scratch on each deployment, it is upgraded instead, protecting the existing data.

Rhetos comes with the CommonConcepts DSL package, a programming language extension that contains many ready-to-use features for building applications.

IntelliSense and syntax highlighting is available for Visual Studio, Visual Studio Code, SublimeText3 and Notepad++.

Documentation and samples

See Rhetos wiki for more information on:

• Creating applications with Rhetos framework
• Rhetos DSL examples
• Available plugins
• Principles behind the Rhetos platform
• Prerequisites, Installation and Development Environment

Visit the project web site at rhetos.org.

License

The code in this repository is licensed under version 3 of the AGPL unless otherwise noted. Please see License.txt for details.

How to contribute

Contributions are very welcome. The easiest way is to fork this repo, and then make a pull request from your fork. The first time you make a pull request, you may be asked to sign a Contributor Agreement. For more info see How to Contribute on Rhetos wiki.

Building the source code

Note: Rhetos NuGet packages are already available at the NuGet.org online gallery. You don't need to build it from source in order to use it in your application.

To build the source, run Clean.bat and Build.bat. The build output files are NuGet packages in the dist subfolder.

Development and Testing

When Rhetos.sln is opened and built in Visual Studio, there are some "smoke test" projects (TestAppDirect*) that require a database connection. Additionally, running integration tests in test projects also requires database connections.

Initial setup (required for development and integration tests):

• Create four empty MS SQL Server databases (for example, "Rhetos6EFCore", "Rhetos6EF6", "Rhetos6TestAppDirectMsSqlEfCore" and "Rhetos6TestAppDirectMsSqlEf6" on localhost SQL Server instance).
• Create two empty PostgreSQL database (if needed, use test\TestAppDirectPostgreSql\setup postgresql db.bat that initializes the databases in a PostgreSQL container).
• Create the corresponding six local setting files local.settings.json in the folders test\CommonConcepts.TestApp.MsSql, test\CommonConcepts.TestApp.MsSqlEf6, test\TestAppDirectMsSqlEfCore, test\TestAppDirectMsSqlEf6, test\TestAppDirectPostgreSql and test\CommonConcepts.TestApp.PostgreSql, with the following content, and modify the connection strings to match your database server instances and databases accordingly:

  {
    "ConnectionStrings": {
      "RhetosConnectionString": "Data Source=ENTER_SQL_SERVER_NAME;Initial Catalog=ENTER_RHETOS_DATABASE_NAME;Integrated Security=true;TrustServerCertificate=true"
      //For PosgreSQL// "RhetosConnectionString": "Host=localhost;Database=ENTER_RHETOS_DATABASE_NAME;Username=postgres"
    }
  }
  

To execute the unit tests and the integration tests after build, run Test.bat.

Visual Studio Solutions

Rhetos.sln contains the source for Rhetos framework and CommonConcepts plugins (a standard library for Rhetos DSL). It also contains unit tests for the projects.

CommonConceptsTest.sln contains the integration tests for DSL concepts in CommonConcepts. After changing the framework code in Rhetos.sln, you will need to run Build.bat and Test.bat, before you can develop the related integration tests in CommonConceptsTest.sln. CommonConceptsTest depends on Rhetos NuGet packages that are created and provide by those scripts.