Professional IronPython

Downloading the Documentation
The download you performed earlier provides code and documentation, but you might find that the 
documentation is outdated. As with everything else about DLR, the documentation is in a constant 
state of flux. If you want to use DLR directly, then you need the documentation found at
http://dlr.codeplex.com/wikipage?title=Docs and specs&referringTitle=Home
.
Unfortunately, you have to download each document separately.
Reporting bugs and Other Issues
At some point, you’ll run into something that doesn’t work as expected. Of course, this problem 
even occurs with production code, but you’ll definitely run into problems when using the current 
release of DLR. In this case, check out the listing of issues at 
http://www.codeplex.com/dlr/
548592c14.indd 292
2/24/10 12:49:05 PM
www.finebook.ir

---

Working with Hosting APIs
 
❘
 
293
WorkItem/List.aspx
. If you don’t find an issue entry that matches the problem you’re experiencing, 
make sure you report the bug online so it gets fixed. Of course, reporting applies equally to code 
and documentation. Documentation errors are often harder to find and fix than coding errors — at 
least where developers are concerned — because it’s easier to see the coding error in many cases.
WORkINg WITH HOSTINg APIS
As you’ve progressed through the book, you probably found that IronPython is a reasonably easy 
language to learn, yet it provides considerable flexibility and functionality. In fact, you may have even 
wondered whether it’s possible to use IronPython as a scripting language for your next application. 
Fortunately, you can use IronPython as the scripting language for your next application by relying on 
the Hosting APIs. It turns out that a lot of people have considered IronPython an optimal language
for the task. The following sections consider a number of Hosting API questions, such as how you can 
use it in an actual application, what the host application needs in order to use the Hosting APIs, and 
what you’d need to do to embed IronPython as a scripting language in an application.
A single section of a book can’t provide everything needed to use the Hosting 
APIs. In fact, the authors of the Hosting APIs specification required 87 pages
just to document the specification. You can find the specification in the
DLR-Spec-Hosting.DOC
 file found in the 
\Codeplex-DLR-0.92\Docs
 folder of 
your DLR installation. Of course, you may find that some of the information in 
this file is outdated, so be sure to check on 
http://www.iunknown.com/2008/01/
latest-dlr-host.html
 for additional information or download the updated 
specification from 
http://www.iunknown.com/files/dlr-spec-hosting.pdf
.