Professional IronPython

Using External Modules with IronPython
Any application can use external modules. In fact, your IronPython application can have any
number of external modules. You can use them as you would any other application. In order to use 
an external module, you simply import it into the main module. Let’s begin this example with a 
simple external module named MyStuff.py. Listing 2-3 shows the code for this module.
lISTINg 2-3: 
 Creating a simple external function
# Define a simple function that takes
# two arguments. 
def SayHello(msg, name):
“Displays a hello message -> SayHello(message, user name)“
print msg, name
return
The 
SayHello()
function is quite simple. All it does is print the message and name onscreen — 
nothing too complicated. However, it does serve as a useful example of how to work with external 
modules. Notice the string in the first line. The __doc__ attribute uses this information. After
you import the module, you can type 
print MyStuff.SayHello.__doc__
and press Enter to see 
this message.
Before you can use 
SayHello()
, you must import it. The main module, External.py, imports the 
external module as shown in Listing 2-4.
lISTINg 2-4: 
 Importing an external module and using it
# Import the file
import MyStuff
# Assign the function to a local variable.
continues
548592c02.indd 39
2/24/10 12:47:23 PM
www.finebook.ir

---

40
❘
CHAPTER 2
Understanding the ironPython Basics
SayHello = MyStuff.SayHello
# Perform the task.
SayHello(‘Hello’, ‘George’)
# Pause the display
raw_input(‘Press any key...’)
The example begins by importing MyStuff. Placing the external module in the same directory as the 
rest of the application is the best way to ensure the interpreter can find it. When you plan to use a 
particular function relatively often, you can assign it to a local variable, as shown in the example. 
This technique lets you call the function without using the module name, as would normally be 
required. The code calls 
SayHello() 
next. It then pauses so you can see the output in Visual 
Studio. Figure 2-22 shows the results.