secretGeek.net

A 3 minute guide to embedding IronPython in a C# application

agile, blog, [code], editor, html, linguistics, microsoft, productivity, tools, UX
A C# app that hosts iron python to perform calculations

Despite knowing absolutely nothing about Python, I've had a lot of fun and a few lttle victories with it tonight. I've built two small apps that I'll include the code for below.

I've avoided IronPython up until now, but a terrible problem has arisen lately.

I've decided to write my own text editor.

This is a bad thing. Only fools write their own text editor. Soon, hair will start growing on the palms of my hands.

But, since I'm looking for some extensibility in this editor idea (of which I'll show more in a subsequent post) I realised that hosting IronPython is the best way to get the sort of scripting I'm after.

Hosting IronPython in C# is well-trodden turf. Many other have been there and blogged it before. But the fun was really in the doing.

Here's two very short demo apps I wrote tonight, literally in under an hour.

First, by following the example Bernie Almosni provides in Extending your c# application with IronPython I built a little interactive calculator, with a history.

The code is trivial and can be downloaded below.

A C# app that hosts iron python to allow a textbox to be modified programmatically

The next example is also trivial, but I'll step through the code just quickly, since it's a superset of the previous example.

I wrote a little application that lets you write python code to alter the contents of a textbox. This is the heart of the editor I have in mind -- and it's barely 10 lines!

So, in a fresh C# winforms app, I added references to all the dll's in C:\Program Files\IronPython 2.0.1 (I didn't know which dlls i needed exactly -- so i referenced them all ;-) )

I created a new form and dropped two text boxes and a button on it, as you'll see in the screenshot.

I added these using statements:

using IronPython.Hosting;
using Microsoft.Scripting;
using Microsoft.Scripting.Hosting;

I created two module levels variables, one to hold the IronPython engine, and one to tell it the 'scope' of the variables I want to share with it.

private ScriptEngine m_engine = Python.CreateEngine();
private ScriptScope m_scope = null;

Upon form_load, I construct the scope, and add the target text box to it. (This is the text box our Python code will be able to act upon.)

m_scope = m_engine.CreateScope();
m_scope.SetVariable("txt", TargetTextBox);

When the user clicks the button, I compile the code in the first box, and execute it as a statement.

Dead simple. Ridiculously simple.

string code = CommandTextBox.Text.Trim();
ScriptSource source = m_engine.CreateScriptSourceFromString(code, SourceCodeKind.SingleStatement);
source.Execute(m_scope);

With that in place, the python code entered at runtime, such as:

txt.SelectedText = txt.SelectedText.upper()

...has the desired effect of making the selected text uppercase.

I got the same effect in C# once, but it took five assemblies, hundreds of lines of code... it was terribly fragile and I broke it beyond repair before I got it to a source repository. A tragic episode, i still feel like stabbing someone every time I think about it. (LFT much?)/p>

So -- here's the source code:

download dodgy sample integrated C#/python code!  Sample Python Calculator and Programmable Text Box.

And here's a couple of other articles on the same topic:

 

My book "Choose Your First Product" is available now.

It gives you 4 easy steps to find and validate a humble product idea.

Learn more.

Steven Nagy on March 05, 2009 14:33 sez:

Interesting... (the IronPython integration that is, not this article). Now we can embed Quake2 style console popdowns in all our applications.

tarn on March 05, 2009 18:36 sez:

That's fantastic, but the fun has only just begun! If you change SourceCodeKind.SingleStatement to .Statements or .File you should be able to run this IronPython code in your app..

-- CUT --

import clr

clr.AddReferenceByPartialName("System.Windows.Forms")
clr.AddReference('IronPython')
clr.AddReference('Microsoft.Scripting')

from System.Windows.Forms import *
from IronPython.Hosting import Python
from Microsoft.Scripting import SourceCodeKind


class MetaNote(Form):
def __init__(self):
self.button = Button()
self.code = TextBox()
self.text = TextBox()

self.Width = 400

self.code.Multiline = True
self.code.Height = 100
self.code.Width = 300;

self.text.Top = 100
self.text.Width = 400
self.text.Height = 300
self.text.Multiline = True

self.button.Left = 300
self.button.Text = "Go"

self.Controls.Add(self.button)
self.Controls.Add(self.text)
self.Controls.Add(self.code)
self.button.Click += self.run

def run(self,sender,e):
engine = Python.CreateEngine()
source = engine.CreateScriptSourceFromString(self.code.Text, SourceCodeKind.Statements)
scope = engine.CreateScope()
scope.SetVariable("txt", self.text);
source.Execute(scope)

f = MetaNote()
f.Show()

-- CUT --

again and again ;)

Bengt on March 06, 2009 02:48 sez:

Use ironscheme and implement emaclisp! :)

Mr Graviton Tepes on March 06, 2009 07:19 sez:

I really like Python!

> Use ironscheme and implement emaclisp! :)

Would it be possible to write emacs in Python?

OJ on March 07, 2009 01:29 sez:

> Use ironscheme and implement emaclisp! :)

*sigh* There's always one isn't there.

Great post LB. I had no idea that embedding Iron(P/R) would be so easy! Great demo.

Tarn, interesting addition, though arguably geeking out a bit ;)

ev on March 08, 2009 08:05 sez:

you know, i always wonder why would you do this (i.e. embed any scripting language in .NET Framework app), if you already have c#/vb compiler available.

Here is very nice project by Oleg Shilo which, AFAIK, grew from similar line of thinking: http://www.csscript.net/

PS. sorry in advance for resubmitting comment, but the first time i submitted it from Opera i got no notice about premoderation or anything else keeping my comment from showing up.

lb on March 08, 2009 15:35 sez:

@ev
>why would you do this if you already c#/vb compiler available ?

Good question!

Basically, c#/vb aren't always the right tool for the job.

I've embedded c#/vb into an application before and it was much more complex to perform, and the final result was much less flexible to the task.

Here's three examples of why a dynamic language is a better choice for embedding.

1. You don't need to worry about an entry point.

In C#/VB a single statement can't exist by itself -- you need to wrap them inside a class definition, and in order to make them executable, you need to setup an explicit entry point (for example in a console app, you have 'main').

This is a detail that you can hide from the end user, but it's still there and likely to lead to more complexity.

2. In C#/VB, the minimum unit is an entire assembly. With a dynamic language, you can get an Abstract Syntax Tree.

If you need to do something with the compiled code other than run it, then having an abstract syntax tree can be useful. With a full assembly, you can use reflection and CodeDom to inspect more detail, but this is considerably more involved.

3. Iron python is more succinct.

I can also think of arguments *against* using IronPython -- for example, if the end user has no familiarity with it, or willingness to gain any.

If 'raw performance' is required then maybe a dynamic language will hold you back (but then again, maybe a plugin solution is not the best approach in such a case anyhow)

2xThomas on April 10, 2010 19:32 sez:

Mr Graviton Tepes, sure. You can write emacs in Python if you want to. Don't see why you would want to do that.

Open up the Python interpreter console and then type: emacs. Congratulations! You have now written emacs in Python. Wow!


Bob on July 09, 2017 01:18 sez:

That was much simpler than expected. Nice.

Juha Kuusama on July 24, 2017 09:05 sez:

Year 2017, things have changed somewhat. Using Visual Studio 2017 and IronPython 2.7.7:
Install IronPython from Nuget package manager console, two lines:

Install-Package IronPython
Install-Package IronPython.StdLib

Most of the references are installed automatically for you. Then, everything you want to use from IP has to be public on C# side. Here is how to access a variable, a function and a component (texbox, made public on the designer):
using Microsoft.Scripting.Hosting;
using Microsoft.Scripting;
using System.Windows.Forms;


namespace WindowsFormsApp1
{
public partial class Form1 : Form
{
public Form1()
{
InitializeComponent();
engine = IronPython.Hosting.Python.CreateEngine();
scope = engine.CreateScope();
scope.SetVariable("Main", this);
}

static public ScriptEngine engine;
static public ScriptScope scope;

public int a = 0;

public void incrA()
{
a = a + 2;
}

private void Script_button_Click(object sender, System.EventArgs e)
{
try
{
string code =
"Main.a= Main.a + 5\n" +
"Main.incrA()\n" +
"Main.textBox1.Text= 'message a='+str(Main.a)";

ScriptSource source = engine.CreateScriptSourceFromString(code,
SourceCodeKind.AutoDetect);
source.Execute(scope);
}
catch (System.Exception ex)
{
string txt = ex.Message; // show the message somehow...
}

}
}
}

Andrew on November 27, 2017 18:08 sez:

Very nice tutorial. I used to embed Tcl/Tk back in the days of old and happily scripting has come a long, long way since.

(By the way, I read every comment and often respond.)

Your comment, please?

Your Name
Your Url (optional)
Note: I may edit, reuse or delete your comment. Don't be mean.