Interpreter–part 5 of n–Documentation


  1. – Idea
  2. – Coding
  3. – Testing
  4.  – Deploy
  5. – Documentation
  6. – Ecosystem / usage

After all this steps, now it is the moment to have Documentation. Basically, if nothing have changed, is the same as the idea –  .

However , there are some points to add:

  1. Clear use of the software ( examples, tutorials, videos, others)
  2. Added badge/link to the software  (nuget,  see  )
  3. Added badge to  build ( see  )
  4. Added badge to license ( see  )
  5. Add reference to any third party software that you are using( any other nuget components / dot net tools – )

But the most important part is to show how you use it in a real project…

Interpreter–part 4 of n – Deploy


  1. – Idea
  2. – Coding
  3. – Testing
  4.  – Deploy
  5. – Documentation
  6. – Ecosystem / usage

After done the testing part, we can deploy the Interpreter . That means uploading to some package sources, as or I choose .

For this, first we should package the applicatiuon. We right click the project, select properties, and then package tab.

Enter the details ,. save , then right click the project again and click “Publish” and fisnish.

In the folder “bin\Debug\netcoreapp2.1\publish” you will find the InterpreterDll.1.0.0.nupkg file. This file you will upload to For this, you have to login to nuget.rog and go to 

After submitting , you will find the package at .

From this, you can testit by downloading directly  from nuget feed .

First deploy was simple  – but we want to do this with a button click.

But we want more – every time a new code is pushed to github  -the tests should run automatically and a new interpreter package will be created. For this we can choose site , integrate with our github repository and create a build release.

I am going to and create a new project.  For this , I will integrate with GitHub and push a new build. Also,  in this definition of build have a publish task that allows to publish as an artifacty the .nupkg that next we will put on github / nuget

Interpreter–part 3 of n -Testing


  1. – Idea
  2. – Coding
  3. – Testing
  4.  – Deploy
  5. – Documentation
  6. – Ecosystem / usage

Now that we do not have just the interpreter part 1 idea, but also interpreter part 2 coding , we can test the application.

For this we should write test for everything that we wrote in the interpreter part 1  idea  .

That gives us a bunch of tests functions:

void InterpretDateTime();
void InterpretDateTimeUtcNow();
void InterpretEnv();
void InterpretGuid();
void InterpretSettingsFile();
void InterpretStaticOneParameter();
void InterpretStaticParameterString();
void InterpretStaticTwoParameterString();

We run those test with VS or

dotnet test

and we think that is ok.

Nope. We should , to be sure,to have the code coverage – means that we verify what we have tested . You can start from here : 

The first iteration for my project gives to me







Covered lines:


Uncovered lines:


Coverable lines:


Total lines:


Line coverage:


Branch coverage:


That it is pretty solid.

Interpreter–part 2 of n – Coding


  1. – Idea
  2. – Coding
  3. – Testing
  4.  – Deploy
  5. – Documentation
  6. – Ecosystem / usage

Now that we have the idea from interpreter part 1 of what we want to do, start coding thinking about what the code will look like.

We want simple use, like

string textToInterpret = "Export#now:yyyyMMddHHmmss#.csv";
var i = new Interpret();
var nameFile = i.InterpretText(textToInterpret);

So we will have just a function, InterpretText , that will have as a parameter a string and returns the interpreted string.

Now we can start the coding part   .This  is somewhat harder – we make separate functions to interpret environment variables, interpret datetime, guid, interpret file json, and interpret with static functions

For this we will create separate functions , that know how to deal with those cases ( The edge case is loading assemblies – you do not want this time consuming to be done every time you interpret – or to load if it is not necessary)

After this  , in order to have a source control, you upload the code on GitHub :

Friday links 276

  1. Ending the Nested Tree of Doom with Chained Promises
  2. Multithreading in C# .NET 4.5 (Part 2) – CodeProject
  3. Useful Reference Books – CodeProject
  4. 16 Useful Mental Life Hacks | Idealist Revolution
  5. Edmond Lau’s answer to What are the questions that can be asked when the interviewer asks ‘Any questions?’ – Quora
  6. Gayle Laakmann McDowell’s answer to What are some interesting coding projects that I can complete in 7-14 days to build my resume for a summer internship? – Quora
  7. McCann Created an Escort Service That Had a Macabre Surprise for Anyone Who Tried It | Adweek
  8. Building and deploying an Outlook 2010 Add-in (part 2 of 2) – MCS UK Solution Development Team
  9. Outlook: Deploying an Outlook 2013 add-in (using InstallShield LE) – EMEA Developer Messaging Team Blog
  10. Humanizr/Humanizer: Humanizer meets all your .NET needs for manipulating and displaying strings, enums, dates, times, timespans, numbers and quantities
  11. rudyhuyn/PluralNet: Improve the localization of your application with support of plural forms. Support all existing languages and decimal numbers. Available for UWP, WinRT, Windows Phone, Xamarin Android and iOS, ASP.Net, .Net apps
  12. Outlook: Deploying an Outlook 2013 add-in (using InstallShield LE) – EMEA Developer Messaging Team Blog
  13. Create your first QnA bot using botframework’s QnA Maker | Robin Osborne
  14. Becoming a better JavaScript developer
  15. 8 Browser Extensions You’ll Love If You Use Trello

Interpreter–part 1 of n – Idea


  1. – Idea
  2. – Coding
  3. – Testing
  4.  – Deploy
  5. – Documentation
  6. – Ecosystem / usage

For Stankins I need a custom interpreter of serialized data. What this means, exactly ?

Let’ suppose I have an appsetting file with a connection string

   “SqlServerConnectionString”: “Server=(local)\\SQL2016;Database=tempdb;Trusted_Connection=True;”

If I use directly this connection from code, fine( Please be sure that you read carefully ).

The idea is to have some settings that is generating all time from data. Let’s suppose you have to write a .csv file with some data.You want to be unique every time . The common idea is to hardcode the file with the date time :

string file = “SendTo”+ DateTime.Now.ToString(“yyyyMMdd”) + “.csv”

What if the the name of the file should be serialized  ?  You retrieve from config the first part ( “SendTo”) , append the datetime format and the .csv. Later, you figure a better idea – to have a GUID. You will modify the code again and wrote

string file = “SendTo”+ Guid.NewGuid().ToString(“N”) + “.csv”

What if you will have something like storing the fle name in a appSettings.json like




retrieve with configuration

var builder = new ConfigurationBuilder()
            var config = builder.Build();

var fileName = config[“fileName”]

and then interpret:

var i = new Interpret();
  var str = i.InterpretText(fileName );

This will give you in the str the string SendTo20180710.csv.

Next time, when you want Guid, you just modify the appSettings.json




The code remains the same for interpret:

var i = new Interpret();
  var str = i.InterpretText(fileName );

but the result will be different ,with the guid into the filename

What I intend to support:

-file: appSettings.json

-env: environment

-static: static functions with one variable

-guid: Guid.NewGuid

-now : datetime

But the idea is that I have a class that serializes itself as follow:



“FileName”: “SendTo#now:yyyyMMdd#.csv”,





The first item will be interpreted as ConnectionString : “Server=(local)\\SQL2016;Database=tempdb;Trusted_Connection=True;”

The second item will be interpreted as FileName: “SendTo20180710.csv”

The third item will call the static functions( Directory.GetCurrentDirectory() , Path.GetPathRoot)   from C# and return the result

The fourth item will call Environment variable solutionPath  and give back as an argument to the static function System.IO.Path.GetFileNameWithoutExtension

The fifth will call Guid.NewGuid().ToString(“N”)

All in all, it is another redirection and interpreting of data.