The ecsharp repository holds several tools for enhancing .NET and C# development:
The Loyc .NET Core libraries, a set of libraries whose theme is "stuff that should be built into the .NET framework, but isn't." These libraries have their own repository and home page, and the Loyc .NET Core repository is the
Core/folder in this repository. One of these libraries (Loyc.Syntax) supports universal syntax trees, LES2 and LES3.
Enhanced C# (or EC#) is a liberalization and regularization of the C# language. You can think of EC# as a C# preprocessor, since only the "front end" part of the project is done. The preprocessor consists of three mostly-independent parts,
- The Enhanced C# parser
- LeMP, the Lexical Macro Processor
- LeMP Standard Macros
These projects are the first products of the Loyc (Language of Your Choice) initiative.
If you just want the core libraries, you can find them in NuGet. Otherwise, see
- How to set up LeMP or LLLPG in Visual Studio
- How to set up LeMP or LLLPG on other platforms
- Download page
How to build
Open Loyc.netfx.sln in Visual Studio (or Loyc.netstd.sln for the .NET Standard edition), set the build configuration to Debug, and build it!
If Visual Studio complains about OxyPlot, the easiest fix is to unload the LoycCore.Benchmarks project (nothing depends on it). To fix it properly, open Core\Loyc.netstd.sln, right-click the solution, choose "Restore NuGet packages", build the solution (just to make sure it worked), and then return to the original solution.
If you need to change any .ecs or .les source files (Enhanced C# or LES), you'll need to install the latest LeMP extension for Visual Studio, which can be found on the Releases page. There is no build step for these files, so the extension is not required for building. Unfortunately VS Code is not supported at this time - let me know if you need support.
How to publish new versions
This is more of a note-to-self than anything. Pull-requestors can ignore it.
- Rebuild all (Release configuration in Loyc.all.sln) and run tests (Tests.exe)
- Update version in Core/AssemblyVersion.cs
- Update appveyor.yml at
- Update appveyor.yml at
- set SEMVER=(semantic version combines w.x.y into wx.y, e.g. 2.7.1 => 27.1, because semantic versioning demands a new major version number for each breaking change, while the internal version number increments the minor version for a minor breaking change.)
- If a GitHub release is to be created, uninstall the LeMP VS extension and rebuild it with UpdateLibLeMPAndReinstall.bat. Manually check that it still works.
- Commit changes
- Push changes and check whether the build succeeded on AppVeyor.
- On success, create an (unannotated) git tag like
git tag v2.7.1.
- Push the tag to make Appveyor publish NuGet packages:
git push origin v2.7.1.
- Every so often, create a release on GitHub.com. Prepare a zip file from the built binaries and include Lib\LeMP\LeMP_VisualStudio.vsix separately as part of the release.
- Update version-history.md on ecsharp.net and core.loyc.net, and update documentation by running doc/Doxygen.bat in the gh-pages branch.