Skip to main content

Roslyn shopping cart DSL - Part 2


In this post I will be reviewing some considerations that I usually have in mind while designing a DSL.

The audience
When you are working on a DSL, the first and most important thing to have in mind is the audience you are aiming for. It’s gonna be technical people, business executives, sales people, etc…, etc….

The syntax
If the audience is not a bunch of techies, here is set of design rules that you should follow (at least, they've worked out for me):
  • The syntax should be as much as closest to the domain terms that the user uses on a daily basis.
  • Use sentences like “when something_happen:” instead of “if (somethingHappen){..}”.
  • Use logical operators like “and”, “or” instead of “&&”, “||”.
  • Don't make your syntax case sensitive.
  • snake_case works better than PascalCase.
  • When syntax error happen (and it will happen) provide useful messages that lead the user to the right path.
  • Try to avoid the use of parentheses as much as you can. (our users are not Lisp programmers ;))
  • You are not building a general purpose language. Avoid loops, conditionals and variables as much as you can. Keep your DSL Turing incomplete.

Working with scripts
  • Build a professional script editor (Notepad sucks, big time)
  • Use different icons to differentiate conditions from actions.
  • Provide an autocomplete mechanism and syntax highlight.
  • Don't try to build your own version of VS. It will take a butt load of time, and most of the features you built will never be used.
  • Provide a versioning mechanism for scripts.

This is how it looks the editor provided with the sample app of this post.

The main component of the editor is a control called “Fast Colored TextBox” created by Pavel Torgashov, all the credits to this guy, the control is awesome and works like a charm.

How you will go from your DSL syntax to executable code
In this post I’m working with a technique called “source to source translation”, this means that I’ll be converting code from our DSL syntax into C# code in order to feed the Roslyn compiler.

Note: The code provided with this post does not cover in deep how source to source translation works nor is a full or complete solution, it’s just going to work with the example I’m showing and maybe give you a starting point, but nothing else.

You can get the source code from github using this link

Comments

  1. I compile and run your demo application. When I type "when", I don't get the autocomplete menu.

    ReplyDelete
    Replies
    1. In order to popup the autocompletion list you should hit Ctrl+Space. It' a pretty common shortcut in old editors. (although, it's not that friendly for end users.... my bad on that one ;))

      Delete
  2. This comment has been removed by the author.

    ReplyDelete

Post a Comment

Popular posts from this blog

How to create MS Word documents from Office templates using C#

The OpenXML SDK allows you to do pretty much anything you want with office files such as Excel, Word, etc… While many people like this library, I found it complex, unintuitive and poorly documented, not to mention the awful xml format that uses under the hood to represent the documents, styles, etc. So I decided not to use it and build my own solution. If you, like me, don’t like that library, you will find in this post an alternative approach to build word documents from templates using c#.
A neat trick to work with Office is to use the macro recorder to understand how things work. The macro recorder allows you to start a macro, do something by hand, stop it, and then take a look at the generated VBA code. Once you do this, you are pretty much set.
This is how it looks the template I’am going to use.


Note: save the file as a Word template (.dotx)
This is the code to create Word documents from C#:

By running the code, you should get a document that looks like this.


Note that the font, forma…

Printing html using the embedded web browser control

In this post I’ll try to answer some questions about the web browser control and provide some workarounds for known issues involved in the printing process.
I'm assuming that you have some experience with the web browser control and basic knowledge of COM and hosting APIs. So I’m not going to cover those topics.
At the bottom of this page I’ve added the links to download a small library I wrote that takes care of printing HTML and a demo app so you can try it out without having to write any code by yourself.
Using the code The HtmlPrinter class will allow you to print html from an URL or just passing the html as string, you can also specify the title and the number of copies you want to print. The code may look something like this: Now that we know how to use the API let get answer some questions.
Why my app crashes when I try to print multiple copies of a page? Well, apparently when you send a lot of print commands to the web browser control, there is a lot of COM crap in between that l…

WinForms, paging the DataGridView the right way

I know this may sound like old history, but in the enterprise world there is still a lot of WinForms development. Just a couple of days ago, I had to implement a custom DataGridView capable to work over a butt load of data (100K+ records) and keep responses times acceptables.
I thought paging will be a good way to go, and as WinForms is pretty old nowadays, I supposed it will be easy to find a couple examples on the web.
While in fact I found examples, all of them were incompletes and/or they wouldn't perform well in real world apps... So I decided to roll my own component and post it online. Hopefully, someone else will find it useful ;).


The bread and butter of this solution relies on LINQ and deferred execution. As LINQ takes care of all complicated work, it was quite easy to implement.
This component also supports conditional format, sorting and some search capabilities, but in this post I will concentrate on paging only (I'll cover the rest of the features in future posts)…