Cement

• Dependency management tool, mostly for C# projects
• Allow get and build your projects with dependencies
• Every project is git repository
• Every project is one solution or some content module

Get started

Install

1. You should have installed git and Visual Studio or MSBuild Tools
2. Download zip from https://github.com/skbkontur/cement/releases/latest
3. Unzip and run dotnet\install.cmd
4. Restart terminal
5. Command cm should show you aviable commands in any directory

Work with cement

Use cm help to see all cement commands. Use cm %command_name% /? or cm help %command_name% to see command description.

All modules description stored in special git repo.

At start your cement will use sample modules from https://github.com/KungA/cement-sample-modules/blob/master/modules

Command cm ls should shows modules A, B, C, D.

Get modules

Lets run some commands to get and build module A, which use modules B, C, D.

cm init

All modules should be downloaded into one 'cement tracked' directory.

cm get A

Download module A with deps B, C, D.

cd A

Go to module directory.

cm build-deps

Build dependencies for current module in right order.

cm build

Build current module. You can use it now.

Update dependencies

cm update-deps

Get latest versions of dependencies from git

cm build-deps

Need to build new version of modules, which were changed.

cm build

And current module.

Creating modules

1. Specify git repo witch will contain all modules description like https://github.com/KungA/cement-sample-modules

2. Add empty modules file to it and push

3. Fill it into %userprofile%\.cement\settings file instead of [email protected]:KungA/cement-sample-modules.git

4. Create repositories for your modules like

   https://github.com/KungA/cement-sample-A

   https://github.com/KungA/cement-sample-B

   https://github.com/KungA/cement-sample-C

   https://github.com/KungA/cement-sample-D

5. Run cm module add A [email protected]:KungA/cement-sample-A.git to add your modules to cement

6. Fill module.yaml file, describing cement modules