TMS Smart Setup

TMS Smart Setup installs more than TMS products. Since version 2.0 it comes with a community registry: a public list of Delphi libraries by other authors that Smart Setup fetches, builds and installs from source.

The newest entry is MARS-Curiosity, the open source REST library for Delphi by Andrea Magni. You write plain Delphi classes, add attributes, and MARS handles routing, parameter binding, serialization and authentication. From version 1.8 on, MARS installs with one command.

Installing a library from the community registry

Third-party libraries come from the community server. With Smart Setup 3.5 or later (download it here), enable that server once:

tms server-enable community true

After that, community libraries install the same way as TMS products:

tms install andreamagni.mars

To get the latest version later, run tms update andreamagni.mars. If you prefer the GUI, tmsgui has a server dropdown that lists TMS products, community libraries or both.

What happens when you install MARS

Smart Setup clones the MARS repository and compiles the runtime and design-time packages for every Delphi version it finds, from 10.4 Sydney on, for Win32 and Win64. It then registers the packages in the IDE and adds MARS to the library path. Delphi 10.4 is also the oldest version MARS 1.8 supports.

Besides the new installation option, MARS 1.8 brings MCP Apps and JWT key rotation. Andrea's release post covers both in detail.

Optional dependency: the JOSE backend

MARS has two JWT backends. The default one uses mORMot and needs nothing else. The other uses delphi-jose-jwt by Paolo Rossi, which is also in the registry.

In the MARS build file, JOSE is a weak dependency: the MARS.JOSE package is only built when delphi-jose-jwt is installed. To get it, run:

tms install paolo-rossi.delphi-jose-jwt

The order doesn't matter. If you install JOSE after MARS, Smart Setup rebuilds MARS and adds the MARS.JOSE package.