IronPython works as an extension to the .NET Framework, but it can also be used by .NET projects to take advantage of Python\u2019s scripting power. Other than that, since IronPython is a real implementation of Python itself, there\u2019s no need to learn a new language or extra features if you already know Python.<\/p>\n
This article explores the language and teaches how you can benefit from its integration with .NET.<\/p>\n
<\/a>Setup<\/h2>\nThere are a couple of ways to install it. If you aim to use IronPython standalone in projects other than those in Visual Studio, you can download and install it. Examples in this article use the 2.7.11 release, but the examples should work well with the latest version.<\/p>\n
Go to the GitHub download page<\/a>, and click the MSI installer to download it. I\u2019m assuming you\u2019re following this tutorial from a Windows OS. Visual Studio still has no support for adding Python extensions on macOS, for instance.<\/p>\nRun the installer and follow the steps until the end.<\/p>\n
![\"IronPython](\"https:\/\/www.red-gate.com\/simple-talk\/wp-content\/uploads\/2021\/02\/word-image-90.png\")
<\/p>\n
Figure 1.<\/strong> Installing IronPython on Windows.<\/strong><\/p>\nDuring the process, you may notice a screen that shows the Python versions being installed (Figure 2). It comes by default with Python\u2019s IronPython language, along with the pip<\/a> (package manager for Python).<\/p>\n![\"IronPython](\"https:\/\/www.red-gate.com\/simple-talk\/wp-content\/uploads\/2021\/02\/word-image-91.png\")
<\/p>\n
Figure 2.<\/strong> Selecting the IronPython features<\/strong>.<\/p>\nMake sure to browse for the installation location shown in Figure 2 if you won\u2019t use the default one. After the process is done, you can go to the specified folder and run the file ipy.exe<\/em>. It represents the command line interface from which you may run your IronPython commands.<\/p>\nRun it, and check in Figure 3 how the interface looks.<\/p>\n
![\"check](\"https:\/\/www.red-gate.com\/simple-talk\/wp-content\/uploads\/2021\/02\/word-image-92.png\")
<\/p>\n
Figure 3. IronPython command-line shell.<\/strong><\/p>\nIt is also a REPL, which allows you to execute interactive Python code to try it out. Do it as you please.<\/p>\n
Alternatively, you can also download IronPython binary files, extract them and access the executor via the command line. We\u2019ll stick, however, to the installer-based version which is more concise and straightforward.<\/p>\n
<\/a>WinForms with IronPython<\/h2>\nNow that you have the environment set up, it\u2019s time to learn what IronPython is capable of doing. Perhaps one of the best ways to prove its interoperability with .NET is through the construction of some WinForms.<\/p>\n
To see this in action, you will create a simple MessageBox<\/a> to display a message window and two buttons: Yes<\/em> and No<\/em>. Figure 4 illustrates how the box is going to look .<\/p>\n![\"MessageBox](\"https:\/\/www.red-gate.com\/simple-talk\/wp-content\/uploads\/2021\/02\/word-image-93.png\")
<\/p>\n
Figure 4.<\/strong> A MessageBox built with IronPython<\/strong>.<\/p>\nEach operation is going to run some Python code to perform different actions. You can find the code for this in Listing 1.<\/p>\n
Listing 1.<\/strong> Creating a box with action buttons.<\/strong><\/p>\nimport clr\r\nclr.AddReference('System')\r\nclr.AddReference('System.Windows.Forms')\r\nimport System\r\nimport System.Windows.Forms as WinForms\r\nmessage = \"Cancel this operation?\"\r\ncaption = \"Alert\"\r\nbuttons = WinForms.MessageBoxButtons.YesNo\r\nresult = WinForms.MessageBox.Show(message, caption, buttons)\r\nif result == WinForms.DialogResult.Yes:\r\n WinForms.MessageBox.Show(\"Great, it's canceled!\")\r\n System.Console.Write(\"Success!\")\r\nelse:\r\n print \"Sorry, something went wrong!\"<\/pre>\nIf you\u2019ve coded with Python and C# before, this code may look weirdly familiar.<\/p>\n
The starting point of any mixed code with IronPython starts with its CLR module<\/a> (the common language runtime). It allows a deep integration between both languages. With it in hand, you can add as many references as you want, such as the System<\/code> and the Windows Forms.<\/p>\nTake note of how the whole coding experience is Python-based, and only Python. This includes the imports, the variables, the code indentation, the conditional statements, etc.<\/p>\n
Once you add the .NET references, you\u2019re allowed to use them throughout the code as real Python objects. The methods, types, parameters, and results also apply, so be careful. Also, pay attention to the body of the if condition. In case the user selects the option \u201cYes\u201d, another message box is displayed along with a logline coded in C# via System.Console<\/code>. Otherwise, the negative log is displayed but this time via Python\u2019s print<\/code> function. Cool, isn\u2019t it?<\/p>\nSave the code to a file called Hello.py<\/em> into the same folder that IronPython is installed. Then, open a standard command line (cmd<\/code>), navigate to the IronPython root folder:<\/p>\ncd C:\\Program Files\\IronPython 2.7<\/pre>\nThen run the following command:<\/p>\n
ipy.exe Hello.py<\/pre>\nThe execution triggers the message box shown in Figure 4. Go ahead and test both the buttons. Figure 5 shows what happens after clicking the Yes <\/em>option.<\/p>\n![](\"https:\/\/www.red-gate.com\/simple-talk\/wp-content\/uploads\/2021\/02\/word-image-94.png\")
<\/p>\n
Figure 5.<\/strong> Message box opened after Yes<\/em> option-click.<\/strong><\/p>\nThe image above will be followed by the message \u201cSuccess\u201d logged in the console.<\/p>\n
<\/a>Dealing with generics<\/h2>\nGenerics are an important part of Object-oriented programming, and IronPython allows its usage along with some Python code. Take the classic example of Collections<\/code>. They represent one of the most traditional uses of generics in C#. Check out the code presented in Listing 2.<\/p>\nListing 2.<\/strong> Dealing with Generics in IronPython<\/strong><\/p>\nfrom System.Collections.Generic import List\r\nitems = List[str]()\r\nitems.Add('Item A')\r\nitems.Add('Item B')\r\nitems.Add('Item C')\r\nfor item in items:\r\n print item<\/pre>\nNote how array-like this syntax is. Yes, you can provide IronPython with generics just the way you access array indices. If you try to add anything other than strings, like shown below:<\/p>\n
items = List[str]()\r\nitems.Add(123)<\/pre>\nA corresponding error will be thrown:<\/p>\n
Traceback (most recent call last):\r\n File \"Hello.py\", line 3, in <module>\r\nTypeError: expected str, got int<\/pre>\n<\/a>Object-oriented programming<\/h2>\nOOP is another crucial part when it comes to C# development. Among its many facets, being able to create classes (along with attributes and methods) and instantiate objects is also possible in IronPython. To demonstrate, change the content of your Hello.py <\/em>file with the code shown in Listing 3.<\/p>\nListing 3.<\/strong> Example of a C# class in IronPython<\/strong><\/p>\nclass Person:\r\n name = 'John Silva'\r\n age = 12\r\n email = 'john@email.com'\r\n \r\n # setters\r\n def setName(self, name):\r\n self.name = name\r\n def setAge(self, age):\r\n self.age = age\r\n def setEmail(self, email):\r\n self.email = email\r\n \r\n # getters\r\n def getName(self):\r\n return self.name\r\n def getAge(self):\r\n return self.age\r\n def getEmail(self):\r\n return self.email\r\n def getInfo(self):\r\n print \"Hi! I'm \", self.name, \", I'm \", self.age, \"years old and this is my email: \", self.email<\/pre>\nPretty simple. There\u2019s just a couple of attributes and getters\/setters for each. To make use of this class, you\u2019d have to import it within another Python file. However, to simplify it, open another command line window and cd<\/em> into the folder where the Hello.py<\/em> file is located. Then, execute the command below in order to let ipy<\/em> notice that specific class:<\/p>\nipy Hello.py<\/pre>\nNow, it\u2019s time to enter into the interactive mode. Just hit the ipy command for that, and the terminal must change to how it is shown in Figure 6.<\/p>\n
![](\"https:\/\/www.red-gate.com\/simple-talk\/wp-content\/uploads\/2021\/02\/word-image-95.png\")
<\/p>\n
Figure 6.<\/strong> IronPython interactive mode.<\/strong><\/p>\nThen, you can run some interactive code exploring the Person<\/code> class previously created. Type the following code lines directly to the new shell window:<\/p>\nimport sys\r\nsys.path.append('C:\\Program Files\\IronPython 2.7')\r\nimport Hello<\/pre>\nMake sure to change IronPython\u2019s path with yours. Finally, play with it by creating a person object and calling its methods:<\/p>\n
person = Hello.Person()\r\nperson.getInfo()\r\n> Hi! I'm John Silva, I'm 12 years old and this is my email: john@email.com<\/pre>\nFigure 7 shows a bit more of the options you can base at.<\/p>\n
![](\"https:\/\/www.red-gate.com\/simple-talk\/wp-content\/uploads\/2021\/02\/word-image-96.png\")
<\/p>\n
Figure 7.<\/strong> Playing with Person object\u2019s methods in IronPython.<\/strong><\/p>\n<\/a>What else can you do with IronPython?<\/h2>\nIronPython can work for many of the .NET facets, such as ASP.NET web applications, APIs, data science, etc., but it\u2019s been more widely used for desktop application development.<\/p>\n
There used to be an IronPython Studio to integrate with Visual Studio 2008. However, time and maintenance have proved too difficult to keep up with. Today, you can add IronPython\u2019s dependencies to your .NET projects via NuGet, especially if you\u2019re working with Visual Studio.<\/p>\n
It\u2019s important to note that IronPython has been around for quite a long time, and still, the team has been working to maintain and update it. The documentation<\/a> is not complete, but it\u2019s enough to make some grounds when getting started. Additionally, the classic book IronPython in Action<\/a> is a must-read if you\u2019re willing to understand more about its capability.<\/p>\n <\/p>\n","protected":false},"excerpt":{"rendered":"
Python is one of the most popular languages. Julio Sampaio explains how IronPython allows you to integrate Python with .NET.…<\/p>\n","protected":false},"author":323407,"featured_media":0,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[146042],"tags":[5647,5021,5134],"coauthors":[93894],"class_list":["post-89888","post","type-post","status-publish","format-standard","hentry","category-python","tag-ironpython","tag-python","tag-sql-prompt"],"acf":[],"_links":{"self":[{"href":"https:\/\/www.red-gate.com\/simple-talk\/wp-json\/wp\/v2\/posts\/89888","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.red-gate.com\/simple-talk\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.red-gate.com\/simple-talk\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.red-gate.com\/simple-talk\/wp-json\/wp\/v2\/users\/323407"}],"replies":[{"embeddable":true,"href":"https:\/\/www.red-gate.com\/simple-talk\/wp-json\/wp\/v2\/comments?post=89888"}],"version-history":[{"count":4,"href":"https:\/\/www.red-gate.com\/simple-talk\/wp-json\/wp\/v2\/posts\/89888\/revisions"}],"predecessor-version":[{"id":89897,"href":"https:\/\/www.red-gate.com\/simple-talk\/wp-json\/wp\/v2\/posts\/89888\/revisions\/89897"}],"wp:attachment":[{"href":"https:\/\/www.red-gate.com\/simple-talk\/wp-json\/wp\/v2\/media?parent=89888"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.red-gate.com\/simple-talk\/wp-json\/wp\/v2\/categories?post=89888"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.red-gate.com\/simple-talk\/wp-json\/wp\/v2\/tags?post=89888"},{"taxonomy":"author","embeddable":true,"href":"https:\/\/www.red-gate.com\/simple-talk\/wp-json\/wp\/v2\/coauthors?post=89888"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}
Run the installer and follow the steps until the end.<\/p>\n
<\/p>\n
Figure 1.<\/strong> Installing IronPython on Windows.<\/strong><\/p>\n During the process, you may notice a screen that shows the Python versions being installed (Figure 2). It comes by default with Python\u2019s IronPython language, along with the pip<\/a> (package manager for Python).<\/p>\n Figure 2.<\/strong> Selecting the IronPython features<\/strong>.<\/p>\n Make sure to browse for the installation location shown in Figure 2 if you won\u2019t use the default one. After the process is done, you can go to the specified folder and run the file ipy.exe<\/em>. It represents the command line interface from which you may run your IronPython commands.<\/p>\n Run it, and check in Figure 3 how the interface looks.<\/p>\n Figure 3. IronPython command-line shell.<\/strong><\/p>\n It is also a REPL, which allows you to execute interactive Python code to try it out. Do it as you please.<\/p>\n Alternatively, you can also download IronPython binary files, extract them and access the executor via the command line. We\u2019ll stick, however, to the installer-based version which is more concise and straightforward.<\/p>\n Now that you have the environment set up, it\u2019s time to learn what IronPython is capable of doing. Perhaps one of the best ways to prove its interoperability with .NET is through the construction of some WinForms.<\/p>\n To see this in action, you will create a simple MessageBox<\/a> to display a message window and two buttons: Yes<\/em> and No<\/em>. Figure 4 illustrates how the box is going to look .<\/p>\n Figure 4.<\/strong> A MessageBox built with IronPython<\/strong>.<\/p>\n Each operation is going to run some Python code to perform different actions. You can find the code for this in Listing 1.<\/p>\n Listing 1.<\/strong> Creating a box with action buttons.<\/strong><\/p>\n If you\u2019ve coded with Python and C# before, this code may look weirdly familiar.<\/p>\n The starting point of any mixed code with IronPython starts with its CLR module<\/a> (the common language runtime). It allows a deep integration between both languages. With it in hand, you can add as many references as you want, such as the Take note of how the whole coding experience is Python-based, and only Python. This includes the imports, the variables, the code indentation, the conditional statements, etc.<\/p>\n Once you add the .NET references, you\u2019re allowed to use them throughout the code as real Python objects. The methods, types, parameters, and results also apply, so be careful. Also, pay attention to the body of the if condition. In case the user selects the option \u201cYes\u201d, another message box is displayed along with a logline coded in C# via Save the code to a file called Hello.py<\/em> into the same folder that IronPython is installed. Then, open a standard command line ( Then run the following command:<\/p>\n The execution triggers the message box shown in Figure 4. Go ahead and test both the buttons. Figure 5 shows what happens after clicking the Yes <\/em>option.<\/p>\n Figure 5.<\/strong> Message box opened after Yes<\/em> option-click.<\/strong><\/p>\n The image above will be followed by the message \u201cSuccess\u201d logged in the console.<\/p>\n Generics are an important part of Object-oriented programming, and IronPython allows its usage along with some Python code. Take the classic example of Listing 2.<\/strong> Dealing with Generics in IronPython<\/strong><\/p>\n Note how array-like this syntax is. Yes, you can provide IronPython with generics just the way you access array indices. If you try to add anything other than strings, like shown below:<\/p>\n A corresponding error will be thrown:<\/p>\n OOP is another crucial part when it comes to C# development. Among its many facets, being able to create classes (along with attributes and methods) and instantiate objects is also possible in IronPython. To demonstrate, change the content of your Hello.py <\/em>file with the code shown in Listing 3.<\/p>\n Listing 3.<\/strong> Example of a C# class in IronPython<\/strong><\/p>\n Pretty simple. There\u2019s just a couple of attributes and getters\/setters for each. To make use of this class, you\u2019d have to import it within another Python file. However, to simplify it, open another command line window and cd<\/em> into the folder where the Hello.py<\/em> file is located. Then, execute the command below in order to let ipy<\/em> notice that specific class:<\/p>\n Now, it\u2019s time to enter into the interactive mode. Just hit the ipy command for that, and the terminal must change to how it is shown in Figure 6.<\/p>\n Figure 6.<\/strong> IronPython interactive mode.<\/strong><\/p>\n Then, you can run some interactive code exploring the Make sure to change IronPython\u2019s path with yours. Finally, play with it by creating a person object and calling its methods:<\/p>\n Figure 7 shows a bit more of the options you can base at.<\/p>\n Figure 7.<\/strong> Playing with Person object\u2019s methods in IronPython.<\/strong><\/p>\n IronPython can work for many of the .NET facets, such as ASP.NET web applications, APIs, data science, etc., but it\u2019s been more widely used for desktop application development.<\/p>\n There used to be an IronPython Studio to integrate with Visual Studio 2008. However, time and maintenance have proved too difficult to keep up with. Today, you can add IronPython\u2019s dependencies to your .NET projects via NuGet, especially if you\u2019re working with Visual Studio.<\/p>\n It\u2019s important to note that IronPython has been around for quite a long time, and still, the team has been working to maintain and update it. The documentation<\/a> is not complete, but it\u2019s enough to make some grounds when getting started. Additionally, the classic book IronPython in Action<\/a> is a must-read if you\u2019re willing to understand more about its capability.<\/p>\n <\/p>\n","protected":false},"excerpt":{"rendered":" Python is one of the most popular languages. Julio Sampaio explains how IronPython allows you to integrate Python with .NET.…<\/p>\n","protected":false},"author":323407,"featured_media":0,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[146042],"tags":[5647,5021,5134],"coauthors":[93894],"class_list":["post-89888","post","type-post","status-publish","format-standard","hentry","category-python","tag-ironpython","tag-python","tag-sql-prompt"],"acf":[],"_links":{"self":[{"href":"https:\/\/www.red-gate.com\/simple-talk\/wp-json\/wp\/v2\/posts\/89888","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.red-gate.com\/simple-talk\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.red-gate.com\/simple-talk\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.red-gate.com\/simple-talk\/wp-json\/wp\/v2\/users\/323407"}],"replies":[{"embeddable":true,"href":"https:\/\/www.red-gate.com\/simple-talk\/wp-json\/wp\/v2\/comments?post=89888"}],"version-history":[{"count":4,"href":"https:\/\/www.red-gate.com\/simple-talk\/wp-json\/wp\/v2\/posts\/89888\/revisions"}],"predecessor-version":[{"id":89897,"href":"https:\/\/www.red-gate.com\/simple-talk\/wp-json\/wp\/v2\/posts\/89888\/revisions\/89897"}],"wp:attachment":[{"href":"https:\/\/www.red-gate.com\/simple-talk\/wp-json\/wp\/v2\/media?parent=89888"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.red-gate.com\/simple-talk\/wp-json\/wp\/v2\/categories?post=89888"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.red-gate.com\/simple-talk\/wp-json\/wp\/v2\/tags?post=89888"},{"taxonomy":"author","embeddable":true,"href":"https:\/\/www.red-gate.com\/simple-talk\/wp-json\/wp\/v2\/coauthors?post=89888"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}<\/p>\n<\/p>\n<\/a>WinForms with IronPython<\/h2>\n
<\/p>\nimport clr\r\nclr.AddReference('System')\r\nclr.AddReference('System.Windows.Forms')\r\nimport System\r\nimport System.Windows.Forms as WinForms\r\nmessage = \"Cancel this operation?\"\r\ncaption = \"Alert\"\r\nbuttons = WinForms.MessageBoxButtons.YesNo\r\nresult = WinForms.MessageBox.Show(message, caption, buttons)\r\nif result == WinForms.DialogResult.Yes:\r\n WinForms.MessageBox.Show(\"Great, it's canceled!\")\r\n System.Console.Write(\"Success!\")\r\nelse:\r\n print \"Sorry, something went wrong!\"<\/pre>\nSystem<\/code> and the Windows Forms.<\/p>\nSystem.Console<\/code>. Otherwise, the negative log is displayed but this time via Python\u2019s print<\/code> function. Cool, isn\u2019t it?<\/p>\ncmd<\/code>), navigate to the IronPython root folder:<\/p>\ncd C:\\Program Files\\IronPython 2.7<\/pre>\n
ipy.exe Hello.py<\/pre>\n
<\/p>\n<\/a>Dealing with generics<\/h2>\n
Collections<\/code>. They represent one of the most traditional uses of generics in C#. Check out the code presented in Listing 2.<\/p>\nfrom System.Collections.Generic import List\r\nitems = List[str]()\r\nitems.Add('Item A')\r\nitems.Add('Item B')\r\nitems.Add('Item C')\r\nfor item in items:\r\n print item<\/pre>\nitems = List[str]()\r\nitems.Add(123)<\/pre>\n
Traceback (most recent call last):\r\n File \"Hello.py\", line 3, in <module>\r\nTypeError: expected str, got int<\/pre>\n
<\/a>Object-oriented programming<\/h2>\n
class Person:\r\n name = 'John Silva'\r\n age = 12\r\n email = 'john@email.com'\r\n \r\n # setters\r\n def setName(self, name):\r\n self.name = name\r\n def setAge(self, age):\r\n self.age = age\r\n def setEmail(self, email):\r\n self.email = email\r\n \r\n # getters\r\n def getName(self):\r\n return self.name\r\n def getAge(self):\r\n return self.age\r\n def getEmail(self):\r\n return self.email\r\n def getInfo(self):\r\n print \"Hi! I'm \", self.name, \", I'm \", self.age, \"years old and this is my email: \", self.email<\/pre>\n
ipy Hello.py<\/pre>\n
<\/p>\nPerson<\/code> class previously created. Type the following code lines directly to the new shell window:<\/p>\nimport sys\r\nsys.path.append('C:\\Program Files\\IronPython 2.7')\r\nimport Hello<\/pre>\nperson = Hello.Person()\r\nperson.getInfo()\r\n> Hi! I'm John Silva, I'm 12 years old and this is my email: john@email.com<\/pre>\n
<\/p>\n<\/a>What else can you do with IronPython?<\/h2>\n