在C#环境中动态调用IronPython脚本(一）

        本文讲述用C#调用Ironpython运行环境，解析并运行动态pyhton脚本。这种情况应用在那些需要滞后规定行为的场合，例如，动态计算项（计算引擎），用户可以自定义计算内容、计算公式等。

        本文的代码适用于IronPython 2.7(需要下载及安装)及C#4.0，由于IronPython早期版本提供的Hosting API不同，对于网上搜索得到的代码，如果是早期版本代码（多数如此），并不能编译通过，所以本文强调代码的版本问题。

        本文代码需要引用两个命名空间IronPython和Microsoft.Scripting (文件位置分别为IronPython 2.7的安装目录下的IronPython.dll和Microsoft.Scripting.dll)。 

一、最简单的例子

        先看一个最简单的例子，C#环境与Python环境没有数据联系。       

      public static void test1()
      {
            var engine = IronPython.Hosting.Python.CreateEngine();
            engine.CreateScriptSourceFromString("print 'hello world'").Execute();
            Console.ReadLine();
      }

        如果IronPython环境建立好，运行test1()，就会得到正确的结果。如果只想运行一段脚本，就是这般简单。

二、C#环境调用Python环境函数

        以上的例子没有实用价值，再看第二个例子，这个例子演示了如何从C#环境调用Python环境中的函数以及类中方法。

 public static void test2()
        {
            var engine = Python.CreateEngine();
            var scope = engine.CreateScope();
            var source = engine.CreateScriptSourceFromString(
                "def adder(arg1, arg2):\n" +
                "   return arg1 + arg2\n" +
                "\n" +
                "def fun(arg1):\n" +
                "   tel = {'jack': 4098, 'sape': 4139}\n" +
                "   for k, v in arg1.iteritems():\n"+
                "      tel[k]=v\n"+
                "   return tel\n" +
                "\n" +
                "class MyClass(object):\n" +
                "   def __init__(self, value):\n" +
                "       self.value = value\n");
            source.Execute(scope);

            var adder = scope.GetVariable<Func<object, object, object>>("adder");
            Console.WriteLine(adder(2, 2));

            var fun = scope.GetVariable<Func<object, object>>("fun");
            IronPython.Runtime.PythonDictionary inputDict = new IronPython.Runtime.PythonDictionary();
            inputDict["abc"] = "abc";
            inputDict["def"] = 456;
            object res = fun(inputDict);
            IronPython.Runtime.PythonDictionary outputDict = res as IronPython.Runtime.PythonDictionary;
            foreach (var k in outputDict.Keys)
            {
                Console.WriteLine("key:"+ k.ToString()+" val:  " + outputDict[k].ToString());
            }

            var myClass = scope.GetVariable<Func<object, object>>("MyClass");
            var myInstance = myClass("hello");

            Console.WriteLine(engine.Operations.GetMember(myInstance, "value"));
        }

上面代码中，python中有两个函数和一个类，第一个函数的参数是简单数据类型，第二个是复杂数据类型（关于两个环境下复杂数据类型的对应，下面将论述）。无论是类还是函数，C#的调用方法都是通过ScriptScope.GetVariable，它的函数定义如下：

T GetVariable<T>(string name);

ScriptScope还有一个更“安全”的方法

boolTryGetVariable<T>(string name, out T value);

可以完成相似的操作。

这个例子，可以扩展C#的应用，例如，python有丰富的数学计算库，而C#在这方面较欠缺，这时，就可以采用上面的方式，计算部分采用现成的python库，而主控程序采用C#编制。

三、在Python环境中调用C#环境函数

现在看第三个例子，如果Python运行逻辑复杂，需要在运行过程中调用C#函数怎么办？

public static void test3()
        {
            var engine = Python.CreateEngine();
            var scope = engine.CreateScope();

            scope.SetVariable("my_object_model", new CSharpClass ());
            string pythonscript =
                "def fun(arg1):\n" +
                "   result = arg1+1\n" +
                "   return result\n" +
                "adder = fun(5) + my_object_model.Foo(2)\n" ;
             engine.CreateScriptSourceFromString(pythonscript).Execute(scope);
             Console.WriteLine(scope.GetVariable("adder"));
        }
Class CSharpClass
{
        public int Foo(int arg)
        {
           return  arg +1;
        }
}

这个例子中，创建CShparpClass类，并将其作为“变量”传到Python环境中，在Python中就可以调用了。注意到C#中的类名可以和Python中不一样。

四、在Python环境中动态调用C#库

        在这种情况下，Python脚本和C#库都是“滞后”于主应用才编写出来的，可以满足用户现场定制行为（采用Python脚本），并且可以给Python脚本传入现场定制的参数。

首先，建立一个C#库，代码如下：

 

namespace LibforPython
{
    public class PythonLib
    {
        public int Test(int x, string op)
        {
            switch (op.ToUpper())
            {
                case "INC":
                    return x + 1;
                case "DEC":
                    return x - 1;
            }
            return x + 1;
        }
    }
}

编译成LibforPython.dll后拷贝到主运行程序的运行目录（二者同目录）。调用代码如下：

      public static void test4()
        {
            var engine = Python.CreateEngine();
            var scope = engine.CreateScope();
            engine.Runtime.LoadAssembly(Assembly.LoadFrom("LibforPython.dll"));              string pythonscript =
               "from LibforPython import PythonLib\n" +
               "o = PythonLib()\n" +
               "res = o.Test(6,'add')\n";
            engine.CreateScriptSourceFromString(pythonscript).Execute(scope);
            Console.WriteLine(scope.GetVariable("res"));
        }

运行以上程序即可。这个例子中，LibforPython.dll是在运行时才引入Python环境中的。对于预先已知的Python可能用到的接口，才用例三的办法更好些，对于预先无法预先定义或“遗忘”的接口，采用本例比较适合。

五、总结

    将Python环境“寄宿”于C#环境，进而动态执行用户自定义的脚本，是应用可配置性、灵活性的一种体现（其他动态语言也可以这么做，以Ironpython比较简单）。这一过程包括以下三步：

           var engine = Python.CreateEngine();

           var scope = engine.CreateScope();

           var source = engine.CreateScriptSourceFromString(“…”);

           source.Execute(scope);

Python环境与宿主环境的交互（参数传入、传出），则通过ScriptScop的GetVariable和SetVariable进行。

        下一个问题就是Python复杂数据类型与C#复杂数据类型的对应以及出错处理等，将在下一篇介绍。这里只把复杂数据类型的对应列出来。

C#                                                           Python      

IronPython.Runtime.List      ――――  List

IronPython.Runtime.SetCollection ―――  Set

IronPython.Runtime.PythonDictionary ―― Dictionary