diff --git a/CSScriptAddon/CSScriptAddon.vb b/CSScriptAddon/CSScriptAddon.vb index 5df1b89..ab52bd7 100644 --- a/CSScriptAddon/CSScriptAddon.vb +++ b/CSScriptAddon/CSScriptAddon.vb @@ -11,7 +11,7 @@ Public Class CSScriptAddon Implements IAddon Sub New() - Dim scriptDir = mpv.mpvConfFolderPath + "scripts" + Dim scriptDir = mp.mpvConfFolderPath + "scripts" If Not Directory.Exists(scriptDir) Then Return Dim csFiles = Directory.GetFiles(scriptDir, "*.cs") If csFiles.Count = 0 Then Return diff --git a/CSScriptAddon/CSScriptAddon.vbproj b/CSScriptAddon/CSScriptAddon.vbproj index eb47078..f418ddb 100644 --- a/CSScriptAddon/CSScriptAddon.vbproj +++ b/CSScriptAddon/CSScriptAddon.vbproj @@ -52,11 +52,6 @@ False .\CSScriptLibrary.dll - - False - ..\mpv.net\bin\Debug\mpvnet.exe - True - @@ -117,5 +112,12 @@ + + + {1751f378-8edf-4b62-be6d-304c7c287089} + mpv.net + False + + \ No newline at end of file diff --git a/CSScriptAddon/My Project/AssemblyInfo.vb b/CSScriptAddon/My Project/AssemblyInfo.vb index 7a53968..df02c45 100644 --- a/CSScriptAddon/My Project/AssemblyInfo.vb +++ b/CSScriptAddon/My Project/AssemblyInfo.vb @@ -8,11 +8,11 @@ Imports System.Runtime.InteropServices ' Review the values of the assembly attributes - + - - + + diff --git a/README.md b/README.md index d922bd0..bd1f6f7 100644 --- a/README.md +++ b/README.md @@ -50,8 +50,9 @@ class Script ### Changes -### 1.? +### 1.1 +- added support for Python scripting via IronPython - show tracks and show playlist didn't work because the duration wasn't defined in the key bindings ### 1.0 diff --git a/RatingAddon/RatingAddon.cs b/RatingAddon/RatingAddon.cs index 34407a1..e7fb9ff 100644 --- a/RatingAddon/RatingAddon.cs +++ b/RatingAddon/RatingAddon.cs @@ -14,8 +14,8 @@ namespace RatingAddon public RatingAddon() { - mpv.ClientMessage += mpv_ClientMessage; - mpv.Shutdown += mpv_Shutdown; + mp.ClientMessage += mpv_ClientMessage; + mp.Shutdown += mpv_Shutdown; } private void mpv_Shutdown() @@ -51,8 +51,8 @@ namespace RatingAddon if (args?.Length != 2 || args[0] != "rate-file" || ! int.TryParse(args[1], out rating)) return; - Dic[mpv.GetStringProp("path")] = rating; - mpv.Command("show-text", $"Rating: {rating}"); + Dic[mp.GetStringProp("path")] = rating; + mp.Command("show-text", $"Rating: {rating}"); } } } \ No newline at end of file diff --git a/RatingAddon/RatingAddon.csproj b/RatingAddon/RatingAddon.csproj index 5db895f..8fc24c8 100644 --- a/RatingAddon/RatingAddon.csproj +++ b/RatingAddon/RatingAddon.csproj @@ -85,6 +85,7 @@ {1751f378-8edf-4b62-be6d-304c7c287089} mpv.net + False diff --git a/mpv.net/Addon.cs b/mpv.net/Addon.cs index f1467b7..55231d8 100644 --- a/mpv.net/Addon.cs +++ b/mpv.net/Addon.cs @@ -28,7 +28,7 @@ namespace mpvnet foreach (string i in Directory.GetDirectories(dir)) catalog.Catalogs.Add(new DirectoryCatalog(i, "*Addon.dll")); - dir = mpv.mpvConfFolderPath + "\\Addons"; + dir = mp.mpvConfFolderPath + "\\Addons"; if (Directory.Exists(dir)) foreach (string i in Directory.GetDirectories(dir)) diff --git a/mpv.net/Command.cs b/mpv.net/Command.cs index efb7706..977c205 100644 --- a/mpv.net/Command.cs +++ b/mpv.net/Command.cs @@ -50,41 +50,41 @@ namespace mpvnet d.Filter = Misc.GetFilter(Misc.FileTypes); if (d.ShowDialog() == DialogResult.OK) - mpv.LoadFiles(d.FileNames); + mp.LoadFiles(d.FileNames); } })); } public static void open_config_folder(string[] args) { - Process.Start(mpv.mpvConfFolderPath); + Process.Start(mp.mpvConfFolderPath); } public static void show_keys(string[] args) { - Process.Start(mpv.InputConfPath); + Process.Start(mp.InputConfPath); } private static void CreateMpvConf() { - if (!File.Exists(mpv.mpvConfPath)) + if (!File.Exists(mp.mpvConfPath)) { - if (!Directory.Exists(mpv.mpvConfFolderPath)) - Directory.CreateDirectory(mpv.mpvConfFolderPath); + if (!Directory.Exists(mp.mpvConfFolderPath)) + Directory.CreateDirectory(mp.mpvConfFolderPath); - File.WriteAllText(mpv.mpvConfPath, "# https://mpv.io/manual/master/#configuration-files"); + File.WriteAllText(mp.mpvConfPath, "# https://mpv.io/manual/master/#configuration-files"); } } public static void show_prefs(string[] args) { CreateMpvConf(); - Process.Start(mpv.mpvConfPath); + Process.Start(mp.mpvConfPath); } public static void history(string[] args) { - var fp = mpv.mpvConfFolderPath + "history.txt"; + var fp = mp.mpvConfFolderPath + "history.txt"; if (File.Exists(fp)) Process.Start(fp); @@ -103,7 +103,7 @@ namespace mpvnet CreateMpvConf(); bool changed = false; - string fp = mpv.mpvConfPath; + string fp = mp.mpvConfPath; var confLines = File.ReadAllLines(fp); for (int i = 0; i < confLines.Length; i++) @@ -130,21 +130,21 @@ namespace mpvnet public static void show_info(string[] args) { - var fi = new FileInfo(mpv.GetStringProp("path")); + var fi = new FileInfo(mp.GetStringProp("path")); using (var mi = new MediaInfo(fi.FullName)) { var w = mi.GetInfo(MediaInfoStreamKind.Video, "Width"); var h = mi.GetInfo(MediaInfoStreamKind.Video, "Height"); - var pos = TimeSpan.FromSeconds(mpv.GetIntProp("time-pos")); - var dur = TimeSpan.FromSeconds(mpv.GetIntProp("duration")); + var pos = TimeSpan.FromSeconds(mp.GetIntProp("time-pos")); + var dur = TimeSpan.FromSeconds(mp.GetIntProp("duration")); string mibr = mi.GetInfo(MediaInfoStreamKind.Video, "BitRate"); if (mibr == "") mibr = "0"; var br = Convert.ToInt32(mibr) / 1000.0 / 1000.0; - var vf = mpv.GetStringProp("video-format").ToUpper(); + var vf = mp.GetStringProp("video-format").ToUpper(); var fn = fi.Name; if (fn.Length > 60) @@ -158,7 +158,7 @@ namespace mpvnet ((int)(fi.Length / 1024 / 1024)).ToString() + $" MB - {w} x {h}\n{vf} - {br.ToString("f1")} Mb/s" + "\n" + fn; - mpv.Command("show-text", info, "5000"); + mp.Command("show-text", info, "5000"); string FormatTime(double value) => ((int)(Math.Floor(value))).ToString("00"); } diff --git a/mpv.net/IronPython/IronPython.Modules.xml b/mpv.net/IronPython/IronPython.Modules.xml deleted file mode 100644 index a59f8c3..0000000 --- a/mpv.net/IronPython/IronPython.Modules.xml +++ /dev/null @@ -1,2565 +0,0 @@ - - - - IronPython.Modules - - - - - Copy the latest data from the memory buffer. - - This won't always contain data, because comrpessed data is only written after a block is filled. - - - - - - Add data to the input buffer. This manipulates the position of the stream - to make it appear to the BZip2 stream that nothing has actually changed. - - The data to append to the buffer. - - - - Try to convert IList(Of byte) to byte[] without copying, if possible. - - - - - - - Throw TypeError with a specified message if object isn't callable. - - - - - Convert object to ushort, throwing ValueError on overflow. - - - - - Interface for "file-like objects" that implement the protocol needed by load() and friends. - This enables the creation of thin wrappers that make fast .NET types and slow Python types look the same. - - - - - Interface for "file-like objects" that implement the protocol needed by dump() and friends. - This enables the creation of thin wrappers that make fast .NET types and slow Python types look the same. - - - - - Call the appropriate reduce method for obj and pickle the object using - the resulting data. Use the first available of - copy_reg.dispatch_table[type(obj)], obj.__reduce_ex__, and obj.__reduce__. - - - - - Pickle the result of a reduce function. - - Only context, obj, func, and reduceCallable are required; all other arguments may be null. - - - - - Write value in pickle decimalnl_short format. - - - - - Write value in pickle float8 format. - - - - - Write value in pickle uint1 format. - - - - - Write value in pickle uint2 format. - - - - - Write value in pickle int4 format. - - - - - Write value in pickle decimalnl_short format. - - - - - Write value in pickle decimalnl_short format. - - - - - Write value in pickle decimalnl_long format. - - - - - Write value in pickle unicodestringnl format. - - - - - Write value in pickle unicodestring4 format. - - - - - Write value in pickle stringnl_noescape_pair format. - - - - - Return true if value is appropriate for formatting in pickle uint1 format. - - - - - Return true if value is appropriate for formatting in pickle uint2 format. - - - - - Return true if value is appropriate for formatting in pickle int4 format. - - - - - Emit a series of opcodes that will set append all items indexed by iter - to the object at the top of the stack. Use APPENDS if possible, but - append no more than BatchSize items at a time. - - - - - Emit a series of opcodes that will set all (key, value) pairs indexed by - iter in the object at the top of the stack. Use SETITEMS if possible, - but append no more than BatchSize items at a time. - - - - - Emit a series of opcodes that will set all (key, value) pairs indexed by - iter in the object at the top of the stack. Use SETITEMS if possible, - but append no more than BatchSize items at a time. - - - - - Find the module for obj and ensure that obj is reachable in that module by the given name. - - Throw PicklingError if any of the following are true: - - The module couldn't be determined. - - The module couldn't be loaded. - - The given name doesn't exist in the module. - - The given name is a different object than obj. - - Otherwise, return the name of the module. - - To determine which module obj lives in, obj.__module__ is used if available. The - module named by obj.__module__ is loaded if needed. If obj has no __module__ - attribute, then each loaded module is searched. If a loaded module has an - attribute with the given name, and that attribute is the same object as obj, - then that module is used. - - - - - Interpret everything from markIndex to the top of the stack as a sequence - of key, value, key, value, etc. Set dict[key] = value for each. Pop - everything from markIndex up when done. - - - - - Used to check the type to see if we can do a comparison. Returns true if we can - or false if we should return NotImplemented. May throw if the type's really wrong. - - - - - Helper function for doing the comparisons. time has no __cmp__ method - - - - - Base class used for iterator wrappers. - - - - - Error function on real values - - - - - Complementary error function on real values: erfc(x) = 1 - erf(x) - - - - - Gamma function on real values - - - - - Natural log of absolute value of Gamma function - - - - - Provides helper functions which need to be called from generated code to implement various - portions of modules. - - - - - Checks for the specific permissions, provided by the mode parameter, are available for the provided path. Permissions can be: - - F_OK: Check to see if the file exists - R_OK | W_OK | X_OK: Check for the specific permissions. Only W_OK is respected. - - - - - single instance of environment dictionary is shared between multiple runtimes because the environment - is shared by multiple runtimes. - - - - - lstat(path) -> stat result - Like stat(path), but do not follow symbolic links. - - - - - spawns a new process. - - If mode is nt.P_WAIT then then the call blocks until the process exits and the return value - is the exit code. - - Otherwise the call returns a handle to the process. The caller must then call nt.waitpid(pid, options) - to free the handle and get the exit code of the process. Failure to call nt.waitpid will result - in a handle leak. - - - - - spawns a new process. - - If mode is nt.P_WAIT then then the call blocks until the process exits and the return value - is the exit code. - - Otherwise the call returns a handle to the process. The caller must then call nt.waitpid(pid, options) - to free the handle and get the exit code of the process. Failure to call nt.waitpid will result - in a handle leak. - - - - - spawns a new process. - - If mode is nt.P_WAIT then then the call blocks until the process exits and the return value - is the exit code. - - Otherwise the call returns a handle to the process. The caller must then call nt.waitpid(pid, options) - to free the handle and get the exit code of the process. Failure to call nt.waitpid will result - in a handle leak. - - - - - spawns a new process. - - If mode is nt.P_WAIT then then the call blocks until the process exits and the return value - is the exit code. - - Otherwise the call returns a handle to the process. The caller must then call nt.waitpid(pid, options) - to free the handle and get the exit code of the process. Failure to call nt.waitpid will result - in a handle leak. - - - - - Copy elements from a Python mapping of dict environment variables to a StringDictionary. - - - - - Convert a sequence of args to a string suitable for using to spawn a process. - - - - - Python regular expression module. - - - - - Compiled reg-ex pattern - - - - - Preparses a regular expression text returning a ParsedRegex class - that can be used for further regular expressions. - - - - - Implementes a resource-based meta_path importer as described in PEP 302. - - - - - Instantiates a new meta_path importer using an embedded ZIP resource file. - - - - - - - Process a sequence of objects that are compatible with ObjectToSocket(). Return two - things as out params: an in-order List of sockets that correspond to the original - objects in the passed-in sequence, and a mapping of these socket objects to their - original objects. - - The socketToOriginal mapping is generated because the CPython select module supports - passing to select either file descriptor numbers or an object with a fileno() method. - We try to be faithful to what was originally requested when we return. - - - - - Return the System.Net.Sockets.Socket object that corresponds to the passed-in - object. obj can be a System.Net.Sockets.Socket, a PythonSocket.SocketObj, a - long integer (representing a socket handle), or a Python object with a fileno() - method (whose result is used to look up an existing PythonSocket.SocketObj, - which is in turn converted to a Socket. - - - - - Stops execution of Python or other .NET code on the main thread. If the thread is - blocked in native code the thread will be interrupted after it returns back to Python - or other .NET code. - - - - - Provides a dictionary storage implementation whose storage is local to - the thread. - - - - - Represents the date components that we found while parsing the date. Used for zeroing out values - which have different defaults from CPython. Currently we only know that we need to do this for - the year. - - - - - Samples on how to subtype built-in types from C# - - - - - an int variable for demonstration purposes - - - - - an int variable for demonstration purposes - - - - - BytesIO([initializer]) -> object - - Create a buffered I/O implementation using an in-memory bytes - buffer, ready for reading and writing. - - - - - close() -> None. Disable all I/O operations. - - - - - True if the file is closed. - - - - - getvalue() -> bytes. - - Retrieve the entire contents of the BytesIO object. - - - - - Remove all 'b's from mode string to simplify parsing - - - - - Read and decode the next chunk from the buffered reader. Returns true if EOF was - not reached. Places decoded string in _decodedChars. - - - - - Convert string or bytes into bytes - - - - - Convert most bytearray-like objects into IList of byte - - - - - Creates an optimized encoding mapping that can be consumed by an optimized version of charmap_encode. - - - - - Encodes the input string with the specified optimized encoding map. - - - - - Decodes the input string using the provided string mapping. - - - - - Optimized encoding mapping that can be consumed by charmap_encode. - - - - - Walks the queue calling back to the specified delegate for - each populated index in the queue. - - - - - Returns the dialects from the code context. - - - - - - - Provides support for interop with native code from Python code. - - - Provides support for interop with native code from Python code. - - - Provides support for interop with native code from Python code. - - - Provides support for interop with native code from Python code. - - - Provides support for interop with native code from Python code. - - - Provides support for interop with native code from Python code. - - - Provides support for interop with native code from Python code. - - - Provides support for interop with native code from Python code. - - - Provides support for interop with native code from Python code. - - - Provides support for interop with native code from Python code. - - - Provides support for interop with native code from Python code. - - - Provides support for interop with native code from Python code. - - - Provides support for interop with native code from Python code. - - - Provides support for interop with native code from Python code. - - - Provides support for interop with native code from Python code. - - - Provides support for interop with native code from Python code. - - - Provides support for interop with native code from Python code. - - - Provides support for interop with native code from Python code. - - - - - The meta class for ctypes array instances. - - - - - Converts an object into a function call parameter. - - - - - Base class for all ctypes interop types. - - - - - Creates a new CFuncPtr object from a tuple. The 1st element of the - tuple is the ordinal or function name. The second is an object with - a _handle property. The _handle property is the handle of the module - from which the function will be loaded. - - - - - Creates a new CFuncPtr which calls a COM method. - - - - - Creates a new CFuncPtr with the specfied address. - - - - - Creates a new CFuncPtr with the specfied address. - - - - - we need to keep alive any methods which have arguments for the duration of the - call. Otherwise they could be collected on the finalizer thread before we come back. - - - - - Creates a method for calling with the specified signature. The returned method has a signature - of the form: - - (IntPtr funcAddress, arg0, arg1, ..., object[] constantPool) - - where IntPtr is the address of the function to be called. The arguments types are based upon - the types that the ArgumentMarshaller requires. - - - - - Base class for marshalling arguments from the user provided value to the - call stub. This class provides the logic for creating the call stub and - calling it. - - - - - Emits the IL to get the argument for the call stub generated into - a dynamic method. - - - - - Gets the expression used to provide the argument. This is the expression - from an incoming DynamicMetaObject. - - - - - Gets an expression which keeps alive the argument for the duration of the call. - - Returns null if a keep alive is not necessary. - - - - - Provides marshalling of primitive values when the function type - has no type information or when the user has provided us with - an explicit cdata instance. - - - - - Provides marshalling for when the function type provide argument information. - - - - - Provides marshalling for when the user provides a native argument object - (usually gotten by byref or pointer) and the function type has no type information. - - - - - The meta class for ctypes function pointer instances. - - - - - Converts an object into a function call parameter. - - - - - Fields are created when a Structure is defined and provide - introspection of the structure. - - - - - Called for fields which have been limited to a range of bits. Given the - value for the full type this extracts the individual bits. - - - - - Called for fields which have been limited to a range of bits. Sets the - specified value into the bits for the field. - - - - - Common functionality that all of the meta classes provide which is part of - our implementation. This is used to implement the serialization/deserialization - of values into/out of memory, emit the marshalling logic for call stubs, and - provide common information (size/alignment) for the types. - - - - - Gets the native size of the type - - - - - Gets the required alignment for the type - - - - - Deserialized the value of this type from the given address at the given - offset. Any new objects which are created will keep the provided - MemoryHolder alive. - - raw determines if the cdata is returned or if the primitive value is - returned. This is only applicable for subtypes of simple cdata types. - - - - - Serializes the provided value into the specified address at the given - offset. - - - - - Gets the .NET type which is used when calling or returning the value - from native code. - - - - - Gets the .NET type which the native type is converted into when going to Python - code. This is usually int, BigInt, double, object, or a CData type. - - - - - Emits marshalling of an object from Python to native code. This produces the - native type from the Python type. - - - - - Emits marshalling from native code to Python code This produces the python type - from the native type. This is used for return values and parameters - to Python callable objects that are passed back out to native code. - - - - - Returns a string which describes the type. Used for _buffer_info implementation which - only exists for testing purposes. - - - - - The meta class for ctypes pointers. - - - - - Converts an object into a function call parameter. - - - - - Access an instance at the specified address - - - - - The meta class for ctypes simple data types. These include primitives like ints, - floats, etc... char/wchar pointers, and untyped pointers. - - - - - Converts an object into a function call parameter. - - - - - Helper function for reading char/wchar's. This is used for reading from - arrays and pointers to avoid creating lots of 1-char strings. - - - - - The enum used for tracking the various ctypes primitive types. - - - - 'c' - - - 'b' - - - 'B' - - - 'h' - - - 'H' - - - 'i' - - - 'I' - - - 'l' - - - 'L' - - - 'f' - - - 'd', 'g' - - - 'q' - - - 'Q' - - - 'O' - - - 'P' - - - 'z' - - - 'Z' - - - 'u' - - - '?' - - - 'v' - - - 'X' - - - - Meta class for structures. Validates _fields_ on creation, provides factory - methods for creating instances from addresses and translating to parameters. - - - - - Converts an object into a function call parameter. - - Structures just return themselves. - - - - - If our size/alignment hasn't been initialized then grabs the size/alignment - from all of our base classes. If later new _fields_ are added we'll be - initialized and these values will be replaced. - - - - - Base class for data structures. Subclasses can define _fields_ which - specifies the in memory layout of the values. Instances can then - be created with the initial values provided as the array. The values - can then be accessed from the instance by field name. The value can also - be passed to a foreign C API and the type can be used in other structures. - - class MyStructure(Structure): - _fields_ = [('a', c_int), ('b', c_int)] - - MyStructure(1, 2).a - MyStructure() - - class MyOtherStructure(Structure): - _fields_ = [('c', MyStructure), ('b', c_int)] - - MyOtherStructure((1, 2), 3) - MyOtherStructure(MyStructure(1, 2), 3) - - - - - The meta class for ctypes unions. - - - - - Converts an object into a function call parameter. - - - - - Gets a function which casts the specified memory. Because this is used only - w/ Python API we use a delegate as the return type instead of an actual address. - - - - - Implementation of our cast function. data is marshalled as a void* - so it ends up as an address. obj and type are marshalled as an object - so we need to unmarshal them. - - - - - Returns a new type which represents a pointer given the existing type. - - - - - Converts an address acquired from PyObj_FromPtr or that has been - marshaled as type 'O' back into an object. - - - - - Converts an object into an opaque address which can be handed out to - managed code. - - - - - Decreases the ref count on an object which has been increased with - Py_INCREF. - - - - - Increases the ref count on an object ensuring that it will not be collected. - - - - - returns address of C instance internal buffer. - - It is the callers responsibility to ensure that the provided instance will - stay alive if memory in the resulting address is to be used later. - - - - - Gets the required alignment of the given type. - - - - - Gets the required alignment of an object. - - - - - Returns a pointer instance for the given CData - - - - - Gets the ModuleBuilder used to generate our unsafe call stubs into. - - - - - Given a specific size returns a .NET type of the equivalent size that - we can use when marshalling these values across calls. - - - - - Shared helper between struct and union for getting field info and validating it. - - - - - Verifies that the provided bit field settings are valid for this type. - - - - - Shared helper to get the _fields_ list for struct/union and validate it. - - - - - Helper function for translating from memset to NT's FillMemory API. - - - - - Helper function for translating from memset to NT's FillMemory API. - - - - - Emits the marshalling code to create a CData object for reverse marshalling. - - - - - Wrapper class for emitting locals/variables during marshalling code gen. - - - - - A wrapper around allocated memory to ensure it gets released and isn't accessed - when it could be finalized. - - - - - Creates a new MemoryHolder and allocates a buffer of the specified size. - - - - - Creates a new MemoryHolder at the specified address which is not tracked - by us and we will never free. - - - - - Creates a new MemoryHolder at the specified address which will keep alive the - parent memory holder. - - - - - Gets the address of the held memory. The caller should ensure the MemoryHolder - is always alive as long as the address will continue to be accessed. - - - - - Gets a list of objects which need to be kept alive for this MemoryHolder to be - remain valid. - - - - - Used to track the lifetime of objects when one memory region depends upon - another memory region. For example if you have an array of objects that - each have an element which has it's own lifetime the array needs to keep - the individual elements alive. - - The keys used here match CPython's keys as tested by CPython's test_ctypes. - Typically they are a string which is the array index, "ffffffff" when - from_buffer is used, or when it's a simple type there's just a string - instead of the full dictionary - we store that under the key "str". - - - - - Copies the data in data into this MemoryHolder. - - - - - Copies memory from one location to another keeping the associated memory holders alive during the - operation. - - - - - Native functions used for exposing ctypes functionality. - - - - - Allocates memory that's zero-filled - - - - - Helper function for implementing memset. Could be more efficient if we - could P/Invoke or call some otherwise native code to do this. - - - - - Returns a new callable object with the provided initial set of arguments - bound to it. Calling the new function then appends to the additional - user provided arguments. - - - - - Creates a new partial object with the provided positional arguments. - - - - - Creates a new partial object with the provided positional and keyword arguments. - - - - - Gets the function which will be called - - - - - Gets the initially provided positional arguments. - - - - - Gets the initially provided keyword arguments or None. - - - - - Gets or sets the dictionary used for storing extra attributes on the partial object. - - - - - Calls func with the previously provided arguments and more positional arguments. - - - - - Calls func with the previously provided arguments and more positional arguments and keyword arguments. - - - - - Operator method to set arbitrary members on the partial object. - - - - - Operator method to get additional arbitrary members defined on the partial object. - - - - - Operator method to delete arbitrary members defined in the partial object. - - - - - Populates the given directory w/ the locale information from the given - CultureInfo. - - - - - Generator based on the .NET Core implementation of System.Random - - - - - handleToSocket allows us to translate from Python's idea of a socket resource (file - descriptor numbers) to .NET's idea of a socket resource (System.Net.Socket objects). - In particular, this allows the select module to convert file numbers (as returned by - fileno()) and convert them to Socket objects so that it can do something useful with them. - - - - - Return the internal System.Net.Sockets.Socket socket object associated with the given - handle (as returned by GetHandle()), or null if no corresponding socket exists. This is - primarily intended to be used by other modules (such as select) that implement - networking primitives. User code should not normally need to call this function. - - - - - Create a Python socket object from an existing .NET socket object - (like one returned from Socket.Accept()) - - - - - Perform initialization common to all constructors - - - - - Convert an object to a 32-bit integer. This adds two features to Converter.ToInt32: - 1. Sign is ignored. For example, 0xffff0000 converts to 4294901760, where Convert.ToInt32 - would throw because 0xffff0000 is less than zero. - 2. Overflow exceptions are thrown. Converter.ToInt32 throws TypeError if x is - an integer, but is bigger than 32 bits. Instead, we throw OverflowException. - - - - - Convert an object to a 16-bit integer. This adds two features to Converter.ToInt16: - 1. Sign is ignored. For example, 0xff00 converts to 65280, where Convert.ToInt16 - would throw because signed 0xff00 is -256. - 2. Overflow exceptions are thrown. Converter.ToInt16 throws TypeError if x is - an integer, but is bigger than 16 bits. Instead, we throw OverflowException. - - - - - Return a standard socket exception (socket.error) whose message and error code come from a SocketException - This will eventually be enhanced to generate the correct error type (error, herror, gaierror) based on the error code. - - - - - Convert an IPv6 address byte array to a string in standard colon-hex notation. - The .NET IPAddress.ToString() method uses dotted-quad for the last 32 bits, - which differs from the normal Python implementation (but is allowed by the IETF); - this method returns the standard (no dotted-quad) colon-hex form. - - - - - Handle conversion of "" to INADDR_ANY and "<broadcast>" to INADDR_BROADCAST. - Otherwise returns host unchanged. - - - - - Return the IP address associated with host, with optional address family checking. - host may be either a name or an IP address (in string form). - - If family is non-null, a gaierror will be thrown if the host's address family is - not the same as the specified family. gaierror is also raised if the hostname cannot be - converted to an IP address (e.g. through a name lookup failure). - - - - - Return the IP address associated with host, with optional address family checking. - host may be either a name or an IP address (in string form). - - If family is non-null, a gaierror will be thrown if the host's address family is - not the same as the specified family. gaierror is also raised if the hostname cannot be - converted to an IP address (e.g. through a name lookup failure). - - - - - Return fqdn, but with its domain removed if it's on the same domain as the local machine. - - - - - Convert a (host, port) tuple [IPv4] (host, port, flowinfo, scopeid) tuple [IPv6] - to its corresponding IPEndPoint. - - Throws gaierror if host is not a valid address. - Throws ArgumentTypeException if any of the following are true: - - address does not have exactly two elements - - address[0] is not a string - - address[1] is not an int - - - - - Convert an IPEndPoint to its corresponding (host, port) [IPv4] or (host, port, flowinfo, scopeid) [IPv6] tuple. - Throws SocketException if the address family is other than IPv4 or IPv6. - - - - - BER encoding of an integer value is the number of bytes - required to represent the integer followed by the bytes - - - - - Enum which specifies the format type for a compiled struct - - - - - Struct used to store the format and the number of times it should be repeated. - - - - - Duplicates a subprocess handle which was created for piping. - - This is only called when we're duplicating the handle to make it inheritable to the child process. In CPython - the parent handle is always reliably garbage collected. Because we know this handle is not going to be - used we close the handle being duplicated. - - - - - Wrapper provided for backwards compatibility. - - - - - Special hash function because IStructuralEquatable.GetHashCode is not allowed to throw. - - - - - Special equals because none of the special cases in Ops.Equals - are applicable here, and the reference equality check breaks some tests. - - - - - gets the object or throws a reference exception - - - - - Special equality function because IStructuralEquatable.Equals is not allowed to throw. - - - - - gets the object or throws a reference exception - - - - - Special equality function because IStructuralEquatable.Equals is not allowed to throw. - - - - - Returns the underlying .NET RegistryKey - - - - - - zip_searchorder defines how we search for a module in the Zip - archive: we first search for a package __init__, then for - non-package .pyc, .pyo and .py entries. The .pyc and .pyo entries - are swapped by initzipimport() if we run in optimized mode. Also, - '/' is replaced by SEP there. - - - - - Given a path to a Zip file and a toc_entry, return the (uncompressed) - data as a new reference. - - - - - - - - Return the code object for the module named by 'fullname' from the - Zip archive as a new reference. - - - - - - - - - - - Given a path to a Zip archive, build a dict, mapping file names - (local to the archive, using SEP as a separator) to toc entries. - - A toc_entry is a tuple: - (__file__, # value to use for __file__, available for all files - compress, # compression kind; 0 for uncompressed - data_size, # size of compressed data on disk - file_size, # size of decompressed data - file_offset, # offset of file header from start of archive - time, # mod time of file (in dos format) - date, # mod data of file (in dos format) - crc, # crc checksum of the data - ) - Directories can be recognized by the trailing SEP in the name, - data_size and file_offset are 0. - - - - - - - Given a (sub)modulename, write the potential file path in the - archive (without extension) to the path buffer. - - - - - - - - Determines the type of module we have (package or module, or not found). - - - - - - - - Provides a StreamContentProvider for a stream of content backed by a file on disk. - - - - - Delivers the remaining bits, left-aligned, in a byte. - - - - This is valid only if NumRemainingBits is less than 8; - in other words it is valid only after a call to Flush(). - - - - - - Reset the BitWriter. - - - - This is useful when the BitWriter writes into a MemoryStream, and - is used by a BZip2Compressor, which itself is re-used for multiple - distinct data blocks. - - - - - - Write some number of bits from the given value, into the output. - - - - The nbits value should be a max of 25, for safety. For performance - reasons, this method does not check! - - - - - - Write a full 8-bit byte into the output. - - - - - Write four 8-bit bytes into the output. - - - - - Write all available byte-aligned bytes. - - - - This method writes no new output, but flushes any accumulated - bits. At completion, the accumulator may contain up to 7 - bits. - - - This is necessary when re-assembling output from N independent - compressors, one for each of N blocks. The output of any - particular compressor will in general have some fragment of a byte - remaining. This fragment needs to be accumulated into the - parent BZip2OutputStream. - - - - - - Writes all available bytes, and emits padding for the final byte as - necessary. This must be the last method invoked on an instance of - BitWriter. - - - - Knuth's increments seem to work better than Incerpi-Sedgewick here. - Possibly because the number of elems to sort is usually small, typically - <= 20. - - - - BZip2Compressor writes its compressed data out via a BitWriter. This - is necessary because BZip2 does byte shredding. - - - - - The number of uncompressed bytes being held in the buffer. - - - - I am thinking this may be useful in a Stream that uses this - compressor class. In the Close() method on the stream it could - check this value to see if anything has been written at all. You - may think the stream could easily track the number of bytes it - wrote, which would eliminate the need for this. But, there is the - case where the stream writes a complete block, and it is full, and - then writes no more. In that case the stream may want to check. - - - - - - Accept new bytes into the compressor data buffer - - - - This method does the first-level (cheap) run-length encoding, and - stores the encoded data into the rle block. - - - - - - Process one input byte into the block. - - - - - To "process" the byte means to do the run-length encoding. - There are 3 possible return values: - - 0 - the byte was not written, in other words, not - encoded into the block. This happens when the - byte b would require the start of a new run, and - the block has no more room for new runs. - - 1 - the byte was written, and the block is not full. - - 2 - the byte was written, and the block is full. - - - - 0 if the byte was not written, non-zero if written. - - - - Append one run to the output block. - - - - - This compressor does run-length-encoding before BWT and etc. This - method simply appends a run to the output block. The append always - succeeds. The return value indicates whether the block is full: - false (not full) implies that at least one additional run could be - processed. - - - true if the block is now full; otherwise false. - - - - Compress the data that has been placed (Run-length-encoded) into the - block. The compressed data goes into the CompressedBytes array. - - - - Side effects: 1. fills the CompressedBytes array. 2. sets the - AvailableBytesOut property. - - - - - This is the most hammered method of this class. - -

- This is the version using unrolled loops. -

- - - Method "mainQSort3", file "blocksort.c", BZip2 1.0.2 - - - Array instance identical to sfmap, both are used only - temporarily and independently, so we do not need to allocate - additional memory. - - - - A read-only decorator stream that performs BZip2 decompression on Read. - - - - - Compressor State - - - - - Create a BZip2InputStream, wrapping it around the given input Stream. - - - - The input stream will be closed when the BZip2InputStream is closed. - - - The stream from which to read compressed data - - - - Create a BZip2InputStream with the given stream, and - specifying whether to leave the wrapped stream open when - the BZip2InputStream is closed. - - The stream from which to read compressed data - - Whether to leave the input stream open, when the BZip2InputStream closes. - - - - - This example reads a bzip2-compressed file, decompresses it, - and writes the decompressed data into a newly created file. - - - var fname = "logfile.log.bz2"; - using (var fs = File.OpenRead(fname)) - { - using (var decompressor = new Ionic.BZip2.BZip2InputStream(fs)) - { - var outFname = fname + ".decompressed"; - using (var output = File.Create(outFname)) - { - byte[] buffer = new byte[2048]; - int n; - while ((n = decompressor.Read(buffer, 0, buffer.Length)) > 0) - { - output.Write(buffer, 0, n); - } - } - } - } - - - - - - Read data from the stream. - - - - - To decompress a BZip2 data stream, create a BZip2InputStream, - providing a stream that reads compressed data. Then call Read() on - that BZip2InputStream, and the data read will be decompressed - as you read. - - - - A BZip2InputStream can be used only for Read(), not for Write(). - - - - The buffer into which the read data should be placed. - the offset within that data array to put the first byte read. - the number of bytes to read. - the number of bytes actually read - - - - Read a single byte from the stream. - - the byte read from the stream, or -1 if EOF - - - - Indicates whether the stream can be read. - - - The return value depends on whether the captive stream supports reading. - - - - - Indicates whether the stream supports Seek operations. - - - Always returns false. - - - - - Indicates whether the stream can be written. - - - The return value depends on whether the captive stream supports writing. - - - - - Flush the stream. - - - - - Reading this property always throws a . - - - - - The position of the stream pointer. - - - - Setting this property always throws a . Reading will return the - total number of uncompressed bytes read in. - - - - - Calling this method always throws a . - - this is irrelevant, since it will always throw! - this is irrelevant, since it will always throw! - irrelevant! - - - - Calling this method always throws a . - - this is irrelevant, since it will always throw! - - - - Calling this method always throws a . - - this parameter is never used - this parameter is never used - this parameter is never used - - - - Dispose the stream. - - - indicates whether the Dispose method was invoked by user code. - - - - - Read n bits from input, right justifying the result. - - - - For example, if you read 1 bit, the result is either 0 - or 1. - - - - The number of bits to read, always between 1 and 32. - - - - Called by createHuffmanDecodingTables() exclusively. - - - Called by recvDecodingTables() exclusively. - - - Freq table collected to save a pass over the data during - decompression. - - - Initializes the tt array. - - This method is called when the required length of the array is known. - I don't initialize it at construction time to avoid unneccessary - memory allocation when compressing small files. - - - - Dump the current state of the decompressor, to restore it in case of an error. - This allows the decompressor to be essentially "rewound" and retried when more - data arrives. - - This is only used by IronPython. - - The current state. - - - - Restore the internal compressor state if an error occurred. - - The old state. - - - - A write-only decorator stream that compresses data as it is - written using the BZip2 algorithm. - - - - - Constructs a new BZip2OutputStream, that sends its - compressed output to the given output stream. - - - - The destination stream, to which compressed output will be sent. - - - - - This example reads a file, then compresses it with bzip2 file, - and writes the compressed data into a newly created file. - - - var fname = "logfile.log"; - using (var fs = File.OpenRead(fname)) - { - var outFname = fname + ".bz2"; - using (var output = File.Create(outFname)) - { - using (var compressor = new Ionic.BZip2.BZip2OutputStream(output)) - { - byte[] buffer = new byte[2048]; - int n; - while ((n = fs.Read(buffer, 0, buffer.Length)) > 0) - { - compressor.Write(buffer, 0, n); - } - } - } - } - - - - - - Constructs a new BZip2OutputStream with specified blocksize. - - the destination stream. - - The blockSize in units of 100000 bytes. - The valid range is 1..9. - - - - - Constructs a new BZip2OutputStream. - - the destination stream. - - whether to leave the captive stream open upon closing this stream. - - - - - Constructs a new BZip2OutputStream with specified blocksize, - and explicitly specifies whether to leave the wrapped stream open. - - - the destination stream. - - The blockSize in units of 100000 bytes. - The valid range is 1..9. - - - whether to leave the captive stream open upon closing this stream. - - - - - Flush the stream. - - - - - The blocksize parameter specified at construction time. - - - - - Write data to the stream. - - - - - Use the BZip2OutputStream to compress data while writing: - create a BZip2OutputStream with a writable output stream. - Then call Write() on that BZip2OutputStream, providing - uncompressed data as input. The data sent to the output stream will - be the compressed form of the input data. - - - - A BZip2OutputStream can be used only for Write() not for Read(). - - - - - The buffer holding data to write to the stream. - the offset within that data array to find the first byte to write. - the number of bytes to write. - - - - Indicates whether the stream can be read. - - - The return value is always false. - - - - - Indicates whether the stream supports Seek operations. - - - Always returns false. - - - - - Indicates whether the stream can be written. - - - The return value should always be true, unless and until the - object is disposed and closed. - - - - - Reading this property always throws a . - - - - - The position of the stream pointer. - - - - Setting this property always throws a . Reading will return the - total number of uncompressed bytes written through. - - - - - Calling this method always throws a . - - this is irrelevant, since it will always throw! - this is irrelevant, since it will always throw! - irrelevant! - - - - Calling this method always throws a . - - this is irrelevant, since it will always throw! - - - - Calling this method always throws a . - - this parameter is never used - this parameter is never used - this parameter is never used - never returns anything; always throws - - - - A write-only decorator stream that compresses data as it is - written using the BZip2 algorithm. This stream compresses by - block using multiple threads. - - - This class performs BZIP2 compression through writing. For - more information on the BZIP2 algorithm, see - . - - - - This class is similar to , - except that this implementation uses an approach that employs multiple - worker threads to perform the compression. On a multi-cpu or multi-core - computer, the performance of this class can be significantly higher than - the single-threaded BZip2OutputStream, particularly for larger streams. - How large? Anything over 10mb is a good candidate for parallel - compression. - - - - The tradeoff is that this class uses more memory and more CPU than the - vanilla BZip2OutputStream. Also, for small files, the - ParallelBZip2OutputStream can be much slower than the vanilla - BZip2OutputStream, because of the overhead associated to using the - thread pool. - - - - - - - Constructs a new ParallelBZip2OutputStream, that sends its - compressed output to the given output stream. - - - - The destination stream, to which compressed output will be sent. - - - - - This example reads a file, then compresses it with bzip2 file, - and writes the compressed data into a newly created file. - - - var fname = "logfile.log"; - using (var fs = File.OpenRead(fname)) - { - var outFname = fname + ".bz2"; - using (var output = File.Create(outFname)) - { - using (var compressor = new Ionic.BZip2.ParallelBZip2OutputStream(output)) - { - byte[] buffer = new byte[2048]; - int n; - while ((n = fs.Read(buffer, 0, buffer.Length)) > 0) - { - compressor.Write(buffer, 0, n); - } - } - } - } - - - - - - Constructs a new ParallelBZip2OutputStream with specified blocksize. - - the destination stream. - - The blockSize in units of 100000 bytes. - The valid range is 1..9. - - - - - Constructs a new ParallelBZip2OutputStream. - - the destination stream. - - whether to leave the captive stream open upon closing this stream. - - - - - Constructs a new ParallelBZip2OutputStream with specified blocksize, - and explicitly specifies whether to leave the wrapped stream open. - - - the destination stream. - - The blockSize in units of 100000 bytes. - The valid range is 1..9. - - - whether to leave the captive stream open upon closing this stream. - - - - - The maximum number of concurrent compression worker threads to use. - - - - - This property sets an upper limit on the number of concurrent worker - threads to employ for compression. The implementation of this stream - employs multiple threads from the .NET thread pool, via - ThreadPool.QueueUserWorkItem(), to compress the incoming data by - block. As each block of data is compressed, this stream re-orders the - compressed blocks and writes them to the output stream. - - - - A higher number of workers enables a higher degree of - parallelism, which tends to increase the speed of compression on - multi-cpu computers. On the other hand, a higher number of buffer - pairs also implies a larger memory consumption, more active worker - threads, and a higher cpu utilization for any compression. This - property enables the application to limit its memory consumption and - CPU utilization behavior depending on requirements. - - - - By default, DotNetZip allocates 4 workers per CPU core, subject to the - upper limit specified in this property. For example, suppose the - application sets this property to 16. Then, on a machine with 2 - cores, DotNetZip will use 8 workers; that number does not exceed the - upper limit specified by this property, so the actual number of - workers used will be 4 * 2 = 8. On a machine with 4 cores, DotNetZip - will use 16 workers; again, the limit does not apply. On a machine - with 8 cores, DotNetZip will use 16 workers, because of the limit. - - - - For each compression "worker thread" that occurs in parallel, there is - up to 2mb of memory allocated, for buffering and processing. The - actual number depends on the property. - - - - CPU utilization will also go up with additional workers, because a - larger number of buffer pairs allows a larger number of background - threads to compress in parallel. If you find that parallel - compression is consuming too much memory or CPU, you can adjust this - value downward. - - - - The default value is 16. Different values may deliver better or - worse results, depending on your priorities and the dynamic - performance characteristics of your storage and compute resources. - - - - The application can set this value at any time, but it is effective - only before the first call to Write(), which is when the buffers are - allocated. - - - - - - Flush the stream. - - - - - The blocksize parameter specified at construction time. - - - - - Write data to the stream. - - - - - Use the ParallelBZip2OutputStream to compress data while - writing: create a ParallelBZip2OutputStream with a writable - output stream. Then call Write() on that - ParallelBZip2OutputStream, providing uncompressed data as - input. The data sent to the output stream will be the compressed - form of the input data. - - - - A ParallelBZip2OutputStream can be used only for - Write() not for Read(). - - - - - The buffer holding data to write to the stream. - the offset within that data array to find the first byte to write. - the number of bytes to write. - - - - Indicates whether the stream can be read. - - - The return value is always false. - - - - - Indicates whether the stream supports Seek operations. - - - Always returns false. - - - - - Indicates whether the stream can be written. - - - The return value depends on whether the captive stream supports writing. - - - - - Reading this property always throws a . - - - - - The position of the stream pointer. - - - - Setting this property always throws a . Reading will return the - total number of uncompressed bytes written through. - - - - - The total number of bytes written out by the stream. - - - This value is meaningful only after a call to Close(). - - - - - Calling this method always throws a . - - this is irrelevant, since it will always throw! - this is irrelevant, since it will always throw! - irrelevant! - - - - Calling this method always throws a . - - this is irrelevant, since it will always throw! - - - - Calling this method always throws a . - - this parameter is never used - this parameter is never used - this parameter is never used - never returns anything; always throws - - - - Returns the "random" number at a specific index. - - the index - the random number - - - - Computes a CRC-32. The CRC-32 algorithm is parameterized - you - can set the polynomial and enable or disable bit - reversal. This can be used for GZIP, BZip2, or ZIP. - - - This type is used internally by DotNetZip; it is generally not used - directly by applications wishing to create, read, or manipulate zip - archive files. - - - - - Indicates the total number of bytes applied to the CRC. - - - - - Indicates the current CRC for all blocks slurped in. - - - - - Returns the CRC32 for the specified stream. - - The stream over which to calculate the CRC32 - the CRC32 calculation - - - - Returns the CRC32 for the specified stream, and writes the input into the - output stream. - - The stream over which to calculate the CRC32 - The stream into which to deflate the input - the CRC32 calculation - - - - Get the CRC32 for the given (word,byte) combo. This is a - computation defined by PKzip for PKZIP 2.0 (weak) encryption. - - The word to start with. - The byte to combine it with. - The CRC-ized result. - - - - Update the value for the running CRC32 using the given block of bytes. - This is useful when using the CRC32() class in a Stream. - - block of bytes to slurp - starting point in the block - how many bytes within the block to slurp - - - - Process one byte in the CRC. - - the byte to include into the CRC . - - - - Process a run of N identical bytes into the CRC. - - - - This method serves as an optimization for updating the CRC when a - run of identical bytes is found. Rather than passing in a buffer of - length n, containing all identical bytes b, this method accepts the - byte value and the length of the (virtual) buffer - the length of - the run. - - - the byte to include into the CRC. - the number of times that byte should be repeated. - - - - Combines the given CRC32 value with the current running total. - - - This is useful when using a divide-and-conquer approach to - calculating a CRC. Multiple threads can each calculate a - CRC32 on a segment of the data, and then combine the - individual CRC32 values at the end. - - the crc value to be combined with this one - the length of data the CRC value was calculated on - - - - Create an instance of the CRC32 class using the default settings: no - bit reversal, and a polynomial of 0xEDB88320. - - - - - Create an instance of the CRC32 class, specifying whether to reverse - data bits or not. - - - specify true if the instance should reverse data bits. - - - - In the CRC-32 used by BZip2, the bits are reversed. Therefore if you - want a CRC32 with compatibility with BZip2, you should pass true - here. In the CRC-32 used by GZIP and PKZIP, the bits are not - reversed; Therefore if you want a CRC32 with compatibility with - those, you should pass false. - - - - - - Create an instance of the CRC32 class, specifying the polynomial and - whether to reverse data bits or not. - - - The polynomial to use for the CRC, expressed in the reversed (LSB) - format: the highest ordered bit in the polynomial value is the - coefficient of the 0th power; the second-highest order bit is the - coefficient of the 1 power, and so on. Expressed this way, the - polynomial for the CRC-32C used in IEEE 802.3, is 0xEDB88320. - - - specify true if the instance should reverse data bits. - - - - - In the CRC-32 used by BZip2, the bits are reversed. Therefore if you - want a CRC32 with compatibility with BZip2, you should pass true - here for the reverseBits parameter. In the CRC-32 used by - GZIP and PKZIP, the bits are not reversed; Therefore if you want a - CRC32 with compatibility with those, you should pass false for the - reverseBits parameter. - - - - - - Reset the CRC-32 class - clear the CRC "remainder register." - - - - Use this when employing a single instance of this class to compute - multiple, distinct CRCs on multiple, distinct data blocks. - - - - - - A Stream that calculates a CRC32 (a checksum) on all bytes read, - or on all bytes written. - - - - - This class can be used to verify the CRC of a ZipEntry when - reading from a stream, or to calculate a CRC when writing to a - stream. The stream should be used to either read, or write, but - not both. If you intermix reads and writes, the results are not - defined. - - - - This class is intended primarily for use internally by the - DotNetZip library. - - - - - - The default constructor. - - - - Instances returned from this constructor will leave the underlying - stream open upon Close(). The stream uses the default CRC32 - algorithm, which implies a polynomial of 0xEDB88320. - - - The underlying stream - - - - The constructor allows the caller to specify how to handle the - underlying stream at close. - - - - The stream uses the default CRC32 algorithm, which implies a - polynomial of 0xEDB88320. - - - The underlying stream - true to leave the underlying stream - open upon close of the CrcCalculatorStream; false otherwise. - - - - A constructor allowing the specification of the length of the stream - to read. - - - - The stream uses the default CRC32 algorithm, which implies a - polynomial of 0xEDB88320. - - - Instances returned from this constructor will leave the underlying - stream open upon Close(). - - - The underlying stream - The length of the stream to slurp - - - - A constructor allowing the specification of the length of the stream - to read, as well as whether to keep the underlying stream open upon - Close(). - - - - The stream uses the default CRC32 algorithm, which implies a - polynomial of 0xEDB88320. - - - The underlying stream - The length of the stream to slurp - true to leave the underlying stream - open upon close of the CrcCalculatorStream; false otherwise. - - - - A constructor allowing the specification of the length of the stream - to read, as well as whether to keep the underlying stream open upon - Close(), and the CRC32 instance to use. - - - - The stream uses the specified CRC32 instance, which allows the - application to specify how the CRC gets calculated. - - - The underlying stream - The length of the stream to slurp - true to leave the underlying stream - open upon close of the CrcCalculatorStream; false otherwise. - the CRC32 instance to use to calculate the CRC32 - - - - Gets the total number of bytes run through the CRC32 calculator. - - - - This is either the total number of bytes read, or the total number of - bytes written, depending on the direction of this stream. - - - - - Provides the current CRC for all blocks slurped in. - - - - The running total of the CRC is kept as data is written or read - through the stream. read this property after all reads or writes to - get an accurate CRC for the entire stream. - - - - - - Indicates whether the underlying stream will be left open when the - CrcCalculatorStream is Closed. - - - - Set this at any point before calling . - - - - - - Read from the stream - - the buffer to read - the offset at which to start - the number of bytes to read - the number of bytes actually read - - - - Write to the stream. - - the buffer from which to write - the offset at which to start writing - the number of bytes to write - - - - Indicates whether the stream supports reading. - - - - - Indicates whether the stream supports seeking. - - - - Always returns false. - - - - - - Indicates whether the stream supports writing. - - - - - Flush the stream. - - - - - Returns the length of the underlying stream. - - - - - The getter for this property returns the total bytes read. - If you use the setter, it will throw - . - - - - - Seeking is not supported on this stream. This method always throws - - - N/A - N/A - N/A - - - - This method always throws - - - N/A - - - diff --git a/mpv.net/IronPython/IronPython.xml b/mpv.net/IronPython/IronPython.xml deleted file mode 100644 index b5a434a..0000000 --- a/mpv.net/IronPython/IronPython.xml +++ /dev/null @@ -1,7660 +0,0 @@ - - - - IronPython - - - - - Gets the closure tuple from our parent context. - - - - - Scope for the comprehension. Because scopes are usually statements and comprehensions are expressions - this doesn't actually show up in the AST hierarchy and instead hangs off the comprehension expression. - - - - - Pulls the closure tuple from our function/generator which is flowed into each function call. - - - - - Returns an expression which creates the function object. - - - - - Creates the LambdaExpression which is the actual function body. - - - - - Creates the LambdaExpression which implements the body of the function. - - The functions signature is either "object Function(PythonFunction, ...)" - where there is one object parameter for each user defined parameter or - object Function(PythonFunction, object[]) for functions which take more - than PythonCallTargets.MaxArgs arguments. - - - - - Determines delegate type for the Python function - - - - - Rewrites the tree for performing lookups against globals instead of being bound - against the optimized scope. This is used if the user creates a function using public - PythonFunction ctor. - - - - - Returns true if the node can throw, false otherwise. Used to determine - whether or not we need to update the current dynamic stack info. - - - - - Creates a method frame for tracking purposes and enforces recursion - - - - - Removes the frames from generated code for when we're compiling the tracing delegate - which will track the frames it's self. - - - - - A temporary variable to track if the current line number has been emitted via the fault update block. - - For example consider: - - try: - raise Exception() - except Exception, e: - # do something here - raise - - At "do something here" we need to have already emitted the line number, when we re-raise we shouldn't add it - again. If we handled the exception then we should have set the bool back to false. - - We also sometimes directly check _lineNoUpdated to avoid creating this unless we have nested exceptions. - - - - - A temporary variable to track the current line number - - - - - Parameter base class - - - - - Position of the parameter: 0-based index - - - - - Parameter name - - - - - Top-level ast for all Python code. Typically represents a module but could also - be exec or eval code. - - - - - Creates a new PythonAst without a body. ParsingFinished should be called afterwards to set - the body. - - - - - Called when parsing is complete, the body is built, the line mapping and language features are known. - - This is used in conjunction with the constructor which does not take a body. It enables creating - the outer most PythonAst first so that nodes can always have a global parent. This lets an un-bound - tree to still provide it's line information immediately after parsing. When we set the location - of each node during construction we also set the global parent. When we name bind the global - parent gets replaced with the real parent ScopeStatement. - - a mapping of where each line begins - The body of code - The language features which were set during parsing. - - - - Binds an AST and makes it capable of being reduced and compiled. Before calling Bind an AST cannot successfully - be reduced. - - - - - Creates a variable at the global level. Called for known globals (e.g. __name__), - for variables explicitly declared global by the user, and names accessed - but not defined in the lexical scope. - - - - - Reduces the PythonAst to a LambdaExpression of type Type. - - - - - True division is enabled in this AST. - - - - - True if the with statement is enabled in this AST. - - - - - True if absolute imports are enabled - - - - - Returns a ScriptCode object for this PythonAst. The ScriptCode object - can then be used to execute the code against it's closed over scope or - to execute it against a different scope. - - - - - Rewrites the tree for performing lookups against globals instead of being bound - against the optimized scope. This is used if the user compiles optimied code and then - runs it against a different scope. - - - - - True if this is on-disk code which we don't really have an AST for. - - - - - Represents a reference to a name. A PythonReference is created for each name - referred to in a scope (global, class, or function). - - - - - True iff there is a path in control flow graph on which the variable is used before initialized (assigned or deleted). - - - - - True iff the variable is referred to from the inner scope. - - - - - PythonWalker class - The Python AST Walker (default result is true) - - - - - PythonWalkerNonRecursive class - The Python AST Walker (default result is false) - - - - - The variable used to hold out parents closure tuple in our local scope. - - - - - Gets the expression associated with the local CodeContext. If the function - doesn't have a local CodeContext then this is the global context. - - - - - True if this scope accesses a variable from an outer scope. - - - - - True if an inner scope is accessing a variable defined in this scope. - - - - - True if we are forcing the creation of a dictionary for storing locals. - - This occurs for calls to locals(), dir(), vars(), unqualified exec, and - from ... import *. - - - - - True if variables can be set in a late bound fashion that we don't - know about at code gen time - for example via from foo import *. - - This is tracked independently of the ContainsUnqualifiedExec/NeedsLocalsDictionary - - - - - Gets or creates the FunctionCode object for this FunctionDefinition. - - - - - Variables that are bound in an outer scope - but not a global scope - - - - - Variables that are bound to the global scope - - - - - Variables that are referred to from a nested scope and need to be - promoted to cells. - - - - - Gets the expression for updating the dynamic stack trace at runtime when an - exception is thrown. - - - - - Gets the expression for the actual updating of the line number for stack traces to be available - - - - - Wraps the body of a statement which should result in a frame being available during - exception handling. This ensures the line number is updated as the stack is unwound. - - - - - Provides a place holder for the expression which represents - a FunctionCode. For functions/classes this gets updated after - the AST has been generated because the FunctionCode needs to - know about the tree which gets generated. For modules we - immediately have the value because it always comes in as a parameter. - - - - - Reducible node so that re-writing for profiling does not occur until - after the script code has been completed and is ready to be compiled. - - Without this extra node profiling would force reduction of the node - and we wouldn't have setup our constant access correctly yet. - - - - - Fake ScopeStatement for FunctionCode's to hold on to after we have deserialized pre-compiled code. - - - - - True if the user provided a step parameter (either providing an explicit parameter - or providing an empty step parameter) false if only start and stop were provided. - - - - - The statements under the try-block. - - - - - Array of except (catch) blocks associated with this try. NULL if there are no except blocks. - - - - - The body of the optional Else block for this try. NULL if there is no Else block. - - - - - The body of the optional finally associated with this try. NULL if there is no finally block. - - - - - Transform multiple python except handlers for a try block into a single catch body. - - The variable for the exception in the catch block. - Null if there are no except handlers. Else the statement to go inside the catch handler - - - - Surrounds the body of an except block w/ the appropriate code for maintaining the traceback. - - - - - Local variable. - - Local variables can be referenced from nested lambdas - - - - - Parameter to a LambdaExpression - - Like locals, they can be referenced from nested lambdas - - - - - Global variable - - Should only appear in global (top level) lambda. - - - - - WithStatement is translated to the DLR AST equivalent to - the following Python code snippet (from with statement spec): - - mgr = (EXPR) - exit = mgr.__exit__ # Not calling it yet - value = mgr.__enter__() - exc = True - try: - VAR = value # Only if "as VAR" is present - BLOCK - except: - # The exceptional case is handled here - exc = False - if not exit(*sys.exc_info()): - raise - # The exception is swallowed if exit() returns true - finally: - # The normal and non-local-goto cases are handled here - if exc: - exit(None, None, None) - - - - - - A global allocator that puts all of the globals into an array access. The array is an - array of PythonGlobal objects. We then just close over the array for any inner functions. - - Once compiled a RuntimeScriptCode is produced which is closed over the entire execution - environment. - - - - - Provides globals for when we need to lookup into a dictionary for each global access. - - This is the slowest form of globals and is only used when we need to run against an - arbitrary dictionary given to us by a user. - - - - - Implements globals which are backed by a static type, followed by an array if the static types' slots become full. The global - variables are stored in static fields on a type for fast access. The type also includes fields for constants and call sites - so they can be accessed much fasetr. - - We don't generate any code into the type though - DynamicMethod's are much faster for code gen then normal ref emit. - - - Implements globals which are backed by a static type, followed by an array if the static types' slots become full. The global - variables are stored in static fields on a type for fast access. The type also includes fields for constants and call sites - so they can be accessed much fasetr. - - We don't generate any code into the type though - DynamicMethod's are much faster for code gen then normal ref emit. - - - - Ensures the underlying array is long enough to accomodate the given index - The context storage type corresponding to the given index - - - Ensures the underlying array is long enough to accomodate the given index - The constant storage type corresponding to the given index - - - Ensures the underlying array is long enough to accomodate the given index - The global storage type corresponding to the given index - - - Ensures the underlying array is long enough to accomodate the given index - The site storage type corresponding to the given index - - - - Small reducable node which just fetches the value from a ClosureCell - object. Like w/ global variables the compiler recognizes these on - sets and turns them into assignments on the python global object. - - - - - Gets the expression which points at the closure cell. - - - - - The original expression for the incoming parameter if this is a parameter closure. Otherwise - the value is null. - - - - - Gets the PythonVariable for which this closure expression was created. - - - - - Creates the storage for the closure cell. If this is a closure over a parameter it - captures the initial incoming parameter value. - - - - - Reduces the closure cell to a read of the value stored in the cell. - - - - - Assigns a value to the closure cell. - - - - - Removes the current value from the closure cell. - - - - - Tracking for variables lifted into closure objects. Used to store information in a function - about the outer variables it accesses. - - - - - Specifies the compilation mode which will be used during the AST transformation - - - - - Compilation will proceed in a manner in which the resulting AST can be serialized to disk. - - - - - Compilation will use a type and declare static fields for globals. The resulting type - is uncollectible and therefore extended use of this will cause memory leaks. - - - - - Compilation will use an array for globals. The resulting code will be fully collectible - and once all references are released will be collected. - - - - - Compilation will force all global accesses to do a full lookup. This will also happen for - any unbound local references. This is the slowest form of code generation and is only - used for exec/eval code where we can run against an arbitrary dictionary. - - - - - When finding a yield return or yield break, this rewriter flattens out - containing blocks, scopes, and expressions with stack state. All - scopes encountered have their variables promoted to the generator's - closure, so they survive yields. - - - - - Spills the right side into a temp, and replaces it with its temp. - Returns the expression that initializes the temp. - - - - - Makes an assignment to this variable. Pushes the assignment as far - into the right side as possible, to allow jumps into it. - - - - - Accesses the property of a tuple. The node can be created first and then the tuple and index - type can be filled in before the tree is actually generated. This enables creation of these - nodes before the tuple type is actually known. - - - - - Represents code which can be lazily compiled. - - The code is created in an AST which provides the Expression of T and - whether or not the code should be interpreted. For non-pre compiled - scenarios the code will not be compiled until the 1st time it is run. - - For pre-compiled scenarios the code is IExpressionSerializable and will - turn into a normal pre-compiled method. - - - - - A ScriptCode which has been loaded from an assembly which is saved on disk. - - - - - Creates a fake PythonAst object which is represenative of the on-disk script code. - - - - - Language features initialized on parser construction and possibly updated during parsing. - The code can set the language features (e.g. "from __future__ import division"). - - - - - Parse one or more lines of interactive input - - null if input is not yet valid but could be with more lines - - - - Given the interactive text input for a compound statement, calculate what the - indentation level of the next line should be - - - - - Peek if the next token is a 'yield' and parse a yield expression. Else return null. - - Called w/ yield already eaten. - - A yield expression if present, else null. - - - - Maybe eats a new line token returning true if the token was - eaten. - - Python always tokenizes to have only 1 new line character in a - row. But we also craete NLToken's and ignore them except for - error reporting purposes. This gives us the same errors as - CPython and also matches the behavior of the standard library - tokenize module. This function eats any present NL tokens and throws - them away. - - - - - Eats a new line token throwing if the next token isn't a new line. - - Python always tokenizes to have only 1 new line character in a - row. But we also craete NLToken's and ignore them except for - error reporting purposes. This gives us the same errors as - CPython and also matches the behavior of the standard library - tokenize module. This function eats any present NL tokens and throws - them away. - - - - - Creates a new PythonCompilerOptions with the default language features enabled. - - - - - Creates a new PythonCompilerOptions with the specified language features enabled. - - - - - Creates a new PythonCompilerOptions and enables or disables true division. - - This overload is obsolete, instead you should use the overload which takes a - ModuleOptions. - - - - - Gets or sets the initial indentation. This can be set to allow parsing - partial blocks of code that are already indented. - - For each element of the array there is an additional level of indentation. - Each integer value represents the number of spaces used for the indentation. - - If this value is null then no indentation level is specified. - - - - - Provides cached global variable for modules to enable optimized access to - module globals. Both the module global value and the cached value can be held - onto and the cached value can be invalidated by the providing LanguageContext. - - The cached value is provided by the LanguageContext.GetModuleCache API. - - - - - Small reducable node which just fetches the value from a PythonGlobal - object. The compiler recognizes these on sets and turns them into - assignments on the python global object. - - - - - A ScriptCode which can be saved to disk. We only create this when called via - the clr.CompileModules API. This ScriptCode does not support running. - - - - - Represents a script code which can be dynamically bound to execute against - arbitrary Scope objects. This is used for code when the user runs against - a particular scope as well as for exec and eval code as well. It is also - used when tracing is enabled. - - - - - Provides a wrapper around "dynamic" expressions which we've opened coded (for optimized code generation). - - This lets us recognize both normal Dynamic and our own Dynamic expressions and apply the combo binder on them. - - - - - Represents a script code which can be consumed at runtime as-is. This code has - no external dependencies and is closed over its scope. - - - - - Summary description for Token. - - - - - IronPython tokenizer - - - - - Used to create tokenizer for hosting API. - - - - - Equality comparer that can compare strings to our current token w/o creating a new string first. - - - - - True if the last characters in the buffer are a backslash followed by a new line indicating - that their is an incompletement statement which needs further input to complete. - - - - - Returns whether the - - - - - Resizes an array to a speficied new size and copies a portion of the original array into its beginning. - - - - - Provides helpers for interacting with IronPython. - - - - - Creates a new ScriptRuntime with the IronPython scipting engine pre-configured. - - - - - - Creates a new ScriptRuntime with the IronPython scipting engine pre-configured and - additional options. - - - - - Creates a new ScriptRuntime with the IronPython scripting engine pre-configured - in the specified AppDomain. The remote ScriptRuntime may be manipulated from - the local domain but all code will run in the remote domain. - - - - - Creates a new ScriptRuntime with the IronPython scripting engine pre-configured - in the specified AppDomain with additional options. The remote ScriptRuntime may - be manipulated from the local domain but all code will run in the remote domain. - - - - - Creates a new ScriptRuntime and returns the ScriptEngine for IronPython. If - the ScriptRuntime is required it can be acquired from the Runtime property - on the engine. - - - - - Creates a new ScriptRuntime with the specified options and returns the - ScriptEngine for IronPython. If the ScriptRuntime is required it can be - acquired from the Runtime property on the engine. - - - - - Creates a new ScriptRuntime and returns the ScriptEngine for IronPython. If - the ScriptRuntime is required it can be acquired from the Runtime property - on the engine. - - The remote ScriptRuntime may be manipulated from the local domain but - all code will run in the remote domain. - - - - - Creates a new ScriptRuntime with the specified options and returns the - ScriptEngine for IronPython. If the ScriptRuntime is required it can be - acquired from the Runtime property on the engine. - - The remote ScriptRuntime may be manipulated from the local domain but - all code will run in the remote domain. - - - - - Given a ScriptRuntime gets the ScriptEngine for IronPython. - - - - - Gets a ScriptScope which is the Python sys module for the provided ScriptRuntime. - - - - - Gets a ScriptScope which is the Python sys module for the provided ScriptEngine. - - - - - Gets a ScriptScope which is the Python __builtin__ module for the provided ScriptRuntime. - - - - - Gets a ScriptScope which is the Python __builtin__ module for the provided ScriptEngine. - - - - - Gets a ScriptScope which is the Python clr module for the provided ScriptRuntime. - - - - - Gets a ScriptScope which is the Python clr module for the provided ScriptEngine. - - - - - Imports the Python module by the given name and returns its ScriptSCope. If the - module does not exist an exception is raised. - - - - - Imports the Python module by the given name and returns its ScriptSCope. If the - module does not exist an exception is raised. - - - - - Imports the Python module by the given name and inserts it into the ScriptScope as that name. If the - module does not exist an exception is raised. - - - - - - - Sets sys.exec_prefix, sys.executable and sys.version and adds the prefix to sys.path - - - - - Sets sys.exec_prefix, sys.executable and sys.version and adds the prefix to sys.path - - - - - Enables call tracing for the current thread in this ScriptEngine. - - TracebackDelegate will be called back for each function entry, exit, exception, and line change. - - - - - Enables call tracing for the current thread for the Python engine in this ScriptRuntime. - - TracebackDelegate will be called back for each function entry, exit, exception, and line change. - - - - - Provides nested level debugging support when SetTrace or SetProfile are used. - - This saves the current tracing information and then calls the provided object. - - - - - Provides nested level debugging support when SetTrace or SetProfile are used. - - This saves the current tracing information and then calls the provided object. - - - - - Creates a ScriptRuntimeSetup object which includes the Python script engine with the specified options. - - The ScriptRuntimeSetup object can then be additional configured and used to create a ScriptRuntime. - - - - - Creates a LanguageSetup object which includes the Python script engine with the specified options. - - The LanguageSetup object can be used with other LanguageSetup objects from other languages to - configure a ScriptRuntimeSetup object. - - - - - Creates a new PythonModule with the specified name and published it in sys.modules. - - Returns the ScriptScope associated with the module. - - - - - Creates a new PythonModule with the specified name and filename published it - in sys.modules. - - Returns the ScriptScope associated with the module. - - - - - Creates a new PythonModule with the specified name, filename, and doc string and - published it in sys.modules. - - Returns the ScriptScope associated with the module. - - - - - Gets the list of loaded Python module files names which are available in the provided ScriptEngine. - - - - - A simple Python command-line should mimic the standard python.exe - - - - - Returns the display look for IronPython. - - The returned string uses This \n instead of Environment.NewLine for it's line seperator - because it is intended to be outputted through the Python I/O system. - - - - - Loads any extension DLLs present in sys.prefix\DLLs directory and adds references to them. - - This provides an easy drop-in location for .NET assemblies which should be automatically referenced - (exposed via import), COM libraries, and pre-compiled Python code. - - - - - Attempts to run a single interaction and handle any language-specific - exceptions. Base classes can override this and call the base implementation - surrounded with their own exception handling. - - Returns null if successful and execution should continue, or an exit code. - - - - - Parses a single interactive command and executes it. - - Returns null if successful and execution should continue, or the appropiate exit code. - - - - - Skip the first line of the code to execute. This is useful for executing Unix scripts which - have the command to execute specified in the first line. - This only apply to the script code executed by the ScriptEngine APIs, but not for other script code - that happens to get called as a result of the execution. - - - - On error. - - - - Helper class for implementing the Python class. - - This is exposed as a service through PythonEngine and the helper class - uses this service to get the correct remoting semantics. - - - - - Returns an ObjectHandle to a delegate of type Action[Action] which calls the current - command dispatcher. - - - - - The error involved an incomplete statement due to an unexpected EOF. - - - - - The error involved an incomplete token. - - - - - The mask for the actual error values - - - - - The error was a general syntax error - - - - - The error was an indentation error. - - - - - The error was a tab error. - - - - - syntax error shouldn't include a caret (no column offset should be included) - - - - - Marks that the return value of a function might include NotImplemented. - - This is added to an operator method to ensure that all necessary methods are called - if one cannot guarantee that it can perform the comparison. - - - - - Specialized version because enumerating tuples by Python's definition - doesn't call __getitem__, but filter does! - - - - - Opens a file and returns a new file object. - - name -> the name of the file to open. - mode -> the mode to open the file (r for reading, w for writing, a for appending, default is r). - bufsize -> the size of the buffer to be used (<= 0 indicates to use the default size) - - - - - Creates a new Python file object from a .NET stream object. - - stream -> the stream to wrap in a file object. - - - - - object overload of range - attempts to convert via __int__, and __trunc__ if arg is - an OldInstance - - - - - object overload of range - attempts to convert via __int__, and __trunc__ if arg is - an OldInstance - - - - - Gets the appropriate LanguageContext to be used for code compiled with Python's compile, eval, execfile, etc... - - - - Returns true if we should inherit our callers context (true division, etc...), false otherwise - - - Returns the default compiler flags or the flags the user specified. - - - - Gets a scope used for executing new code in optionally replacing the globals and locals dictionaries. - - - - - Returns detailed call statistics. Not implemented in IronPython and always returns None. - - - - - Handles output of the expression statement. - Prints the value and sets the __builtin__._ - - - - - Not used. - - - - - Not used. - - - - - Not an actual node. We don't create this, but it's here for compatibility. - - - - - A strongly-typed resource class, for looking up localized strings, etc. - - - - - Returns the cached ResourceManager instance used by this class. - - - - - Overrides the current thread's CurrentUICulture property for all - resource lookups using this strongly typed resource class. - - - - - Looks up a localized string similar to couldn't find member {0}. - - - - - Looks up a localized string similar to default value must be specified here. - - - - - Looks up a localized string similar to duplicate argument '{0}' in function definition. - - - - - Looks up a localized string similar to duplicate keyword argument. - - - - - Looks up a localized string similar to <eof> while reading string. - - - - - Looks up a localized string similar to EOF while scanning triple-quoted string. - - - - - Looks up a localized string similar to EOL while scanning single-quoted string. - - - - - Looks up a localized string similar to expected an indented block. - - - - - Looks up a localized string similar to expected name. - - - - - Looks up a localized string similar to Expecting identifier:. - - - - - Looks up a localized string similar to inconsistent use of tabs and spaces in indentation. - - - - - Looks up a localized string similar to unindent does not match any outer indentation level. - - - - - Looks up a localized string similar to Invalid argument value.. - - - - - Looks up a localized string similar to MakeGenericType on non-generic type. - - - - - Looks up a localized string similar to Invalid parameter collection for the function.. - - - - - Looks up a localized string similar to invalid token - - - - - Looks up a localized string similar to invalid syntax. - - - - - Looks up a localized string similar to object ({0}) is not creatable w/ keyword arguments. - - - - - Looks up a localized string similar to keywords must come before * args. - - - - - Looks up a localized string similar to type does not have {0} field. - - - - - Looks up a localized string similar to from __future__ imports must occur at the beginning of the file. - - - - - Looks up a localized string similar to 'return' outside function. - - - - - Looks up a localized string similar to 'yield' outside function. - - - - - Looks up a localized string similar to NEWLINE in double-quoted string. - - - - - Looks up a localized string similar to NEWLINE in single-quoted string. - - - - - Looks up a localized string similar to future statement does not support import *. - - - - - Looks up a localized string similar to non-keyword arg after keyword arg. - - - - - Looks up a localized string similar to not a chance. - - - - - Looks up a localized string similar to The method or operation is not implemented.. - - - - - Looks up a localized string similar to only one ** allowed. - - - - - Looks up a localized string similar to only one * allowed. - - - - - Looks up a localized string similar to Context must be PythonCompilerContext. - - - - - Looks up a localized string similar to cannot delete slot. - - - - - Looks up a localized string similar to cannot get slot. - - - - - Looks up a localized string similar to cannot set slot. - - - - - Looks up a localized string similar to static property '{0}' of '{1}' can only be read through a type, not an instance. - - - - - Looks up a localized string similar to static property '{0}' of '{1}' can only be assigned to through a type, not an instance. - - - - - Looks up a localized string similar to no value for this token. - - - - - Looks up a localized string similar to too many versions. - - - - - Looks up a localized string similar to unexpected token '{0}'. - - - - - Looks up a localized string similar to future feature is not defined:. - - - - - Provides support for emitting warnings when built in methods are invoked at runtime. - - - - - Backwards compatible Convert for the old sites that need to flow CodeContext - - - - - Creates a new InvokeBinder which will call with positional splatting. - - The signature of the target site should be object(function), object[], retType - - - - - - - Creates a new InvokeBinder which will call with positional and keyword splatting. - - The signature of the target site should be object(function), object[], dictionary, retType - - - - - Common helpers used by the various binding logic. - - - - - Tries to get the BuiltinFunction for the given name on the type of the provided MetaObject. - - Succeeds if the MetaObject is a BuiltinFunction or BuiltinMethodDescriptor. - - - - - Gets the best CallSignature from a MetaAction. - - The MetaAction should be either a Python InvokeBinder, or a DLR InvokeAction or - CreateAction. For Python we can use a full-fidelity - - - - - - - Transforms an invoke member into a Python GetMember/Invoke. The caller should - verify that the given attribute is not resolved against a normal .NET class - before calling this. If it is a normal .NET member then a fallback InvokeMember - is preferred. - - - - - Determines if the type associated with the first MetaObject is a subclass of the - type associated with the second MetaObject. - - - - - Adds a try/finally which enforces recursion limits around the target method. - - - - - Helper to do fallback for Invoke's so we can handle both StandardAction and Python's - InvokeBinder. - - - - - Converts arguments into a form which can be used for COM interop. - - The argument is only converted if we have an IronPython specific - conversion when calling COM methods. - - - - - Converts a single argument into a form which can be used for COM - interop. - - The argument is only converted if we have an IronPython specific - conversion when calling COM methods. - - - - - Fallback action for performing an invoke from Python. We translate the - CallSignature which supports splatting position and keyword args into - their expanded form. - - - - - Builds up a series of conditionals when the False clause isn't yet known. We can - keep appending conditions and if true's. Each subsequent true branch becomes the - false branch of the previous condition and body. Finally a non-conditional terminating - branch must be added. - - - - - Adds a new conditional and body. The first call this becomes the top-level - conditional, subsequent calls will have it added as false statement of the - previous conditional. - - - - - If present, converts the finish condition body be a normal conditional body. - The builder instance will become unfinished again. - - If no finish condition body is available, this extends the last condition check - with the new condition. - - - - - Adds the non-conditional terminating node. - - - - - Returns true if no conditions have been added - - - - - Returns true if a final, non-conditional, body has been added. - - - - - Gets the resulting meta object for the full body. FinishCondition - must have been called. - - - - - Adds a variable which will be scoped at the level of the final expression. - - - - - ArgBuilder which provides the CodeContext parameter to a method. - - - - - Fallback action for performing a new() on a foreign IDynamicMetaObjectProvider. used - when call falls back. - - - - - Base class for all of our fast get delegates. This holds onto the - delegate and provides the Update function. - - - - - Updates the call site when the current rule is no longer applicable. - - - - - Base class for all of our fast set delegates. This holds onto the - delegate and provides the Update and Optimize functions. - - - - - Updates the call site when the current rule is no longer applicable. - - - - - An interface that is implemented on DynamicMetaObjects. - - This allows objects to opt-into custom conversions when calling - COM APIs. The IronPython binders all call this interface before - doing any COM binding. - - - - - Interface used to mark objects which contain a dictionary of custom attributes that shadow - their existing attributes in a dynamic fashion. - - - - - Ensures that a non-null IDictionary instance is created for CustomAttributes and - returns it. - - - - - Meta-object which allows IPythonExpandable objects to behave like Python objects in their - ability to dynamically add and remove new or existing custom attributes, generally shadowing - existing built-in members. - - Getting: Member accesses first consult the object's CustomAttributes dictionary, then fall - through to the underlying object. - - Setting: Values can be bound to any member name, shadowing any existing attributes except - public non-PythonHidden fields and properties, which will bypass the dictionary. Thus, - it is possible for SetMember to fail, for example if the property is read-only or of - the wrong type. - - Deleting: Any member represented in the dictionary can be deleted, re-exposing the - underlying member if it exists. Any other deletions will fail. - - - - - Interface used to mark objects as being invokable from Python. These objects support - calling with splatted positional and keyword arguments. - - - - - Gets the PythonContext which the CallSiteBinder is associated with. - - - - - Provides a MetaObject for instances of Python's old-style classes. - - TODO: Lots of CodeConetxt references, need to move CodeContext onto OldClass and pull it from there. - - - - - Performs the actual work of binding to the function. - - Overall this works by going through the arguments and attempting to bind all the outstanding known - arguments - position arguments and named arguments which map to parameters are easy and handled - in the 1st pass for GetArgumentsForRule. We also pick up any extra named or position arguments which - will need to be passed off to a kw argument or a params array. - - After all the normal args have been assigned to do a 2nd pass in FinishArguments. Here we assign - a value to either a value from the params list, kw-dict, or defaults. If there is ambiguity between - this (e.g. we have a splatted params list, kw-dict, and defaults) we call a helper which extracts them - in the proper order (first try the list, then the dict, then the defaults). - - - - - Makes the test for our rule. - - - - - Makes the test when we just have simple positional arguments. - - - - - Makes the test when we have a keyword argument call or splatting. - - - - - - Gets the array of expressions which correspond to each argument for the function. These - correspond with the function as it's defined in Python and must be transformed for our - delegate type before being used. - - - - - Binds any missing arguments to values from params array, kw dictionary, or default values. - - - - - Creates the argument for the list expansion parameter. - - - - - Adds extra positional arguments to the start of the expanded list. - - - - - Creates the argument for the dictionary expansion parameter. - - - - - Adds an unbound keyword argument into the dictionary. - - - - - - Adds a check to the last parameter (so it's evaluated after we've extracted - all the parameters) to ensure that we don't have any extra params or kw-params - when we don't have a params array or params dict to expand them into. - - - - - Helper function to validate that a named arg isn't duplicated with by - a params list or the dictionary (or both). - - - - - Helper function to get a value (which has no default) from either the - params list or the dictionary (or both). - - - - - Helper function to get the specified variable from the dictionary. - - - - - Helper function to extract the variable from defaults, or to call a helper - to check params / kw-dict / defaults to see which one contains the actual value. - - - - - Helper function to extract from the params list or dictionary depending upon - which one has an available value. - - - - - Helper function to extract the next argument from the params list. - - - - - Fixes up the argument list for the appropriate target delegate type. - - - - - Helper function to get the function argument strongly typed. - - - - - Called when the user is expanding a dictionary - we copy the user - dictionary and verify that it contains only valid string names. - - - - - Called when the user is expanding a params argument - - - - - Called when the user hasn't supplied a dictionary to be expanded but the - function takes a dictionary to be expanded. - - - - - Helper function to create the expression for creating the actual tuple passed through. - - - - - Creates the code to invoke the target delegate function w/ the specified arguments. - - - - - Appends the initialization code for the call to the function if any exists. - - - - - Creates a target which creates a new dynamic method which contains a single - dynamic site that invokes the callable object. - - TODO: This should be specialized for each callable object - - - - - Creating a standard .NET type is easy - we just call it's constructor with the provided - arguments. - - - - - Creating a Python type involves calling __new__ and __init__. We resolve them - and generate calls to either the builtin funcions directly or embed sites which - call the slots at runtime. - - - - - Checks if we have a default new and init - in this case if we have any - arguments we don't allow the call. - - - - - Creates a test which tests the specific version of the type. - - - - - Base class for performing member binding. Derived classes override Add methods - to produce the actual final result based upon what the GetBinderHelper resolves. - - - - - - Provides the normal meta binder binding. - - - - - Provides delegate based fast binding. - - - - - Various helpers related to calling Python __*__ conversion methods - - - - - Helper for falling back - if we have a base object fallback to it first (which can - then fallback to the calling site), otherwise fallback to the calling site. - - - - - Helper for falling back - if we have a base object fallback to it first (which can - then fallback to the calling site), otherwise fallback to the calling site. - - - - - Provides the lookup logic for resolving a Python object. Subclasses - provide the actual logic for producing the binding result. Currently - there are two forms of the binding result: one is the DynamicMetaObject - form used for non-optimized bindings. The other is the Func of CallSite, - object, CodeContext, object form which is used for fast binding and - pre-compiled rules. - - - - - GetBinder which produces a DynamicMetaObject. This binder always - successfully produces a DynamicMetaObject which can perform the requested get. - - - - - Makes a rule which calls a user-defined __getattribute__ function and falls back to __getattr__ if that - raises an AttributeError. - - slot is the __getattribute__ method to be called. - - - - - Checks a range of the MRO to perform old-style class lookups if any old-style classes - are present. We will call this twice to produce a search before a slot and after - a slot. - - - - - Checks to see if this type has __getattribute__ that overrides all other attribute lookup. - - This is more complex then it needs to be. The problem is that when we have a - mixed new-style/old-style class we have a weird __getattribute__ defined. When - we always dispatch through rules instead of PythonTypes it should be easy to remove - this. - - - - - Helper for falling back - if we have a base object fallback to it first (which can - then fallback to the calling site), otherwise fallback to the calling site. - - - - - Looks up the associated PythonTypeSlot from the object. Indicates if the result - came from a standard .NET type in which case we will fallback to the sites binder. - - - - - Helper for falling back - if we have a base object fallback to it first (which can - then fallback to the calling site), otherwise fallback to the calling site. - - - - - Helper for falling back - if we have a base object fallback to it first (which can - then fallback to the calling site), otherwise fallback to the calling site. - - - - - Provides a way for the binder to provide a custom error message when lookup fails. Just - doing this for the time being until we get a more robust error return mechanism. - - - - - Provides a way for the binder to provide a custom error message when lookup fails. Just - doing this for the time being until we get a more robust error return mechanism. - - - - - Gets the PythonBinder associated with tihs CodeContext - - - - - Performs .NET member resolution. This looks within the given type and also - includes any extension members. Base classes and their extension members are - not searched. - - - - - Performs .NET member resolution. This looks within the given type and also - includes any extension members. Base classes and their extension members are - not searched. - - This version allows PythonType's for protected member resolution. It shouldn't - be called externally for other purposes. - - - - - Performs .NET member resolution. This looks the type and any base types - for members. It also searches for extension members in the type and any base types. - - - - - Gets the member names which are defined in this type and any extension members. - - This search does not include members in any subtypes or their extension members. - - - - - Gets the member names which are defined in the type and any subtypes. - - This search includes members in the type and any subtypes as well as extension - types of the type and its subtypes. - - - - - Creates the initial table of extension types. These are standard extension that we apply - to well known .NET types to make working with them better. Being added to this table does - not make a type a Python type though so that it's members are generally accessible w/o an - import clr and their type is not re-named. - - - - - Creates a table of standard .NET types which are also standard Python types. These types have a standard - set of extension types which are shared between all runtimes. - - - - - Event handler for when our domain manager has an assembly loaded by the user hosting the script - runtime. Here we can gather any information regarding extension methods. - - Currently DLR-style extension methods become immediately available w/o an explicit import step. - - - - - Provides a cache from Type/name -> PythonTypeSlot and also allows access to - all members (and remembering whether all members are cached). - - - - - Writes to a cache the result of a type lookup. Null values are allowed for the slots and they indicate that - the value does not exist. - - - - - Looks up a cached type slot for the specified member and type. This may return true and return a null slot - that indicates - that a cached result for a member which doesn't exist has been stored. Otherwise it returns true if a slot is found or - false if it is not. - - - - - Looks up a cached member group for the specified member and type. This may return true and return a null group - that indicates - that a cached result for a member which doesn't exist has been stored. Otherwise it returns true if a group is found or - false if it is not. - - - - - Checks to see if all members have been populated for the provided type. - - - - - Populates the type with all the provided members and marks the type - as being fully cached. - - The dictionary is used for the internal storage and should not be modified after - providing it to the cache. - - - - - Returns an enumerable object which provides access to all the members of the provided type. - - The caller must check that the type is fully cached and populate the cache if it isn't before - calling this method. - - - - - Python's Invoke is a non-standard action. Here we first try to bind through a Python - internal interface (IPythonInvokable) which supports CallSigantures. If that fails - and we have an IDO then we translate to the DLR protocol through a nested dynamic site - - this includes unsplatting any keyword / position arguments. Finally if it's just a plain - old .NET type we use the default binder which supports CallSignatures. - - - - - The Action used for Python call sites. This supports both splatting of position and keyword arguments. - - When a foreign object is encountered the arguments are expanded into normal position/keyword arguments. - - - - - Python's Invoke is a non-standard action. Here we first try to bind through a Python - internal interface (IPythonInvokable) which supports CallSigantures. If that fails - and we have an IDO then we translate to the DLR protocol through a nested dynamic site - - this includes unsplatting any keyword / position arguments. Finally if it's just a plain - old .NET type we use the default binder which supports CallSignatures. - - - - - Fallback - performs the default binding operation if the object isn't recognized - as being invokable. - - - - - Gets the CallSignature for this invocation which describes how the MetaObject array - is to be mapped. - - - - - Creates a nested dynamic site which uses the unpacked arguments. - - - - - Translates our CallSignature into a DLR Argument list and gives the simple MetaObject's which are extracted - from the tuple or dictionary parameters being splatted. - - - - - The result type of the operation. - - - - - Custom dynamic site kinds for simple sites that just take a fixed set of parameters. - - - - - Unary operator. - - Gets various documentation about the object returned as a string - - - - - Unary operator. - - Gets information about the type of parameters, returned as a string. - - - - - Unary operator. - - Checks whether the object is callable or not, returns true if it is. - - - - - Binary operator. - - Checks to see if the instance contains another object. Returns true or false. - - - - - Unary operator. - - Returns the number of items stored in the object. - - - - - Binary operator. - - Compares two instances returning an integer indicating the relationship between them. May - throw if the object types are uncomparable. - - - - - Binary operator. - - Returns both the dividend and quotioent of x / y. - - - - - Unary operator. - - Get the absolute value of the instance. - - - - - Unary operator. - - Gets the positive value of the instance. - - - - - Unary operator. - - Negates the instance and return the new value. - - - - - Unary operator. - - Returns the ones complement of the instance. - - - - - Unary operator. - - Boolean negation - - - - - Unary operator. - - Negation, returns object - - - - - Get enumerator for iteration binder. Returns a KeyValuePair<IEnumerator, IDisposable> - - The IEnumerator is used for iteration. The IDisposable is provided if the object was an - IEnumerable or IEnumerable<T> and is a disposable object. - - - - Operator for performing add - - - Operator for performing sub - - - Operator for performing pow - - - Operator for performing mul - - - Operator for performing floordiv - - - Operator for performing div - - - Operator for performing truediv - - - Operator for performing mod - - - Operator for performing lshift - - - Operator for performing rshift - - - Operator for performing and - - - Operator for performing or - - - Operator for performing xor - - - Operator for performing lt - - - Operator for performing gt - - - Operator for performing le - - - Operator for performing ge - - - Operator for performing eq - - - Operator for performing ne - - - Operator for performing lg - - - Operator for performing in-place add - - - Operator for performing in-place sub - - - Operator for performing in-place pow - - - Operator for performing in-place mul - - - Operator for performing in-place floordiv - - - Operator for performing in-place div - - - Operator for performing in-place truediv - - - Operator for performing in-place mod - - - Operator for performing in-place lshift - - - Operator for performing in-place rshift - - - Operator for performing in-place and - - - Operator for performing in-place or - - - Operator for performing in-place xor - - - Operator for performing reverse add - - - Operator for performing reverse sub - - - Operator for performing reverse pow - - - Operator for performing reverse mul - - - Operator for performing reverse floordiv - - - Operator for performing reverse div - - - Operator for performing reverse truediv - - - Operator for performing reverse mod - - - Operator for performing reverse lshift - - - Operator for performing reverse rshift - - - Operator for performing reverse and - - - Operator for performing reverse or - - - Operator for performing reverse xor - - - Operator for performing reverse divmod - - - - Provides binding logic which is implemented to follow various Python protocols. This includes - things such as calling __call__ to perform calls, calling __nonzero__/__len__ to convert to - bool, calling __add__/__radd__ to do addition, etc... - - This logic gets shared between both the IDynamicMetaObjectProvider implementation for Python objects as well - as the Python sites. This ensures the logic we follow for our builtin types and user defined - types is identical and properly conforming to the various protocols. - - - - - Gets a MetaObject which converts the provided object to a bool using __nonzero__ or __len__ - protocol methods. This code is shared between both our fallback for a site and our MetaObject - for user defined objects. - - - - - Used for conversions to bool - - - - - Creates a rule for the contains operator. This is exposed via "x in y" in - IronPython. It is implemented by calling the __contains__ method on x and - passing in y. - - If a type doesn't define __contains__ but does define __getitem__ then __getitem__ is - called repeatedly in order to see if the object is there. - - For normal .NET enumerables we'll walk the iterator and see if it's present. - - - - - Delegate for finishing the comparison. This takes in a condition and a return value and needs to update the ConditionalBuilder - with the appropriate resulting body. The condition may be null. - - - - - Helper to handle a comparison operator call. Checks to see if the call can - return NotImplemented and allows the caller to modify the expression that - is ultimately returned (e.g. to turn __cmp__ into a bool after a comparison) - - - - - calls __coerce__ for old-style classes and performs the operation if the coercion is successful. - - - - - Makes the comparison rule which returns an int (-1, 0, 1). TODO: Better name? - - - - - Python has three protocols for slicing: - Simple Slicing x[i:j] - Extended slicing x[i,j,k,...] - Long Slice x[start:stop:step] - - The first maps to __*slice__ (get, set, and del). - This takes indexes - i, j - which specify the range of elements to be - returned. In the slice variants both i, j must be numeric data types. - The 2nd and 3rd are both __*item__. - This receives a single index which is either a Tuple or a Slice object (which - encapsulates the start, stop, and step values) - - This is in addition to a simple indexing x[y]. - - For simple slicing and long slicing Python generates Operators.*Slice. For - the extended slicing and simple indexing Python generates a Operators.*Item - action. - - Extended slicing maps to the normal .NET multi-parameter input. - - So our job here is to first determine if we're to call a __*slice__ method or - a __*item__ method. - - - - - Helper to convert all of the arguments to their known types. - - - - - Gets the arguments that need to be provided to __*item__ when we need to pass a slice object. - - - - - Base class for calling indexers. We have two subclasses that target built-in functions and user defined callable objects. - - The Callable objects get handed off to ItemBuilder's which then call them with the appropriate arguments. - - - - - Creates a new CallableObject. If BuiltinFunction is available we'll create a BuiltinCallable otherwise - we create a SlotCallable. - - - - - Gets the arguments in a form that should be used for extended slicing. - - Python defines that multiple tuple arguments received (x[1,2,3]) get - packed into a Tuple. For most .NET methods we just want to expand - this into the multiple index arguments. For slots and old-instances - we want to pass in the tuple - - - - - Adds the target of the call to the rule. - - - - - Subclass of Callable for a built-in function. This calls a .NET method performing - the appropriate bindings. - - - - - Callable to a user-defined callable object. This could be a Python function, - a class defining __call__, etc... - - - - - Base class for building a __*item__ or __*slice__ call. - - - - - Derived IndexBuilder for calling __*slice__ methods - - - - - Derived IndexBuilder for calling __*item__ methods. - - - - - Helper to get the symbols for __*item__ and __*slice__ based upon if we're doing - a get/set/delete and the minimum number of arguments required for each of those. - - - - - Checks if a coercion check should be performed. We perform coercion under the following - situations: - 1. Old instances performing a binary operator (excluding rich comparisons) - 2. User-defined new instances calling __cmp__ but only if we wouldn't dispatch to a built-in __coerce__ on the parent type - - This matches the behavior of CPython. - - - - - - Produces an error message for the provided message and type names. The error message should contain - string formatting characters ({0}, {1}, etc...) for each of the type names. - - - - - Provides an abstraction for calling something which might be a builtin function or - might be some arbitrary user defined slot. If the object is a builtin function the - call will go directly to the underlying .NET method. If the object is an arbitrary - callable object we will setup a nested dynamic site for performing the additional - dispatch. - - TODO: We could probably do a specific binding to the object if it's another IDyanmicObject. - - - - - Combines two methods, which came from two different binary types, selecting the method which has the best - set of conversions (the conversions which result in the least narrowing). - - - - - Tries to get a MethodBinder associated with the slot for the specified type. - - If a method is found the binder is set and true is returned. - If nothing is found binder is null and true is returned. - If something other than a method is found false is returned. - - TODO: Remove rop - - - - - Implements a built-in module which is instanced per PythonContext. - - Implementers can subclass this type and then have a module which has efficient access - to internal state (this doesn't need to go through PythonContext.GetModuleState). These - modules can also declare module level globals which they'd like to provide efficient - access to by overloading GetGlobalVariableNames. When Initialize is called these - globals are provided and can be cached in the instance for fast global access. - - Just like normal static modules these modules are registered with the PythonModuleAttribute. - - - - - Initializes the module for it's first usage. By default this calls PerformModuleReload with the - the dictionary. - - The CodeContext for the module. - A list of globals which have optimize access. Contains at least all of the global variables reutrned by GetGlobalVariableNames. - - - - Gets a list of variable names which should have optimized storage (instances of PythonGlobal objects). - The module receives the global objects during the Initialize call and can hold onto them for - direct access to global members. - - - - - Called when the user attempts to reload() on your module and by the base class Initialize method. - - This provides an opportunity to allocate any per-module data which is not simply function definitions. - - A common usage here is to create exception objects which are allocated by the module using PythonExceptions.CreateSubType. - - - - - Provides access to the PythonContext which this module was created for. - - - - - Provides access to the CodeContext for the module. Returns null before Initialize() is called. - - - - - bytearray(string, encoding[, errors]) -> bytearray - bytearray(iterable) -> bytearray - - Construct a mutable bytearray object from: - - an iterable yielding values in range(256), including: - + a list of integer values - + a bytes, bytearray, buffer, or array object - - a text string encoded using the specified encoding - - bytearray([int]) -> bytearray - - Construct a zero-ititialized bytearray of the specified length. - (default=0) - - - - - return true if self is a titlecased string and there is at least one - character in self; also, uppercase characters may only follow uncased - characters (e.g. whitespace) and lowercase characters only cased ones. - return false otherwise. - - - - - Return a string which is the concatenation of the strings - in the sequence seq. The separator between elements is the - string providing this method - - - - - This overload is specifically implemented because in IronPython strings are unicode - - - - - return true if self is a titlecased string and there is at least one - character in self; also, uppercase characters may only follow uncased - characters (e.g. whitespace) and lowercase characters only cased ones. - return false otherwise. - - - - - Return a string which is the concatenation of the strings - in the sequence seq. The separator between elements is the - string providing this method - - - - - Returns a copy of the internal byte array. - - - System.Byte[] - - - - - This method returns the underlying byte array directly. - It should be used sparingly! - - - System.Byte[] - - - - - Marks a method as being a class method. The PythonType which was used to access - the method will then be passed as the first argument. - - - - - this class contains objecs and static methods used for - .NET/CLS interop with Python. - - - - - Gets the current ScriptDomainManager that IronPython is loaded into. The - ScriptDomainManager can then be used to work with the language portion of the - DLR hosting APIs. - - - - - Use(name) -> module - - Attempts to load the specified module searching all languages in the loaded ScriptRuntime. - - - - - Use(path, language) -> module - - Attempts to load the specified module belonging to a specific language loaded into the - current ScriptRuntime. - - - - - SetCommandDispatcher(commandDispatcher) - - Sets the current command dispatcher for the Python command line. - - The command dispatcher will be called with a delegate to be executed. The command dispatcher - should invoke the target delegate in the desired context. - - A common use for this is to enable running all REPL commands on the UI thread while the REPL - continues to run on a non-UI thread. - - - - - LoadTypeLibrary(rcw) -> type lib desc - - Gets an ITypeLib object from OLE Automation compatible RCW , - reads definitions of CoClass'es and Enum's from this library - and creates an object that allows to instantiate coclasses - and get actual values for the enums. - - - - - LoadTypeLibrary(guid) -> type lib desc - - Reads the latest registered type library for the corresponding GUID, - reads definitions of CoClass'es and Enum's from this library - and creates a IDynamicMetaObjectProvider that allows to instantiate coclasses - and get actual values for the enums. - - - - - AddReferenceToTypeLibrary(rcw) -> None - - Makes the type lib desc available for importing. See also LoadTypeLibrary. - - - - - AddReferenceToTypeLibrary(guid) -> None - - Makes the type lib desc available for importing. See also LoadTypeLibrary. - - - - - Gets the CLR Type object from a given Python type object. - - - - - Gets the Python type object from a given CLR Type object. - - - - - OBSOLETE: Gets the Python type object from a given CLR Type object. - - Use clr.GetPythonType instead. - - - - - accepts(*types) -> ArgChecker - - Decorator that returns a new callable object which will validate the arguments are of the specified types. - - - - - - - returns(type) -> ReturnChecker - - Returns a new callable object which will validate the return type is of the specified type. - - - - - Decorator for verifying the arguments to a function are of a specified type. - - - - - Returned value when using clr.accepts/ArgChecker. Validates the argument types and - then calls the original function. - - - - - Decorator for verifying the return type of functions. - - - - - Returned value when using clr.returns/ReturnChecker. Calls the original function and - validates the return type is of a specified type. - - - - - returns the result of dir(o) as-if "import clr" has not been performed. - - - - - Returns the result of dir(o) as-if "import clr" has been performed. - - - - - Attempts to convert the provided object to the specified type. Conversions that - will be attempted include standard Python conversions as well as .NET implicit - and explicit conversions. - - If the conversion cannot be performed a TypeError will be raised. - - - - - Provides a helper for compiling a group of modules into a single assembly. The assembly can later be - reloaded using the clr.AddReference API. - - - - - clr.CompileSubclassTypes(assemblyName, *typeDescription) - - Provides a helper for creating an assembly which contains pre-generated .NET - base types for new-style types. - - This assembly can then be AddReferenced or put sys.prefix\DLLs and the cached - types will be used instead of generating the types at runtime. - - This function takes the name of the assembly to save to and then an arbitrary - number of parameters describing the types to be created. Each of those - parameter can either be a plain type or a sequence of base types. - - clr.CompileSubclassTypes(object) -> create a base type for object - clr.CompileSubclassTypes(object, str, System.Collections.ArrayList) -> create - base types for both object and ArrayList. - - clr.CompileSubclassTypes(object, (object, IComparable)) -> create base types for - object and an object which implements IComparable. - - - - - - clr.GetSubclassedTypes() -> tuple - - Returns a tuple of information about the types which have been subclassed. - - This tuple can be passed to clr.CompileSubclassTypes to cache these - types on disk such as: - - clr.CompileSubclassTypes('assembly', *clr.GetSubclassedTypes()) - - - - - Provides a StreamContentProvider for a stream of content backed by a file on disk. - - - - - Goes through the list of files identifying the relationship between packages - and subpackages. Returns a dictionary with all of the package filenames (minus __init__.py) - mapping to their full name. For example given a structure: - - C:\ - someDir\ - package\ - __init__.py - a.py - b\ - __init.py - c.py - - Returns: - {r'C:\somedir\package' : 'package', r'C:\somedir\package\b', 'package.b'} - - This can then be used for calculating the full module name of individual files - and packages. For example a's full name is "package.a" and c's full name is - "package.b.c". - - - - - Returns a list of profile data. The values are tuples of Profiler.Data objects - - All times are expressed in the same unit of measure as DateTime.Ticks - - - - - Resets all profiler counters back to zero - - - - - Enable or disable profiling for the current ScriptEngine. This will only affect code - that is compiled after the setting is changed; previously-compiled code will retain - whatever setting was active when the code was originally compiled. - - The easiest way to recompile a module is to reload() it. - - - - - Serializes data using the .NET serialization formatter for complex - types. Returns a tuple identifying the serialization format and the serialized - data which can be fed back into clr.Deserialize. - - Current serialization formats include custom formats for primitive .NET - types which aren't already recognized as tuples. None is used to indicate - that the Binary .NET formatter is used. - - - - - Deserializes the result of a Serialize call. This can be used to perform serialization - for .NET types which are serializable. This method is the callable object provided - from __reduce_ex__ for .serializable .NET types. - - The first parameter indicates the serialization format and is the first tuple element - returned from the Serialize call. - - The second parameter is the serialized data. - - - - - Captures and flows the state of executing code from the generated - Python code into the IronPython runtime. - - - - - Creates a new CodeContext which is backed by the specified Python dictionary. - - - - - Gets the module state for top-level code. - - - - - Gets the DLR scope object that corresponds to the global variables of this context. - - - - - Gets the PythonContext which created the CodeContext. - - - - - Gets the dictionary for the global variables from the ModuleContext. - - - - - True if this global context should display CLR members on shared types (for example .ToString on int/bool/etc...) - - False if these attributes should be hidden. - - - - - Attempts to lookup the provided name in this scope or any outer scope. - - - - - Looks up a global variable. If the variable is not defined in the - global scope then built-ins is consulted. - - - - - Gets the dictionary used for storage of local variables. - - - - - Attempts to lookup the variable in the local scope. - - - - - Removes a variable from the local scope. - - - - - Sets a variable in the local scope. - - - - - Gets a variable from the global scope. - - - - - Sets a variable in the global scope. - - - - - Removes a variable from the global scope. - - - - - Returns the dictionary associated with __builtins__ if one is - set or null if it's not available. If __builtins__ is a module - the module's dictionary is returned. - - - - - General purpose storage used for most PythonDictionarys. - - This dictionary storage is thread safe for multiple readers or writers. - - Mutations to the dictionary involves a simple locking strategy of - locking on the DictionaryStorage object to ensure that only one - mutation happens at a time. - - Reads against the dictionary happen lock free. When the dictionary is mutated - it is either adding or removing buckets in a thread-safe manner so that the readers - will either see a consistent picture as if the read occured before or after the mutation. - - When resizing the dictionary the buckets are replaced atomically so that the reader - sees the new buckets or the old buckets. When reading the reader first reads - the buckets and then calls a static helper function to do the read from the bucket - array to ensure that readers are not seeing multiple bucket arrays. - - - - - Creates a new dictionary storage with no buckets - - - - - Creates a new dictionary storage with no buckets - - - - - Creates a new dictionary geting values/keys from the - items arary - - - - - Creates a new dictionary storage with the given set of buckets - and size. Used when cloning the dictionary storage. - - - - - Adds a new item to the dictionary, replacing an existing one if it already exists. - - - - - Initializes the buckets to their initial capacity, the caller - must check if the buckets are empty first. - - - - - Add helper that works over a single set of buckets. Used for - both the normal add case as well as the resize case. - - - - - Add helper which adds the given key/value (where the key is not null) with - a pre-computed hash code. - - - - - Removes an entry from the dictionary and returns true if the - entry was removed or false. - - - - - Removes an entry from the dictionary and returns true if the - entry was removed or false. The key will always be hashed - so if it is unhashable an exception will be thrown - even - if the dictionary has no buckets. - - - - - Checks to see if the key exists in the dictionary. - - - - - Trys to get the value associated with the given key and returns true - if it's found or false if it's not present. - - - - - Static helper to try and get the value from the dictionary. - - Used so the value lookup can run against a buckets while a writer - replaces the buckets. - - - - - Returns the number of key/value pairs currently in the dictionary. - - - - - Clears the contents of the dictionary. - - - - - Clones the storage returning a new DictionaryStorage object. - - - - - Helper to hash the given key w/ support for null. - - - - - Used to store a single hashed key/value. - - Bucket is not serializable because it stores the computed hash - code which could change between serialization and deserialization. - - - - - Special marker NullValue used during deserialization to not add - an extra field to the dictionary storage type. - - - - - Copy on write constant dictionary storage used for dictionaries created with constant items. - - - - - General conversion routine TryConvert - tries to convert the object to the desired type. - Try to avoid using this method, the goal is to ultimately remove it! - - - - - This function tries to convert an object to IEnumerator, or wraps it into an adapter - Do not use this function directly. It is only meant to be used by Ops.GetEnumerator. - - - - - This function tries to convert an object to IEnumerator, or wraps it into an adapter - Do not use this function directly. It is only meant to be used by Ops.GetEnumerator. - - - - - Attempts to convert value into a index usable for slicing and return the integer - value. If the conversion fails false is returned. - - If throwOverflowError is true then BigInteger's outside the normal range of integers will - result in an OverflowError. - - - - - Attempts to convert value into a index usable for slicing and return the integer - value. If the conversion fails false is returned. - - If throwOverflowError is true then BigInteger's outside the normal range of integers will - result in an OverflowError. - - - - - Converts a value to int ignoring floats - - - - - Gets all of the extra names and values stored in the dictionary. - - - - - Attemps to sets a value in the extra keys. Returns true if the value is set, false if - the value is not an extra key. - - - - - Attempts to get a value from the extra keys. Returns true if the value is an extra - key and has a value. False if it is not an extra key or doesn't have a value. - - - - - Attempts to remove the key. Returns true if the key is removed, false - if the key was not removed, or null if the key is not an extra key. - - - - - Adapts an IDictionary[object, object] for use as a PythonDictionary used for - our debug frames. Also hides the special locals which start with $. - - - - - Provides both helpers for implementing Python dictionaries as well - as providing public methods that should be exposed on all dictionary types. - - Currently these are published on IDictionary<object, object> - - - - - Abstract base class for all PythonDictionary storage. - - Defined as a class instead of an interface for performance reasons. Also not - using IDictionary* for keeping a simple interface. - - Full locking is defined as being on the DictionaryStorage object it's self, - not an internal member. This enables subclasses to provide their own locking - aruond large operations and call lock free functions. - - - - - Adds items from this dictionary into the other dictionary - - - - - Provides fast access to the __path__ attribute if the dictionary storage supports caching it. - - - - - Provides fast access to the __package__ attribute if the dictionary storage supports caching it. - - - - - Provides fast access to the __builtins__ attribute if the dictionary storage supports caching it. - - - - - Provides fast access to the __name__ attribute if the dictionary storage supports caching it. - - - - - Provides fast access to the __import__ attribute if the dictionary storage supports caching it. - - - - - Marks a type so that IronPython will not expose types which have GetMemberNames - as having a __dir__ method. - - Also suppresses __dir__ on something which implements IDynamicMetaObjectProvider - but is not an IPythonObject. - - - - - Marks a type so that IronPython will not expose the ICollection interface out as - __len__. - - - - - Marks a type so that IronPython will not expose the IDisposable interface out as - __enter__ and __exit__ methods of a context manager. - - - - - Marks a type so that IronPython will not expose the IEnumerable interface out as - __contains__ - - - - - Marks a type so that IronPython will not expose the IEnumerable interface out as - __iter__ - - - - - Singleton used for dictionaries which contain no items. - - - - - GeneratorExitException is a standard exception raised by Generator.Close() to allow a caller - to close out a generator. - - GeneratorExit is introduced in Pep342 for Python2.5. - - - - .NET exception thrown when a Python syntax error is related to incorrect indentation. - - - - - Implementation of the Python exceptions module and the IronPython/CLR exception mapping - mechanism. The exception module is the parent module for all Python exception classes - and therefore is built-in to IronPython.dll instead of IronPython.Modules.dll. - - The exception mapping mechanism is exposed as internal surface area available to only - IronPython / IronPython.Modules.dll. The actual exceptions themselves are all public. - - Because the oddity of the built-in exception types all sharing the same physical layout - (see also PythonExceptions.BaseException) some classes are defined as classes w/ their - proper name and some classes are defined as PythonType fields. When a class is defined - for convenience their's also an _TypeName version which is the PythonType. - - - - - Base class for all Python exception objects. - - When users throw exceptions they typically throw an exception which is - a subtype of this. A mapping is maintained between Python exceptions - and .NET exceptions and a corresponding .NET exception is thrown which - is associated with the Python exception. This class represents the - base class for the Python exception hierarchy. - - Users can catch exceptions rooted in either hierarchy. The hierarchy - determines whether the user catches the .NET exception object or the - Python exception object. - - Most built-in Python exception classes are actually instances of the BaseException - class here. This is important because in CPython the exceptions do not - add new members and therefore their layouts are compatible for multiple - inheritance. The exceptions to this rule are the classes which define - their own fields within their type, therefore altering their layout: - EnvironmentError - SyntaxError - IndentationError (same layout as SyntaxError) - TabError (same layout as SyntaxError) - SystemExit - UnicodeDecodeError - UnicodeEncodeError - UnicodeTranslateError - - These exceptions cannot be combined in multiple inheritance, e.g.: - class foo(EnvironmentError, IndentationError): pass - - fails but they can be combined with anything which is just a BaseException: - class foo(UnicodeDecodeError, SystemError): pass - - Therefore the majority of the classes are just BaseException instances with a - custom PythonType object. The specialized ones have their own .NET class - which inherits from BaseException. User defined exceptions likewise inherit - from this and have their own .NET class. - - - - - Initializes the Exception object with an unlimited number of arguments - - - - - Returns the exception 'message' if only a single argument was provided - during creation or an empty string. - - - - - Gets or sets the arguments used for creating the exception - - - - - Returns a tuple of (type, (arg0, ..., argN)) for implementing pickling/copying - - - - - Returns a tuple of (type, (arg0, ..., argN)) for implementing pickling/copying - - - - - Gets the nth member of the args property - - - - - Gets or sets the dictionary which is used for storing members not declared to have space reserved - within the exception object. - - - - - Updates the exception's state (dictionary) with the new values - - - - - Gets the CLR exception associated w/ this Python exception. Not visible - until a .NET namespace is imported. - - - - - Provides custom member lookup access that fallbacks to the dictionary - - - - - Provides custom member assignment which stores values in the dictionary - - - - - Provides custom member deletion which deletes values from the dictionary - or allows clearing 'message'. - - - - - Implements __repr__ which returns the type name + the args - tuple code formatted. - - - - - Initializes the Python exception from a .NET exception - - - - - - Helper to get the CLR exception associated w/ this Python exception - creating it if one has not already been created. - - - - - Creates a new throwable exception of type type where the type is an new-style exception. - - Used at runtime when creating the exception from a user provided type via the raise statement. - - - - - Creates a throwable exception of type type where the type is an OldClass. - - Used at runtime when creating the exception form a user provided type that's an old class (via the raise statement). - - - - - Returns the CLR exception associated with a Python exception - creating a new exception if necessary - - - - - Given a CLR exception returns the Python exception which most closely maps to the CLR exception. - - - - - Creates a new style Python exception from the .NET exception - - - - - Internal helper to associate a .NET exception and a Python exception. - - - - - Internal helper to get the associated Python exception from a .NET exception. - - - - - Converts the DLR SyntaxErrorException into a Python new-style SyntaxError instance. - - - - - Creates a PythonType for a built-in module. These types are mutable like - normal user types. - - - - - Creates a PythonType for a built-in module. These types are mutable like - normal user types. - - - - - Creates a PythonType for a built-in module, where the type may inherit - from multiple bases. These types are mutable like normal user types. - - - - - Creates a new type for a built-in exception which derives from another Python - type. . These types are built-in and immutable like any other normal type. For - example StandardError.x = 3 is illegal. This isn't for module exceptions which - are like user defined types. thread.error.x = 3 is legal. - - - - - Creates a new type for a built-in exception which is the root concrete type. - - - - - Gets the list of DynamicStackFrames for the current exception. - - - - - .NET exception that is thrown to signal the end of iteration in Python - - - - - .NET exception that is thrown to shutdown the interpretter and exit the system. - - - - - Result of sys.exit(n) - - - null if the script exited using "sys.exit(int_value)" - null if the script exited using "sys.exit(None)" - x if the script exited using "sys.exit(x)" where isinstance(x, int) == False - - - int_value if the script exited using "sys.exit(int_value)" - 1 otherwise - - - - - .NET Exception thrown when a Python syntax error is related to incorrect tabs. - - - - - returns string containing human readable representation of traceback - - - - - Represents the set of extension methods which are loaded into a module. - - This set is immutable (as far the external viewer is considered). When a - new extension method set is loaded into a module we create a new ExtensionMethodsSet object. - - Multiple modules which have the same set of extension methods use the same set. - - - - - Tracks the extension types that are loaded for a given assembly. - - We can have either types, namespaces, or a full assembly added as a reference. - - When the user just adds types we just add them to the type hash set. - - When the user adds namespaces we add them to the namespaces hashset. On the - next lookup we'll lazily load the types from that namespace and put them in Types. - - When the user adds assemblies we set the value to the NotYetLoadedButFullAssembly - value. The next load request will load the types from that namespace and put them - in Types. When we do that we'll mark the assembly as FullyLoaded so we don't - have to go through that again if the user adds a namespace. - - - - - Returns all of the extension methods with the given name. - - - - - Returns all of the extension methods which are applicable for the given type. - - - - - Helper NumberFormatInfo for use by int/BigInteger __format__ routines - for width specified leading zero support that contains ','s every 3 digits. - i.e. For use by d/g/G format specifiers. NOT for use by n format specifiers. - - - - - Set if the function includes a *args argument list. - - - - - Set if the function includes a **kwargs argument dictionary. - - - - - Set if the function is a generator. - - - - - Set if the function was compiled with future division. - - - - - IronPython specific: Set if the function includes nested exception handling and therefore can alter - sys.exc_info(). - - - - - IronPython specific: Set if the function includes a try/finally block. - - - - - Represents a piece of code. This can reference either a CompiledCode - object or a Function. The user can explicitly call FunctionCode by - passing it into exec or eval. - - - - - This is both the lock that is held while enumerating the threads or updating the thread accounting - information. It's also a marker CodeList which is put in place when we are enumerating the thread - list and all additions need to block. - - This lock is also acquired whenever we need to calculate how a function's delegate should be created - so that we don't race against sys.settrace/sys.setprofile. - - - - - Constructor used to create a FunctionCode for code that's been serialized to disk. - - Code constructed this way cannot be interpreted or debugged using sys.settrace/sys.setprofile. - - Function codes created this way do support recursion enforcement and are therefore registered in the global function code registry. - - - - - Constructor to create a FunctionCode at runtime. - - Code constructed this way supports both being interpreted and debugged. When necessary the code will - be re-compiled or re-interpreted for that specific purpose. - - Function codes created this way do support recursion enforcement and are therefore registered in the global function code registry. - - the initial delegate provided here should NOT be the actual code. It should always be a delegate which updates our Target lazily. - - - - - Registers the current function code in our global weak list of all function codes. - - The weak list can be enumerated with GetAllCode(). - - Ultimately there are 3 types of threads we care about races with: - 1. Other threads which are registering function codes - 2. Threads calling sys.settrace which require the world to stop and get updated - 3. Threads running cleanup (thread pool thread, or call to gc.collect). - - The 1st two must have perfect synchronization. We cannot have a thread registering - a new function which another thread is trying to update all of the functions in the world. Doing - so would mean we could miss adding tracing to a thread. - - But the cleanup thread can run in parallel to either registrying or sys.settrace. The only - thing it needs to take a lock for is updating our accounting information about the - number of code objects are alive. - - - - - Enumerates all function codes for updating the current type of targets we generate. - - While enumerating we hold a lock so that users cannot change sys.settrace/sys.setprofile - until the lock is released. - - - - - Returns a list of variable names which are accessed from nested functions. - - - - - Returns the byte code. IronPython does not implement this and always - returns an empty string for byte code. - - - - - Returns a list of constants used by the function. - - The first constant is the doc string, or None if no doc string is provided. - - IronPython currently does not include any other constants than the doc string. - - - - - Returns the filename that the code object was defined in. - - - - - Returns the 1st line number of the code object. - - - - - Returns a set of flags for the function. - - 0x04 is set if the function used *args - 0x08 is set if the function used **args - 0x20 is set if the function is a generator - - - - - Returns a list of free variables (variables accessed - from an outer scope). This does not include variables - accessed in the global scope. - - - - - Returns a mapping between byte code and line numbers. IronPython does - not implement this because byte code is not available. - - - - - Returns the name of the code (function name, class name, or <module>). - - - - - Returns a list of global variable names accessed by the code. - - - - - Returns the number of local varaibles defined in the function. - - - - - Returns the stack size. IronPython does not implement this - because byte code is not supported. - - - - - Creates a FunctionCode object for exec/eval/execfile'd/compile'd code. - - The code is then executed in a specific CodeContext by calling the .Call method. - - If the code is being used for compile (vs. exec/eval/execfile) then it needs to be - registered in case our tracing mode changes. - - - - - Called the 1st time a function is invoked by our OriginalCallTarget* methods - over in PythonCallTargets. This computes the real delegate which needs to be - created for the function. Usually this means starting off interpretering. It - also involves adding the wrapper function for recursion enforcement. - - Because this can race against sys.settrace/setprofile we need to take our - _ThreadIsEnumeratingAndAccountingLock to ensure no one is actively changing all - of the live functions. - - - - - Updates the delegate based upon current Python context settings for recursion enforcement - and for tracing. - - - - - Called to set the initial target delegate when the user has passed -X:Debug to enable - .NET style debugging. - - - - - Gets the LambdaExpression for tracing. - - If this is a generator function code then the lambda gets tranformed into the correct generator code. - - - - - Gets the correct final LambdaExpression for this piece of code. - - This is either just _lambda or _lambda re-written to be a generator expression. - - - - - Extremely light weight linked list of weak references used for tracking - all of the FunctionCode objects which get created and need to be updated - for purposes of recursion enforcement or tracing. - - - - - True iff the thread is currently inside the generator (ie, invoking the _next delegate). - This can be used to enforce that a generator does not call back into itself. - Pep255 says that a generator should throw a ValueError if called reentrantly. - - - - - We cache the GeneratorFinalizer of generators that were closed on the user - thread, and did not get finalized on the finalizer thread. We can then reuse - the object. Reusing objects with a finalizer is good because it reduces - the load on the GC's finalizer queue. - - - - - Fields set by Throw() to communicate an exception to the yield point. - These are plumbed through the generator to become parameters to Raise(...) invoked - at the yield suspension point in the generator. - - - - - Value sent by generator.send(). - Since send() could send an exception, we need to keep this different from throwable's value. - - - - - See PEP 342 (http://python.org/dev/peps/pep-0342/) for details of new methods on Generator. - Full signature including default params for throw is: - throw(type, value=None, traceback=None) - Use multiple overloads to resolve the default parameters. - - - - - Throw(...) is like Raise(...) being called from the yield point within the generator. - Note it must come from inside the generator so that the traceback matches, and so that it can - properly cooperate with any try/catch/finallys inside the generator body. - - If the generator catches the exception and yields another value, that is the return value of g.throw(). - - - - - send() was added in Pep342. It sends a result back into the generator, and the expression becomes - the result of yield when used as an expression. - - - - - Close introduced in Pep 342. - - - - - Gets the name of the function that produced this generator object. - - - - - Core implementation of IEnumerator.MoveNext() - - - - - Core implementation of Python's next() method. - - - - - Helper called from PythonOps after the yield statement - Keepin this in a helper method: - - reduces generated code size - - allows better coupling with PythonGenerator.Throw() - - avoids throws from emitted code (which can be harder to debug). - - - - - - Called to throw an exception set by Throw(). - - - - - True if the generator has finished (is "closed"), else false. - Python language spec mandates that calling Next on a closed generator gracefully throws a StopIterationException. - This can never be reset. - - - - - True if the generator can set sys exc info and therefore needs exception save/restore. - - - - - Importer class - used for importing modules. Used by Ops and __builtin__ - Singleton living on Python engine. - - - - - Gateway into importing ... called from Ops. Performs the initial import of - a module and returns the module. - - - - - Gateway into importing ... called from Ops. Performs the initial import of - a module and returns the module. This version returns light exceptions instead of throwing. - - - - - Gateway into importing ... called from Ops. This is called after - importing the module and is used to return individual items from - the module. The outer modules dictionary is then updated with the - result. - - - - - Called by the __builtin__.__import__ functions (general importing) and ScriptEngine (for site.py) - - level indiciates whether to perform absolute or relative imports. - -1 indicates both should be performed - 0 indicates only absolute imports should be performed - Positive numbers indicate the # of parent directories to search relative to the calling module - - - - - Interrogates the importing module for __name__ and __path__, which determine - whether the imported module (whose name is 'name') is being imported as nested - module (__path__ is present) or as sibling. - - For sibling import, the full name of the imported module is parent.sibling - For nested import, the full name of the imported module is parent.module.nested - where parent.module is the mod.__name__ - - - the globals dictionary - Name of the module to be imported - Output - full name of the module being imported - Path to use to search for "full" - the import level for relaive imports - the parent module - the global __package__ value - - - - - Given the parent module name looks up the __path__ property. - - - - - Trys to get an existing module and if that fails fall backs to searching - - - - - Attempts to load a module from sys.meta_path as defined in PEP 302. - - The meta_path provides a list of importer objects which can be used to load modules before - searching sys.path but after searching built-in modules. - - - - - Given a user defined importer object as defined in PEP 302 tries to load a module. - - First the find_module(fullName, path) is invoked to get a loader, then load_module(fullName) is invoked - - - - - Finds a user defined importer for the given path or returns null if no importer - handles this path. - - - - - Wrapper class used when a user defined type (new-style or old-style) - defines __index__. We provide a conversion from all user defined - types to the Index type so they can be used for determing and method bind - time the most appropriate method to dispatch to. - - - - - ModuleDictionaryStorage for a built-in module which is bound to a specific instance. - - These modules don't need to use PythonContext.GetModuleState() for storage and therefore - can provide efficient access to internal variables. They can also cache PythonGlobal - objects and provide efficient access to module globals. - - To the end user these modules appear just like any other module. These modules are - implemented by subclassing the BuiltinPythonModule class. - - - - - Defines the internal interface used for accessing weak references and adding finalizers - to user-defined types. - - - - - Gets the current WeakRefTracker for an object that can be used to - append additional weak references. - - - - - Attempts to set the WeakRefTracker for an object. Used on the first - addition of a weak ref tracker to an object. If the object doesn't - support adding weak references then it returns false. - - - - - Sets a WeakRefTracker on an object for the purposes of supporting finalization. - All user types (new-style and old-style) support finalization even if they don't - support weak-references, and therefore this function always succeeds. Note the - slot used to store the WeakRefTracker is still shared between SetWeakRef and - SetFinalizer if a type supports both. - - - - - - Allow types to implement weakvreference tracking by returning a proxy. - - The proxy can refer to the current Python context, whihc is the main purpose. - - - - - - - - - - Provides a list of all the members of an instance. ie. all the keys in the - dictionary of the object. Note that it can contain objects that are not strings. - - Such keys can be added in IronPython using syntax like: - obj.__dict__[100] = someOtherObject - - This Python specific version also supports filtering based upon the show cls - flag by flowing in the code context. - - - - - Represents a sequence which may have been provided as a set of parameters to an indexer. - - TODO: This should be removed, and all uses of this should go to [SpecialName]object GetItem(..., params object[] keys) - and [SpecialName]void SetItem(..., params object [] keys) or this[params object[]xyz] which is also legal. - - currently this exists for backwards compatibility w/ IronPython's "expandable tuples". - - - - - Creates a new list with the data in the array and a size - the same as the length of the array. The array is held - onto and may be mutated in the future by the list. - - params array to use for lists storage - - - - Gets a reasonable size for the addition of two arrays. We round - to a power of two so that we usually have some extra space if - the resulting array gets added to. - - - - - Non-thread safe adder, should only be used by internal callers that - haven't yet exposed their list. - - - - - Compares the two specified keys - - - - - Supports __index__ on arbitrary types, also prevents __float__ - - - - - we need to lock both objects (or copy all of one's data w/ it's lock held, and - then compare, which is bad). Therefore we have a strong order for locking on - the two objects based upon the hash code or object identity in case of a collision - - - - - Summary description for ConstantValue. - - - - - MemoryView slicing is somewhat different and more restricted than - standard slicing. - - - - - Validates that the current self object is usable for this method. - - - - - Captures the globals and other state of module code. - - - - - Creates a new ModuleContext which is backed by the specified dictionary. - - - - - Creates a new ModuleContext for the specified module. - - - - - Gets the dictionary used for the global variables in the module - - - - - Gets the language context which created this module. - - - - - Gets the DLR Scope object which is associated with the modules dictionary. - - - - - Gets the global CodeContext object which is used for execution of top-level code. - - - - - Gets the module object which this code is executing in. - - This module may or may not be published in sys.modules. For user defined - code typically the module gets published at the start of execution. But if - this ModuleContext is attached to a Scope, or if we've just created a new - module context for executing code it will not be in sys.modules. - - - - - Gets the features that code has been compiled with in the module. - - - - - Gets or sets whether code running in this context should display - CLR members (for example .ToString on objects). - - - - - Initializes __builtins__ for the module scope. - - - - - Enables lazy initialization of module dictionaries. - - - - - Cached global value. Created and maintained on a per-language basis. Default - implementation returns a singleton which indicates caching is not occuring. - - - - - Creates a new ModuleGlobalCache with the specified value. - - - - - True if the ModuleGlobalCache is participating in a caching strategy. - - - - - True if there is currently a value associated with this global variable. False if - it is currently unassigned. - - - - - Gets or sets the current cached value - - - - - Event handler for when the value has changed. Language implementors should call this when - the cached value is invalidated. - - - - - Enable true division (1/2 == .5) - - - - - Indicates that .NET methods such as .ToString should be available on Python objects. - - - - - Indicates that the module should be generated in an optimal form which will result - in it being uncollectable. - - - - - Indicates when the module should be executed immedatiately upon creation. - - - - - Enable usage of the with statement - - - - - Enable absolute imports - - - - - Indiciates that __builtins__ should not be set in the module - - - - - Indiciates that when the module is initialized it should set __builtins__ to the __builtin__ module - instead of the __builtin__ dictionary. - - - - - Marks code as being created for exec, eval. Code generated this way will - be capable of running against different scopes and will do lookups at runtime - for free global variables. - - - - - Indiciates that the first line of code should be skipped. - - - - - Enable usage of print as a function for better compatibility with Python 3.0. - - - - - Forces the code to be interpreted rather than compiled - - - - - String Literals should be parsed as Unicode strings - - - - - Include comments in the parse tree - - - - - Generated code should support light exceptions - - - - - New string formatter for 'str'.format(...) calls and support for the Formatter - library via the _formatter_parser / _formatter_field_name_split - methods. - - We parse this format: - - replacement_field = "{" field_name ["!" conversion] [":" format_spec] "}" - field_name = (identifier | integer) ("." attribute_name | "[" element_index "]")* - attribute_name = identifier - element_index = identifier - conversion = "r" | "s" - format_spec = any char, { must be balanced (for computed values), passed to __format__ method on object - - - - - Runs the formatting operation on the given format and keyword arguments - - - - - Gets the formatting information for the given format. This is a list of tuples. The tuples - include: - - text, field name, format spec, conversion - - - - - Parses a field name returning the argument name and an iterable - object which can be used to access the individual attribute - or element accesses. The iterator yields tuples of: - - bool (true if attribute, false if element index), attribute/index value - - - - - Base class used for parsing the format. Subclasss override Text/ReplacementField methods. Those - methods get called when they call Parse and then they can do the appropriate actions for the - format. - - - - - Gets an enumerable object for walking the parsed format. - - TODO: object array? struct? - - - - - Provides an enumerable of the parsed format. The elements of the tuple are: - the text preceding the format information - the field name - the format spec - the conversion - - - - - Handles {{ and }} within the string. Returns true if a double bracket - is found and yields the text - - - - - Parses the conversion character and returns it - - - - - Checks to see if we're at the end of the format. If there's no more characters left we report - the error, otherwise if we hit a } we return true to indicate parsing should stop. - - - - - Parses the format spec string and returns it. - - - - - Parses the field name and returns it. - - - - - Handles parsing the field name and the format spec and returns it. At the parse - level these are basically the same - field names just have more terminating characters. - - The most complex part of parsing them is they both allow nested braces and require - the braces are matched. Strangely though the braces need to be matched across the - combined field and format spec - not within each format. - - - - - Provides the built-in string formatter which is exposed to Python via the str.format API. - - - - - Inspects a format spec to see if it contains nested format specs which - we need to compute. If so runs another string formatter on the format - spec to compute those values. - - - - - Given the field name gets the object from our arguments running - any of the member/index accessors. - - - - - Applies the known built-in conversions to the object if a conversion is - specified. - - - - - Gets the initial object represented by the field name - e.g. the 0 or - keyword name. - - - - - Given the object value runs the accessors in the field name (if any) against the object. - - - - - Parses the field name including attribute access or element indexing. - - - - - Parses the field name including attribute access or element indexing. - - - - - Converts accessors from our internal structure into a PythonTuple matching how CPython - exposes these - - - - - Parses an identifier and returns it - - - - - Encodes all the information about the field name. - - - - - Encodes a single field accessor (.b or [number] or [str]) - - - - - Multiply two object[] arrays - slow version, we need to get the type, etc... - - - - - Multiply two object[] arrays - internal version used for objects backed by arrays - - - - - Add two arrays - internal versions for objects backed by arrays - - - - - - - - - - We override the behavior of equals, compare and hashcode to make - chars seem as much like strings as possible. In Python there is no - difference between these types. - - - - - Helper class that all custom type descriptor implementations call for - the bulk of their implementation. - - - - - Returns the digits for the format spec, no sign is included. - - - - - Interface used for things which can convert to delegates w/o code gen. Currently - this is just non-overloaded builtin functions and bound builtin functions. Avoiding - the code gen is not only nice for compilation but it also enables delegates to be added - in C# and removed in Python. - - - - - Returns the digits for the format spec, no sign is included. - - - - - InstanceOps contains methods that get added to CLS types depending on what - methods and constructors they define. These have not been added directly to - PythonType since they need to be added conditionally. - - Possibilities include: - - __new__, one of 3 __new__ sets can be added: - DefaultNew - This is the __new__ used for a PythonType (list, dict, object, etc...) that - has only 1 default public constructor that takes no parameters. These types are - mutable types, and __new__ returns a new instance of the type, and __init__ can be used - to re-initialize the types. This __new__ allows an unlimited number of arguments to - be passed if a non-default __init__ is also defined. - - NonDefaultNew - This is used when a type has more than one constructor, or only has one - that takes more than zero parameters. This __new__ does not allow an arbitrary # of - extra arguments. - - DefaultNewCls - This is the default new used for CLS types that have only a single ctor - w/ an arbitray number of arguments. This constructor allows setting of properties - based upon an extra set of kw-args, e.g.: System.Windows.Forms.Button(Text='abc'). It - is only used on non-Python types. - - __init__: - For types that do not define __init__ we have an __init__ function that takes an - unlimited number of arguments and does nothing. All types share the same reference - to 1 instance of this. - - next: Defined when a type is an enumerator to expose the Python iter protocol. - - - repr: Added for types that override ToString - - get: added for types that implement IDescriptor - - - - - __dir__(self) -> Returns the list of members defined on a foreign IDynamicMetaObjectProvider. - - - - - Provides the implementation of __enter__ for objects which implement IDisposable. - - - - - Provides the implementation of __exit__ for objects which implement IDisposable. - - - - - Determines if a type member can be imported. This is used to treat static types like modules. - - - - - Implements __contains__ for types implementing IEnumerable of T. - - - - - Implements __contains__ for types implementing IEnumerable - - - - - Implements __contains__ for types implementing IEnumerable of T. - - - - - Implements __contains__ for types implementing IEnumerable - - - - - Implements __reduce_ex__ for .NET types which are serializable. This uses the .NET - serializer to get a string of raw data which can be serialized. - - - - - Contains Python extension methods that are added to object - - - - Types for which the pickle module has built-in support (from PEP 307 case 2) - - - - __class__, a custom slot so that it works for both objects and types. - - - - - Removes an attribute from the provided member - - - - - Returns the hash code of the given object - - - - - Gets the specified attribute from the object without running any custom lookup behavior - (__getattr__ and __getattribute__) - - - - - Initializes the object. The base class does nothing. - - - - - Initializes the object. The base class does nothing. - - - - - Initializes the object. The base class does nothing. - - - - - Creates a new instance of the type - - - - - Creates a new instance of the type - - - - - Creates a new instance of the type - - - - - Runs the pickle protocol - - - - - Runs the pickle protocol - - - - - Runs the pickle protocol - - - - - Returns the code representation of the object. The default implementation returns - a string which consists of the type and a unique numerical identifier. - - - - - Sets an attribute on the object without running any custom object defined behavior. - - - - - Returns the number of bytes of memory required to allocate the object. - - - - - Returns a friendly string representation of the object. - - - - - Return a dict that maps slot names to slot values, but only include slots that have been assigned to. - Looks up slots in base types as well as the current type. - - Sort-of Python equivalent (doesn't look up base slots, while the real code does): - return dict([(slot, getattr(self, slot)) for slot in type(self).__slots__ if hasattr(self, slot)]) - - Return null if the object has no __slots__, or empty dict if it has __slots__ but none are initialized. - - - - - Implements the default __reduce_ex__ method as specified by PEP 307 case 2 (new-style instance, protocol 0 or 1) - - - - - Returns the closest base class (in terms of MRO) that isn't defined in Python code - - - - - Implements the default __reduce_ex__ method as specified by PEP 307 case 3 (new-style instance, protocol 2) - - - - - Contains functions that are called directly from - generated code to perform low-level runtime functionality. - - - - - Creates a new dictionary extracting the keys and values from the - provided data array. Keys/values are adjacent in the array with - the value coming first. - - - - - Creates a new dictionary extracting the keys and values from the - provided data array. Keys/values are adjacent in the array with - the value coming first. - - - - - Wraps up all the semantics of multiplying sequences so that all of our sequences - don't duplicate the same logic. When multiplying sequences we need to deal with - only multiplying by valid sequence types (ints, not floats), support coercion - to integers if the type supports it, not multiplying by None, and getting the - right semantics for multiplying by negative numbers and 1 (w/ and w/o subclasses). - - This function assumes that it is only called for case where count is not implicitly - coercible to int so that check is skipped. - - - - - Supports calling of functions that require an explicit 'this' - Currently, we check if the function object implements the interface - that supports calling with 'this'. If not, the 'this' object is dropped - and a normal call is made. - - - - - Called from generated code emitted by NewTypeMaker. - - - - - Handles the descriptor protocol for user-defined objects that may implement __get__ - - - - - Handles the descriptor protocol for user-defined objects that may implement __set__ - - - - - Handles the descriptor protocol for user-defined objects that may implement __delete__ - - - - - Python runtime helper for raising assertions. Used by AssertStatement. - - - - - Python runtime helper for raising assertions. Used by AssertStatement. - - Object representing the assertion message - - - - Python runtime helper to create instance of Python List object. - - New instance of List - - - - Python runtime helper to create a populated instance of Python List object. - - - - - Python runtime helper to create a populated instance of Python List object w/o - copying the array contents. - - - - - Python runtime helper to create a populated instance of Python List object. - - List is populated by arbitrary user defined object. - - - - - Python runtime helper to create an instance of Python List object. - - List has the initial provided capacity. - - - - - Python runtime helper to create an instance of Tuple - - - - - - - Python runtime helper to create an instance of Tuple - - - - - - Python Runtime Helper for enumerator unpacking (tuple assignments, ...) - Creates enumerator from the input parameter e, and then extracts - expected number of values, returning them as array - - If the input is a Python tuple returns the tuples underlying data array. Callers - should not mutate the resulting tuple. - - The code context of the AST getting enumerator values. - object to enumerate - expected number of objects to extract from the enumerator - - array of objects (.Lengh == expected) if exactly expected objects are in the enumerator. - Otherwise throws exception - - - - - Python runtime helper to create instance of Slice object - - Start of the slice. - End of the slice. - Step of the slice. - Slice - - - - Prints newline into default standard output - - - - - Prints newline into specified destination. Sets softspace property to false. - - - - - Prints value into default standard output with Python comma semantics. - - - - - Prints value into specified destination with Python comma semantics. - - - - - Called from generated code when we are supposed to print an expression value - - - - - Called from generated code for: - - import spam.eggs - - - - - Python helper method called from generated code for: - - import spam.eggs as ham - - - - - Called from generated code for: - - from spam import eggs1, eggs2 - - - - - Imports one element from the module in the context of: - - from module import a, b, c, d - - Called repeatedly for all elements being imported (a, b, c, d above) - - - - - Called from generated code for: - - from spam import * - - - - - Unqualified exec statement support. - A Python helper which will be called for the statement: - - exec code - - - - - Qualified exec statement support, - Python helper which will be called for the statement: - - exec code in globals [, locals ] - - - - - Called from generated code at the start of a catch block. - - - - - Get an exception tuple for the "current" exception. This is used for sys.exc_info() - - - - - Get an exception tuple for a given exception. This is like the inverse of MakeException. - - the code context - the exception to create a tuple for. - a tuple of (type, value, traceback) - This is called directly by the With statement so that it can get an exception tuple - in its own private except handler without disturbing the thread-wide sys.exc_info(). - - - - helper function for re-raised exceptions. - - - - - helper function for re-raised exception. - This entry point is used by 'raise' inside 'with' statement - - - - - - - helper function for non-re-raise exceptions. - - type is the type of exception to throw or an instance. If it - is an instance then value should be null. - - If type is a type then value can either be an instance of type, - a Tuple, or a single value. This case is handled by EC.CreateThrowable. - - - - - Extracts an argument from either the dictionary or params - - - - - Creates a new array the values set to Uninitialized.Instance. The array - is large enough to hold for all of the slots allocated for the type and - its sub types. - - - - - Helper to determine if the value is a simple numeric type (int or big int or bool) - used for OldInstance - deprecated form of slicing. - - - - - Helper to determine if the type is a simple numeric type (int or big int or bool) - used for OldInstance - deprecated form of slicing. - - - - - Helper to determine if the type is a simple numeric type (int or big int or bool) but not a subclass - - - - - For slicing. Fixes up a BigInteger and returns an integer w/ the length of the - object added if the value is negative. - - - - - For slicing. Gets the length of the object, used to only get the length once. - - - - - Helper method for DynamicSite rules that check the version of their dynamic object - TODO - Remove this method for more direct field accesses - - - - - - - - Called from generated code. Gets a builtin function and the BuiltinFunctionData associated - with the object. Tests to see if the function is bound and has the same data for the generated - rule. - - - - - Convert object to a given type. This code is equivalent to NewTypeMaker.EmitConvertFromObject - except that it happens at runtime instead of compile time. - - - - - Provides access to AppDomain.DefineDynamicAssembly which cannot be called from a DynamicMethod - - - - - Generates a new delegate type. The last type in the array is the return type. - - - - - Generates a new delegate type. The last type in the array is the return type. - - - - - Provides the entry point for a compiled module. The stub exe calls into InitializeModule which - does the actual work of adding references and importing the main module. Upon completion it returns - the exit code that the program reported via SystemExit or 0. - - - - - Provides the entry point for a compiled module. The stub exe calls into InitializeModule which - does the actual work of adding references and importing the main module. Upon completion it returns - the exit code that the program reported via SystemExit or 0. - - - - - Called from generated code, helper to remove a name - - - - - Called from generated code, helper to do name lookup - - - - - Called from generated code, helper to do name assignment - - - - - Returns an IntPtr in the proper way to CPython - an int or a Python long - - - - - Create at TypeError exception for when Raise() can't create the exception requested. - - original type of exception requested - a TypeEror exception - - - - Gets a list of DynamicStackFrames for the given exception. These stack frames - can be programmatically inspected to understand the frames the exception crossed - through including Python frames. - - Dynamic stack frames are not preserved when an exception crosses an app domain - boundary. - - - - - Helper clas for calls to unicode(...). We generate code which checks if unicode - is str and if it is we redirect those calls to the unicode function defined on this - class. - - - - - Looks up __init__ avoiding calls to __getattribute__ and handling both - new-style and old-style classes in the MRO. - - - - - Gets a builtin function for the given declaring type and member infos. - - Given the same inputs this always returns the same object ensuring there's only 1 builtinfunction - for each .NET method. - - This method takes both a cacheName and a pythonName. The cache name is the real method name. The pythonName - is the name of the method as exposed to Python. - - - - - Checks to see if the provided members are always visible for the given type. - - This filters out methods such as GetHashCode and Equals on standard .NET - types that we expose directly as Python types (e.g. object, string, etc...). - - It also filters out the base helper overrides that are added for supporting - super calls on user defined types. - - - - - a function is static if it's a static .NET method and it's defined on the type or is an extension method - with StaticExtensionMethod decoration. - - - - - If we have only interfaces, we'll need to insert object's base - - - - - ExtensibleString is the base class that is used for types the user defines - that derive from string. It carries along with it the string's value and - our converter recognizes it as a string. - - - - - StringOps is the static class that contains the methods defined on strings, i.e. 'abc' - - Here we define all of the methods that a Python user would see when doing dir('abc'). - If the user is running in a CLS aware context they will also see all of the methods - defined in the CLS System.String type. - - - - - Returns a copy of this string converted to uppercase - - - - - return true if self is a titlecased string and there is at least one - character in self; also, uppercase characters may only follow uncased - characters (e.g. whitespace) and lowercase characters only cased ones. - return false otherwise. - - - - - Return a string which is the concatenation of the strings - in the sequence seq. The separator between elements is the - string providing this method - - - - - Replaces each replacement field in the string with the provided arguments. - - replacement_field = "{" field_name ["!" conversion] [":" format_spec] "}" - field_name = (identifier | integer) ("." identifier | "[" element_index "]")* - - format_spec: [[fill]align][sign][#][0][width][,][.precision][type] - - Conversion can be 'r' for repr or 's' for string. - - - - - Replaces each replacement field in the string with the provided arguments. - - replacement_field = "{" field_name ["!" conversion] [":" format_spec] "}" - field_name = (identifier | integer) ("." identifier | "[" element_index "]")* - - format_spec: [[fill]align][sign][#][0][width][.precision][type] - - Conversion can be 'r' for repr or 's' for string. - - - - - Gets the starting offset checking to see if the incoming bytes already include a preamble. - - - - When encoding or decoding strings if an error occurs CPython supports several different - behaviors, in addition it supports user-extensible behaviors as well. For the default - behavior we're ok - both of us support throwing and replacing. For custom behaviors - we define a single fallback for decoding and encoding that calls the python function to do - the replacement. - - When we do the replacement we call the provided handler w/ a UnicodeEncodeError or UnicodeDecodeError - object which contains: - encoding (string, the encoding the user requested) - end (the end of the invalid characters) - object (the original string being decoded) - reason (the error, e.g. 'unexpected byte code', not sure of others) - start (the start of the invalid sequence) - - The decoder returns a tuple of (unicode, int) where unicode is the replacement string - and int is an index where encoding should continue. - - - - Indexer for generic parameter resolution. We bind to one of the generic versions - available in this type collision. A user can also do someType[()] to force to - bind to the non-generic version, but we will always present the non-generic version - when no bindings are available. - - - - - Object.ToString() displays the CLI type name. But we want to display the class name (e.g. - '<foo object at 0x000000000000002C>' unless we've overridden __repr__ but not __str__ in - which case we'll display the result of __repr__. - - - - - Provides a debug view for user defined types. This class is declared as public - because it is referred to from generated code. You should not use this class. - - - - - Manages the acquisition of profiling data for a single ScriptRuntime - - - - - Get the unique Profiler instance for this ScriptRuntime - - - - - Given a MethodBase, return an index into the array of perf data. Treat each - CLR method as unique. - - - - - Given the unique name of something we're profiling, return an index into the array of perf data. - - - - - Add a new profiler entry. Not all names are unique. - - - - - Gets the current summary of profile data - - - - - Resets the current summary of profile data back to zero - - - - - Adds profiling calls to a Python method. - Calculates both the time spent only in this method - - - - - Wraps a call to a MethodInfo with profiling capture for that MethodInfo - - - - - Encapsulates profiler data to return to clients - - - - - Marks that this built-in method should be treated as external by the profiler. - When placed on a call emitted into a Python method, all the time spent in this - call will still show up in its parent's inclusive time, but will not be - part of its exclusive time. - - - - - Simple implementation of ASCII encoding/decoding. The default instance (PythonAsciiEncoding.Instance) is - setup to always convert even values outside of the ASCII range. The EncoderFallback/DecoderFallbacks can - be replaced with versions that will throw exceptions instead though. - - - - - A DynamicMetaObject which is just used to support custom conversions to COM. - - - - - A marker interface so we can recognize and access sequence members on our array objects. - - - - stored for copy_reg module, used for reduce protocol - - - stored for copy_reg module, used for reduce protocol - - - - Creates a new PythonContext not bound to Engine. - - - - - Gets or sets the maximum depth of function calls. Equivalent to sys.getrecursionlimit - and sys.setrecursionlimit. - - - - - Gets or sets the main thread which should be interupted by thread.interrupt_main - - - - - Checks to see if module state has the current value stored already. - - - - - Gets per-runtime state used by a module. The module should have a unique key for - each piece of state it needs to store. - - - - - Sets per-runtime state used by a module. The module should have a unique key for - each piece of state it needs to store. - - - - - Sets per-runtime state used by a module and returns the previous value. The module - should have a unique key for each piece of state it needs to store. - - - - - Sets per-runtime state used by a module and returns the previous value. The module - should have a unique key for each piece of state it needs to store. - - - - - Initializes the sys module on startup. Called both to load and reload sys - - - - - Reads one line keeping track of the # of bytes read - - - - - We use Assembly.LoadFile to load assemblies from a path specified by the script (in LoadAssemblyFromFileWithPath). - However, when the CLR loader tries to resolve any of assembly references, it will not be able to - find the dependencies, unless we can hook into the CLR loader. - - - - - Returns (and creates if necessary) the PythonService that is associated with this PythonContext. - - The PythonService is used for providing remoted convenience helpers for the DLR hosting APIs. - - - - - Gets or sets the default encoding for this system state / engine. - - - - - Dictionary from name to type of all known built-in module names. - - - - - Dictionary from type to name of all built-in modules. - - - - - TODO: Remove me, or stop caching built-ins. This is broken if the user changes __builtin__ - - - - - Gets the member names associated with the object - TODO: Move "GetMemberNames" functionality into MetaObject implementations - - - - Dictionary of error handlers for string codecs. - - - Table of functions used for looking for additional codecs. - - - - Gets a SiteLocalStorage when no call site is available. - - - - - Invokes the specified operation on the provided arguments and returns the new resulting value. - - operation is usually a value from StandardOperators (standard CLR/DLR operator) or - OperatorStrings (a Python specific operator) - - - - - Returns a shared code context for the current PythonContext. This shared - context can be used for performing general operations which usually - require a CodeContext. - - - - - Returns an overload resolver for the current PythonContext. The overload - resolver will flow the shared context through as it's CodeContext. - - - - - Returns a shared code context for the current PythonContext. This shared - context can be used for doing lookups which need to occur as if they - happened in a module which has done "import clr". - - - - - Sets the current command dispatcher for the Python command line. The previous dispatcher - is returned. Null can be passed to remove the current command dispatcher. - - The command dispatcher will be called with a delegate to be executed. The command dispatcher - should invoke the target delegate in the desired context. - - A common use for this is to enable running all REPL commands on the UI thread while the REPL - continues to run on a non-UI thread. - - The ipy.exe REPL will call into PythonContext.DispatchCommand to dispatch each execution to - the correct thread. Other REPLs can do the same to support this functionality as well. - - - - - Dispatches the command to the current command dispatcher. If there is no current command - dispatcher the command is executed immediately on the current thread. - - - - - Gets a function which can be used for comparing two values. If cmp is not null - then the comparison will use the provided comparison function. Otherwise - it will use the normal Python semantics. - - If type is null then a generic comparison function is returned. If type is - not null a comparison function is returned that's used for just that type. - - - - - Performs a GC collection including the possibility of freeing weak data structures held onto by the Python runtime. - - - - - - Gets a PythonContext given a DynamicMetaObjectBinder. - - - - - List of unary operators which we have sites for to enable fast dispatch that - doesn't collide with other operators. - - - - - Note: - IEnumerator innerEnum = Dictionary<K,V>.KeysCollections.GetEnumerator(); - innerEnum.MoveNext() will throw InvalidOperation even if the values get changed, - which is supported in python - - - - - Note: - IEnumerator innerEnum = Dictionary<K,V>.KeysCollections.GetEnumerator(); - innerEnum.MoveNext() will throw InvalidOperation even if the values get changed, - which is supported in python - - - - - Note: - IEnumerator innerEnum = Dictionary<K,V>.KeysCollections.GetEnumerator(); - innerEnum.MoveNext() will throw InvalidOperation even if the values get changed, - which is supported in python - - - - - A DynamicStackFrame which has Python specific data. Currently this - includes the code context which may provide access to locals and the - function code object which is needed to build frame objects from. - - - - - Gets the code context of the function. - - If the function included a call to locals() or the FullFrames - option is enabled then the code context includes all local variables. - - Null if deserialized. - - - - - Gets the code object for this frame. This is used in creating - the trace back. Null if deserialized. - - - - - Sets the mode to text or binary. Returns true if previously set to text, false if previously set to binary. - - - - - Truncates the file to the current length as indicated by tell(). - - - - - Truncates the file to the specified length. - - - - - - Created for a user-defined function. - - - - - Python ctor - maps to function.__new__ - - y = func(x.__code__, globals(), 'foo', None, (a, )) - - - - - The parent CodeContext in which this function was declared. - - - - - Captures the # of args and whether we have kw / arg lists. This - enables us to share sites for simple calls (calls that don't directly - provide named arguments or the list/dict params). - - - - - Calculates the _compat value which is used for call-compatibility checks - for simple calls. Whenver any of the dependent values are updated this - must be called again. - - The dependent values include: - _nparams - this is readonly, and never requies an update - _defaults - the user can mutate this (func_defaults) and that forces - an update - expand dict/list - based on nparams and flags, both read-only - - Bits are allocated as: - 00003fff - Normal argument count - 0fffb000 - Default count - 10000000 - unused - 20000000 - expand list - 40000000 - expand dict - 80000000 - unused - - Enforce recursion is added at runtime. - - - - - Generators w/ exception handling need to have some data stored - on them so that we appropriately set/restore the exception state. - - - - - Returns an ID for the function if one has been assigned, or zero if the - function has not yet required the use of an ID. - - - - - Gets the position for the expand list argument or -1 if the function doesn't have an expand list parameter. - - - - - Gets the position for the expand dictionary argument or -1 if the function doesn't have an expand dictionary parameter. - - - - - Gets the number of normal (not params or kw-params) parameters. - - - - - Gets the number of extra arguments (params or kw-params) - - - - - Marks a member as being hidden from Python code. - - - - - Marks a class as being hidden from the Python hierarchy. This is applied to the base class - and then all derived types will not see the base class in their hierarchy and will not be - able to access members declaredo on the base class. - - - - - Python module. Stores classes, functions, and data. Usually a module - is created by importing a file or package from disk. But a module can also - be directly created by calling the module type and providing a name or - optionally a documentation string. - - - - - Creates a new module backed by a Scope. Used for creating modules for foreign Scope's. - - - - - Creates a new PythonModule with the specified dictionary. - - Used for creating modules for builtin modules which don't have any code associated with them. - - - - - This assembly-level attribute specifies which types in the engine represent built-in Python modules. - - Members of a built-in module type should all be static as an instance is never created. - - - - - Creates a new PythonModuleAttribute that can be used to specify a built-in module that exists - within an assembly. - - The built-in module name - The type that implements the built-in module. - The valid platform identifiers for this module. - - - - The built-in module name - - - - - The type that implements the built-in module - - - - - Provides human readable names for how Python maps the various DLR NarrowingLevel's. - - - - - No narrowing conversions are performed - - - - - Double/Single to Decimal - PythonTuple to Array - Generic conversions - BigInteger to Int64 - - - - - Numeric conversions excluding from floating point values - Boolean conversions - Delegate conversions - Enumeration conversions - - - - - Enables Python protocol conversions (__int__, etc...) - - - - - Provides storage of IronPython specific data in the DLR Scope ScopeExtension. - - This enables IronPython to track code compilation flags such as from __future__ - flags and import clr flags across multiple executions of user-provided scopes. - - - - - Return a copy of this tuple's data array. - - - - - public class to get optimized - - - - - Marks a type as being a PythonType for purposes of member lookup, creating instances, etc... - - If defined a PythonType will use __new__ / __init__ when creating instances. This allows the - object to match the native Python behavior such as returning cached values from __new__ or - supporting initialization to run multiple times via __init__. - - The attribute also allows you to specify an alternate type name. This allows the .NET name to - be different from the Python name so they can follow .NET naming conventions. - - Types defining this attribute also don't show CLR methods such as Equals, GetHashCode, etc... until - the user has done an import clr. - - - - - Provides dictionary based storage which is backed by a Scope object. - - - - - Provides more specific type information for Python lists which are not strongly typed. - - This attribute can be applied to fields, parameters, proeprties, and return values. It can be - inspected to get type information about the types of the values of the expected - list or the returned list. - - - - - Mutable set class - - - - - Appends an IEnumerable to an existing set - - - - - Immutable set class - - - - - Iterator over sets - - - - - General-purpose storage used for Python sets and frozensets. - - The set storage is thread-safe for multiple readers or writers. - - Mutations to the set involve a simple locking strategy of locking on the SetStorage object - itself to ensure mutual exclusion. - - Reads against the set happen lock-free. When the set is mutated, it adds or removes buckets - in an atomic manner so that the readers will see a consistent picture as if the read - occurred either before or after the mutation. - - - - - Creates a new set storage with no buckets - - - - - Creates a new set storage with no buckets - - - - - Returns the number of items currently in the set - - - - - Adds a new item to the set, unless an equivalent item is already present - - - - - Static helper which adds the given non-null item with a precomputed hash code. Returns - true if the item was added, false if it was already present in the set. - - - - - Lock-free helper on a non-null item with a pre-calculated hash code. Removes the item - if it is present in the set, otherwise adds it. - - - - - Clears the contents of the set - - - - - Clones the set, returning a new SetStorage object - - - - - Checks to see if the given item exists in the set - - - - - Checks to see if the given item exists in the set, and tries to hash it even - if it is known not to be in the set. - - - - - - - Adds items from this set into the other set - - - - - Removes the first set element in the iteration order. - - true if an item was removed, false if the set was empty - - - - Removes an item from the set and returns true if it was present, otherwise returns - false - - - - - Removes an item from the set and returns true if it was removed. The item will always - be hashed, throwing if it is unhashable - even if the set has no buckets. - - - - - Lock-free helper to remove a non-null item - - - - - Determines whether the current set shares no elements with the given set - - - - - Determines whether the current set is a subset of the given set - - - - - Determines whether the current set is a strict subset of the given set - - - - - Mutates this set to contain its union with 'other'. The caller must lock the current - set if synchronization is desired. - - - - - Mutates this set to contain its intersection with 'other'. The caller must lock the - current set if synchronization is desired. - - - - - Mutates this set to contain its symmetric difference with 'other'. The caller must - lock the current set if synchronization is desired. - - - - - Mutates this set to contain its difference with 'other'. The caller must lock the - current set if synchronization is desired. - - - - - Computes the union of self and other, returning an entirely new set. This method is - thread-safe and makes no modifications to self or other. - - - - - Computes the intersection of self and other, returning an entirely new set. This - method is thread-safe and makes no modifications to self or other. - - - - - Computes the symmetric difference of self and other, returning an entirely new set. - This method is thread-safe and makes no modifications to self or other. - - - - - Computes the difference of self and other, returning an entirely new set. This - method is thread-safe and makes no modifications to self or other. - - - - - Used to store a single hashed item. - - Bucket is not serializable because it stores the computed hash code, which could change - between serialization and deserialization. - - - - - Helper to hash the given item w/ support for null - - - - - Helper which ensures that the first argument x requires the least work to enumerate - - - - - A factory which creates a SetStorage object from any Python iterable. It extracts - the underlying storage of a set or frozen set without copying, which is left to the - caller if necessary. - - - - - A factory which creates a SetStorage object from any Python iterable. It extracts - the underlying storage of a set or frozen set without copying, which is left to the - caller if necessary. - Returns true if the given object was a set or frozen set, false otherwise. - - - - - A factory which creates a SetStorage object from any Python iterable. It extracts - the underlying storage of a set or frozen set, copying in the former case, to return - a SetStorage object that is guaranteed not to receive any outside mutations. - - - - - Extracts the SetStorage object from o if it is a set or frozenset and returns true. - Otherwise returns false. - - - - - Creates a hashable set from the given set, or does nothing if the given object - is not a set. - - True if o is a set or frozenset, false otherwise - - - - Provides storage which is flowed into a callers site. The same storage object is - flowed for multiple calls enabling the callee to cache data that can be re-used - across multiple calls. - - Data is a public field so that this works properly with DynamicSite's as the reference - type (and EnsureInitialize) - - - - - Gets the indices for the deprecated __getslice__, __setslice__, __delslice__ functions - - This form is deprecated in favor of using __getitem__ w/ a slice object as an index. This - form also has subtly different mechanisms for fixing the slice index before calling the function. - - If an index is negative and __len__ is not defined on the object than an AttributeError - is raised. - - - - - Provides a representation and parsing for the default formatting specification. This is used - by object.__format__, int.__format__, long.__format__, and float.__format__ to do the common - format spec parsing. - - The default specification is: - - format_spec = [[fill]align][sign][#][0][width][,][.precision][type] - fill = a character other than } - align = "<" | ">" | "=" | "^" - sign = "+" | "-" | " " - width = integer - precision = integer - type = "b" | "c" | "d" | "e" | "E" | "f" | "F" | "g" | "G" | "n" | "o" | "x" | "X" | "%" - - - - - Parses a format spec and returns a new StringFormatSpec object. - - - - - StringFormatter provides Python's % style string formatting services. - - - - - Read a possible mapping key for %(key)s. - - The key name enclosed between the '%(key)s', - or null if there are no paranthesis such as '%s'. - - - - AppendBase appends an integer at the specified radix doing all the - special forms for Python. We have a copy and paste version of this - for BigInteger below that should be kept in sync. - - - - - BigInteger version of AppendBase. Should be kept in sync w/ AppendBase - - - - - Optimized storage for setting exc_type, exc_value, and exc_traceback. - - This optimization can go away in Python 3.0 when these attributes are no longer used. - - - - - BuiltinFunction represents any standard CLR function exposed to Python. - This is used for both methods on standard Python types such as list or tuple - and for methods from arbitrary .NET assemblies. - - All calls are made through the optimizedTarget which is created lazily. - - TODO: Back BuiltinFunction's by MethodGroup's. - - - - - Creates a new builtin function for a static .NET function. This is used for module methods - and well-known __new__ methods. - - - - - Creates a built-in function for a .NET method declared on a type. - - - - - Creates a bound built-in function. The instance may be null for built-in functions - accessed for None. - - - - - Returns a BuiltinFunction bound to the provided type arguments. Returns null if the binding - cannot be performed. - - - - - Returns a descriptor for the built-in function if one is - neededed - - - - - Gets the target methods that we'll be calling. - - - - - True if the method should be visible to non-CLS opt-in callers - - - - - Makes a test for the built-in function against the private _data - which is unique per built-in function. - - - - - Helper for generating the call to a builtin function. This is used for calls from built-in method - descriptors and built-in functions w/ and w/o a bound instance. - - This provides all sorts of common checks on top of the call while the caller provides a delegate - to do the actual call. The common checks include: - check for generic-only methods - reversed operator support - transforming arguments so the default binder can understand them (currently user defined mapping types to PythonDictionary) - returning NotImplemented from binary operators - Warning when calling certain built-in functions - - - The call binder we're doing the call for - An expression which points to the code context - the meta object for the built in function - true if we're calling with an instance - The arguments being passed to the function - A restriction for the built-in function, method desc, etc... - A delegate to perform the actual call to the method. - - - - Provides (for reflected methods) a mapping from a signature to the exact target - which takes this signature. - signature with syntax like the following: - someClass.SomeMethod.Overloads[str, int]("Foo", 123) - - - - - Gets the overload dictionary for the logical function. These overloads - are never bound to an instance. - - - - - Returns the instance used for binding. This differs on module functions implemented - using instance methods so the built-in functions there don't expose the instance. - - - - - A custom built-in function which supports indexing - - - - - Use indexing on generic methods to provide a new reflected method with targets bound with - the supplied type arguments. - - - - - Find matching overloads by checking signature against available targets - - Given signature - List of possible targets - If set to true, the method will check whether the first paramter of the - target is of the type CodeContext and removes it - Possible overloads - - - - Throws a formatted exception if no overload matchs. - - Passed signature which should be used - Given targets, which does not fit to the signature - - - - - - - Provides a CustomTracker which handles special fields which have custom - behavior on get/set. - - - - - Provides custom, versioned, dictionary access for instances. Used for both - new-style and old-style instances. - - Each class can allocate a version for instance storage using the - CustomInstanceDictionaryStorage.AllocateInstance method. The version allocated - is dependent upon the names which are likely to appear in the instance - dictionary. Currently these names are calculated by collecting the names - that are assigned to during the __init__ method and combining these with - all such names in the types MRO. - - When creating the dictionary for storing instance values the class can then create - a PythonDictionary backed by a CustomInstanceDictionaryStorage with it's - version. When doing a get/set optimized code can then be produced that - verifies we have CustomInstanceDictionaryStorage and it has the - correct version. If we have a matching dictionary then gets/sets can turn - into simple array accesses rather than dictionary gets/sets. For programs - which access a large number of instance variables this can dramatically - speed up the program. - - TODO: Should we attempt to unify all versions which share the same keys? - - - - - Creates a DLR OverloadDoc object which describes information about this overload. - - The method to document - The name of the method if it should override the name in the MethodBase - Parameters to skip at the end - used for removing the value on a setter method - true to include self on instance methods - - - - Converts a Type object into a string suitable for lookup in the help file. All generic types are - converted down to their generic type definition. - - - - - Gets the XPathDocument for the specified assembly, or null if one is not available. - - - - - Gets the Xml documentation for the specified MethodBase. - - - - - Gets the Xml documentation for the specified Type. - - - - - Gets the Xml documentation for the specified Field. - - - - - Gets the Xml documentation for the specified Field. - - - - - Converts the XML as stored in the config file into a human readable string. - - - - - Marks a type as being a suitable type to be used for user-defined classes. - - The requirements for this are that a type has to follow the patterns - that NewTypeMaker derived types follow. This includes: - The type's constructors must all take PythonType as the 1st parameter - which sets the underlying type for the actual object - The type needs to implement IPythonObject - Dictionary-based storage needs to be provided for setting individual members - Virtual methods exposed to Python need to support checking the types dictionary for invocations - - - - - Represents a set of attributes that different functions can have. - - - - No flags have been set - - - This is a function w/ no instance pointer - - - This is a method that requires an instance - - - Built-in functions can encapsulate both methods and functions, in which case both bits are set - - - True is the function/method should be visible from pure-Python code - - - True if this is a __r*__ method for a CLS overloaded operator method - - - - This method represents a binary operator method for a CLS overloaded operator method. - - Being a binary operator causes the following special behaviors to kick in: - A failed binding at call time returns NotImplemented instead of raising an exception - A reversed operator will automatically be created if: - 1. The parameters are both of the instance type - 2. The parameters are in reversed order (other, this) - - This enables simple .NET operator methods to be mapped into the Python semantics. - - - - - A method declared on a built-in module - - - - - Base class for helper which creates instances. We have two derived types: One for user - defined types which prepends the type before calling, and one for .NET types which - doesn't prepend the type. - - - - - This interface is used for implementing parts of the IronPython type system. It - is not intended for consumption from user programs. - - - - - Thread-safe dictionary set. Returns the dictionary set or the previous value if already set or - null if the dictionary set isn't supported. - - - - - - - Dictionary replacement. Returns true if replaced, false if the dictionary set isn't supported. - - - - - - - Calculates the method resolution order for a Python class - the rules are: - If A is a subtype of B, then A has precedence (A > B) - If C appears before D in the list of bases then C > D - If E > F in one __mro__ then E > F in all __mro__'s for our subtype - - class A(object): pass - class B(object): pass - class C(B): pass - class N(A,B,C): pass # illegal - - This is because: - C.__mro__ == (C, B, object) - N.__mro__ == (N, A, B, C, object) - which would conflict, but: - - N(B,A) is ok (N, B, a, object) - N(C, B, A) is ok (N, C, B, A, object) - - Calculates a C3 MRO as described in "The Python 2.3 Method Resolution Order" - plus support for old-style classes. - - We build up a list of our base classes MRO's plus our base classes themselves. - We go through the list in order. Look at the 1st class in the current list, and - if it's not the non-first class in any other list then remove it from all the lists - and append it to the mro. Otherwise continue to the next list. If all the classes at - the start are no-good then the MRO is bad and we throw. - - For old-style classes if the old-style class is the only one in the list of bases add - it as a depth-first old-style MRO, otherwise compute a new-style mro for all the classes - and use that. - - - - - - - - - Contains helper methods for converting C# names into Python names. - - - - - TypeInfo captures the minimal CLI information required by NewTypeMaker for a Python object - that inherits from a CLI type. - - - - - "bases" contains a set of PythonTypes. These can include types defined in Python (say cpy1, cpy2), - CLI types (say cCLI1, cCLI2), and CLI interfaces (say iCLI1, iCLI2). Here are some - examples of how this works: - - (bases) => baseType, {interfaceTypes} - - (cpy1) => System.Object, {} - (cpy1, cpy2) => System.Object, {} - (cpy1, cCLI1, iCLI1, iCLI2) => cCLI1, {iCLI1, iCLI2} - [some type that satisfies the line above] => - cCLI1, {iCLI1, iCLI2} - (cCLI1, cCLI2) => error - - - - - Filters out old-classes and throws if any non-types are included, returning a - yielding the remaining PythonType objects. - - - - - Python class hierarchy is represented using the __class__ field in the object. It does not - use the CLI type system for pure Python types. However, Python types which inherit from a - CLI type, or from a builtin Python type which is implemented in the engine by a CLI type, - do have to use the CLI type system to interoperate with the CLI world. This means that - objects of different Python types, but with the same CLI base type, can use the same CLI type - - they will just have different values for the __class__ field. - - The easiest way to inspect the functionality implemented by NewTypeMaker is to persist the - generated IL using "ipy.exe -X:SaveAssemblies", and then inspect the - persisted IL using ildasm. - - - - - Loads any available new types from the provided assembly and makes them - available via the GetNewType API. - - - - - Is this a type used for instances Python types (and not for the types themselves)? - - - - - Gets the position for the parameter which we are overriding. - - - - - - - - - Defines an interface on the type that forwards all calls - to a helper method in UserType. The method names all will - have Helper appended to them to get the name for UserType. The - UserType version should take 1 extra parameter (self). - - - - - Overrides methods - this includes all accessible virtual methods as well as protected non-virtual members - including statics and non-statics. - - - - - Loads all the incoming arguments and forwards them to mi which - has the same signature and then returns the result - - - - - Emits code to check if the class has overridden this specific - function. For example: - - MyDerivedType.SomeVirtualFunction = ... - or - - class MyDerivedType(MyBaseType): - def SomeVirtualFunction(self, ...): - - - - - - Emit code to convert object to a given type. This code is semantically equivalent - to PythonBinder.EmitConvertFromObject, except this version accepts ILGen whereas - PythonBinder accepts Compiler. The Binder will chagne soon and the two will merge. - - - - - Emits code to check if the class has overridden this specific - function. For example: - - MyDerivedType.SomeVirtualFunction = ... - or - - class MyDerivedType(MyBaseType): - def SomeVirtualFunction(self, ...): - - - - - - Emits the call to lookup a member defined in the user's type. Returns - the local which stores the resulting value and leaves a value on the - stack indicating the success of the lookup. - - - - - Creates a method for doing a base method dispatch. This is used to support - super(type, obj) calls. - - - - - Generates stub to receive the CLR call and then call the dynamic language code. - This code is same as StubGenerator.cs in the Microsoft.Scripting, except it - accepts ILGen instead of Compiler. - - - - - Called from PythonTypeOps - the BuiltinFunction._function lock must be held. - - - - - Same as the DLR ReturnFixer, but accepts lower level constructs, - such as LocalBuilder, ParameterInfos and ILGen. - - - - - Returns the dictionary used to store state for this object - - - - - OperatorMapping provides a mapping from DLR operators to their associated .NET methods. - - - - - Given an operator returns the OperatorMapping associated with the operator or null - - - - - The operator the OperatorMapping provides info for. - - - - - The primary method name associated with the method. This method name is - usally in the form of op_Operator (e.g. op_Addition). - - - - - The secondary method name associated with the method. This method name is - usually a standard .NET method name with pascal casing (e.g. Add). - - - - - The return type that must match for the alternate operator to be valid. - - This is available alternate operators don't have special names and therefore - could be confused for a normal method which isn't fulfilling the contract. - - - - - Cached CallSites. User types are cached on the PythonType and System types are cached on the - PythonContext to avoid cross-runtime contamination due to the binder on the site. - - - - - Represents a PythonType. Instances of PythonType are created via PythonTypeBuilder. - - - - - Provides delegates that will invoke a parameterless type ctor. The first key provides - the dictionary for a specific type, the 2nd key provides the delegate for a specific - call site type used in conjunction w/ our IFastInvokable implementation. - - - - - Shared built-in functions for creating instances of user defined types. Because all - types w/ the same UnderlyingSystemType share the same constructors these can be - shared across multiple types. - - - - - Creates a new type for a user defined type. The name, base classes (a tuple of type - objects), and a dictionary of members is provided. - - - - - Creates a new type for a user defined type. The name, base classes (a tuple of type - objects), and a dictionary of members is provided. - - - - - Creates a new PythonType object which is backed by the specified .NET type for - storage. The type is considered a system type which can not be modified - by the user. - - - - - - Creates a new PythonType which is a subclass of the specified PythonType. - - Used for runtime defined new-style classes which require multiple inheritance. The - primary example of this is the exception system. - - - - - Creates a new PythonType which is a subclass of the specified PythonTypes. - - Used for runtime defined new-style classes which require multiple inheritance. The - primary example of this is the exception system. - - - - - Creates a new PythonType which is a subclass of the specified PythonTypes. - - Used for runtime defined new-style classes which require multiple inheritance. The - primary example of this is the exception system. - - - - - Creates a new PythonType which is a subclass of the specified PythonType. - - Used for runtime defined new-style classes which require multiple inheritance. The - primary example of this is the exception system. - - - - - Creates a new PythonType which is a subclass of the specified PythonTypes. - - Used for runtime defined new-style classes which require multiple inheritance. The - primary example of this is the exception system. - - - - - Creates a new PythonType which is a subclass of the specified PythonTypes. - - Used for runtime defined new-style classes which require multiple inheritance. The - primary example of this is the exception system. - - - - - Creates a new PythonType object which represents an Old-style class. - - - - - Used in copy_reg which is the only consumer of __flags__ in the standard library. - - Set if the type is user defined - - - - - Set if the type has __abstractmethods__ defined - - - - - Check whether the current type is iterabel - - - True if it is iterable - - - - Returns true if the specified object is an instance of this type. - - - - - Gets the name of the dynamic type - - - - - Gets the resolution order used for attribute lookup - - - - - Gets the dynamic type that corresponds with the provided static type. - - Returns null if no type is available. TODO: In the future this will - always return a PythonType created by the DLR. - - - - - - - Sets the python type that corresponds with the provided static type. - - This is used for built-in types which have a metaclass. Currently - only used by ctypes. - - - - - Allocates the storage for the instance running the .NET constructor. This provides - the creation functionality for __new__ implementations. - - - - - Allocates the storage for the instance running the .NET constructor. This provides - the creation functionality for __new__ implementations. - - - - - Allocates the storage for the instance running the .NET constructor. This provides - the creation functionality for __new__ implementations. - - - - - Allocates the storage for the instance running the .NET constructor. This provides - the creation functionality for __new__ implementations. - - - - - Allocates the storage for the instance running the .NET constructor. This provides - the creation functionality for __new__ implementations. - - - - - Allocates the storage for the instance running the .NET constructor. This provides - the creation functionality for __new__ implementations. - - - - - Gets the underlying system type that is backing this type. All instances of this - type are an instance of the underlying system type. - - - - - Gets the extension type for this type. The extension type provides - a .NET type which can be inherited from to extend sealed classes - or value types which Python allows inheritance from. - - - - - Gets the base types from which this type inherits. - - - - - Returns true if this type is a subclass of other - - - - - True if the type is a system type. A system type is a type which represents an - underlying .NET type and not a subtype of one of these types. - - - - - Looks up a slot on the dynamic type - - - - - Searches the resolution order for a slot matching by name - - - - - Searches the resolution order for a slot matching by name. - - Includes searching for methods in old-style classes - - - - - Internal helper to add a new slot to the type - - - - - - - Gets a value from a dynamic type and any sub-types. Values are stored in slots (which serve as a level of - indirection). This searches the types resolution order and returns the first slot that - contains the value. - - - - - Attempts to lookup a member w/o using the customizer. Equivelent to object.__getattribute__ - but it doens't throw an exception. - - - - - - Gets a value from a dynamic type and any sub-types. Values are stored in slots (which serve as a level of - indirection). This searches the types resolution order and returns the first slot that - contains the value. - - - - - Attempts to lookup a member w/o using the customizer. - - - - - - Sets a value on an instance. If a slot is available in the most derived type the slot - is set there, otherwise the value is stored directly in the instance. - - - - - Attempst to set a value w/o going through the customizer. - - This enables languages to provide the "base" implementation for setting attributes - so that the customizer can call back here. - - - - - Returns a list of all slot names for the type and any subtypes. - - The context that is doing the inquiry of InvariantContext.Instance. - - - - Returns a list of all slot names for the type, any subtypes, and the instance. - - The context that is doing the inquiry of InvariantContext.Instance. - the instance to get instance members from, or null. - - - - Adds members from a user defined type. - - - - - Adds members from a user defined type instance - - - - - Gets the .NET type which is used for instances of the Python type. - - When overridden by a metaclass enables a customization of the .NET type which - is used for instances of the Python type. Meta-classes can construct custom - types at runtime which include new .NET methods, fields, custom attributes or - other features to better interoperate with .NET. - - - - - Initializes a PythonType that represents a standard .NET type. The same .NET type - can be shared with the Python type system. For example object, string, int, - etc... are all the same types. - - - - - Creates a __new__ method for the type. If the type defines interesting constructors - then the __new__ method will call that. Otherwise if it has only a single argless - - - - - This will return a unique integer for every version of every type in the system. - This means that DynamicSite code can generate a check to see if it has the correct - PythonType and version with a single integer compare. - - TODO - This method and related code should fail gracefully on overflow. - - - - - Internal helper function to add a subtype - - - - - Gets a list of weak references to all the subtypes of this class. May return null - if there are no subtypes of the class. - - - - - The type has a ctor which does not accept PythonTypes. This is used - for user defined types which implement __clrtype__ - - - - - Returns a CLR WeakReference object to this PythonType that can be shared - between anyone who needs a weak reference to the type. - - - - - Implements fast binding for user defined types. This ensures that common highly dynamic - scenarios will run fast (for instance creating new types repeatedly and only creating a limited - number of instances of them). It also gives better code sharing amongst different subclasses - of the same types and improved startup time due to reduced code generation. - - - - - Base class for doing fast type invoke binding. Subclasses are created using - reflection once during the binding. The subclasses can then proceed to do - the binding w/o using reflection. Otherwise we'd have lots more reflection - calls which would slow the binding up. - - - - - Gets or creates delegate for calling the constructor function. - - - - - Used when a type overrides __new__ with a Python function or other object - that can return an arbitrary value. If the return value is not the same type - as the type which had __new__ then we need to lookup __init__ on the type - and invoke it. Also handles initialization for finalization when __del__ - is defined for the same reasons. - - - - - target is the newly initialized value. - args are the arguments to be passed to __init__ - - - - - Provides a slot object for the dictionary to allow setting of the dictionary. - - - - - Helpers for interacting w/ .NET types. This includes: - - Member resolution via GetMember/GetMembers. This performs a member lookup which includes the registered - extension types in the PythonBinder. Internally the class has many MemberResolver's which provide - the various resolution behaviors. - - Cached member access - this is via static classes such as Object and provides various MemberInfo's so we're - not constantly looking up via reflection. - - - - list of resolvers which we run to resolve items - - - - Gets the statically known member from the type with the specific name. Searches the entire type hierarchy to find the specified member. - - - - - Gets all the statically known members from the specified type. Searches the entire type hierarchy to get all possible members. - - The result may include multiple resolution. It is the callers responsibility to only treat the 1st one by name as existing. - - - - - Gets the statically known member from the type with the specific name. Searches only the specified type to find the member. - - - - - Gets all the statically known members from the specified type. Searches only the specified type to find the members. - - The result may include multiple resolution. It is the callers responsibility to only treat the 1st one by name as existing. - - - - - Abstract class used for resolving members. This provides two methods of member look. The first is looking - up a single member by name. The other is getting all of the members. - - There are various subclasses of this which have different methods of resolving the members. The primary - function of the resolvers are to provide the name->value lookup. They also need to provide a simple name - enumerator. The enumerator is kept simple because it's allowed to return duplicate names as well as return - names of members that don't exist. The base MemberResolver will then verify their existance as well as - filter duplicates. - - - - - Looks up an individual member and returns a MemberGroup with the given members. - - - - - Returns a list of members that exist on the type. The ResolvedMember structure indicates both - the name and provides the MemberGroup. - - - - - Returns a list of possible members which could exist. ResolveMember needs to be called to verify their existance. Duplicate - names can also be returned. - - - - - One off resolver for various special methods which are known by name. A delegate is provided to provide the actual member which - will be resolved. - - - - - Standard resolver for looking up .NET members. Uses reflection to get the members by name. - - - - - Resolves methods mapped to __eq__ and __ne__ from IStructuralEquatable.Equals - - - - - Resolves methods mapped to __gt__, __lt__, __ge__, __le__, as well as providing an alternate resolution - for __eq__ and __ne__, from the comparable type's CompareTo method. - - This should be run after the EqualityResolver. - - - - - Resolves methods mapped to __*__ methods automatically from the .NET operator. - - - - - Filters alternative methods out that don't match the expected signature and therefore - are just sharing a common method name. - - - - - Removes Object.Equals methods as we never return these for PythonOperationKind. - - - - - Provides bindings to private members when that global option is enabled. - - - - - Provides resolutions for protected members that haven't yet been - subclassed by NewTypeMaker. - - - - - Creates the resolver table which includes all the possible resolutions. - - - - - - Provides a resolution for __complex__ - - - - - Provides a resolution for __float__ - - - - - Provides a resolution for __int__ - - - - - Provides a resolution for __long__ - - - - - Provides a resolution for __getitem__ - - - - - Provides a resolution for __setitem__ - - - - - Provides a resolution for __str__. - - - - - Provides a resolution for __repr__ - - - - - Helper to see if the type explicitly overrides the method. This ignores members - defined on object. - - - - - Provides a resolution for __hash__ looking for IStructuralEquatable.GetHashCode. - - - - - Provides a resolution for __new__. For standard .NET types __new__ resolves to their - constructor. For Python types they inherit __new__ from their base class. - - TODO: Can we just always fallback to object.__new__? If not why not? - - - - - Provides a resolution for next - - - - - Provides a resolution for __len__ - - - - - Provides a resolution for __iter__ - - - - - Looks for an Equals overload defined on the type and if one is present binds __ne__ to an - InstanceOps helper. - - - - - Provides an implementation of __contains__. We can pull contains from: - ICollection of T which defines Contains directly - IList which defines Contains directly - IDictionary which defines Contains directly - IDictionary of K,V which defines Contains directly - IEnumerable of K which we have an InstaceOps helper for - IEnumerable which we have an instance ops helper for - IEnumerator of K which we have an InstanceOps helper for - IEnumerator which we have an instance ops helper for - - String is ignored here because it defines __contains__ via extension methods already. - - The lookup is well ordered and not dependent upon the order of values returned by reflection. - - - - - Helper for IEnumerable/IEnumerator __contains__ - - - - - Base class used for resolving a name into a member on the type. - - - - - Gets an instance op method for the given type and name. - - Instance ops methods appaer on the base most class that's required to expose it. So - if we have: Array[int], Array, object we'd only add an instance op method to Array and - Array[int] inherits it. It's obviously not on object because if it was there we'd just - put the method in ObjectOps. - - Therefore the different binders expose this at the appropriate times. - - - - - MemberBinder which searches the entire type hierarchy and their extension types to find a member. - - - - - MemberBinder which searches only the current type and it's extension types to find a member. - - - - - Primary worker for getting the member(s) associated with a single name. Can be called with different MemberBinder's to alter the - scope of the search. - - - - - Primary worker for returning a list of all members in a type. Can be called with different MemberBinder's to alter the scope - of the search. - - - - - Helper to get a MemberGroup for methods declared on InstanceOps - - - - - Helper to get the proper typecasting method, according to the following precedence rules: - - 1. Strongest (most specific) declaring type - 2. Strongest (most specific) parameter type - 3. Type of conversion - i. Implicit - ii. Explicit - 4. Return type (order specified in toTypes) - - - - - Helper for creating a typecast resolver - - - - - Helper for creating __getitem__/__setitem__ resolvers - - false for a getter, true for a setter - - - - Filters out methods which are present on standard .NET types but shouldn't be there in Python - - - - - When private binding is enabled we can have a collision between the private Event - and private field backing the event. We filter this out and favor the event. - - This matches the v1.0 behavior of private binding. - - - - - Filters down to include only protected methods - - - - - If an operator is a reverisble operator (e.g. addition) then we need to filter down to just the forward/reverse - versions of the .NET method. For example consider: - - String.op_Multiplication(int, string) - String.op_Multiplication(string, int) - - If this method were defined on string it defines that you can do: - 2 * 'abc' - or: - 'abc' * 2 - - either of which will produce 'abcabc'. The 1st form is considered the reverse form because it is declared on string - but takes a non-string for the 1st argument. The 2nd is considered the forward form because it takes a string as the - 1st argument. - - When dynamically dispatching for 2 * 'abc' we'll first try __mul__ on int, which will fail with a string argument. Then we'll try - __rmul__ on a string which will succeed and dispatch to the (int, string) overload. - - For multiplication in this case it's not too interesting because it's commutative. For addition this might be more interesting - if, for example, we had unicode and ASCII strings. In that case Unicode strings would define addition taking both unicode and - ASCII strings in both forms. - - - - - Checks to see if the parameter type and the declaring type are compatible to determine - if an operator is forward or reverse. - - - - - Checks to see if this is an operator method which Python recognizes. For example - op_Comma is not recognized by Python and therefore should exposed to the user as - a method that is callable by name. - - - - - A TypeSlot is an item that gets stored in a type's dictionary. Slots provide an - opportunity to customize access at runtime when a value is get or set from a dictionary. - - - - - Gets the value stored in the slot for the given instance binding it to an instance if one is provided and - the slot binds to instances. - - - - - Sets the value of the slot for the given instance. - - true if the value was set, false if it can't be set - - - - Deletes the value stored in the slot from the instance. - - true if the value was deleted, false if it can't be deleted - - - - True if generating code for gets can result in more optimal accesses. - - - - - Gets an expression which is used for accessing this slot. If the slot lookup fails the error expression - is used again. - - The default implementation just calls the TryGetValue method. Subtypes of PythonTypeSlot can override - this and provide a more optimal implementation. - - - - - True if TryGetValue will always succeed, false if it may fail. - - This is used to optimize away error generation code. - - - - - The unbound representation of an event property - - - - - BoundEvent is the object that gets returned when the user gets an event object. An - BoundEvent tracks where the event was received from and is used to verify we get - a proper add when dealing w/ statics events. - - - - - Represents a ReflectedProperty created for an extension method. Logically the property is an - instance property but the method implementing it is static. - - - - - Convenience function for users to call directly - - - - - This function can be used to set a field on a value type without emitting a warning. Otherwise it is provided only to have symmetry with properties which have GetValue/SetValue for supporting explicitly implemented interfaces. - - Setting fields on value types usually warns because it can silently fail to update the value you expect. For example consider this example where Point is a value type with the public fields X and Y: - - arr = System.Array.CreateInstance(Point, 10) - arr[0].X = 42 - print arr[0].X - - prints 0. This is because reading the value from the array creates a copy of the value. Setting the value then mutates the copy and the array does not get updated. The same problem exists when accessing members of a class. - - - - - Base class for properties backed by methods. These include our slot properties, - indexers, and normal properties. This class provides the storage of these as well - as the storage of our optimized getter/setter methods, documentation for the property, - etc... - - - - - Provides access to non-default .NET indexers (aka properties w/ parameters). - - C# doesn't support these, but both COM and VB.NET do. The types dictionary - gets populated w/a ReflectedGetterSetter indexer which is a descriptor. Getting - the descriptor returns a bound indexer. The bound indexer supports indexing. - We support multiple indexer parameters via expandable tuples. - - - - - True if generating code for gets can result in more optimal accesses. - - - - - Convenience function for users to call directly - - - - - Convenience function for users to call directly - - - - - Represents a member of a user-defined type which defines __slots__. The names listed in - __slots__ have storage allocated for them with the type and provide fast get/set access. - - - - - Gets the index into the object array to be used for the slot storage. - - - - - Couples a MemberGroup and the name which produces the member group together - - - - - Represents an ops-extension which adds a new slot. The slot can have arbitrary - get/set behavior above and beyond normal .NET methods or properties. This is - typically in regards to how it processes access from instances or subtypes. - - - - - single finalizable instance used to track and deliver all the - callbacks for a single object that has been weakly referenced by - one or more references and proxies. The reference to this object - is held in objects that implement IWeakReferenceable. - - - - - Finalizable object used to hook up finalization calls for OldInstances. - - We create one of these each time an object w/ a finalizer gets created. The - only reference to this object is the instance so when that goes out of context - this does as well and this will get finalized. - - - - - Marks a method/field/property as being a wrapper descriptor. A wrapper desriptor - is a member defined on PythonType but is available both for type and other - instances of type. For example type.__bases__. - - - - - For IList arguments: Marks that the argument is typed to accept a bytes or - bytearray object. This attribute disallows passing a Python list object and - auto-applying our generic conversion. It also enables conversion of a string to - a IList of byte in IronPython 2.6. - - For string arguments: Marks that the argument is typed to accept a bytes object - as well. (2.6 only) - - - - - Provides more specific type information for Python dictionaries which are not strongly typed. - - This attribute can be applied to fields, parameters, proeprties, and return values. It can be - inspected to get type information about the types of the keys and values of the expected - dictionary or the returned dictionary. - - - - - Gets the collection of command line arguments. - - - - - Should we strip out all doc strings (the -O command line option). - - - - - Should we strip out all doc strings (the -OO command line option). - - - - - List of -W (warning filter) options collected from the command line. - - - - - Enables warnings related to Python 3.0 features. - - - - - Enables 3.0 features that are implemented in IronPython. - - - - - Enables debugging support. When enabled a .NET debugger can be attached - to the process to step through Python code. - - - - - Enables inspect mode. After running the main module the REPL will be started - within that modules context. - - - - - Suppresses addition of the user site directory. This is ignored by IronPython - except for updating sys.flags. - - - - - Disables import site on startup. - - - - - Ignore environment variables that configure the IronPython context. - - - - - Enables the verbose option which traces import statements. This is ignored by IronPython - except for setting sys.flags. - - - - - Sets the maximum recursion depth. Setting to Int32.MaxValue will disable recursion - enforcement. - - - - - Makes available sys._getframe. Local variables will not be available in frames unless the - function calls locals(), dir(), vars(), etc... For ensuring locals are always available use - the FullFrames option. - - - - - Makes available sys._getframe. All locals variables will live on the heap (for a considerable - performance cost) enabling introspection of all code. - - - - - Tracing is always available. Without this option tracing is only enabled when sys.settrace - is called. This means code that was already running before sys.settrace will not be debuggable. - - With this option pdb.set_trace and pdb.post_mortem will always work properly. - - - - - Severity of a warning that indentation is formatted inconsistently. - - - - - The division options (old, new, warn, warnall) - - - - - Forces all code to be compiled in a mode in which the code can be reliably collected by the CLR. - - - - - Enable profiling code - - - - - Returns a regular expression of Python files which should not be emitted in debug mode. - - - - - Gets the CPython version which IronPython will emulate. Currently limited - to either 2.6 or 3.0. - - - - diff --git a/mpv.net/IronPython/Microsoft.Dynamic.xml b/mpv.net/IronPython/Microsoft.Dynamic.xml deleted file mode 100644 index 7ce5218..0000000 --- a/mpv.net/IronPython/Microsoft.Dynamic.xml +++ /dev/null @@ -1,8409 +0,0 @@ - - - - Microsoft.Dynamic - - - - - Provides binding semantics for a language. This include conversions as well as support - for producing rules for actions. These optimized rules are used for calling methods, - performing operators, and getting members using the ActionBinder's conversion semantics. - - - - - Determines if the binder should allow access to non-public members. - - By default the binder does not allow access to non-public members. Base classes - can inherit and override this value to customize whether or not private binding - is available. - - - - - Converts an object at runtime into the specified type. - - - - - Determines if a conversion exists from fromType to toType at the specified narrowing level. - toNotNullable is true if the target variable doesn't allow null values. - - - - - Provides ordering for two parameter types if there is no conversion between the two parameter types. - - - - - Converts the provided expression to the given type. The expression is safe to evaluate multiple times. - - - - - Gets the members that are visible from the provided type of the specified name. - - The default implemetnation first searches the type, then the flattened heirachy of the type, and then - registered extension methods. - - - - - Called when a set is attempting to assign to a field or property from a derived class through the base class. - - The default behavior is to allow the assignment. - - - - - Creates an ErrorInfo object when a static property is accessed from an instance member. The default behavior is throw - an exception indicating that static members properties be accessed via an instance. Languages can override this to - customize the exception, message, or to produce an ErrorInfo object which reads or writes to the property being accessed. - - The static property being accessed through an instance - True if the user is assigning to the property, false if the user is reading from the property - The parameters being used to access the property. This includes the instance as the first entry, any index parameters, and the - value being assigned as the last entry if isAssignment is true. - - - - - Provides a way for the binder to provide a custom error message when lookup fails. Just - doing this for the time being until we get a more robust error return mechanism. - - Deprecated, use the non-generic version instead - - - - - Gets the extension members of the given name from the provided type. Base classes are also - searched for their extension members. Once any of the types in the inheritance hierarchy - provide an extension member the search is stopped. - - - - - Gets the extension members of the given name from the provided type. Subclasses of the - type and their extension members are not searched. - - - - - Provides an opportunity for languages to replace all MemberTracker's with their own type. - - Alternatlely a language can expose MemberTracker's directly. - - The member which is being returned to the user. - Tthe type which the memberTrack was accessed from - - - - - TODO: Alternatively, it should be sufficient to remember indices for this, list, dict and block. - - - - - Convention for an individual argument at a callsite. - - Multiple different callsites can match against a single declaration. - Some argument kinds can be "unrolled" into multiple arguments, such as list and dictionary. - - - - - Simple unnamed positional argument. - In Python: foo(1,2,3) are all simple arguments. - - - - - Argument with associated name at the callsite - In Python: foo(a=1) - - - - - Argument containing a list of arguments. - In Python: foo(*(1,2*2,3)) would match 'def foo(a,b,c)' with 3 declared arguments such that (a,b,c)=(1,4,3). - it could also match 'def foo(*l)' with 1 declared argument such that l=(1,4,3) - - - - - Argument containing a dictionary of named arguments. - In Python: foo(**{'a':1, 'b':2}) - - - - - Richly represents the signature of a callsite. - - - - - Array of additional meta information about the arguments, such as named arguments. - Null for a simple signature that's just an expression list. eg: foo(a*b,c,d) - - - - - Number of arguments in the signature. - - - - - All arguments are unnamed and matched by position. - - - - - True if the OldCallAction includes an ArgumentInfo of ArgumentKind.Dictionary or ArgumentKind.Named. - - - - - Gets the number of positional arguments the user provided at the call site. - - - - - Gets the index into _args array indicating the first post-splat argument or -1 of there are no splatted arguments. - For call site f(a,b,*c,d) and preSplatLimit == 1 and postSplatLimit == 2 - args would be (a,b,c[0],c[n-2],c[n-1],d) with splat index 3, where n = c.Count. - - - - - The number of arguments not counting the collapsed ones. - - - - - Gets the number of hidden arguments (used for error reporting). - - - - - Gets the total number of visible arguments passed to the call site including collapsed ones. - - - - - Binds named arguments to the parameters. Returns a permutation of indices that captures the relationship between - named arguments and their corresponding parameters. Checks for duplicate and unbound named arguments. - Ensures that for all i: namedArgs[i] binds to parameters[args.Length + bindingPermutation[i]] - - - - - ArgBuilder provides an argument value used by the MethodBinder. One ArgBuilder exists for each - physical parameter defined on a method. - - Contrast this with ParameterWrapper which represents the logical argument passed to the method. - - - - - Gets the priority. - - - - - The number of actual arguments consumed by this builder. - - - - - Provides the Expression which provides the value to be passed to the argument. - If null is returned the argument is skipped (not passed to the callee). - - - - - Returns the type required for the argument or null if the ArgBuilder - does not consume a type. - - - - - Provides an Expression which will update the provided value after a call to the method. May - return null if no update is required. - - - - - If the argument produces a return value (e.g. a ref or out value) this provides - the additional value to be returned. - - - - - An assignable value that is passed to a byref parameter - After the call it will contain the updated value - - - - - Indicates the specific type of failure, if any, from binding to a method. - - - - - The binding succeeded. Only one method was applicable or had the best conversion. - - - - - More than one method was applicable for the provided parameters and no method was considered the best. - - - - - There are no overloads that match the number of parameters required for the call - - - - - None of the target method(s) can successfully be called. The failure can be due to: - 1. Arguments could not be successfully converted for the call - 2. Keyword arguments could not be assigned to positional arguments - 3. Keyword arguments could be assigned but would result in an argument being assigned - multiple times (keyword and positional arguments conflit or dupliate keyword arguments). - - - - - Actual arguments cannot be constructed. - - - - - No method is callable. For example, all methods have an unbound generic parameter. - - - - - Encapsulates the result of an attempt to bind to one or methods using the OverloadResolver. - - Users should first check the Result property to see if the binding was successful or - to determine the specific type of failure that occured. If the binding was successful - MakeExpression can then be called to create an expression which calls the method. - If the binding was a failure callers can then create a custom error message based upon - the reason the call failed. - - - - - Creates a new BindingTarget when the method binding has succeeded. - - - - - Creates a new BindingTarget when the method binding has failed due to an incorrect argument count - - - - - Creates a new BindingTarget when the method binding has failued due to - one or more parameters which could not be converted. - - - - - Creates a new BindingTarget when the match was ambiguous - - - - - Other failure. - - - - - Gets the result of the attempt to bind. - - - - - Gets an Expression which calls the binding target if the method binding succeeded. - - Throws InvalidOperationException if the binding failed. - - - - - Returns the method if the binding succeeded, or null if no method was applicable. - - - - - Returns the selected overload if the binding succeeded, or null if no one was applicable. - - - - - Gets the name of the method as supplied to the OverloadResolver. - - - - - Returns the MethodTarget if the binding succeeded, or null if no method was applicable. - - - - - Returns the methods which don't have any matches or null if Result == BindingResult.AmbiguousMatch - - - - - Returns the methods and their associated conversion failures if Result == BindingResult.CallFailure. - - - - - Returns the acceptable number of arguments which can be passed to the method if Result == BindingResult.IncorrectArgumentCount. - - - - - Returns the total number of arguments provided to the call. 0 if the call succeeded or failed for a reason other - than argument count mismatch. - - - - - Gets the MetaObjects which we originally did binding against in their restricted form. - - The members of the array correspond to each of the arguments. All members of the array - have a value. - - - - - Returns the return type of the binding, or null if no method was applicable. - - - - - Gets the NarrowingLevel of the method if the call succeeded. - If the call failed returns NarrowingLevel.None. - - - - - Returns true if the binding was succesful, false if it failed. - This is an alias for BindingTarget.Result == BindingResult.Success. - - - - - Represents the reason why a call to a specific method could not be performed by the OverloadResolver. - - The reason for the failure is specified by the CallFailureReason property. Once this property - has been consulted the other properties can be consulted for more detailed information regarding - the failure. - - If reason is ConversionFailure the ConversionResults property will be non-null. - If reason is UnassignableKeyword the KeywordArguments property will be non-null and include - the keywords which could not be assigned. - If reason is DuplicateKeyword the KeywordArguments property will be non-null and include - the keywords which were duplicated (either by the keywords themselves or by positional - arguments). - - MethodTarget is always set and indicates the method which failed to bind. - - - - - Gets the MethodTarget which the call failed for. - - - - - Gets the reason for the call failure which determines the other - properties of the CallFailure which should be consulted. - - - - - Gets a list of ConversionResult's for each parameter indicating - whether the conversion was successful or failed and the types - being converted. - - - - - Gets the list of keyword arguments that were either dupliated or - unassignable. - - - - - Default value, their was no CallFailure. - - - - - One of more parameters failed to be converted - - - - - One or more keyword arguments could not be successfully assigned to a positional argument - - - - - One or more keyword arguments were duplicated or would have taken the spot of a - provided positional argument. - - - - - Type arguments could not be inferred - - - - - Represents a collection of MethodCandidate's which all accept the - same number of logical parameters. For example a params method - and a method with 3 parameters would both be a CandidateSet for 3 parameters. - - - - - Represents information about a failure to convert an argument from one - type to another. - - - - - Value of the argument or null if it is not available. - - - - - Argument actual type or its limit type if the value not known. - DynamicNull if the argument value is null. - - - - - ArgBuilder which provides a default parameter value for a method call. - - - - - The number of actual arguments consumed by this builder. - - - - - ArgBuilder which provides a value for a keyword argument. - - The KeywordArgBuilder calculates its position at emit time using it's initial - offset within the keyword arguments, the number of keyword arguments, and the - total number of arguments provided by the user. It then delegates to an - underlying ArgBuilder which only receives the single correct argument. - - Delaying the calculation of the position to emit time allows the method binding to be - done without knowing the exact the number of arguments provided by the user. Hence, - the method binder can be dependent only on the set of method overloads and keyword names, - but not the user arguments. While the number of user arguments could be determined - upfront, the current MethodBinder does not have this design. - - - - - The underlying builder should expect a single parameter as KeywordArgBuilder is responsible - for calculating the correct parameter to use - - - - - - Updates fields/properties of the returned value with unused keyword parameters. - - - - - MethodCandidate represents the different possible ways of calling a method or a set of method overloads. - A single method can result in multiple MethodCandidates. Some reasons include: - - Every optional parameter or parameter with a default value will result in a candidate - - The presence of ref and out parameters will add a candidate for languages which want to return the updated values as return values. - - ArgumentKind.List and ArgumentKind.Dictionary can result in a new candidate per invocation since the list might be different every time. - - Each MethodCandidate represents the parameter type for the candidate using ParameterWrapper. - - - - - Builds a new MethodCandidate which takes count arguments and the provided list of keyword arguments. - - The basic idea here is to figure out which parameters map to params or a dictionary params and - fill in those spots w/ extra ParameterWrapper's. - - - - - Narrowing conversions are conversions that cannot be proved to always succeed, conversions that are - known to possibly lose information, and conversions across domains of types sufficiently different - to merit narrowing notation like casts. - - Its upto every language to define the levels for conversions. The narrowling levels can be used by - for method overload resolution, where the overload is based on the parameter types (and not the number - of parameters). - - - - - Conversions at this level do not do any narrowing. Typically, this will include - implicit numeric conversions, Type.IsAssignableFrom, StringBuilder to string, etc. - - - - - Language defined prefered narrowing conversion. First level that introduces narrowing - conversions. - - - - - Language defined preferred narrowing conversion. Second level that introduces narrowing - conversions and should have more conversions than One. - - - - - Language defined preferred narrowing conversion. Third level that introduces narrowing - conversions and should have more conversions that Two. - - - - - A somewhat meaningful conversion is possible, but it will quite likely be lossy. - For eg. BigInteger to an Int32, Boolean to Int32, one-char string to a char, - larger number type to a smaller numeric type (where there is no overflow), etc - - - - - Builds the argument for an out argument when not passed a StrongBox. The out parameter - is returned as an additional return value. - - - - - Defines a method overload abstraction for the purpose of overload resolution. - It provides the overload resolver the metadata it needs to perform the resolution. - - - WARNING: This is a temporary API that will undergo breaking changes in future versions. - - - - - Null for constructors. - - - - - The method arity can vary, i.e. the method has params array or params dict parameters. - - - - - Represents a method overload that is bound to a . - - - Not thread safe. - WARNING: This is a temporary API that will undergo breaking changes in future versions. - - - - - Provides binding and overload resolution to .NET methods. - - MethodBinder's can be used for: - generating new AST code for calling a method - calling a method via reflection at runtime - (not implemented) performing an abstract call - - MethodBinder's support default arguments, optional arguments, by-ref (in and out), and keyword arguments. - - Implementation Details: - - The MethodBinder works by building up a CandidateSet for each number of effective arguments that can be - passed to a set of overloads. For example a set of overloads such as: - foo(object a, object b, object c) - foo(int a, int b) - - would have 2 target sets - one for 3 parameters and one for 2 parameters. For parameter arrays - we fallback and create the appropriately sized CandidateSet on demand. - - Each CandidateSet consists of a set of MethodCandidate's. Each MethodCandidate knows the flattened - parameters that could be received. For example for a function such as: - foo(params int[] args) - - When this method is in a CandidateSet of size 3 the MethodCandidate takes 3 parameters - all of them - ints; if it's in a CandidateSet of size 4 it takes 4 parameters. Effectively a MethodCandidate is - a simplified view that allows all arguments to be treated as required positional arguments. - - Each MethodCandidate in turn refers to a MethodTarget. The MethodTarget is composed of a set - of ArgBuilder's and a ReturnBuilder which know how to consume the positional arguments and pass - them to the appropriate argument of the destination method. This includes routing keyword - arguments to the correct position, providing the default values for optional arguments, etc... - - After binding is finished the MethodCandidates are thrown away and a BindingTarget is returned. - The BindingTarget indicates whether the binding was successful and if not any additional information - that should be reported to the user about the failed binding. It also exposes the MethodTarget which - allows consumers to get the flattened list of required parameters for the call. MethodCandidates - are not exposed and are an internal implementation detail of the MethodBinder. - - - - - Resolves a method overload and returns back a BindingTarget. - - The BindingTarget can then be tested for the success or particular type of - failure that prevents the method from being called. If successfully bound the BindingTarget - contains a list of argument meta-objects with additional restrictions that ensure the selection - of the particular overload. - - - - - Checks to see if the language allows named arguments to be bound to instance fields or - properties and turned into setters. By default this is only allowed on contructors. - - - - - Gets an expression that evaluates to the result of GetByRefArray operation. - - - - - Allow to bind an array/dictionary instance or a null reference to params array/dictionary parameter. - - - - - Called before arguments binding. - - - A bitmask that indicates (set bits) the parameters that were mapped by this method. - A default mapping will be constructed for the remaining parameters (cleared bits). - - - - - Return null if arguments cannot be constructed and overload resolution should produce an error. - - - - - Determines whether given overloads are overloaded on index-th parameter (the types of the index-th parameters are the same). - - - - - Selects the best (of two) candidates for conversion from actualType - - - - - Provides ordering for two parameter types if there is no conversion between the two parameter types. - - - - - The method is called each time an item of lazily splatted argument is needed. - - - - - Gets the next argument to consume. - - - - - Maps out parameters to return args and ref parameters to ones that don't accept StrongBox. - - - - - ParameterWrapper represents the logical view of a parameter. For eg. the byref-reduced signature - of a method with byref parameters will be represented using a ParameterWrapper of the underlying - element type, since the logical view of the byref-reduced signature is that the argument will be - passed by value (and the updated value is included in the return value). - - Contrast this with ArgBuilder which represents the real physical argument passed to the method. - - - - - ParameterInfo is not available. - - - - - True if the wrapper represents a params-array parameter (false for parameters created by expansion of a params-array). - - - - - True if the wrapper represents a params-dict parameter (false for parameters created by expansion of a params-dict). - - - - - Creates a parameter that represents an expanded item of params-array. - - - - - Builds the parameter for a params dictionary argument - this collects all the extra name/value - pairs provided to the function into a SymbolDictionary which is passed to the function. - - - - - An argument that the user wants to explicitly pass by-reference (with copy-in copy-out semantics). - The user passes a StrongBox[T] object whose value will get updated when the call returns. - - - - - True if there are restrictions beyond just simple type restrictions - - - - - Creates a ReturnBuilder - - the type the ReturnBuilder will leave on the stack - - - - Builds a parameter for a reference argument when a StrongBox has not been provided. The - updated return value is returned as one of the resulting return values. - - - - - SimpleArgBuilder produces the value produced by the user as the argument value. It - also tracks information about the original parameter and is used to create extended - methods for params arrays and param dictionary functions. - - - - - Parameter info is not available for this argument. - - - - - Type and whether the parameter is a params-array or params-dictionary is derived from info. - - - - - Gets the index of actual argument expression. - - - - - Gets the generic arguments for method based upon the constraints discovered during - type inference. Returns null if not all generic arguments had their types inferred. - - - - - Creates a new set of arg builders for the given generic method definition which target the new - parameters. - - - - - Creates a new list of ParameterWrappers for the generic method replacing the old parameters with the new ones. - - - - - Gets the generic type arguments sorted so that the type arguments - that are depended upon by other type arguments are sorted before - their dependencies. - - - - - Checks to see if the x type parameter is dependent upon the y type parameter. - - - - - Builds a mapping based upon generic parameter constraints between related generic - parameters. This is then used to sort the generic parameters so that we can process - the least dependent parameters first. For example given the method: - - void Foo{T0, T1}(T0 x, T1 y) where T0 : T1 - - We need to first infer the type information for T1 before we infer the type information - for T0 so that we can ensure the constraints are correct. - - - - - Returns a mapping from generic type parameter to the input DMOs which map to it. - - - - - Adds any additional ArgumentInputs entries for the given object and parameter type. - - - - - Walks the nested generic hierarchy to construct all of the generic parameters referred - to by this type. For example if getting the generic parameters for the x parameter on - the method: - - void Foo{T0, T1}(Dictionary{T0, T1} x); - - We would add both typeof(T0) and typeof(T1) to the list of generic arguments. - - - - - Maps a single type parameter to the possible parameters and DynamicMetaObjects - we can get inference from. For example for the signature: - - void Foo{T0, T1}(T0 x, T1 y, IList{T1} z); - - We would have one ArgumentInput for T0 which holds onto the DMO providing the argument - value for x. We would also have one ArgumentInput for T1 which holds onto the 2 DMOs - for y and z. Associated with y would be a GenericParameterInferer and associated with - z would be a ConstructedParameterInferer. - - - - - Provides generic type inference for a single parameter. - - - For example: - M{T}(T x) - M{T}(IList{T} x) - M{T}(ref T x) - M{T}(T[] x) - M{T}(ref Dictionary{T,T}[] x) - - - - - Provides generic type inference for a single parameter. - - - For example: - M{T}(T x) - M{T}(IList{T} x) - M{T}(ref T x) - M{T}(T[] x) - M{T}(ref Dictionary{T,T}[] x) - - - - - Checks if the constraints are violated by the given input for the specified generic method parameter. - - This method must be supplied with a mapping for any dependent generic method type parameters which - this one can be constrained to. For example for the signature "void Foo{T0, T1}(T0 x, T1 y) where T0 : T1". - we cannot know if the constraints are violated unless we know what we have calculated T1 to be. - - - - - Finds all occurences of genericParameter in openType and the corresponding concrete types in closedType. - Returns true iff all occurences of the generic parameter in the open type correspond to the same concrete type in the closed type - and this type satisfies given constraints. Returns the concrete type in match if so. - - - - - Implemented by DynamicMetaObject subclasses when the associated object - can participate in generic method type inference. This interface - is used when the inference engine is attempting to perform type inference - for a parameter which is typed to a delegate type. - - - - - Returns the type inferred for parameterType when performing - inference for a conversion to delegateType. - - - - - Provides information about the result of a custom object which dynamically infers back types. - Currently only used for invokable objects to feedback the types for a delegate type. - - - - - A tree rewriter which will find dynamic sites which consume dynamic sites and - turn them into a single combo dynamic site. The combo dynamic site will then run the - individual meta binders and produce the resulting code in a single dynamic site. - - - - - A reducible node which we use to generate the combo dynamic sites. Each time we encounter - a dynamic site we replace it with a ComboDynamicSiteExpression. When a child of a dynamic site - turns out to be a ComboDynamicSiteExpression we will then merge the child with the parent updating - the binding mapping info. If any of the inputs cause side effects then we'll stop the combination. - - - - - A binder which can combine multiple binders into a single dynamic site. The creator - of this needs to perform the mapping of parameters, constants, and sub-site expressions - and provide a List of BinderMappingInfo representing this data. From there the ComboBinder - just processes the list to create the resulting code. - - - - - Provides a mapping for inputs of combo action expressions. The input can map - to either an input of the new dynamic site, an input of a previous DynamicExpression, - or a ConstantExpression which has been pulled out of the dynamic site arguments. - - - - - Contains the mapping information for a single Combo Binder. This includes the original - meta-binder and the mapping of parameters, sub-sites, and constants into the binding. - - - - - Builds up a series of conditionals when the False clause isn't yet known. We can - keep appending conditions and if true's. Each subsequent true branch becomes the - false branch of the previous condition and body. Finally a non-conditional terminating - branch must be added. - - - - - Adds a new conditional and body. The first call this becomes the top-level - conditional, subsequent calls will have it added as false statement of the - previous conditional. - - - - - Adds the non-conditional terminating node. - - - - - Adds the non-conditional terminating node. - - - - - Gets the resulting meta object for the full body. FinishCondition - must have been called. - - - - - Adds a variable which will be scoped at the level of the final expression. - - - - - Determines the result of a conversion action. The result can either result in an exception, a value that - has been successfully converted or default(T), or a true/false result indicating if the value can be converted. - - - - - Attempts to perform available implicit conversions and throws if there are no available conversions. - - - - - Attempst to perform available implicit and explicit conversions and throws if there are no available conversions. - - - - - Attempts to perform available implicit conversions and returns default(ReturnType) if no conversions can be performed. - - If the return type of the rule is a value type then the return value will be zero-initialized. If the return type - of the rule is object or another class then the return type will be null (even if the conversion is to a value type). - This enables ImplicitTry to be used to do TryConvertTo even if the type is value type (and the difference between - null and a real value can be distinguished). - - - - - Attempts to perform available implicit and explicit conversions and returns default(ReturnType) if no conversions - can be performed. - - If the return type of the rule is a value type then the return value will be zero-initialized. If the return type - of the rule is object or another class then the return type will be null (even if the conversion is to a value type). - This enables ExplicitTry to be used to do TryConvertTo even if the type is value type (and the difference between - null and a real value can be distinguished). - - - - - A custom member tracker which enables languages to plug in arbitrary - members into the lookup process. - - - - - Provides binding semantics for a language. This include conversions as well as support - for producing rules for actions. These optimized rules are used for calling methods, - performing operators, and getting members using the ActionBinder's conversion semantics. - - - - - Checks if the conversion is to object and produces a target if it is. - - - - - Checks if any conversions are available and if so builds the target for that conversion. - - - - - Checks if the conversion can be handled by a simple cast. - - - - - Checks if the conversion can be handled by calling a user-defined conversion method. - - - - - Helper that checkes both types to see if either one defines the specified conversion - method. - - - - - Checks if any of the members of the MemberGroup provide the applicable conversion and - if so uses it to build a conversion rule. - - - - - Checks if the conversion is to applicable by extracting the value from Extensible of T. - - - - - Checks if there's an implicit numeric conversion for primitive data types. - - - - - Checks if there's a conversion to/from Nullable of T. - - - - - Checks to see if there's a conversion of null to a reference type - - - - - Helper to produce an error when a conversion cannot occur - - - - - Helper to produce a rule which just boxes a value type - - - - - Helper to produce a conversion rule by calling the helper method to do the convert - - - - - Helper to produce a conversion rule by calling the helper method to do the convert - - - - - Helper to produce a conversion rule by calling the method to do the convert. This version takes the parameter - to be passed to the conversion function and we call it w/ our own value or w/ our Extensible.Value. - - - - - Helper to wrap explicit conversion call into try/catch incase it throws an exception. If - it throws the default value is returned. - - - - - Helper to produce a rule when no conversion is required (the strong type of the expression - input matches the type we're converting to or has an implicit conversion at the IL level) - - - - - Helper to produce a rule when no conversion is required from an extensible type's - underlying storage to the type we're converting to. The type of extensible type - matches the type we're converting to or has an implicit conversion at the IL level. - - - - - Helper to extract the value from an Extensible of T - - - - - Helper to convert a null value to nullable of T - - - - - Helper to produce the rule for converting T to Nullable of T - - - - - Helper to produce the rule for converting T to Nullable of T - - - - - Returns a value which indicates failure when a OldConvertToAction of ImplicitTry or - ExplicitTry. - - - - - Helper to extract the Value of an Extensible of T from the - expression being converted. - - - - - Helper that checks if fromType is an Extensible of T or a subtype of - Extensible of T and if so returns the T. Otherwise it returns fromType. - - This is used to treat extensible types the same as their underlying types. - - - - - Creates a target which returns null for a reference type. - - - - - Provides a way for the binder to provide a custom error message when lookup fails. Just - doing this for the time being until we get a more robust error return mechanism. - - - - - Called when the user is accessing a protected or private member on a get. - - The default implementation allows access to the fields or properties using reflection. - - - - - Provides a way for the binder to provide a custom error message when lookup fails. Just - doing this for the time being until we get a more robust error return mechanism. - - - - if a member-injector is defined-on or registered-for this type call it - - - - Helper class for flowing information about the GetMember request. - - - - - Builds a MetaObject for performing a member get. Supports all built-in .NET members, the OperatorMethod - GetBoundMember, and StrongBox instances. - - - The name of the member to retrieve. This name is not processed by the DefaultBinder and - is instead handed off to the GetMember API which can do name mangling, case insensitive lookups, etc... - - - The MetaObject from which the member is retrieved. - - - Returns a DynamicMetaObject which represents the value that will be returned when the member is accessed. - - The returned DynamicMetaObject may be strongly typed to a value type which needs boxing before being - returned from a standard DLR GetMemberBinder. The language is responsible for performing any boxing - so that it has an opportunity to perform custom boxing. - - - - - Builds a MetaObject for performing a member get. Supports all built-in .NET members, the OperatorMethod - GetBoundMember, and StrongBox instances. - - - The name of the member to retrieve. This name is not processed by the DefaultBinder and - is instead handed off to the GetMember API which can do name mangling, case insensitive lookups, etc... - - - The MetaObject from which the member is retrieved. - - - Provides overload resolution and method binding for any calls which need to be performed for the GetMember. - - - Returns a DynamicMetaObject which represents the value that will be returned when the member is accessed. - - The returned DynamicMetaObject may be strongly typed to a value type which needs boxing before being - returned from a standard DLR GetMemberBinder. The language is responsible for performing any boxing - so that it has an opportunity to perform custom boxing. - - - - - Builds a MetaObject for performing a member get. Supports all built-in .NET members, the OperatorMethod - GetBoundMember, and StrongBox instances. - - - The name of the member to retrieve. This name is not processed by the DefaultBinder and - is instead handed off to the GetMember API which can do name mangling, case insensitive lookups, etc... - - - The MetaObject from which the member is retrieved. - - - An OverloadResolverFactory which can be used for performing overload resolution and method binding. - - - True if the operation should return Operation.Failed on failure, false if it - should return the exception produced by MakeMissingMemberError. - - - The meta object to be used if the get results in an error. - - - Returns a DynamicMetaObject which represents the value that will be returned when the member is accessed. - - The returned DynamicMetaObject may be strongly typed to a value type which needs boxing before being - returned from a standard DLR GetMemberBinder. The language is responsible for performing any boxing - so that it has an opportunity to perform custom boxing. - - - - - Builds a MetaObject for performing a member get. Supports all built-in .NET members, the OperatorMethod - GetBoundMember, and StrongBox instances. - - - The name of the member to retrieve. This name is not processed by the DefaultBinder and - is instead handed off to the GetMember API which can do name mangling, case insensitive lookups, etc... - - - The MetaObject from which the member is retrieved. - - - True if the operation should return Operation.Failed on failure, false if it - should return the exception produced by MakeMissingMemberError. - - - The meta object to be used if the get results in an error. - - - Returns a DynamicMetaObject which represents the value that will be returned when the member is accessed. - - The returned DynamicMetaObject may be strongly typed to a value type which needs boxing before being - returned from a standard DLR GetMemberBinder. The language is responsible for performing any boxing - so that it has an opportunity to perform custom boxing. - - - - if a member-injector is defined-on or registered-for this type call it - - - - Helper class for flowing information about the GetMember request. - - - - - Provides default binding for performing a call on the specified meta objects. - - The signature describing the call - The meta object to be called. - - Additional meta objects are the parameters for the call as specified by the CallSignature in the CallAction. - - A MetaObject representing the call or the error. - - - - Provides default binding for performing a call on the specified meta objects. - - The signature describing the call - The meta object to be called. - - Additional meta objects are the parameters for the call as specified by the CallSignature in the CallAction. - - Overload resolver factory. - A MetaObject representing the call or the error. - - - - Provides default binding for performing a call on the specified meta objects. - - The signature describing the call - The meta object to be called. - - Additional meta objects are the parameters for the call as specified by the CallSignature in the CallAction. - - Overload resolver factory. - The result should the object be uncallable. - A MetaObject representing the call or the error. - - - - Gets a TargetInfo object for performing a call on this object. - - If this object is a delegate we bind to the Invoke method. - If this object is a MemberGroup or MethodGroup we bind to the methods in the member group. - If this object is a BoundMemberTracker we bind to the methods with the bound instance. - If the underlying type has defined an operator Call method we'll bind to that method. - - - - - Binds to the methods in a method group. - - - - - Binds to the methods in a member group. - - TODO: We should really only have either MemberGroup or MethodGroup, not both. - - - - - Binds to the BoundMemberTracker and uses the instance in the tracker and restricts - based upon the object instance type. - - - - - Binds to the Invoke method on a delegate if this is a delegate type. - - - - - Attempts to bind to an operator Call method. - - - - - Encapsulates information about the target of the call. This includes an implicit instance for the call, - the methods that we'll be calling as well as any restrictions required to perform the call. - - - - - Performs binding against a set of overloaded methods using the specified arguments. The arguments are - consumed as specified by the CallSignature object. - - Overload resolver. - The methods to be called - A meta object which results from the call. - - - - Performs binding against a set of overloaded methods using the specified arguments. The arguments are - consumed as specified by the CallSignature object. - - Overload resolver. - The methods to be called - The name of the method or null to use the name from targets. - A meta object which results from the call. - - - - Performs binding against a set of overloaded methods using the specified arguments. The arguments are - consumed as specified by the CallSignature object. - - Overload resolver. - The methods to be called - Additional restrictions which should be applied to the resulting MetaObject. - A meta object which results from the call. - - - - Performs binding against a set of overloaded methods using the specified arguments. The arguments are - consumed as specified by the CallSignature object. - - Overload resolver. - The methods to be called - Additional restrictions which should be applied to the resulting MetaObject. - The name of the method or null to use the name from targets. - A meta object which results from the call. - - - - Performs binding against a set of overloaded methods using the specified arguments. The arguments are - consumed as specified by the CallSignature object. - - TODO. - TODO. - Overload resolver. - The methods to be called - Additional restrictions which should be applied to the resulting MetaObject. - The resulting binding target which can be used for producing error information. - The name of the method or null to use the name from targets. - A meta object which results from the call. - - - - Makes test for param arrays and param dictionary parameters. - - - - - Pulls out the right argument to build the splat test. MakeParamsTest makes the actual test. - - - - - Builds the restrictions for calling with a splatted argument array. Ensures that the - argument is still an ICollection of object and that it has the same number of arguments. - - - - - Builds the restrictions for calling with keyword arguments. The restrictions include - tests on the individual keys of the dictionary to ensure they have the same names. - - - - - Creates the MetaObject for indexing directly into arrays or indexing into objects which have - default members. Returns null if we're not an indexing operation. - - - - - Creates the MetaObject for indexing directly into arrays or indexing into objects which have - default members. Returns null if we're not an indexing operation. - - - - - Creates the meta object for the rest of the operations: comparisons and all other - ExpressionType. If the operation cannot be completed a MetaObject which indicates an - error will be returned. - - - - - Creates the meta object for the rest of the operations: comparisons and all other - ExpressionType. If the operation cannot be completed a MetaObject which indicates an - error will be returned. - - - - - Produces a rule for comparing a value to null - supports comparing object references and nullable types. - - - - - Builds a MetaObject for performing a member get. Supports all built-in .NET members, the OperatorMethod - GetBoundMember, and StrongBox instances. - - - The name of the member to retrieve. This name is not processed by the DefaultBinder and - is instead handed off to the GetMember API which can do name mangling, case insensitive lookups, etc... - - - The MetaObject from which the member is retrieved. - - - The value being assigned to the target member. - - - - - Builds a MetaObject for performing a member get. Supports all built-in .NET members, the OperatorMethod - GetBoundMember, and StrongBox instances. - - - The name of the member to retrieve. This name is not processed by the DefaultBinder and - is instead handed off to the GetMember API which can do name mangling, case insensitive lookups, etc... - - - The MetaObject from which the member is retrieved. - - - The value being assigned to the target member. - - - Provides overload resolution and method binding for any calls which need to be performed for the SetMember. - - - - - Builds a MetaObject for performing a member get. Supports all built-in .NET members, the OperatorMethod - GetBoundMember, and StrongBox instances. - - - The name of the member to retrieve. This name is not processed by the DefaultBinder and - is instead handed off to the GetMember API which can do name mangling, case insensitive lookups, etc... - - - The MetaObject from which the member is retrieved. - - - The value being assigned to the target member. - - - Provides a DynamicMetaObject that is to be used as the result if the member cannot be set. If null then then a language - specific error code is provided by ActionBinder.MakeMissingMemberErrorForAssign which can be overridden by the language. - - - - - Builds a MetaObject for performing a member get. Supports all built-in .NET members, the OperatorMethod - GetBoundMember, and StrongBox instances. - - - The name of the member to retrieve. This name is not processed by the DefaultBinder and - is instead handed off to the GetMember API which can do name mangling, case insensitive lookups, etc... - - - The MetaObject from which the member is retrieved. - - - The value being assigned to the target member. - - - Provides overload resolution and method binding for any calls which need to be performed for the SetMember. - - - Provides a DynamicMetaObject that is to be used as the result if the member cannot be set. If null then then a language - specific error code is provided by ActionBinder.MakeMissingMemberErrorForAssign which can be overridden by the language. - - - - if a member-injector is defined-on or registered-for this type call it - - - - Returns true if the method should not be displayed in the stack frame. - - - - - Encapsulates information about the result that should be produced when - a OldDynamicAction cannot be performed. The ErrorInfo can hold one of: - an expression which creates an Exception to be thrown - an expression which produces a value which should be returned - directly to the user and represents an error has occured (for - example undefined in JavaScript) - an expression which produces a value which should be returned - directly to the user but does not actually represent an error. - - ErrorInfo's are produced by an ActionBinder in response to a failed - binding. - - - - - Private constructor - consumers must use static From* factories - to create ErrorInfo objects. - - - - - Creates a new ErrorInfo which represents an exception that should - be thrown. - - - - - Creates a new ErrorInfo which represents a value which should be - returned to the user. - - - - - Crates a new ErrorInfo which represents a value which should be returned - to the user but does not represent an error. - - - - - - - The ErrorInfo expression produces an exception - - - - - The ErrorInfo expression produces a value which represents the error (e.g. undefined) - - - - - The ErrorInfo expression produces a value which is not an error - - - - - A MetaObject which was produced as the result of a failed binding. - - - - - Doesn't need to check PrivateBinding setting: no method that is part of the event is public the entire event is private. - If the code has already a reference to the event tracker instance for a private event its "static-ness" is not influenced - by private-binding setting. - - - - - Gets the stub list for a COM Object. For COM objects we store the stub list - directly on the object using the Marshal APIs. This allows us to not have - any circular references to deal with via weak references which are challenging - in the face of COM. - - - - - Holds on a list of delegates hooked to the event. - We need the list because we cannot enumerate the delegates hooked to CLR event and we need to do so in - handler removal (we need to do custom delegate comparison there). If BCL enables the enumeration we could remove this. - - - - - Storage for the handlers - a key value pair of the callable object and the delegate handler. - - - - - Storage for the handlers - a key value pair of the callable object and the delegate handler. - - The delegate handler is closed over the callable object. Therefore as long as the object is alive the - delegate will stay alive and so will the callable object. That means it's fine to have a weak reference - to both of these objects. - - - - - Represents extension method. - - - - - Gets the declaring type of the extension method. Since this is an extension method, - the declaring type is in fact the type this extension method extends, - not Method.DeclaringType - - - - - Implemented by binders which support light exceptions. Dynamic objects - binding against a binder which implements this interface can check - SupportsLightThrow to see if the binder currently supports safely - returning a light exception. Light exceptions can be created with - LightException.Throw. - - Binders also need to implement GetlightBinder. This method - returns a new call site binder which may return light exceptions if - the binder supports them. - - - - - Returns true if a callsite binding against this binder can - return light exceptions. - - - - - Gets a binder which will support light exception if one is - available. - - - - - Interceptor prototype. The interceptor is a call site binder that wraps - a real call site binder and can perform arbitrary operations on the expression - trees that the wrapped binder produces: - * Dumping the trees - * Additional rewriting - * Static compilation - * ... - - - - - MemberGroups are a collection of MemberTrackers which are commonly produced - on-demand to talk about the available members. They can consist of a mix of - different member types or multiple membes of the same type. - - The most common source of MemberGroups is from ActionBinder.GetMember. From here - the DLR will perform binding to the MemberTrackers frequently producing the value - resulted from the user. If the result of the action produces a member it's self - the ActionBinder can provide the value exposed to the user via ReturnMemberTracker. - - ActionBinder provides default functionality for both getting members from a type - as well as exposing the members to the user. Getting members from the type maps - closely to reflection and exposing them to the user exposes the MemberTrackers - directly. - - - - - Specifies the action for which the default binder is requesting a member. - - - - - Represents a logical member of a type. The member could either be real concrete member on a type or - an extension member. - - This seperates the "physical" members that .NET knows exist on types from the members that - logically exist on a type. It also provides other abstractions above the level of .NET reflection - such as MemberGroups and NamespaceTracker's. - - It also provides a wrapper around the reflection APIs which cannot be extended from partial trust. - - - - - We ensure we only produce one MemberTracker for each member which logically lives on the declaring type. So - for example if you get a member from a derived class which is declared on the base class it should be the same - as getting the member from the base class. That’s easy enough until you get into extension members – here there - might be one extension member which is being applied to multiple types. Therefore we need to take into account the - extension type when ensuring that we only have 1 MemberTracker ever created. - - - - - The type of member tracker. - - - - - The logical declaring type of the member. - - - - - The name of the member. - - - - - Gets the expression that creates the value. - - Returns null if it's an error to get the value. The caller can then call GetErrorForGet to get - the correct error Expression (or null if they should provide a default). - - - - - Gets an expression that assigns a value to the left hand side. - - Returns null if it's an error to assign to. The caller can then call GetErrorForSet to - get the correct error Expression (or null if a default error should be provided). - - - - - Gets an expression that assigns a value to the left hand side. - - Returns null if it's an error to assign to. The caller can then call GetErrorForSet to - get the correct error Expression (or null if a default error should be provided). - - - - - Gets an expression that performs a call on the object using the specified arguments. - - Returns null if it's an error to perform the specific operation. The caller can then call - GetErrorsForDoCall to get the correct error Expression (or null if a default error should be provided). - - - - - Returns the error associated with getting the value. - - A null return value indicates that the default error message should be provided by the caller. - - - - - Returns the error associated with accessing this member via a bound instance. - - A null return value indicates that the default error message should be provided by the caller. - - - - - Helper for getting values that have been bound. Called from BoundMemberTracker. Custom member - trackers can override this to provide their own behaviors when bound to an instance. - - - - - Helper for setting values that have been bound. Called from BoundMemberTracker. Custom member - trackers can override this to provide their own behaviors when bound to an instance. - - - - - Helper for setting values that have been bound. Called from BoundMemberTracker. Custom member - trackers can override this to provide their own behaviors when bound to an instance. - - - - - Binds the member tracker to the specified instance rturning a new member tracker if binding - is possible. If binding is not possible the existing member tracker will be returned. For example - binding to a static field results in returning the original MemberTracker. Binding to an instance - field results in a new BoundMemberTracker which will get GetBoundValue/SetBoundValue to pass the - instance through. - - - - - MethodGroup's represent a unique collection of method's. Typically this - unique set is all the methods which are overloaded by the same name including - methods with different arity. These methods represent a single logically - overloaded element of a .NET type. - - The base DLR binders will produce MethodGroup's when provided with a MemberGroup - which contains only methods. The MethodGroup's will be unique instances per - each unique group of methods. - - - - - Returns a BuiltinFunction bound to the provided type arguments. Returns null if the binding - cannot be performed. - - - - - NamespaceTracker represent a CLS namespace. - - - - - Loads all the types from all assemblies that contribute to the current namespace (but not child namespaces) - - - - - Populates the tree with nodes for each part of the namespace - - - Full namespace name. It can be null (for top-level types) - - - - - As a fallback, so if the type does exist in any assembly. This would happen if a new type was added - that was not in the hardcoded list of types. - This code is not accurate because: - 1. We dont deal with generic types (TypeCollision). - 2. Previous calls to GetCustomMemberNames (eg. "from foo import *" in Python) would not have included this type. - 3. This does not deal with new namespaces added to the assembly - - - - - This stores all the public non-nested type names in a single namespace and from a single assembly. - This allows inspection of the namespace without eagerly loading all the types. Eagerly loading - types slows down startup, increases working set, and is semantically incorrect as it can trigger - TypeLoadExceptions sooner than required. - - - - - Marks a method as not having side effects. used by the combo binder - to allow calls to methods. - - - - - OperatorInfo provides a mapping from DLR ExpressionType to their associated .NET methods. - - - - - Given an operator returns the OperatorInfo associated with the operator or null - - - - - Gets the operator the OperatorInfo provides info for. - - - - - Gets the primary method name associated with the method. - This method name is usally in the form of op_Operator (e.g. op_Addition). - - - - - Gets the secondary method name associated with the method. - This method name is usually a standard .NET method name with pascal casing (e.g. Add). - - - - - Represents a logical Property as a member of a Type. This Property can either be a real - concrete Property on a type (implemented with a ReflectedPropertyTracker) or an extension - property (implemented with an ExtensionPropertyTracker). - - - - - Represents the top reflected package which contains extra information such as - all the assemblies loaded and the built-in modules. - - - - - returns the package associated with the specified namespace and - updates the associated module to mark the package as imported. - - - - - Ensures that the assembly is loaded - - - true if the assembly was loaded for the first time. - false if the assembly had already been loaded before - - - - When an (interop) assembly is loaded, we scan it to discover the GUIDs of COM interfaces so that we can - associate the type definition with COM objects with that GUID. - Since scanning all loaded assemblies can be expensive, in the future, we might consider a more explicit - user binder to trigger scanning of COM types. - - - - Specifies that the member is a constructor, representing a ConstructorTracker - - - Specifies that the member is an event, representing a EventTracker - - - Specifies that the member is a field, representing a FieldTracker - - - Specifies that the member is a method, representing a MethodTracker - - - Specifies that the member is a property, representing a PropertyTracker - - - Specifies that the member is a property, representing a TypeTracker - - - Specifies that the member is a namespace, representing a NamespaceTracker - - - Specifies that the member is a group of method overloads, representing a MethodGroup - - - Specifies that the member is a group of types that very by arity, representing a TypeGroup - - - Specifies that the member is a custom meber, represetning a CustomTracker - - - Specifies that the member is a bound to an instance, representing a BoundMemberTracker - - - - A TypeCollision is used when we have a collision between - two types with the same name. Currently this is only possible w/ generic - methods that should logically have arity as a portion of their name. For eg: - System.EventHandler and System.EventHandler[T] - System.Nullable and System.Nullable[T] - System.IComparable and System.IComparable[T] - - The TypeCollision provides an indexer but also is a real type. When used - as a real type it is the non-generic form of the type. - - The indexer allows the user to disambiguate between the generic and - non-generic versions. Therefore users must always provide additional - information to get the generic version. - - - - The merged list so far. Could be null - The new type(s) to add to the merged list - The merged list. Could be a TypeTracker or TypeGroup - - - Gets the arity of generic parameters - - - No non-generic type is represented by this group. - - - - This returns the DeclaringType of all the types in the TypeGroup - - - - - This returns the base name of the TypeGroup (the name shared by all types minus arity) - - - - - This will return the result only for the non-generic type if one exists, and will throw - an exception if all types in the TypeGroup are generic - - - - - This will return the result only for the non-generic type if one exists, and will throw - an exception if all types in the TypeGroup are generic - - - - - Enables implicit Type to TypeTracker conversions accross dynamic languages. - - - - - Factory methods. - - - - - Null coalescing expression - {result} ::= ((tmp = {_left}) == null) ? {right} : tmp - '??' operator in C#. - - - - - True coalescing expression. - {result} ::= IsTrue(tmp = {left}) ? {right} : tmp - Generalized AND semantics. - - - - - False coalescing expression. - {result} ::= IsTrue(tmp = {left}) ? tmp : {right} - Generalized OR semantics. - - - - - True coalescing expression. - {result} ::= IsTrue(tmp = {left}) ? {right} : tmp - Generalized AND semantics. - - - - - False coalescing expression. - {result} ::= IsTrue(tmp = {left}) ? tmp : {right} - Generalized OR semantics. - - - - - Wraps the given value in a WeakReference and returns a tree that will retrieve - the value from the WeakReference. - - - - - Creates a generator with type IEnumerable{T}, where T is the label.Type - - - - - - - - Creates new instance of the LambdaBuilder with the specified name and return type. - - Return type of the lambda being built. - Name for the lambda being built. - new LambdaBuilder instance - - - - The helper to create the AST method call node. Will add conversions (Utils.Convert) - to parameters and instance if necessary. - - - - - The helper to create the AST method call node. Will add conversions (Utils.Convert) - to parameters and instance if necessary. - - - - - The complex call helper to create the AST method call node. - Will add conversions (Expression.Convert()), deals with default parameter values and params arrays. - - - - - Converts an expression to a void type. - - An to convert to void. - An that has the property equal to and the and property set to void. - - - - Returns an expression that boxes a given value. Uses boxed objects cache for Int32 and Boolean types. - - - - - Determines whether specified expression type represents an assignment. - - - True if the expression type represents an assignment. - - - Note that some other nodes can also assign to variables, members or array items: - MemberInit, NewArrayInit, Call with ref params, New with ref params, Dynamic with ref params. - - - - - Determines if the left child of the given expression is read or written to or both. - - - - - Returns null if no expression was added into the builder. - If only a single expression was added returns it. - Otherwise returns a containing the expressions added to the builder. - - - - - If the number of items added to the builder is greater than 4 returns a read-only collection builder containing all the items. - Returns null otherwise. - - - - - Wrapping a tree in this node enables jumps from finally blocks - It does this by generating control-flow logic in the tree - - Reducing this node requires a full tree walk of its body - (but not nested lambdas) - - WARNING: this node cannot contain jumps across blocks, because it - assumes any unknown jumps are jumps to an outer scope. - - - - - The purpose of this rewriter is simple: ETs do not allow jumps (break, continue, return, goto) - that would go through a finally/fault. So we replace them with code that instead stores a flag, - and then jumps to the end of the finally/fault. At the end of the try-finally, we emit a switch - that then jumps to the correct label. - - A few things that make this more complicated: - - 1. If a finally contains a jump out, then jumps in the try/catch need to be replaced as well. - It's to support cases like this: - # returns 234 - def foo(): - try: return 123 - finally: return 234 - - We need to replace the "return 123" because after it jumps, we'll go to the finally, which - might decide to jump again, but once the IL finally exits, it ignores the finally jump and - keeps going with the original jump. The moral of the story is: if any jumps in finally are - rewritten, try/catch jumps must be also. - - 2. To generate better code, we only have one state variable, so if we have to jump out of - multiple finallys we just keep jumping. It looks sort of like this: - foo: - try { ... } finally { - try { ... } finally { - ... - if (...) { - // was: goto foo; - $flow = 1; goto endInnerFinally; - } - ... - endInnerFinally: - } - switch ($flow) { - case 1: goto endOuterFinally; - } - ... - endOuterFinally: - } - switch ($flow) { - case 1: $flow = 0; goto foo; - } - ... - - - - - - A parameterless generator, that is of type IEnumerable, IEnumerable{T}, - IEnumerator, or IEnumerator{T}. Its body can contain a series of - YieldExpressions. Each call into MoveNext on the enumerator reenters - the generator, and executes until it reaches a YieldReturn or YieldBreak - expression - - - - - The label used by YieldBreak and YieldReturn expressions to yield - from this generator - - - - - The body of the generator, which can contain YieldBreak and - YieldReturn expressions - - - - - Indicates whether the lhs instances are preserved when assignments - are made to expressions containing yields. - - - - - When finding a yield return or yield break, this rewriter flattens out - containing blocks, scopes, and expressions with stack state. All - scopes encountered have their variables promoted to the generator's - closure, so they survive yields. - - - - - Makes an assignment to this variable. Pushes the assignment as far - into the right side as possible, to allow jumps into it. - - - - - Returns true if the expression remains constant no matter when it is evaluated. - - - - - Implemented by expressions which can provide a version which is aware of light exceptions. - - Normally these expressions will simply reduce to a version which throws a real exception. - When the expression is used inside of a region of code which supports light exceptions - the light exception re-writer will call ReduceForLightExceptions. The expression can - then return a new expression which can return a light exception rather than throwing - a real .NET exception. - - - - - The builder for creating the LambdaExpression node. - - Since the nodes require that parameters and variables are created - before hand and then passed to the factories creating LambdaExpression - this builder keeps track of the different pieces and at the end creates - the LambdaExpression. - - TODO: This has some functionality related to CodeContext that should be - removed, in favor of languages handling their own local scopes - - - - - The name of the lambda. - Currently anonymous/unnamed lambdas are not allowed. - - - - - Return type of the lambda being created. - - - - - List of lambda's local variables for direct manipulation. - - - - - List of lambda's parameters for direct manipulation - - - - - The params array argument, if any. - - - - - The body of the lambda. This must be non-null. - - - - - The generated lambda should have dictionary of locals - instead of allocating them directly on the CLR stack. - - - - - The scope is visible (default). Invisible if false. - - - - - Creates a parameter on the lambda with a given name and type. - - Parameters maintain the order in which they are created, - however custom ordering is possible via direct access to - Parameters collection. - - - - - Creates a parameter on the lambda with a given name and type. - - Parameters maintain the order in which they are created, - however custom ordering is possible via direct access to - Parameters collection. - - - - - adds existing parameter to the lambda. - - Parameters maintain the order in which they are created, - however custom ordering is possible via direct access to - Parameters collection. - - - - - Creates a hidden parameter on the lambda with a given name and type. - - Parameters maintain the order in which they are created, - however custom ordering is possible via direct access to - Parameters collection. - - - - - Creates a params array argument on the labmda. - - The params array argument is added to the signature immediately. Before the lambda is - created, the builder validates that it is still the last (since the caller can modify - the order of parameters explicitly by maniuplating the parameter list) - - - - - Creates a local variable with specified name and type. - TODO: simplify by pushing logic into callers - - - - - Creates a local variable with specified name and type. - TODO: simplify by pushing logic into callers - - - - - Creates a temporary variable with specified name and type. - - - - - Adds the temporary variable to the list of variables maintained - by the builder. This is useful in cases where the variable is - created outside of the builder. - - - - - Creates the LambdaExpression from the builder. - After this operation, the builder can no longer be used to create other instances. - - Desired type of the lambda. - New LambdaExpression instance. - - - - Creates the LambdaExpression from the builder. - After this operation, the builder can no longer be used to create other instances. - - New LambdaExpression instance. - - - - Creates the generator LambdaExpression from the builder. - After this operation, the builder can no longer be used to create other instances. - - New LambdaExpression instance. - - - - Fixes up lambda body and parameters to match the signature of the given delegate if needed. - - - - - - Validates that the builder has enough information to create the lambda. - - - - - Provides a method call to a method which may return light exceptions. - - The call is to a method which supports light exceptions. When reducing - an additional check and throw is added. When a block code of is re-written - for light exceptions this instead reduces to not throw a .NET exception. - - - - - Internal re-writer class which creates code which is light exception aware. - - - - - Class used to be avoid overhead of creating expression trees when we're usually - - - - - Adds light exception handling to the provided expression which - is light exception aware. - - - - - Expression which produces a light exception value. This should be constructed - with the expression which creates the exception and this method will then call - a helper method which wraps the exception in our internal light exception class. - - - - - Represents either a YieldBreak or YieldReturn in a GeneratorExpression - If Value is non-null, it's a YieldReturn; otherwise it's a YieldBreak - and executing it will stop enumeration of the generator, causing - MoveNext to return false. - - - - - The value yieled from this expression, if it is a yield return - - - - - Gets the label used to yield from this generator - - - - - These are some generally useful helper methods. Currently the only methods are those to - cached boxed representations of commonly used primitive types so that they can be shared. - This is useful to most dynamic languages that use object as a universal type. - - The methods in RuntimeHelepers are caleld by the generated code. From here the methods may - dispatch to other parts of the runtime to get bulk of the work done, but the entry points - should be here. - - - - - Used by prologue code that is injected in lambdas to ensure that delegate signature matches what - lambda body expects. Such code typically unwraps subset of the params array manually, - but then passes the rest in bulk if lambda body also expects params array. - - This calls ArrayUtils.ShiftLeft, but performs additional checks that - ArrayUtils.ShiftLeft assumes. - - - - - A singleton boxed boolean true. - - - - - A singleton boxed boolean false. - - - - - Gets a singleton boxed value for the given integer if possible, otherwise boxes the integer. - - The value to box. - The boxed value. - - - - Helper method to create an instance. Work around for Silverlight where Activator.CreateInstance - is SecuritySafeCritical. - - TODO: Why can't we just emit the right thing for default(T)? - It's always null for reference types and it's well defined for value types - - - - - EventInfo.EventHandlerType getter is marked SecuritySafeCritical in CoreCLR - This method is to get to the property without using Reflection - - - - - - - Provides the test to see if an interpreted call site should switch over to being compiled. - - - - - Enables an object to be serializable to an Expression tree. The expression tree can then - be emitted into an assembly enabling the de-serialization of the object. - - - - - Wraps all arguments passed to a dynamic site with more arguments than can be accepted by a Func/Action delegate. - The binder generating a rule for such a site should unwrap the arguments first and then perform a binding to them. - - - - - Gets the number of items in _arguments that represent the arguments. - - - - - Helper methods that calls are generated to from the default DLR binders. - - - - - Helper function to combine an object array with a sequence of additional parameters that has been splatted for a function call. - - - - - EventInfo.EventHandlerType getter is marked SecuritySafeCritical in CoreCLR - This method is to get to the property without using Reflection - - - - - - - The MethodBinder will perform normal method binding. - - - - - The MethodBinder will return the languages definition of NotImplemented if the arguments are - incompatible with the signature. - - - - - The MethodBinder will set properties/fields for unused keyword arguments on the instance - that gets returned from the method. - - - - - The delegate representing the DLR Main function - - - - - Implements explicit casts supported by the runtime. - - - Implements explicit casts supported by the runtime. - - - - - Explicitly casts the object to a given type (and returns it as object) - - - - - Represents the context that is flowed for doing Compiler. Languages can derive - from this class to provide additional contextual information. - - - - - Gets the source unit currently being compiled in the CompilerContext. - - - - - Gets the sink for parser callbacks (e.g. brace matching, etc.). - - - - - Gets the current error sink. - - - - - Gets the compiler specific options. - - - - - Abstract base class used for optimized thread-safe dictionaries which have a set - of pre-defined string keys. - - Implementers derive from this class and override the GetExtraKeys, TrySetExtraValue, - and TryGetExtraValue methods. When looking up a value first the extra keys will be - searched using the optimized Try*ExtraValue functions. If the value isn't found there - then the value is stored in the underlying .NET dictionary. - - This dictionary can store object values in addition to string values. It also supports - null keys. - - - - - Gets a list of the extra keys that are cached by the the optimized implementation - of the module. - - - - - Try to set the extra value and return true if the specified key was found in the - list of extra values. - - - - - Try to get the extra value and returns true if the specified key was found in the - list of extra values. Returns true even if the value is Uninitialized. - - - - - Used as the value for the ScriptingRuntimeHelpers.GetDelegate method caching system - - - - - Generates stub to receive the CLR call and then call the dynamic language code. - - - - - Used as the key for the LanguageContext.GetDelegate method caching system - - - - - An attribute that is applied to saved ScriptCode's to be used to re-create the ScriptCode - from disk. - - - - - Gets names stored in optimized scope. - - - - - Provides a mechanism for providing documentation stored in an assembly as metadata. - - Applying this attribute will enable documentation to be provided to the user at run-time - even if XML Documentation files are unavailable. - - - - - Provides support for converting objects to delegates using the DLR binders - available by the provided language context. - - Primarily this supports converting objects implementing IDynamicMetaObjectProvider - to the appropriate delegate type. - - If the provided object is already a delegate of the appropriate type then the - delegate will simply be returned. - - - - - Creates a delegate with a given signature that could be used to invoke this object from non-dynamic code (w/o code context). - A stub is created that makes appropriate conversions/boxing and calls the object. - The stub should be executed within a context of this object's language. - - The converted delegate. - The object is either a subclass of Delegate but not the requested type or does not implement IDynamicMetaObjectProvider. - - - - Represents the type of a null value. - - - - - Private constructor is never called since 'null' is the only valid instance. - - - - - Updates an exception before it's getting re-thrown so - we can present a reasonable stack trace to the user. - - - - - Returns all the stack traces associates with an exception - - - - - Marks a class in the assembly as being an extension type for another type. - - - - - Marks a type in the assembly as being an extension type for another type. - - The type which is being extended - The type which provides the extension members. - - - - The type which contains extension members which are added to the type being extended. - - - - - The type which is being extended by the extension type. - - - - - Indicates that a DynamicMetaObject might be convertible to a CLR type. - - - - - Given an ID returns the object associated with that ID. - - - - - Gets a unique ID for an object - - - - - Goes over the hashtable and removes empty entries - - - - - Weak-ref wrapper caches the weak reference, our hash code, and the object ID. - - - - - WrapperComparer treats Wrapper as transparent envelope - - - - - Provides a list of all the members of an instance. - - - - - Indicates that a MetaObject is already representing a restricted type. Useful - when we're already restricted to a known type but this isn't captured in - the type info (e.g. the type is not sealed). - - - - - A useful interface for taking slices of numeric arrays, inspired by Python's Slice objects. - - - - - The starting index of the slice or null if no first index defined - - - - - The ending index of the slice or null if no ending index defined - - - - - The length of step to take - - - - - Internal class which binds a LanguageContext, StreamContentProvider, and Encoding together to produce - a TextContentProvider which reads binary data with the correct language semantics. - - - - - Provides support for light exceptions. These exceptions are propagated by - returning an instance of a private wrapper class containing the exception. Code - which is aware of light exceptions will branch to apporiate exception handling - blocks when in a try and otherwise return the value up the stack. This avoids - using the underlying CLR exception mechanism with overhead such as creating stack - traces. - - When a light exception reaches the boundary of code which is not light exception - aware the caller must check to see if a light exception is being thrown and if - so raise a .NET exception. - - This class provides methods for re-writing expression trees to support light exceptions, - methods to create light throw objects, check if an object is a light - throw object, and turn such an object back into a .NET Exception which can be thrown. - - Light exceptions also don't build up stack traces or interoperate with filter blocks - via 2-pass exception handling. - - - - - Rewrites the provided expression to support light exceptions. - - Calls to the returned expression, if not from other light-weight aware calls, - need to call GetLightException on return to see if an exception was thrown - and if so throw it. - - - - - Returns a new expression which will lazily reduce to a light - expression re-written version of the same expression. - - - - - Returns a new expression which is re-written for light exceptions - but will throw an exception if it escapes the expression. If this - expression is part of a larger experssion which is later re-written - for light exceptions then it will propagate the light exception up. - - - - - Returns an object which represents a light exception. - - - - - Returns an object which represents a light exception. - - - - - Returns an object which represents a light exception. - - - - - If the binder supports light exceptions then a light exception throwing expression is returned. - - Otherwise a normal throwing expression is returned. - - - - - If the binder supports light exceptions then a light exception throwing expression is returned. - - Otherwise a normal throwing expression is returned. - - - - - Throws the exception if the value represents a light exception - - - - - Wraps the expression in a check and rethrow. - - - - - Checks to see if the provided value is a light exception. - - - - - Gets the light exception from an object which may contain a light - exception. Returns null if the object is not a light exception. - - Used for throwing the exception at non-light exception boundaries. - - - - - Returns true if the call site binder is a light exception binder and supports - light throws. Returns false otherwise. - - - - - - - Sealed wrapper class to indicate something is a light exception. - - - - - Marks a method which may return a light exception. Such - methods need to have their return value checked and the exception - will need to be thrown if the caller is not light exception aware. - - - - - Creates a dictionary of locals in this scope - - - - - Returns Microsoft.Scripting.Runtime.DynamicNull if the object contains a null value, - otherwise, returns self.LimitType - - - - - Returns Microsoft.Scripting.Runtime.DynamicNull if the object contains a null value, - otherwise, returns self.RuntimeType - - - - - Event args for when a ScriptScope has had its contents changed. - - - - - Creates a new ModuleChangeEventArgs object with the specified name and type. - - - - - Creates a nwe ModuleChangeEventArgs with the specified name, type, and changed value. - - - - - Gets the name of the symbol that has changed. - - - - - Gets the way in which the symbol has changed: Set or Delete. - - - - - Gets the symbol has been set provides the new value. - - - - - The way in which a module has changed : Set or Delete - - - - - A new value has been set in the module (or a previous value has changed). - - - - - A value has been removed from the module. - - - - - A NullTextContentProvider to be provided when we have a pre-compiled ScriptCode which doesn't - have source code associated with it. - - - - - Singleton instance returned from an operator method when the operator method cannot provide a value. - - - - - Represents an ops-extension method which is added as an operator. - - The name must be a well-formed name such as "Add" that matches the CLS - naming conventions for adding overloads associated with op_* methods. - - - - - Efficiently tracks (line,column) information as text is added, and - collects line mappings between the original and generated source code - so we can generate correct debugging information later - - - - - Marks the current position of the writer as corresponding to the - original location passed in - - the line pragma corresponding to the - current position in the generated code - - - - Represents an ops-extension method which is used to implement a property. - - - - - Provides a cache of reflection members. Only one set of values is ever handed out per a - specific request. - - - - - TODO: Make me private again - - - - - Indicates an extension method should be added as a static method, not a instance method. - - - - - Sets the current position inside current token or one character behind it. - - - - - Sets the current position inside current token or one character behind it. - A relative displacement with respect to the current position in the token is specified. - - - - - Marks token end. Enables to read the current token. - - - - - Marks token start. It means the buffer can drop the current token. - Can be called even if no token has been read yet. - - - - - Reads till the end of line and returns the character that stopped the reading. - The returned character is not skipped. - - - - - Resizes an array to a speficied new size and copies a portion of the original array into its beginning. - - - - - Provides services for loading XAML and binding events to dynamic language code definitions. - - - - - Loads XAML from the specified stream and returns the deserialized object. Any event handlers - are bound to methods defined in the provided Scope and converted using the provided DynamicOperations - object. - - - - - Loads XAML from the specified filename and returns the deserialized object. Any event handlers - are bound to methods defined in the provided Scope and converted using the provided DynamicOperations - object. - - - - - Loads XAML from the specified XmlReader and returns the deserialized object. Any event handlers - are bound to methods defined in the provided Scope and converted using the provided DynamicOperations - object. - - - - - Loads XAML from the specified TextReader and returns the deserialized object. Any event handlers - are bound to methods defined in the provided Scope and converted using the provided DynamicOperations - object. - - - - - Loads XAML from the specified XamlXmlReader and returns the deserialized object. Any event handlers - are bound to methods defined in the provided Scope and converted using the provided DynamicOperations - object. - - - - - Returns the list of x:Name'd objects that we saw and should set on the root object. - - - - - Dummy, should never be called - - - - - Stores information needed to emit debugging symbol information for a - source file, in particular the file name and unique language identifier - - - - - Gets the source file name. - - - - - Gets the language's unique identifier, if any. - - - - - Gets the language vendor's unique identifier, if any. - - - - - ArgBuilder provides an argument value used by the MethodBinder. One ArgBuilder exists for each - physical parameter defined on a method. - - Contrast this with ParameterWrapper which represents the logical argument passed to the method. - - - - - Provides the Expression which provides the value to be passed to the argument. - - - - - Provides the Expression which provides the value to be passed to the argument. - This method is called when result is intended to be used ByRef. - - - - - Provides an Expression which will update the provided value after a call to the method. - May return null if no update is required. - - - - - Provides the implementation of performing AddAssign and SubtractAssign binary operations. - - The binder provided by the call site. - The handler for the operation. - The result of the operation. - true if the operation is complete, false if the call site should determine behavior. - - - - Adds a handler to an event. - - The handler to be added. - The original event with handler added. - - - - Removes handler from the event. - - The handler to be removed. - The original event with handler removed. - - - - Provides helper methods to bind COM objects dynamically. - - - - - Determines if an object is a COM object. - - The object to test. - true if the object is a COM object, false otherwise. - - - - Tries to perform binding of the dynamic get member operation. - - An instance of the that represents the details of the dynamic operation. - The target of the dynamic operation. - The new representing the result of the binding. - true if member evaluation may be delayed. - true if operation was bound successfully; otherwise, false. - - - - Tries to perform binding of the dynamic get member operation. - - An instance of the that represents the details of the dynamic operation. - The target of the dynamic operation. - The new representing the result of the binding. - true if operation was bound successfully; otherwise, false. - - - - Tries to perform binding of the dynamic set member operation. - - An instance of the that represents the details of the dynamic operation. - The target of the dynamic operation. - The representing the value for the set member operation. - The new representing the result of the binding. - true if operation was bound successfully; otherwise, false. - - - - Tries to perform binding of the dynamic invoke operation. - - An instance of the that represents the details of the dynamic operation. - The target of the dynamic operation. - An array of instances - arguments to the invoke member operation. - The new representing the result of the binding. - true if operation was bound successfully; otherwise, false. - - - - Tries to perform binding of the dynamic invoke member operation. - - An instance of the that represents the details of the dynamic operation. - The target of the dynamic operation. - An array of instances - arguments to the invoke member operation. - The new representing the result of the binding. - true if operation was bound successfully; otherwise, false. - - - - Tries to perform binding of the dynamic get index operation. - - An instance of the that represents the details of the dynamic operation. - The target of the dynamic operation. - An array of instances - arguments to the invoke member operation. - The new representing the result of the binding. - true if operation was bound successfully; otherwise, false. - - - - Tries to perform binding of the dynamic set index operation. - - An instance of the that represents the details of the dynamic operation. - The target of the dynamic operation. - An array of instances - arguments to the invoke member operation. - The representing the value for the set index operation. - The new representing the result of the binding. - true if operation was bound successfully; otherwise, false. - - - - Tries to perform binding of the dynamic Convert operation. - - An instance of the that represents the details of the dynamic operation. - The target of the dynamic operation. - The new representing the result of the binding. - true if operation was bound successfully; otherwise, false. - - - - Gets the member names associated with the object. - This function can operate only with objects for which returns true. - - The object for which member names are requested. - The collection of member names. - - - - Gets the member names of the data-like members associated with the object. - This function can operate only with objects for which returns true. - - The object for which member names are requested. - The collection of member names. - - - - Gets the data-like members and associated data for an object. - This function can operate only with objects for which returns true. - - The object for which data members are requested. - The enumeration of names of data members for which to retrieve values. - The collection of pairs that represent data member's names and their data. - - - - Special binder that indicates special semantics for COM GetMember operation. - - - - - This class implements an event sink for a particular RCW. - Unlike the implementation of events in TlbImp'd assemblies, - we will create only one event sink per RCW (theoretically RCW might have - several ComEventSink evenk sinks - but all these implement different source intefaces). - Each ComEventSink contains a list of ComEventSinkMethod objects - which represent - a single method on the source interface an a multicast delegate to redirect - the calls. Notice that we are chaining multicast delegates so that same - ComEventSinkMedhod can invoke multiple event handlers). - - ComEventSink implements an IDisposable pattern to Unadvise from the connection point. - Typically, when RCW is finalized the corresponding Dispose will be triggered by - ComEventSinksContainer finalizer. Notice that lifetime of ComEventSinksContainer - is bound to the lifetime of the RCW. - - - - - Contains a methods DISPID (in a string formatted of "[DISPID=N]" - and a chained list of delegates to invoke - - - - - ComEventSinkProxy class is responsible for handling QIs for sourceIid - on instances of ComEventSink. - - Background: When a COM even sink advises to a connection point it is - supposed to hand over the dispinterface. Now, some hosts will trust - the COM client to pass the correct pointer, but some will not. - E.g. Excel's implementation of Connection Points will not cause a - QI on the pointer that has been passed, however Word will QI the - pointer to return the required interface. - - ComEventSink does not, strongly speaking, implements the interface - that it claims to implement - it is just "faking" it by using IReflect. - Thus, Word's QIs on the pointer passed to ICP::Advise would fail. To - prevent this we take advangate of RealProxy's ability of - "dressing up" like other classes and hence successfully respond to QIs - for interfaces that it does not really support( it is OK to say - "I implement this interface" for event sinks only since the common - practice is to use IDistpach.Invoke when calling into event sinks). - - - - - ComEventSinksContainer is just a regular list with a finalizer. - This list is usually attached as a custom data for RCW object and - is finalized whenever RCW is finalized. - - - - - Layout of the IDispatch vtable - - - - - Invokes the object. If it falls back, just produce an error. - - - - - Splats the arguments to another nested dynamic site, which does the - real invocation of the IDynamicMetaObjectProvider. - - - - - Create a stub for the target of the optimized lopop. - - - - - - Gets expressions to access all the arguments. This includes the instance argument. - - - - - This is a helper class for runtime-callable-wrappers of COM instances. We create one instance of this type - for every generic RCW instance. - - - - - This is the factory method to get the ComObject corresponding to an RCW - - - - - - The parameter description of a method defined in a type library - - - - - Creates a representation for the paramter of a COM method - - - - - Creates a representation for the return value of a COM method - TODO: Return values should be represented by a different type - - - - - DBNull.Value if there is no default value - - - - - Look for typeinfo using IDispatch.GetTypeInfo - - - - Some COM objects just dont expose typeinfo. In these cases, this method will return null. - Some COM objects do intend to expose typeinfo, but may not be able to do so if the type-library is not properly - registered. This will be considered as acceptable or as an error condition depending on throwIfMissingExpectedTypeInfo - - - - - This method should be called when typeinfo is not available for an object. The function - will check if the typeinfo is expected to be missing. This can include error cases where - the same error is guaranteed to happen all the time, on all machines, under all circumstances. - In such cases, we just have to operate without the typeinfo. - - However, if accessing the typeinfo is failing in a transient way, we might want to throw - an exception so that we will eagerly predictably indicate the problem. - - - - - This class contains methods that either cannot be expressed in C#, or which require writing unsafe code. - Callers of these methods need to use them extremely carefully as incorrect use could cause GC-holes - and other problems. - - - - - - Ensure that "value" is a local variable in some caller's frame. So converting - the byref to an IntPtr is a safe operation. Alternatively, we could also allow - allowed "value" to be a pinned object. - - - - - We will emit an indirect call to an unmanaged function pointer from the vtable of the given interface pointer. - This approach can take only ~300 instructions on x86 compared with ~900 for Marshal.Release. We are relying on - the JIT-compiler to do pinvoke-stub-inlining and calling the pinvoke target directly. - - - - - We will emit an indirect call to an unmanaged function pointer from the vtable of the given IDispatch interface pointer. - It is not possible to express this in C#. Using an indirect pinvoke call allows us to do our own marshalling. - We can allocate the Variant arguments cheaply on the stack. We are relying on the JIT-compiler to do - pinvoke-stub-inlining and calling the pinvoke target directly. - The alternative of calling via a managed interface declaration of IDispatch would have a performance - penalty of going through a CLR stub that would have to re-push the arguments on the stack, etc. - Marshal.GetDelegateForFunctionPointer could be used here, but its too expensive (~2000 instructions on x86). - - - - - Cached information from a TLB. Only information that is required is saved. CoClasses are used - for event hookup. Enums are stored for accessing symbolic names from scripts. - - - - - Reads the latest registered type library for the corresponding GUID, - reads definitions of CoClass'es and Enum's from this library - and creates a IDynamicMetaObjectProvider that allows to instantiate coclasses - and get actual values for the enums. - - Type Library Guid - ComTypeLibDesc object - - - - Gets an ITypeLib object from OLE Automation compatible RCW , - reads definitions of CoClass'es and Enum's from this library - and creates a IDynamicMetaObjectProvider that allows to instantiate coclasses - and get actual values for the enums. - - OLE automation compatible RCW - ComTypeLibDesc object - - - - This represents a bound dispmember on a IDispatch object. - - - - - This is similar to ComTypes.EXCEPINFO, but lets us do our own custom marshaling - - - - - An object that implements IDispatch - - This currently has the following issues: - 1. If we prefer ComObjectWithTypeInfo over IDispatchComObject, then we will often not - IDispatchComObject since implementations of IDispatch often rely on a registered type library. - If we prefer IDispatchComObject over ComObjectWithTypeInfo, users get a non-ideal experience. - 2. IDispatch cannot distinguish between properties and methods with 0 arguments (and non-0 - default arguments?). So obj.foo() is ambiguous as it could mean invoking method foo, - or it could mean invoking the function pointer returned by property foo. - We are attempting to find whether we need to call a method or a property by examining - the ITypeInfo associated with the IDispatch. ITypeInfo tell's use what parameters the method - expects, is it a method or a property, what is the default property of the object, how to - create an enumerator for collections etc. - 3. IronPython processes the signature and converts ref arguments into return values. - However, since the signature of a DispMethod is not available beforehand, this conversion - is not possible. There could be other signature conversions that may be affected. How does - VB6 deal with ref arguments and IDispatch? - - We also support events for IDispatch objects: - Background: - COM objects support events through a mechanism known as Connect Points. - Connection Points are separate objects created off the actual COM - object (this is to prevent circular references between event sink - and event source). When clients want to sink events generated by - COM object they would implement callback interfaces (aka source - interfaces) and hand it over (advise) to the Connection Point. - - Implementation details: - When IDispatchComObject.TryGetMember request is received we first check - whether the requested member is a property or a method. If this check - fails we will try to determine whether an event is requested. To do - so we will do the following set of steps: - 1. Verify the COM object implements IConnectionPointContainer - 2. Attempt to find COM object's coclass's description - a. Query the object for IProvideClassInfo interface. Go to 3, if found - b. From object's IDispatch retrieve primary interface description - c. Scan coclasses declared in object's type library. - d. Find coclass implementing this particular primary interface - 3. Scan coclass for all its source interfaces. - 4. Check whether to any of the methods on the source interfaces matches - the request name - - Once we determine that TryGetMember requests an event we will return - an instance of BoundDispEvent class. This class has InPlaceAdd and - InPlaceSubtract operators defined. Calling InPlaceAdd operator will: - 1. An instance of ComEventSinksContainer class is created (unless - RCW already had one). This instance is hanged off the RCW in attempt - to bind the lifetime of event sinks to the lifetime of the RCW itself, - meaning event sink will be collected once the RCW is collected (this - is the same way event sinks lifetime is controlled by PIAs). - Notice: ComEventSinksContainer contains a Finalizer which will go and - unadvise all event sinks. - Notice: ComEventSinksContainer is a list of ComEventSink objects. - 2. Unless we have already created a ComEventSink for the required - source interface, we will create and advise a new ComEventSink. Each - ComEventSink implements a single source interface that COM object - supports. - 3. ComEventSink contains a map between method DISPIDs to the - multicast delegate that will be invoked when the event is raised. - 4. ComEventSink implements IReflect interface which is exposed as - custom IDispatch to COM consumers. This allows us to intercept calls - to IDispatch.Invoke and apply custom logic - in particular we will - just find and invoke the multicast delegate corresponding to the invoked - dispid. - - - - - ArgBuilder which always produces null. - - - - - SimpleArgBuilder produces the value produced by the user as the argument value. It - also tracks information about the original parameter and is used to create extended - methods for params arrays and param dictionary functions. - - - - - If a managed user type (as opposed to a primitive type or a COM object) is passed as an argument to a COM call, we need - to determine the VarEnum type we will marshal it as. We have the following options: - 1. Raise an exception. Languages with their own version of primitive types would not be able to call - COM methods using the language's types (for eg. strings in IronRuby are not System.String). An explicit - cast would be needed. - 2. We could marshal it as VT_DISPATCH. Then COM code will be able to access all the APIs in a late-bound manner, - but old COM components will probably malfunction if they expect a primitive type. - 3. We could guess which primitive type is the closest match. This will make COM components be as easily - accessible as .NET methods. - 4. We could use the type library to check what the expected type is. However, the type library may not be available. - - VarEnumSelector implements option # 3 - - - - - Gets the managed type that an object needs to be coverted to in order for it to be able - to be represented as a Variant. - - In general, there is a many-to-many mapping between Type and VarEnum. However, this method - returns a simple mapping that is needed for the current implementation. The reason for the - many-to-many relation is: - 1. Int32 maps to VT_I4 as well as VT_ERROR, and Decimal maps to VT_DECIMAL and VT_CY. However, - this changes if you throw the wrapper types into the mix. - 2. There is no Type to represent COM types. __ComObject is a private type, and Object is too - general. - - - - - Creates a family of COM types such that within each family, there is a completely non-lossy - conversion from a type to an earlier type in the family. - - - - - Get the (one representative type for each) primitive type families that the argument can be converted to - - - - - If there is more than one type family that the argument can be converted to, we will throw a - AmbiguousMatchException instead of randomly picking a winner. - - - - - Is there a unique primitive type that has the best conversion for the argument - - - - - Get the COM Variant type that argument should be marshaled as for a call to COM - - - - - Variant is the basic COM type for late-binding. It can contain any other COM data type. - This type definition precisely matches the unmanaged data layout so that the struct can be passed - to and from COM calls. - - - - - Primitive types are the basic COM types. It includes valuetypes like ints, but also reference types - like BStrs. It does not include composite types like arrays and user-defined COM types (IUnknown/IDispatch). - - - - - Get the managed object representing the Variant. - - - - - - Release any unmanaged memory associated with the Variant - - - - - - VariantBuilder handles packaging of arguments into a Variant for a call to IDispatch.Invoke - - - - - Strongly-typed and parameterized string factory. - - - Strongly-typed and parameterized string factory. - - - - - A string like "COM object is expected." - - - - - A string like "Cannot perform call." - - - - - A string like "COM object does not support events." - - - - - A string like "COM object does not support specified source interface." - - - - - A string like "Marshal.SetComObjectData failed." - - - - - A string like "This method exists only to keep the compiler happy." - - - - - A string like "Unexpected VarEnum {0}." - - - - - A string like "Error while invoking {0}." - - - - - A string like "Error while invoking {0}." - - - - - A string like "Error while invoking {0}. Named arguments are not supported." - - - - - A string like "Error while invoking {0}." - - - - - A string like "Could not convert argument {0} for call to {1}." - - - - - A string like "Error while invoking {0}. A required parameter was omitted." - - - - - A string like "ResolveComReference.CannotRetrieveTypeInformation." - - - - - A string like "IDispatch::GetIDsOfNames behaved unexpectedly for {0}." - - - - - A string like "Attempting to wrap an unsupported enum type." - - - - - A string like "Attempting to pass an event handler of an unsupported type." - - - - - A string like "Could not get dispatch ID for {0} (error: {1})." - - - - - A string like "There are valid conversions from {0} to {1}." - - - - - A string like "Variant.GetAccessor cannot handle {0}." - - - - - A string like "Cannot access member {1} declared on type {0} because the type contains generic parameters." - - - - - A string like "Type '{0}' is missing or cannot be loaded." - - - - - A string like "static property "{0}" of "{1}" can only be read through a type, not an instance" - - - - - A string like "static property "{0}" of "{1}" can only be assigned to through a type, not an instance" - - - - - A string like "Method precondition violated" - - - - - A string like "Invalid argument value" - - - - - A string like "Non-empty string required" - - - - - A string like "Non-empty collection required" - - - - - A string like "must by an Exception instance" - - - - - A string like "Type of test must be bool" - - - - - A string like "Type of the expression must be bool" - - - - - A string like "Empty string is not a valid path." - - - - - A string like "Invalid delegate type (Invoke method not found)." - - - - - A string like "expected only static property" - - - - - A string like "Property doesn't exist on the provided type" - - - - - A string like "Field doesn't exist on provided type" - - - - - A string like "Type doesn't have constructor with a given signature" - - - - - A string like "Type doesn't have a method with a given name." - - - - - A string like "Type doesn't have a method with a given name and signature." - - - - - A string like "Count must be non-negative." - - - - - A string like "arrayType must be an array type" - - - - - A string like "Either code or target must be specified." - - - - - A string like "Type parameter is {0}. Expected a delegate." - - - - - A string like "Cannot cast from type '{0}' to type '{1}" - - - - - A string like "unknown member type: '{0}'. " - - - - - A string like "RuleBuilder can only be used with delegates whose first argument is CallSite." - - - - - A string like "no instance for call." - - - - - A string like "Missing Test." - - - - - A string like "Missing Target." - - - - - A string like "The operation requires a non-generic type for {0}, but this represents generic types only" - - - - - A string like "Invalid operation: '{0}'" - - - - - A string like "Finally already defined." - - - - - A string like "Can not have fault and finally." - - - - - A string like "Fault already defined." - - - - - A string like "Cannot create default value for type {0}." - - - - - A string like "Unhandled convert: {0}" - - - - - A string like "{0}.{1} has no publiclly visible method." - - - - - A string like "Global/top-level local variable names must be unique." - - - - - A string like "Generating code from non-serializable CallSiteBinder." - - - - - A string like "Specified path is invalid." - - - - - A string like "Dictionaries are not hashable." - - - - - A string like "language already registered." - - - - - A string like "The method or operation is not implemented." - - - - - A string like "No exception." - - - - - A string like "Extension type {0} must be public." - - - - - A string like "Already initialized." - - - - - A string like "CreateScopeExtension must return a scope extension." - - - - - A string like "Invalid number of parameters for the service." - - - - - A string like "Invalid type of argument {0}; expecting {1}." - - - - - A string like "Cannot change non-caching value." - - - - - A string like "Field {0} is read-only" - - - - - A string like "Property {0} is read-only" - - - - - A string like "Expected event from {0}.{1}, got event from {2}.{3}." - - - - - A string like "expected bound event, got {0}." - - - - - A string like "Expected type {0}, got {1}." - - - - - A string like "can only write to member {0}." - - - - - A string like "No code to compile." - - - - - A string like "Invalid stream type: {0}." - - - - - A string like "Queue empty." - - - - - A string like "Enumeration has not started. Call MoveNext." - - - - - A string like "Enumeration already finished." - - - - - A string like "can't add another casing for identifier {0}" - - - - - A string like "can't add new identifier {0}" - - - - - A string like "Type '{0}' doesn't provide a suitable public constructor or its implementation is faulty: {1}" - - - - - A string like "Invalid output directory." - - - - - A string like "Invalid assembly name or file extension." - - - - - A string like "Cannot emit constant {0} ({1})" - - - - - A string like "No implicit cast from {0} to {1}" - - - - - A string like "No explicit cast from {0} to {1}" - - - - - A string like "name '{0}' not defined" - - - - - A string like "No default value for a given type." - - - - - A string like "Specified language provider type is not registered." - - - - - A string like "can't read from property" - - - - - A string like "can't write to property" - - - - - A string like "Cannot create instance of {0} because it contains generic parameters" - - - - - A string like "Non-verifiable assembly generated: {0}:\nAssembly preserved as {1}\nError text:\n{2}\n" - - - - - Strongly-typed and parameterized exception factory. - - - Strongly-typed and parameterized exception factory. - - - - - ArgumentException with message like "COM object does not support events." - - - - - ArgumentException with message like "COM object does not support specified source interface." - - - - - InvalidOperationException with message like "Marshal.SetComObjectData failed." - - - - - InvalidOperationException with message like "This method exists only to keep the compiler happy." - - - - - InvalidOperationException with message like "Unexpected VarEnum {0}." - - - - - System.Reflection.TargetParameterCountException with message like "Error while invoking {0}." - - - - - MissingMemberException with message like "Error while invoking {0}." - - - - - ArgumentException with message like "Error while invoking {0}. Named arguments are not supported." - - - - - OverflowException with message like "Error while invoking {0}." - - - - - ArgumentException with message like "Could not convert argument {0} for call to {1}." - - - - - ArgumentException with message like "Error while invoking {0}. A required parameter was omitted." - - - - - InvalidOperationException with message like "ResolveComReference.CannotRetrieveTypeInformation." - - - - - ArgumentException with message like "IDispatch::GetIDsOfNames behaved unexpectedly for {0}." - - - - - InvalidOperationException with message like "Attempting to wrap an unsupported enum type." - - - - - InvalidOperationException with message like "Attempting to pass an event handler of an unsupported type." - - - - - MissingMemberException with message like "Could not get dispatch ID for {0} (error: {1})." - - - - - System.Reflection.AmbiguousMatchException with message like "There are valid conversions from {0} to {1}." - - - - - NotImplementedException with message like "Variant.GetAccessor cannot handle {0}." - - - - - ArgumentException with message like "Either code or target must be specified." - - - - - InvalidOperationException with message like "Type parameter is {0}. Expected a delegate." - - - - - InvalidOperationException with message like "Cannot cast from type '{0}' to type '{1}" - - - - - InvalidOperationException with message like "unknown member type: '{0}'. " - - - - - InvalidOperationException with message like "RuleBuilder can only be used with delegates whose first argument is CallSite." - - - - - InvalidOperationException with message like "no instance for call." - - - - - InvalidOperationException with message like "Missing Test." - - - - - InvalidOperationException with message like "Missing Target." - - - - - TypeLoadException with message like "The operation requires a non-generic type for {0}, but this represents generic types only" - - - - - ArgumentException with message like "Invalid operation: '{0}'" - - - - - InvalidOperationException with message like "Finally already defined." - - - - - InvalidOperationException with message like "Can not have fault and finally." - - - - - InvalidOperationException with message like "Fault already defined." - - - - - ArgumentException with message like "Cannot create default value for type {0}." - - - - - ArgumentException with message like "Unhandled convert: {0}" - - - - - InvalidOperationException with message like "{0}.{1} has no publiclly visible method." - - - - - ArgumentException with message like "Global/top-level local variable names must be unique." - - - - - ArgumentException with message like "Generating code from non-serializable CallSiteBinder." - - - - - ArgumentException with message like "Specified path is invalid." - - - - - ArgumentTypeException with message like "Dictionaries are not hashable." - - - - - InvalidOperationException with message like "language already registered." - - - - - NotImplementedException with message like "The method or operation is not implemented." - - - - - InvalidOperationException with message like "No exception." - - - - - ArgumentException with message like "Extension type {0} must be public." - - - - - InvalidOperationException with message like "Already initialized." - - - - - InvalidImplementationException with message like "CreateScopeExtension must return a scope extension." - - - - - ArgumentException with message like "Invalid number of parameters for the service." - - - - - ArgumentException with message like "Invalid type of argument {0}; expecting {1}." - - - - - ArgumentException with message like "Cannot change non-caching value." - - - - - MissingMemberException with message like "Field {0} is read-only" - - - - - MissingMemberException with message like "Property {0} is read-only" - - - - - ArgumentException with message like "Expected event from {0}.{1}, got event from {2}.{3}." - - - - - ArgumentTypeException with message like "expected bound event, got {0}." - - - - - ArgumentTypeException with message like "Expected type {0}, got {1}." - - - - - MemberAccessException with message like "can only write to member {0}." - - - - - InvalidOperationException with message like "No code to compile." - - - - - ArgumentException with message like "Invalid stream type: {0}." - - - - - InvalidOperationException with message like "Queue empty." - - - - - InvalidOperationException with message like "Enumeration has not started. Call MoveNext." - - - - - InvalidOperationException with message like "Enumeration already finished." - - - - - InvalidOperationException with message like "can't add another casing for identifier {0}" - - - - - InvalidOperationException with message like "can't add new identifier {0}" - - - - - ArgumentException with message like "Invalid output directory." - - - - - ArgumentException with message like "Invalid assembly name or file extension." - - - - - ArgumentException with message like "Cannot emit constant {0} ({1})" - - - - - ArgumentException with message like "No implicit cast from {0} to {1}" - - - - - ArgumentException with message like "No explicit cast from {0} to {1}" - - - - - MissingMemberException with message like "name '{0}' not defined" - - - - - ArgumentException with message like "No default value for a given type." - - - - - ArgumentException with message like "Specified language provider type is not registered." - - - - - InvalidOperationException with message like "can't read from property" - - - - - InvalidOperationException with message like "can't write to property" - - - - - ArgumentException with message like "Cannot create instance of {0} because it contains generic parameters" - - - - - System.Security.VerificationException with message like "Non-verifiable assembly generated: {0}:\nAssembly preserved as {1}\nError text:\n{2}\n" - - - - - Used by compilers to provide additional debug information about LambdaExpression to DebugContext - - - - - Implemented by compilers to allow the traceback engine to get additional information. - - - - - Provides services to compilers for instrumenting code with tracebacks. - - - - - Creates a new instance of DebugContext - - - - - Transforms a LambdaExpression to a debuggable LambdaExpression - - - - - Transforms a LambdaExpression to a debuggable LambdaExpression - - - - - Resets a state associated with a source file that's maintained in the DebugContext - - - - - Threads - - - - - Hook - - - - - Thread - - - - - FrameOrder - - - - - Variables - - - - - CurrentSequencePointIndex - - - - - // This method is called from the generator to update the frame with generator's locals - - - - - Remaps the frame's state to use the generator for execution. - - Int32.MaxValue to map to latest version - - - - DebuggableLambdaBuilder is used to transform a DLR expression tree into a debuggable lambda expression. - - - - - Used to wrap a lambda that was already a generator prior to transform. - - - - - Used to rewrite expressions containing DebugInfoExpressions. - - - - - Combines source file and span. Also provides Contains and Intersects functionality. - - - - - Implementation of IDebugRuntimeVariables, which wraps IRuntimeVariables + FunctionInfo/DebugMarker - - - - - Default implementation of BaseDebugThread, which uses DLR's RuntimeVariablesExpression for lifting locals. - - - - - Default implementation of IDebugThreadFactory, which uses DLR's RuntimeVariablesExpression for lifting locals. - - - - - SequencePoints - - - - - Gets the name. - - - - - Gets the custom payload. - - - - - GetTraceLocations - - - - - - Callback that is fired by the traceback engine - - - - - Used to extract locals information from expressions. - - - - - Strongly-typed and parameterized string factory. - - - - - IDebugRuntimeVariables is used to wrap IRuntimeVariables and add properties for retrieving - FunctionInfo and DebugMarker from debuggable labmdas. - - - - - IDebugThreadFactory is used to abstract how frames and local variables are maintained at run/debug time. - - - - - Implements IRuntimeVariables in a way that preserves scoping within the lambda. - - - - - TraceSession. - - Basically holds a list of last encountered DebugFrame instances - (one per running thread). - - - - - Used to provide information about locals/parameters at debug time. - - - - - Index within byref variables list or within strongbox variables list. - - - - - Index within the combined list. - - - - - Gets the variable type. - - - - - Gets the name. - - - - - Gets or sets a value indicating whether it is a parameter. - - - - - This class holds onto internal debugging options used in this assembly. - These options can be set via environment variables DLR_{option-name}. - Boolean options map "true" to true and other values to false. - - These options are for internal debugging only, and should not be - exposed through any public APIs. - - - - - True if the MethodBase is method which is going to construct an object - - - - - Returns the System.Type for any object, including null. The type of null - is represented by None.Type and all other objects just return the - result of Object.GetType - - - - - Simply returns a Type[] from calling GetType on each element of args. - - - - - EMITTED - Used by default method binder to check types of splatted arguments. - - - - - Given a MethodInfo which may be declared on a non-public type this attempts to - return a MethodInfo which will dispatch to the original MethodInfo but is declared - on a public type. - - Returns the original method if the method if a public version cannot be found. - - - - - Non-public types can have public members that we find when calling type.GetMember(...). This - filters out the non-visible members by attempting to resolve them to the correct visible type. - - If no correct visible type can be found then the member is not visible and we won't call it. - - - - - Sees if two MemberInfos point to the same underlying construct in IL. This - ignores the ReflectedType property which exists on MemberInfos which - causes direct comparisons to be false even if they are the same member. - - - - - Returns a value which indicates failure when a OldConvertToAction of ImplicitTry or - ExplicitTry. - - - - - Creates an interpreted delegate for the lambda. - - The lambda to compile. - A delegate which can interpret the lambda. - - - - Creates an interpreted delegate for the lambda. - - The lambda to compile. - The number of iterations before the interpreter starts compiling - A delegate which can interpret the lambda. - - - - Creates an interpreted delegate for the lambda. - - The lambda's delegate type. - The lambda to compile. - A delegate which can interpret the lambda. - - - - Creates an interpreted delegate for the lambda. - - The lambda to compile. - The number of iterations before the interpreter starts compiling - A delegate which can interpret the lambda. - - - - Compiles the lambda into a method definition. - - the lambda to compile - A which will be used to hold the lambda's IL. - A parameter that indicates if debugging information should be emitted to a PDB symbol store. - - - - Compiles the LambdaExpression. - - If the lambda is compiled with emitDebugSymbols, it will be - generated into a TypeBuilder. Otherwise, this method is the same as - calling LambdaExpression.Compile() - - This is a workaround for a CLR limitiation: DynamicMethods cannot - have debugging information. - - the lambda to compile - true to generate a debuggable method, false otherwise - the compiled delegate - - - - Compiles the LambdaExpression, emitting it into a new type, and - optionally making it debuggable. - - This is a workaround for a CLR limitiation: DynamicMethods cannot - have debugging information. - - the lambda to compile - Debugging information generator used by the compiler to mark sequence points and annotate local variables. - True if debug symbols (PDBs) are emitted by the . - the compiled delegate - - - - Removes all live objects and places them in static fields of a type. - - - - - Reduces the provided DynamicExpression into site.Target(site, *args). - - - - - Tests to see if the expression is a constant with the given value. - - The expression to examine - The constant value to check for. - true/false - - - - Tests to see if the expression is a constant with the given value. - - The expression to examine - The constant value to check for. - true/false - - - - Provides a simple expression which enables embedding FieldBuilder's - in an AST before the type is complete. - - - - - Begins a catch block. - - - - - Begins an exception block for a filtered exception. - - - - - Begins an exception block for a non-filtered exception. - - - - - - Begins an exception fault block - - - - - Begins a finally block - - - - - Ends an exception block. - - - - - Begins a lexical scope. - - - - - Ends a lexical scope. - - - - - Declares a local variable of the specified type. - - - - - Declares a local variable of the specified type, optionally - pinning the object referred to by the variable. - - - - - Declares a new label. - - - - - Marks the label at the current position. - - - - - Emits an instruction. - - - - - Emits an instruction with a byte argument. - - - - - Emits an instruction with the metadata token for the specified contructor. - - - - - Emits an instruction with a double argument. - - - - - Emits an instruction with the metadata token for the specified field. - - - - - Emits an instruction with a float argument. - - - - - Emits an instruction with an int argument. - - - - - Emits an instruction with a label argument. - - - - - Emits an instruction with multiple target labels (switch). - - - - - Emits an instruction with a reference to a local variable. - - - - - Emits an instruction with a long argument. - - - - - Emits an instruction with the metadata token for a specified method. - - - - - Emits an instruction with a signed byte argument. - - - - - Emits an instruction with a short argument. - - - - - Emits an instruction with a signature token. - - - - - Emits an instruction with a string argument. - - - - - Emits an instruction with the metadata token for a specified type argument. - - - - - Emits a call or a virtual call to the varargs method. - - - - - Emits an unmanaged indirect call instruction. - - - - - Emits a managed indirect call instruction. - - - - - Marks a sequence point. - - - - - Specifies the namespace to be used in evaluating locals and watches for the - current active lexical scope. - - - - - Emits a Ldind* instruction for the appropriate type - - - - - Emits a Stind* instruction for the appropriate type. - - - - - Emits a Stelem* instruction for the appropriate type. - - - - - Boxes the value of the stack. No-op for reference types. Void is - converted to a null reference. For almost all value types this - method will box them in the standard way. Int32 and Boolean are - handled with optimized conversions that reuse the same object for - small values. For Int32 this is purely a performance optimization. - For Boolean this is use to ensure that True and False are always - the same objects. - - - - - Emits an array of constant values provided in the given list. - The array is strongly typed. - - - - - Emits an array of values of count size. The items are emitted via the callback - which is provided with the current item index to emit. - - - - - Emits an array construction code. - The code assumes that bounds for all dimensions - are already emitted. - - - - - Emits default(T) - Semantics match C# compiler behavior - - - - - A simple dictionary of queues, keyed off a particular type - This is useful for storing free lists of variables - - - - - Helper class to remove methods w/ identical signatures. Used for GetDefaultMembers - which returns members from all types in the hierarchy. - - - - - Directory where snippet assembly will be saved if SaveSnippets is set. - - - - - Save snippets to an assembly (see also SnippetsDirectory, SnippetsFileName). - - - - - Serializes constants and dynamic sites so the code can be saved to disk - - - - - Gets the Compiler associated with the Type Initializer (cctor) creating it if necessary. - - - - - Command line hosting service. - - - - - Scope is not remotable, and this only works in the same AppDomain. - - - - - Executes the comand line - depending upon the options provided we will - either run a single file, a single command, or enter the interactive loop. - - - - - Runs the command line. Languages can override this to provide custom behavior other than: - 1. Running a single command - 2. Running a file - 3. Entering the interactive console loop. - - - - - - Runs the specified filename - - - - - Starts the interactive loop. Performs any initialization necessary before - starting the loop and then calls RunInteractiveLoop to start the loop. - - Returns the exit code when the interactive loop is completed. - - - - - Runs the interactive loop. Repeatedly parse and run interactive actions - until an exit code is received. If any exceptions are unhandled displays - them to the console - - - - - Attempts to run a single interaction and handle any language-specific - exceptions. Base classes can override this and call the base implementation - surrounded with their own exception handling. - - Returns null if successful and execution should continue, or an exit code. - - - - - Parses a single interactive command or a set of statements and executes it. - - Returns null if successful and execution should continue, or the appropiate exit code. - - We check if the code read is an interactive command or statements is by checking for NewLine - If the code contains NewLine, it's a set of statements (most probably from SendToConsole) - If the code does not contain a NewLine, it's an interactive command typed by the user at the prompt - - - - - Private helper function to see if we should treat the current input as a blank link. - - We do this if we only have auto-indent text. - - - - - Read a statement, which can potentially be a multiple-line statement suite (like a class declaration). - - Should the console session continue, or did the user indicate - that it should be terminated? - Expression to evaluate. null for empty input - - - - Gets the next level for auto-indentation - - - - - Core functionality to implement an interactive console. This should be derived for concrete implementations - - - - - Console Host entry-point .exe name. - - - - - Request (from another thread) the console REPL loop to terminate - - The caller can specify the exitCode corresponding to the event triggering - the termination. This will be returned from CommandLine.Run - - - - To be called from entry point. - - - - - - - - name == null means that the argument doesn't specify an option; the value contains the entire argument - name == "" means that the option name is empty (argument separator); the value is null then - - - - - Literal script command given using -c option - - - - - Filename to execute passed on the command line options. - - - - - Only print the version of the script interpreter and exit - - - - - Used to dispatch a single interactive command. It can be used to control things like which Thread - the command is executed on, how long the command is allowed to execute, etc - - - - - Handles input and output for the console. It is comparable to System.IO.TextReader, - System.IO.TextWriter, System.Console, etc - - - - - Read a single line of interactive input, or a block of multi-line statements. - - An event-driven GUI console can implement this method by creating a thread that - blocks and waits for an event indicating that input is available - - The indentation level to be used for the current suite of a compound statement. - The console can ignore this argument if it does not want to support auto-indentation - null if the input stream has been closed. A string with a command to execute otherwise. - It can be a multi-line string which should be processed as block of statements - - - - On error. - - - - Supports detecting the remote runtime being killed, and starting up a new one. - - Threading model: - - ConsoleRestartManager creates a separate thread on which to create and execute the consoles. - There are usually atleast three threads involved: - - 1. Main app thread: Instantiates ConsoleRestartManager and accesses its APIs. This thread has to stay - responsive to user input and so the ConsoleRestartManager APIs cannot be long-running or blocking. - Since the remote runtime process can terminate asynchronously, the current RemoteConsoleHost can - change at any time (if auto-restart is enabled). The app should typically not care which instance of - RemoteConsoleHost is currently being used. The flowchart of this thread is: - Create ConsoleRestartManager - ConsoleRestartManager.Start - Loop: - Respond to user input | Send user input to console for execution | BreakExecution | RestartConsole | GetMemberNames - ConsoleRestartManager.Terminate - TODO: Currently, BreakExecution and GetMemberNames are called by the main thread synchronously. - Since they execute code in the remote runtime, they could take arbitrarily long. We should change - this so that the main app thread can never be blocked indefinitely. - - 2. Console thread: Dedicated thread for creating RemoteConsoleHosts and executing code (which could - take a long time or block indefinitely). - Wait for ConsoleRestartManager.Start to be called - Loop: - Create RemoteConsoleHost - Wait for signal for: - Execute code | RestartConsole | Process.Exited - - 3. CompletionPort async callbacks: - Process.Exited | Process.OutputDataReceived | Process.ErrorDataReceived - - 4. Finalizer thred - Some objects may have a Finalize method (which possibly calls Dispose). Not many (if any) types - should have a Finalize method. - - - - - - Accessing _remoteConsoleHost from a thread other than console thread can result in race. - If _remoteConsoleHost is accessed while holding _accessLock, it is guaranteed to be - null or non-disposed. - - - - - This is created on the "creating thread", and goes on standby. Start needs to be called for activation. - - A host might want one of two behaviors: - 1. Keep the REPL loop alive indefinitely, even when a specific instance of the RemoteConsoleHost terminates normally - 2. Close the REPL loop when an instance of the RemoteConsoleHost terminates normally, and restart the loop - only if the instance terminates abnormally. - - - - Needs to be called for activation. - - - - - Request (from another thread) the console REPL loop to terminate - - - - - This allows the RemoteConsoleHost to abort a long-running operation. The RemoteConsoleHost itself - does not know which ThreadPool thread might be processing the remote call, and so it needs - cooperation from the remote runtime server. - - - - - Since OnOutputDataReceived is sent async, it can arrive late. The remote console - cannot know if all output from the current command has been received. So - RemoteCommandDispatcher writes out a marker to indicate the end of the output - - - - - Aborts the current active call to Execute by doing Thread.Abort - - true if a Thread.Abort was actually called. false if there is no active call to Execute - - - - Customize the CommandLine for remote scenarios - - - - - CommandDispatcher to ensure synchronize output from the remote runtime - - - - - ConsoleHost where the ScriptRuntime is hosted in a separate process (referred to as the remote runtime server) - - The RemoteConsoleHost spawns the remote runtime server and specifies an IPC channel name to use to communicate - with each other. The remote runtime server creates and initializes a ScriptRuntime and a ScriptEngine, and publishes - it over the specified IPC channel at a well-known URI. Note that the RemoteConsoleHost cannot easily participate - in the initialization of the ScriptEngine as classes like LanguageContext are not remotable. - - The RemoteConsoleHost then starts the interactive loop and executes commands on the ScriptEngine over the remoting channel. - The RemoteConsoleHost listens to stdout of the remote runtime server and echos it locally to the user. - - - - - Called if the remote runtime process exits by itself. ie. without the remote console killing it. - - - - - Allows the console to customize the environment variables, working directory, etc. - - At the least, processInfo.FileName should be initialized - - - - Aborts the current active call to Execute by doing Thread.Abort - - true if a Thread.Abort was actually called. false if there is no active call to Execute - - - - The remote runtime server uses this class to publish an initialized ScriptEngine and ScriptRuntime - over a remoting channel. - - - - - Publish objects so that the host can use it, and then block indefinitely (until the input stream is open). - - Note that we should publish only one object, and then have other objects be accessible from it. Publishing - multiple objects can cause problems if the client does a call like "remoteProxy1(remoteProxy2)" as remoting - will not be able to know if the server object for both the proxies is on the same server. - - The IPC channel that the remote console expects to use to communicate with the ScriptEngine - A intialized ScriptScope that is ready to start processing script commands - - - - Class managing the command history. - - - - - List of available options - - - - - Cursor position management - - - - - Beginning position of the cursor - top coordinate. - - - - - Beginning position of the cursor - left coordinate. - - - - - The console input buffer. - - - - - Current position - index into the input buffer - - - - - The number of white-spaces displayed for the auto-indenation of the current line - - - - - Length of the output currently rendered on screen. - - - - - Command history - - - - - Tab options available in current context - - - - - Cursort anchor - position of cursor when the routine was called - - - - - The command line that this console is attached to. - - - - - Displays the next option in the option list, - or beeps if no options available for current input prefix. - If no input prefix, simply print tab. - - - - - - - Handle the enter key. Adds the current input (if not empty) to the history. - - - The input string. - - - - The number of arguments including "this" for instance methods. - - - - Instruction can't be created due to insufficient privileges. - - - Instruction can't be created due to insufficient privileges. - - - - Gets the next type or null if no more types are available. - - - - - Uses reflection to create new instance of the appropriate ReflectedCaller - - - - - Fast creation works if we have a known primitive types for the entire - method siganture. If we have any non-primitive types then FastCreate - falls back to SlowCreate which works for all types. - - Fast creation is fast because it avoids using reflection (MakeGenericType - and Activator.CreateInstance) to create the types. It does this through - calling a series of generic methods picking up each strong type of the - signature along the way. When it runs out of types it news up the - appropriate CallInstruction with the strong-types that have been built up. - - One relaxation is that for return types which are non-primitive types - we can fallback to object due to relaxed delegates. - - - - - This instruction implements a goto expression that can jump out of any expression. - It pops values (arguments) from the evaluation stack that the expression tree nodes in between - the goto expression and the target label node pushed and not consumed yet. - A goto expression can jump into a node that evaluates arguments only if it carries - a value and jumps right after the first argument (the carried value will be used as the first argument). - Goto can jump into an arbitrary child of a BlockExpression since the block doesn’t accumulate values - on evaluation stack as its child expressions are being evaluated. - - Goto needs to execute any finally blocks on the way to the target label. - - { - f(1, 2, try { g(3, 4, try { goto L } finally { ... }, 6) } finally { ... }, 7, 8) - L: ... - } - - The goto expression here jumps to label L while having 4 items on evaluation stack (1, 2, 3 and 4). - The jump needs to execute both finally blocks, the first one on stack level 4 the - second one on stack level 2. So, it needs to jump the first finally block, pop 2 items from the stack, - run second finally block and pop another 2 items from the stack and set instruction pointer to label L. - - Goto also needs to rethrow ThreadAbortException iff it jumps out of a catch handler and - the current thread is in "abort requested" state. - - - - - The first instruction of finally block. - - - - - The last instruction of finally block. - - - - - The last instruction of a catch exception handler. - - - - - The last instruction of a fault exception handler. - - - - - Implements dynamic call site with many arguments. Wraps the arguments into . - - - - - Attaches a cookie to the last emitted instruction. - - - - Instruction can't be created due to insufficient privileges. - - - - Contains compiler state corresponding to a LabelTarget - See also LabelScopeInfo. - - - - - Returns true if we can jump into this node - - - - - A single interpreted frame might be represented by multiple subsequent Interpreter.Run CLR frames. - This method filters out the duplicate CLR frames. - - - - - A simple forth-style stack machine for executing Expression trees - without the need to compile to IL and then invoke the JIT. This trades - off much faster compilation time for a slower execution performance. - For code that is only run a small number of times this can be a - sweet spot. - - The core loop in the interpreter is the RunInstructions method. - - - - - Runs instructions within the given frame. - - - Interpreted stack frames are linked via Parent reference so that each CLR frame of this method corresponds - to an interpreted stack frame in the chain. It is therefore possible to combine CLR stack traces with - interpreted stack traces by aligning interpreted frames to the frames of this method. - Each group of subsequent frames of Run method corresponds to a single interpreted frame. - - - - - Manages creation of interpreted delegates. These delegates will get - compiled if they are executed often enough. - - - - - true if the compiled delegate has the same type as the lambda; - false if the type was changed for interpretation. - - - - - Used by LightLambda to get the compiled delegate. - - - - - Create a compiled delegate for the LightLambda, and saves it so - future calls to Run will execute the compiled code instead of - interpreting. - - - - - Provides notification that the LightLambda has been compiled. - - - - - Visits a LambdaExpression, replacing the constants with direct accesses - to their StrongBox fields. This is very similar to what - ExpressionQuoter does for LambdaCompiler. - - Also inserts debug information tracking similar to what the interpreter - would do. - - - - - Local variable mapping. - - - - - The variable that holds onto the StrongBox{object}[] closure from - the interpreter - - - - - A stack of variables that are defined in nested scopes. We search - this first when resolving a variable in case a nested scope shadows - one of our variable instances. - - - - - Walks the lambda and produces a higher order function, which can be - used to bind the lambda to a closure array from the interpreter. - - The lambda to bind. - Variables which are being accessed defined in the outer scope. - A delegate that can be called to produce a delegate bound to the passed in closure array. - - - - Provides a list of variables, supporing read/write of the values - - - - - Gets a copy of the local variables which are defined in the current scope. - - - - - - Checks to see if the given variable is defined within the current local scope. - - - - - Gets the variables which are defined in an outer scope and available within the current scope. - - - - - Tracks where a variable is defined and what range of instructions it's used in - - - - - marks a field, class, or struct as being safe to have statics which can be accessed - from multiple runtimes. - - Static fields which are not read-only or marked with this attribute will be flagged - by a test which looks for state being shared between runtimes. Before applying this - attribute you should ensure that it is safe to share the state. This is typically - state which is lazy initialized or state which is caching values which are identical - in all runtimes and are immutable. - - - - - Sets the value at the given index for a tuple of the given size. This set supports - walking through nested tuples to get the correct final index. - - - - - Gets the value at the given index for a tuple of the given size. This get - supports walking through nested tuples to get the correct final index. - - - - - Gets the unbound generic Tuple type which has at lease size slots or null if a large enough tuple is not available. - - - - - Creates a generic tuple with the specified types. - - If the number of slots fits within the maximum tuple size then we simply - create a single tuple. If it's greater then we create nested tuples - (e.g. a Tuple`2 which contains a Tuple`128 and a Tuple`8 if we had a size of 136). - - - - - Gets the number of usable slots in the provided Tuple type including slots available in nested tuples. - - - - - Creates a new instance of tupleType with the specified args. If the tuple is a nested - tuple the values are added in their nested forms. - - - - - Gets the values from a tuple including unpacking nested values. - - - - - Gets the series of properties that needs to be accessed to access a logical item in a potentially nested tuple. - - - - - Gets the series of properties that needs to be accessed to access a logical item in a potentially nested tuple. - - - - - Provides an expression for creating a tuple with the specified values. - - - - - This class is useful for quickly collecting performance counts for expensive - operations. Usually this means operations involving either reflection or - code gen. Long-term we need to see if this can be plugged better into the - standard performance counter architecture. - - - - - temporary categories for quick investigation, use a custom key if you - need to track multiple items, and if you want to keep it then create - a new Categories entry and rename all your temporary entries. - - - - - Gets custom data to be serialized when saving script codes to disk. - - - - - ScriptCode is an instance of compiled code that is bound to a specific LanguageContext - but not a specific ScriptScope. The code can be re-executed multiple times in different - scopes. Hosting API counterpart for this class is CompiledCode. - - - - - This takes an assembly name including extension and saves the provided ScriptCode objects into the assembly. - - The provided script codes can constitute code from multiple languages. The assemblyName can be either a fully qualified - or a relative path. The DLR will simply save the assembly to the desired location. The assembly is created by the DLR and - if a file already exists than an exception is raised. - - The DLR determines the internal format of the ScriptCode and the DLR can feel free to rev this as appropriate. - - - - - This will take an assembly object which the user has loaded and return a new set of ScriptCode’s which have - been loaded into the provided ScriptDomainManager. - - If the language associated with the ScriptCode’s has not already been loaded the DLR will load the - LanguageContext into the ScriptDomainManager based upon the saved LanguageContext type. - - If the LanguageContext or the version of the DLR the language was compiled against is unavailable a - TypeLoadException will be raised unless policy has been applied by the administrator to redirect bindings. - - - - - Provides a StreamContentProvider for a stream of content backed by a file on disk. - - - - - Converts a generic ICollection of T into an array of T. - - If the collection is already an array of T the original collection is returned. - - - - - Converts a generic ICollection of T into an array of R using a given conversion. - - If the collection is already an array of R the original collection is returned. - - - - - Provides a dictionary-like object used for caches which holds onto a maximum - number of elements specified at construction time. - - This class is not thread safe. - - - - - Creates a dictionary-like object used for caches. - - The maximum number of elements to store. - - - - Tries to get the value associated with 'key', returning true if it's found and - false if it's not present. - - - - - Adds a new element to the cache, replacing and moving it to the front if the - element is already present. - - - - - Returns the value associated with the given key, or throws KeyNotFoundException - if the key is not present. - - - - - Not all .NET enumerators throw exceptions if accessed in an invalid state. This type - can be used to throw exceptions from enumerators implemented in IronPython. - - - - - Wraps the provided enumerable into a ReadOnlyCollection{T} - - Copies all of the data into a new array, so the data can't be - changed after creation. The exception is if the enumerable is - already a ReadOnlyCollection{T}, in which case we just return it. - - - - - Allows wrapping of proxy types (like COM RCWs) to expose their IEnumerable functionality - which is supported after casting to IEnumerable, even though Reflection will not indicate - IEnumerable as a supported interface - - - - - Requires the specified index to point inside the array. - - Array is null. - Index is outside the array. - - - - Requires the specified index to point inside the array. - - Index is outside the array. - - - - Requires the specified index to point inside the array or at the end - - Array is null. - Index is outside the array. - - - - Requires the specified index to point inside the array or at the end - - Array is null. - Index is outside the array. - - - - Requires the range [offset, offset + count] to be a subset of [0, array.Count]. - - Offset or count are out of range. - - - - Requires the range [offset, offset + count] to be a subset of [0, array.Count]. - - Offset or count are out of range. - - - - Requires the range [offset, offset + count] to be a subset of [0, array.Count]. - - Array is null. - Offset or count are out of range. - - - - Requires the range [offset, offset + count] to be a subset of [0, array.Count]. - - String is null. - Offset or count are out of range. - - - - Requires the array and all its items to be non-null. - - - - - Requires the enumerable collection and all its items to be non-null. - - - - - List optimized for few writes and multiple reads. It provides thread-safe read and write access. - Iteration is not thread-safe by default, but GetCopyForRead allows for iteration - without taking a lock. - - - - - Gets a copy of the contents of the list. The copy will not change even if the original - CopyOnWriteList object is modified. This method should be used to iterate the list in - a thread-safe way if no lock is taken. Iterating on the original list is not guaranteed - to be thread-safe. - - The returned copy should not be modified by the caller. - - - - Presents a flat enumerable view of multiple dictionaries - - - - - Returns the list of expressions represented by the instances. - - An array of instances to extract expressions from. - The array of expressions. - - - - Creates an instance of for a runtime value and the expression that represents it during the binding process. - - The runtime value to be represented by the . - An expression to represent this during the binding process. - The new instance of . - - - - Produces an interpreted binding using the given binder which falls over to a compiled - binding after hitCount tries. - - This method should be called whenever an interpreted binding is required. Sometimes it will - return a compiled binding if a previous binding was produced and it's hit count was exhausted. - In this case the binder will not be called back for a new binding - the previous one will - be used. - - The delegate type being used for the call site - The binder used for the call site - The number of calls before the binder should switch to a compiled mode. - The arguments that are passed for the binding (as received in a BindDelegate call) - A delegate which represents the interpreted binding. - - - - Expression which reduces to the normal test but under the interpreter adds a count down - check which enables compiling when the count down is reached. - - - - - Base class for storing information about the binding that a specific rule is applicable for. - - We have a derived generic class but this class enables us to refer to it w/o having the - generic type information around. - - This class tracks both the count down to when we should compile. When we compile we - take the Expression[T] that was used before and compile it. While this is happening - we continue to allow the interpreted code to run. When the compilation is complete we - store a thread static which tells us what binding failed and the current rule is no - longer functional. Finally the language binder will call us again and we'll retrieve - and return the compiled overload. - - - - - A hybrid dictionary which compares based upon object identity. - - - - - Seeks the first character of a specified line in the text stream. - - The reader. - Line number. The current position is assumed to be line #1. - - Returns true if the line is found, false otherwise. - - - - - Reads characters to a string until end position or a terminator is reached. - Doesn't include the terminator into the resulting string. - Returns null, if the reader is at the end position. - - - - - Reads characters until end position or a terminator is reached. - Returns true if the character has been found (the reader is positioned right behind the character), - false otherwise. - - - - - Calculates the quotient of two 32-bit signed integers rounded towards negative infinity. - - Dividend. - Divisor. - The quotient of the specified numbers rounded towards negative infinity, or (int)Floor((double)x/(double)y). - is 0. - The caller must check for overflow (x = Int32.MinValue, y = -1) - - - - Calculates the quotient of two 64-bit signed integers rounded towards negative infinity. - - Dividend. - Divisor. - The quotient of the specified numbers rounded towards negative infinity, or (int)Floor((double)x/(double)y). - is 0. - The caller must check for overflow (x = Int64.MinValue, y = -1) - - - - Calculates the remainder of floor division of two 32-bit signed integers. - - Dividend. - Divisor. - The remainder of of floor division of the specified numbers, or x - (int)Floor((double)x/(double)y) * y. - is 0. - - - - Calculates the remainder of floor division of two 32-bit signed integers. - - Dividend. - Divisor. - The remainder of of floor division of the specified numbers, or x - (int)Floor((double)x/(double)y) * y. - is 0. - - - - Behaves like Math.Round(value, MidpointRounding.AwayFromZero) - Needed because CoreCLR doesn't support this particular overload of Math.Round - - - - - Behaves like Math.Round(value, precision, MidpointRounding.AwayFromZero) - However, it works correctly on negative precisions and cases where precision is - outside of the [-15, 15] range. - - (This function is also needed because CoreCLR lacks this overload.) - - - - - Evaluates a polynomial in v0 where the coefficients are ordered in increasing degree - - - - - Evaluates a polynomial in v0 where the coefficients are ordered in increasing degree - if reverse is false, and increasing degree if reverse is true. - - - - - A numerically precise version of sin(v0 * pi) - - - - - A numerically precise version of |sin(v0 * pi)| - - - - - Take the quotient of the 2 polynomials forming the Lanczos approximation - with N=13 and G=13.144565 - - - - - Computes the Gamma function on positive values, using the Lanczos approximation. - Lanczos parameters are N=13 and G=13.144565. - - - - - Computes the Log-Gamma function on positive values, using the Lanczos approximation. - Lanczos parameters are N=13 and G=13.144565. - - - - - Thread safe dictionary that allows lazy-creation where readers will block for - the creation of the lazily created value. Call GetOrCreateValue w/ a key - and a callback function. If the value exists it is returned, if not the create - callback is called (w/o any locks held). The create call back will only be called - once for each key. - - - - - Helper class which stores the published value - - - - - Converts a boxed enum value to the underlying integer value. - - - - - Creates an open delegate for the given (dynamic)method. - - - - - Creates a closed delegate for the given (dynamic)method. - - - - - Gets a Func of CallSite, object * paramCnt, object delegate type - that's suitable for use in a non-strongly typed call site. - - - - - Returns true if the specified parameter is mandatory, i.e. is not optional and doesn't have a default value. - - - - - Yields all ancestors of the given type including the type itself. - Does not include implemented interfaces. - - - - - Like Type.GetInterfaces, but only returns the interfaces implemented by this type - and not its parents. - - - - - Enumerates extension methods in given assembly. Groups the methods by declaring namespace. - Uses a global cache if is true. - - - - - Binds occurances of generic parameters in against corresponding types in . - Invokes (parameter, type) for each such binding. - Returns false if the is structurally different from or if the binder returns false. - - - - - Determines if a given type matches the type that the method extends. - The match might be non-trivial if the extended type is an open generic type with constraints. - - - - - Splits text and optionally indents first lines - breaks along words, not characters. - - - - - Dictionary[TKey, TValue] is not thread-safe in the face of concurrent reads and writes. SynchronizedDictionary - provides a thread-safe implementation. It holds onto a Dictionary[TKey, TValue] instead of inheriting from - it so that users who need to do manual synchronization can access the underlying Dictionary[TKey, TValue]. - - - - - This returns the raw unsynchronized Dictionary[TKey, TValue]. Users are responsible for locking - on it before accessing it. Also, it should not be arbitrarily handed out to other code since deadlocks - can be caused if other code incorrectly locks on it. - - - - - Provides fast strongly typed thread local storage. This is significantly faster than - Thread.GetData/SetData. - - - - - True if the caller will guarantee that all cleanup happens as the thread - unwinds. - - This is typically used in a case where the thread local is surrounded by - a try/finally block. The try block pushes some state, the finally block - restores the previous state. Therefore when the thread exits the thread - local is back to it's original state. This allows the ThreadLocal object - to not check the current owning thread on retrieval. - - - - - Gets or sets the value for the current thread. - - - - - Gets the current value if its not == null or calls the provided function - to create a new value. - - - - - Calls the provided update function with the current value and - replaces the current value with the result of the function. - - - - - Replaces the current value with a new one and returns the old value. - - - - - Gets the StorageInfo for the current thread. - - - - - Called when the fast path storage lookup fails. if we encountered the Empty storage - during the initial fast check then spin until we hit non-empty storage and try the fast - path again. - - - - - Creates the StorageInfo for the thread when one isn't already present. - - - - - Helper class for storing the value. We need to track if a ManagedThreadId - has been re-used so we also store the thread which owns the value. - - - - - Caches type member lookup. - - - When enumerating members (methods, properties, events) of a type (declared or inherited) Reflection enumerates all - runtime members of the type and its base types and caches the result. - When looking for a member of a specific name Reflection still enumerates all and filters out those that don't match the name. - That's inefficient when looking for members of multiple names one by one. - Instead we build a map of name to member list and then answer subsequent queries by simply looking up the dictionary. - - - - - Returns a numerical code of the size of a type. All types get both a horizontal - and vertical code. Types that are lower in both dimensions have implicit conversions - to types that are higher in both dimensions. - - - - - Represents an array that has value equality. - - - - - Simple class for tracking a list of items and enumerating over them. - The items are stored in weak references; if the objects are collected, - they will not be seen when enumerating. - - The type of the collection element. - - - - Similar to Dictionary[TKey,TValue], but it also ensures that the keys will not be kept alive - if the only reference is from this collection. The value will be kept alive as long as the key - is alive. - - This currently has a limitation that the caller is responsible for ensuring that an object used as - a key is not also used as a value in *any* instance of a WeakHash. Otherwise, it will result in the - object being kept alive forever. This effectively means that the owner of the WeakHash should be the - only one who has access to the object used as a value. - - Currently, there is also no guarantee of how long the values will be kept alive even after the keys - get collected. This could be fixed by triggerring CheckCleanup() to be called on every garbage-collection - by having a dummy watch-dog object with a finalizer which calls CheckCleanup(). - - - - - Check if any of the keys have gotten collected - - Currently, there is also no guarantee of how long the values will be kept alive even after the keys - get collected. This could be fixed by triggerring CheckCleanup() to be called on every garbage-collection - by having a dummy watch-dog object with a finalizer which calls CheckCleanup(). - - - - - Changes the semantics of GC handle to return null instead of throwing - an . - - - - - This class represents adler32 checksum algorithm. - - - - - This static method returns adler32 checksum of the buffer data - - - - - Implementation of the Deflate compression algorithm. - - - - - Deflate algorithm configuration parameters class - - - - - reduce lazy search above this match length - - - - - do not perform lazy search above this match length - - - - - quit search above this match length - - - - - Constructor which initializes class inner fields - - - - - Maximum memory level - - - - - Defalult compression method - - - - - Default memory level - - - - - Deflate class congiration table - - - - - block not completed, need more input or more output - - - - - Block internalFlush performed - - - - - Finish started, need only more output at next deflate - - - - - finish done, accept no more input or output - - - - - preset dictionary flag in zlib header - - - - - The deflate compression method - - - - - The size of the buffer - - - - - repeat previous bit length 3-6 times (2 bits of repeat count) - - - - - repeat a zero length 3-10 times (3 bits of repeat count) - - - - - repeat a zero length 11-138 times (7 bits of repeat count) - - - - - Gets or sets the Compression level. - - - - - Gets or sets the Number of bytes in the pending buffer. - - - - - Gets or sets the Output pending buffer. - - - - - Gets or sets the next pending byte to output to the stream. - - - - - Gets or sets a value indicating whether to suppress zlib header and adler32. - - - - - Pointer back to this zlib stream - - - - - As the name implies - - - - - Size of Pending_buf - - - - - UNKNOWN, BINARY or ASCII - - - - - STORED (for zip only) or DEFLATED - - - - - Value of internalFlush parameter for previous deflate call - - - - - LZ77 Window size (32K by default) - - - - - log2(w_size) (8..16) - - - - - w_size - 1 - - - - - Sliding Window. Input bytes are ReadPos into the second half of the Window, - and move to the first half later to keep a dictionary of at least wSize - bytes. With this organization, matches are limited to a distance of - wSize-MAX_MATCH bytes, but this ensures that IO is always - performed with a length multiple of the block size. Also, it limits - the Window size to 64K, which is quite useful on MSDOS. - To do: use the user input buffer as sliding Window. - - - - - Actual size of Window: 2*wSize, except when the user input buffer is directly used as sliding Window. - - - - - Link to older string with same hash index. To limit the size of this - array to 64K, this link is maintained only for the last 32K strings. - An index in this array is thus a Window index modulo 32K. - - - - - Heads of the hash chains or NIL. - - - - - hash index of string to be inserted - - - - - number of elements in hash table - - - - - log2(hash_size) - - - - - hash_size-1 - - - - - Number of bits by which ins_h must be shifted at each input - step. It must be such that after MIN_MATCH steps, the oldest - byte no longer takes part in the hash key, that is: - hash_shift * MIN_MATCH >= hash_bits - - - - - Window position at the beginning of the current output block. Gets negative when the Window is moved backwards. - - - - - length of best match - - - - - previous match - - - - - set if previous match exists - - - - - start of string to insert - - - - - start of matching string - - - - - number of valid bytes ahead in Window - - - - - Length of the best match at previous step. Matches not greater than this - are discarded. This is used in the lazy match evaluation. - - - - - To speed up deflation, hash chains are never searched beyond this - length. A higher limit improves compression ratio but degrades the speed. - - - - - Attempt to find a better match only when the current match is strictly - smaller than this value. This mechanism is used only for compression - levels >= 4. - - - - - favor or force Huffman coding - - - - - Use a faster search when the previous match is longer than this - - - - - Stop searching when current match exceeds this - - - - - literal and length tree - - - - - distance tree - - - - - Huffman tree for bit lengths - - - - - Desc for literal tree - - - - - desc for distance tree - - - - - desc for bit length tree - - - - - number of codes at each bit length for an optimal tree - - - - - heap used to build the Huffman trees - - - - - number of elements in the heap - - - - - element of largest frequency - - - - - Depth of each subtree used as tie breaker for trees of equal frequency - - - - - index for literals or lengths - - - - - Size of match buffer for literals/lengths. There are 4 reasons for - limiting lit_bufsize to 64K: - - frequencies can be kept in 16 bit counters - - if compression is not successful for the first block, all input - data is still in the Window so we can still emit a stored block even - when input comes from standard input. (This can also be done for - all blocks if lit_bufsize is not greater than 32K.) - - if compression is not successful for a file smaller than 64K, we can - even emit a stored file instead of a stored block (saving 5 bytes). - This is applicable only for zip (not gzip or zlib). - - creating new Huffman trees less frequently may not provide fast - adaptation to changes in the input data statistics. (Take for - example a binary file with poorly compressible code followed by - a highly compressible string table.) Smaller buffer sizes give - fast adaptation but have of course the overhead of transmitting - trees more frequently. - - I can't count above 4 - - - - - running index in l_buf - - - - - index of pendig_buf - - - - - bit length of current block with optimal trees - - - - - bit length of current block with static trees - - - - - number of string matches in current block - - - - - bit length of EOB code for last block - - - - - Output buffer. bits are inserted starting at the bottom (least - significant bits). - - - - - Number of valid bits in bi_buf. All bits above the last valid bit - are always zero. - - - - - Default constructor - - - - - Initialization - - - - - Initialize the tree data structures for a new zlib stream. - - - - - Initializes block - - - - - Restore the heap property by moving down the tree starting at node k, - exchanging a node with the smallest of its two sons if necessary, stopping - when the heap property is re-established (each father smaller than its - two sons). - - - - - Scan a literal or distance tree to determine the frequencies of the codes - in the bit length tree. - - - - - Construct the Huffman tree for the bit lengths and return the index in - bl_order of the last bit length code to send. - - - - - Send the header for a block using dynamic Huffman trees: the counts, the - lengths of the bit length codes, the literal tree and the distance tree. - IN assertion: lcodes >= 257, dcodes >= 1, blcodes >= 4. - - - - - Send a literal or distance tree in compressed form, using the codes in - bl_tree. - - - - - Output a byte on the stream. - IN assertion: there is enough room in Pending_buf. - - - - - Adds a byte to the buffer - - - - - Send one empty static block to give enough lookahead for inflate. - This takes 10 bits, of which 7 may remain in the bit buffer. - The current inflate code requires 9 bits of lookahead. If the - last two codes for the previous block (real code plus EOB) were coded - on 5 bits or less, inflate may have only 5+3 bits of lookahead to decode - the last real code. In this case we send two empty static blocks instead - of one. (There are no problems if the previous block is stored or fixed.) - To simplify the code, we assume the worst case of last real code encoded - on one bit only. - - - - - Save the match info and tally the frequency counts. Return true if - the current block must be flushed. - - - - - Send the block data compressed using the given Huffman trees - - - - - Set the data type to ASCII or BINARY, using a crude approximation: - binary if more than 20% of the bytes are <= 6 or >= 128, ascii otherwise. - IN assertion: the fields freq of dyn_ltree are set and the total of all - frequencies does not exceed 64K (to fit in an int on 16 bit machines). - - - - - Flush the bit buffer, keeping at most 7 bits in it. - - - - - Flush the bit buffer and align the output on a byte boundary - - - - - Copy a stored block, storing first the length and its - one's complement if requested. - - - - - Flushes block - - - - - Copy without compression as much as possible from the input stream, return - the current block state. - This function does not insert new strings in the dictionary since - uncompressible data is probably not useful. This function is used - only for the level=0 compression option. - NOTE: this function should be optimized to avoid extra copying from - Window to Pending_buf. - - - - - Send a stored block - - - - - Determine the best encoding for the current block: dynamic trees, static - trees or store, and output the encoded block to the zip file. - - - - - Fill the Window when the lookahead becomes insufficient. - Updates strstart and lookahead. - - IN assertion: lookahead less than MIN_LOOKAHEAD - OUT assertions: strstart less than or equal to window_size-MIN_LOOKAHEAD - At least one byte has been ReadPos, or _avail_in == 0; reads are - performed for at least two bytes (required for the zip translate_eol - option -- not supported here). - - - - - Compress as much as possible from the input stream, return the current - block state. - This function does not perform lazy evaluation of matches and inserts - new strings in the dictionary only for unmatched strings or for short - matches. It is used only for the fast compression options. - - - - - Same as above, but achieves better compression. We use a lazy - evaluation for matches: a match is finally adopted only if there is - no better match at the next Window position. - - - - - Finds the longest matching data part - - - - - Deflate algorithm initialization - - ZStream object - Compression level - Window bits - A result code - - - - Initializes deflate algorithm - - ZStream object - Compression level - Operation result result code - - - - Deflate algorithm initialization - - ZStream object - Compression level - Window bits - Memory level - Compression strategy - Operation result code - - - - Resets the current state of deflate object - - - - - Finish compression with deflate algorithm - - - - - Sets deflate algorithm parameters - - - - - Sets deflate dictionary - - - - - Performs data compression with the deflate algorithm - - - - - Static constructor initializes config_table - - - - - current inflate_block mode - - - - - if STORED, bytes left to copy - - - - - table lengths (14 bits) - - - - - index into blens (or border) - - - - - bit lengths of codes - - - - - bit length tree depth - - - - - bit length decoding tree - - - - - if CODES, current state - - - - - true if this block is the last block - - - - - single malloc for tree space - - - - - need check - - - - - check on output - - - - - Gets or sets the sliding window. - - - - - Gets or sets the one byte after sliding Window. - - - - - Gets or sets the Window ReadPos pointer. - - - - - Gets or sets the Window WritePos pointer. - - - - - Gets or sets the bits in bit buffer. - - - - - Gets or sets the bit buffer. - - - - - Resets this InfBlocks class instance - - - - - Block processing functions - - - - - Frees inner buffers - - - - - Sets dictionary - - - - - Returns true if inflate is currently at the End of a block generated - by Z_SYNC_FLUSH or Z_FULL_FLUSH. - - - - - copy as much as possible from the sliding Window to the output area - - - - - Inflate codes mode - - - - - This class is used by the InfBlocks class - - - - - current inflate_codes mode - - - - - length - - - - - pointer into tree - - - - - current index of the tree - - - - - - - - - - ltree bits decoded per branch - - - - - dtree bits decoded per branch - - - - - literal/length/eob tree - - - - - literal/length/eob tree index - - - - - distance tree - - - - - distance tree index - - - - - Constructor which takes literal, distance trees, corresponding bites decoded for branches, corresponding indexes and a ZStream object - - - - - Constructor which takes literal, distance trees, corresponding bites decoded for branches and a ZStream object - - - - - Block processing method - - An instance of the InfBlocks class - A ZStream object - A result code - - - - Frees allocated resources - - - - - Fast inflate procedure. Called with number of bytes left to WritePos in Window at least 258 - (the maximum string length) and number of input bytes available - at least ten. The ten bytes are six bytes for the longest length/ - distance pair plus four bytes for overloading the bit buffer. - - - - - This enumeration contains modes of inflate processing - - - - - waiting for method byte - - - - - waiting for flag byte - - - - - four dictionary check bytes to go - - - - - three dictionary check bytes to go - - - - - two dictionary check bytes to go - - - - - one dictionary check byte to go - - - - - waiting for inflateSetDictionary - - - - - decompressing blocks - - - - - four check bytes to go - - - - - three check bytes to go - - - - - two check bytes to go - - - - - one check byte to go - - - - - finished check, done - - - - - got an error--stay here - - - - - current inflate mode - - - - - if FLAGS, method byte - - - - - computed check value - - - - - stream check value - - - - - if BAD, inflateSync's marker bytes count - - - - - flag for no wrapper - - - - - log2(Window size) (8..15, defaults to 15) - - - - - current inflate_blocks state - - - - - Resets the Inflate algorithm - - A ZStream object - A result code - - - - Finishes the inflate algorithm processing - - A ZStream object - Operation result code - - - - Initializes the inflate algorithm - - A ZStream object - Window size - Operation result code - - - - Runs inflate algorithm - - A ZStream object - Flush strategy - Operation result code - - - - Sets dictionary for the inflate operation - - A ZStream object - An array of byte - dictionary - Dictionary length - Operation result code - - - - Inflate synchronization - - A ZStream object - Operation result code - - - - Returns true if inflate is currently at the End of a block generated - by Z_SYNC_FLUSH or Z_FULL_FLUSH. This function is used by one PPP - implementation to provide an additional safety check. PPP uses Z_SYNC_FLUSH - but removes the length bytes of the resulting empty stored block. When - decompressing, PPP checks that at the End of input packet, inflate is - waiting for these length bytes. - - - - - Creates header remover. - As long as header is not completed, call to Remover.MoveNext() returns true and - adjust state of z. - - Stream where gzip header will appear. - - - - - Contains utility information for the InfTree class - - - - - Given a list of code lengths and a maximum table size, make a set of - tables to decode that set of codes. - - Return (int)ZLibResultCode.Z_OK on success, (int)ZLibResultCode.Z_DATA_ERROR if the given code set is incomplete (the tables are still built in this case), (int)ZLibResultCode.Z_DATA_ERROR if the input is invalid (an over-subscribed set of lengths), or (int)ZLibResultCode.Z_DATA_ERROR if not enough memory. - - - - - Build trees - - - - - Builds dynamic trees - - - - - Build fixed trees - - - - - Bit length codes must not exceed MAX_BL_BITS bits - - - - - This class represents a tree and is used in the Deflate class - - - - - The dynamic tree - - - - - Largest code with non zero frequency - - - - - the corresponding static tree - - - - - The dynamic tree - - - - - Largest code with non zero frequency - - - - - the corresponding static tree - - - - - Mapping from a distance to a distance code. dist is the distance - 1 and - must not have side effects. _dist_code[256] and _dist_code[257] are never - used. - - - - - Compute the optimal bit lengths for a tree and update the total bit length - for the current block. - IN assertion: the fields freq and dad are set, heap[heap_max] and - above are the tree nodes sorted by increasing frequency. - OUT assertions: the field count is set to the optimal bit length, the - array bl_count contains the frequencies for each bit length. - The length opt_len is updated; static_len is also updated if stree is - not null. - - - - - Construct one Huffman tree and assigns the code bit strings and lengths. - Update the total bit length for the current block. - IN assertion: the field freq is set for all tree elements. - OUT assertions: the fields count and code are set to the optimal bit length - and corresponding code. The length opt_len is updated; static_len is - also updated if stree is not null. The field max_code is set. - - - - - Generate the codes for a given tree and bit counts (which need not be - optimal). - IN assertion: the array bl_count contains the bit length statistics for - the given tree and the field count is set for all tree elements. - OUT assertion: the field code is set for all tree elements of non - zero code length. - - - - - Reverse the first count bits of a code, using straightforward code (a faster - method would use a table) - - - - - Some constants for specifying compression levels. Methods which takes a compression level as a parameter expects an integer value from 0 to 9. You can either specify an integer value or use constants for some most widely used compression levels. - - - - - No compression should be used at all. - - - - - Minimal compression, but greatest speed. - - - - - Maximum compression, but slowest. - - - - - Select default compression level (good compression, good speed). - - - - - Compression strategies. The strategy parameter is used to tune the compression algorithm. The strategy parameter only affects the compression ratio but not the correctness of the compressed output even if it is not set appropriately. - - - - - This strategy is designed for filtered data. Data which consists of mostly small values, with random distribution should use Z_FILTERED. With this strategy, less string matching is performed. - - - - - Z_HUFFMAN_ONLY forces Huffman encoding only (no string match) - - - - - The default strategy is the most commonly used. With this strategy, string matching and huffman compression are balanced. - - - - - Flush strategies - - - - - Do not internalFlush data, but just write data as normal to the output buffer. This is the normal way in which data is written to the output buffer. - - - - - Obsolete. You should use Z_SYNC_FLUSH instead. - - - - - All pending output is flushed to the output buffer and the output is aligned on a byte boundary, so that the decompressor can get all input data available so far. - - - - - All output is flushed as with Z_SYNC_FLUSH, and the compression state is reset so that decompression can restart from this point if previous compressed data has been damaged or if random access is desired. Using Z_FULL_FLUSH too often can seriously degrade the compression. ZLib_InflateSync will locate points in the compression string where a full has been performed. - - - - - Notifies the module that the input has now been exhausted. Pending input is processed, pending output is flushed and calls return with Z_STREAM_END if there was enough output space. - - - - - Results of operations in ZLib library - - - - - No failure was encountered, the operation completed without problem. - - - - - No failure was encountered, and the input has been exhausted. - - - - - A preset dictionary is required for decompression of the data. - - - - - An internal error occurred - - - - - The stream structure was inconsistent - - - - - Input data has been corrupted (for decompression). - - - - - Memory allocation failed. - - - - - There was not enough space in the output buffer. - - - - - The version supplied does not match that supported by the ZLib module. - - - - - States of deflate operation - - - - - Data block types, i.e. binary or ascii text - - - - - Helper class - - - - - Copies large array which was passed as srcBuf to the Initialize method into the destination array which were passes as destBuff - - The number of bytes copied - - - - Max Window size - - - - - preset dictionary flag in zlib header - - - - - The size of the buffer - - - - - Deflate compression method index - - - - - This method returns the literal value received - - The literal to return - The received value - - - - This method returns the literal value received - - The literal to return - The received value - - - - This method returns the literal value received - - The literal to return - The received value - - - - This method returns the literal value received - - The literal to return - The received value - - - - Performs an unsigned bitwise right shift with the specified number - - Number to operate on - Ammount of bits to shift - The resulting number from the shift operation - - - - Performs an unsigned bitwise right shift with the specified number - - Number to operate on - Ammount of bits to shift - The resulting number from the shift operation - - - - Performs an unsigned bitwise right shift with the specified number - - Number to operate on - Ammount of bits to shift - The resulting number from the shift operation - - - - Performs an unsigned bitwise right shift with the specified number - - Number to operate on - Ammount of bits to shift - The resulting number from the shift operation - - - Reads a number of characters from the current source Stream and writes the data to the target array at the specified index. - The source Stream to ReadPos from. - Contains the array of characters ReadPos from the source Stream. - The starting index of the target array. - The maximum number of characters to ReadPos from the source Stream. - The number of characters ReadPos. The number will be less than or equal to count depending on the data available in the source Stream. Returns -1 if the End of the stream is reached. - - - Reads a number of characters from the current source TextReader and writes the data to the target array at the specified index. - The source TextReader to ReadPos from - Contains the array of characteres ReadPos from the source TextReader. - The starting index of the target array. - The maximum number of characters to ReadPos from the source TextReader. - The number of characters ReadPos. The number will be less than or equal to count depending on the data available in the source TextReader. Returns -1 if the End of the stream is reached. - - - - Converts a string to an array of bytes - - The string to be converted - The new array of bytes - - - - Converts an array of bytes to an array of chars - - The array of bytes to convert - The new array of chars - - - - see definition of array dist_code below - - - - - ZStream is used to store user data to compress/decompress. - - - - - Maximum memory level - - - - - Next input byte array - - - - - Index of the first byte in the input array. - - - - - Number of bytes available at _next_in - - - - - total nb of input bytes ReadPos so far - - - - - Byte array for the next output block - - - - - Index of the first byte in the _next_out array - - - - - Remaining free space at _next_out - - - - - Total number of bytes in output array - - - - - A string to store operation result message (corresponding to result codes) - - - - - A deflate object to perform data compression - - - - - Inflate object to perform data decompression - - - - - Adler-32 value for uncompressed data processed so far. - - - - - Best guess about the data type: ascii or binary - - - - - Gets/Sets the next input byte array. - - - - - Index of the first byte in the input array. - - - - - Gets/Sets the number of bytes available in the input buffer. - - - - - Gets/Sets the total number of bytes in the input buffer. - - - - - Gets/Sets the buffer for the next output data. - - - - - Gets/Sets the index of the first byte in the byte array to write to. - - - - - Gets/Sets the remaining free space in the buffer. - - - - - Gets/Sets the total number of bytes in the output array. - - - - - Gets sets the last error message occurred during class operations. - - - - - A deflate object to perform data compression - - - - - Inflate object to perform data decompression - - - - - Initializes the internal stream state for decompression. The fields , must be - initialized before by the caller. If is not null and is large - enough (the exact value depends on the compression method), determines the compression - method from the ZLib header and allocates all data structures accordingly; otherwise the allocation will be deferred - to the first call of . - - - inflateInit returns if success, if there was not enough memory, - if the ZLib library version is incompatible with the version assumed by the caller. - is set to null if there is no error message. does not perform any decompression - apart from reading the ZLib header if present: this will be done by . (So and - may be modified, but and are unchanged.) - - - - - This is another version of with an extra parameter. The fields , must be - initialized before by the caller. If is not null and is large enough - (the exact value depends on the compression method), determines the compression method from - the ZLib header and allocates all data structures accordingly; otherwise the allocation will be deferred to the first - call of . - - The windowBits parameter is the base two logarithm of the maximum window size (the size of the history buffer). - It should be in the range 8..15 for this version of the library. The default value is 15 if is used instead. - If a compressed stream with a larger window size is given as input, will return with the error code - instead of trying to allocate a larger window. - - inflateInit returns if success, if there was not enough memory, - if a parameter is invalid (such as a negative memLevel). is set to null - if there is no error message. does not perform any decompression apart from reading the ZLib header - if present: this will be done by . (So and may be modified, - but and are unchanged.) - - - - - This method decompresses as much data as possible, and stops when the input buffer () becomes empty or - the output buffer () becomes full. It may some introduce some output latency (reading input without producing any output) - except when forced to flush. - The detailed semantics are as follows. performs one or both of the following actions: - - - Decompress more input starting at and update and - accordingly. If not all input can be processed (because there is not enough room in the output buffer), is updated and - processing will resume at this point for the next call of . - Provide more output starting at and update and - accordingly. provides as much output as possible, until there is no more input data or no more space in - the output buffer (see below about the parameter). - - - - Flush strategy to use. - - Before the call of , the application should ensure that at least one of the actions is possible, by providing - more input and/or consuming more output, and updating the next_* and avail_* values accordingly. The application can consume the uncompressed - output when it wants, for example when the output buffer is full (avail_out == 0), or after each call of . - If returns and with zero , it must be called again - after making room in the output buffer because there might be more output pending. - If the parameter is set to , flushes - as much output as possible to the output buffer. The flushing behavior of is not specified for values of - the parameter other than and , - but the current implementation actually flushes as much output as possible anyway. - should normally be called until it returns or an error. - However if all decompression is to be performed in a single step (a single call of inflate), the parameter - should be set to . In this case all pending input is processed and all pending output is flushed; - must be large enough to hold all the uncompressed data. (The size of the uncompressed data may have been - saved by the compressor for this purpose.) The next operation on this stream must be to deallocate the decompression - state. The use of is never required, but can be used to inform that a faster - routine may be used for the single call. - If a preset dictionary is needed at this point (see ), sets strm-adler - to the adler32 checksum of the dictionary chosen by the compressor and returns ; otherwise it - sets strm->adler to the adler32 checksum of all output produced so far (that is, bytes) and returns - , or an error code as described below. At the end of the stream, - ) checks that its computed adler32 checksum is equal to that saved by the compressor and returns - only if the checksum is correct. - - - returns if some progress has been made (more input processed or more output produced), - if the end of the compressed data has been reached and all uncompressed output has been produced, - if a preset dictionary is needed at this point, if - the input data was corrupted (input stream not conforming to the ZLib format or incorrect adler32 checksum), - if the stream structure was inconsistent (for example if or - was null), if there was not enough memory, - if no progress is possible or if there was not enough room in the output buffer - when is used. In the case, the application - may then call to look for a good compression block. - - - - - All dynamically allocated data structures for this stream are freed. This function discards any unprocessed input and does not flush any - pending output. - - - inflateEnd returns if success, - if the stream state was inconsistent. In the error case, msg may be set but then points to a static string (which must not be deallocated). - - - - - Skips invalid compressed data until a full flush point (see the description of deflate with Z_FULL_FLUSH) can be found, - or until all available input is skipped. No output is provided. - - - returns if a full flush point has been found, - if no more input was provided, if no flush point has been found, or - if the stream structure was inconsistent. In the success case, the application may save the current - current value of which indicates where valid compressed data was found. In the error case, the application may repeatedly - call , providing more input each time, until success or end of the input data. - - - - - Initializes the decompression dictionary from the given uncompressed byte sequence. This function must be called immediately after a call of if this call returned . The dictionary chosen by the compressor can be determined from the Adler32 value returned by this call of . The compressor and decompresser must use exactly the same dictionary. - - A byte array - a dictionary. - The length of the dictionary. - - inflateSetDictionary returns if success, if a parameter is invalid (such as null dictionary) or the stream state is inconsistent, if the given dictionary doesn't match the expected one (incorrect Adler32 value). inflateSetDictionary does not perform any decompression: this will be done by subsequent calls of . - - - - - Initializes the internal stream state for compression. - - An integer value from 0 to 9 indicating the desired compression level. - - DeflateInit returns if success, if there was not enough memory, - if level is not a valid compression level. is set to null if there is - no error message. does not perform any compression: this will be done by . - - - - - Initializes the internal stream state for compression. - - An integer value from 0 to 9 indicating the desired compression level. - The windowBits parameter is the base two logarithm of the window size (the size of the history buffer). It should be in the - range 8..15 for this version of the library. Larger values of this parameter result in better compression at the expense of memory usage. - The default value is 15 if DeflateInit is used instead. - - DeflateInit returns if success, if there was not enough memory, - if level is not a valid compression level. is set to null if there - is no error message. does not perform any compression: this will be done by . - - - - - Deflate compresses as much data as possible, and stops when the input buffer becomes empty or the - output buffer becomes full. It may introduce some output latency (reading input without producing any output) - except when forced to flush. - The detailed semantics are as follows. deflate performs one or both of the following actions: - - Compress more input starting at and update and accordingly. - If not all input can be processed (because there is not enough room in the output buffer), and - are updated and processing will resume at this point for the next call of . - Provide more output starting at and update and accordingly. - This action is forced if the parameter flush is non zero. Forcing flush frequently degrades the compression ratio, so this parameter should - be set only when necessary (in interactive applications). Some output may be provided even if flush is not set. - - - - The flush strategy to use. - - - Before the call of , the application should ensure that at least one of the actions is possible, by providing - more input and/or consuming more output, and updating or accordingly ; - should never be zero before the call. The application can consume the compressed output when it wants, for example when the output buffer is full - (avail_out == 0), or after each call of . If returns - and with zero , it must be called again after making room in the output buffer because there might be more output pending. - - - If the parameter is set to , all pending output is flushed to the - output buffer and the output is aligned on a byte boundary, so that the decompressor can get all input - data available so far. (In particular is zero after the call if enough output space has been provided before the call.) - Flushing may degrade compression for some compression algorithms and so it should be used only when necessary. - - - If flush is set to , all output is flushed as with , - and the compression state is reset so that decompression can restart from this point if previous compressed data has been damaged or if - random access is desired. Using too often can seriously degrade the compression. - - - - - If deflate returns with == 0, this function must be called again with the same value of the flush - parameter and more output space (updated ), until the flush is complete ( returns with - non-zero ). - - - If the parameter is set to , pending input is processed, pending - output is flushed and deflate returns with if there was enough output space ; - if deflate returns with , this function must be called again with - and more output space (updated ) but no more input data, until it returns with - or an error. After deflate has returned , the only possible operation on the stream is - . - - can be used immediately after if all the compression is to be - done in a single step. In this case, avail_out must be at least 0.1% larger than avail_in plus 12 bytes. If deflate does not return - Z_STREAM_END, then it must be called again as described above. - - - sets strm-> adler to the adler32 checksum of all input read so far (that is, bytes). - - - may update data_type if it can make a good guess about the input data type (Z_ASCII or Z_BINARY). - In doubt, the data is considered binary. This field is only for information purposes and does not affect the compression algorithm in any manner. - - - returns if some progress has been made (more input processed or more output produced), - if all input has been consumed and all output has been produced (only when flush is set to - ), if the stream state was inconsistent (for example if - or was null), if no progress is possible - (for example or was zero). - - - - - - All dynamically allocated data structures for this stream are freed. This function discards any unprocessed input and does not flush any pending - output. - - - deflateEnd returns if success, if the stream state was inconsistent, - if the stream was freed prematurely (some input or output was discarded). In the error case, - may be set but then points to a static string (which must not be deallocated). - - - - - Dynamically update the compression level and compression strategy. The interpretation of level is as in . - This can be used to switch between compression and straight copy of the input data, or to switch to a different kind of input data - requiring a different strategy. If the compression level is changed, the input available so far is compressed with the old level - (and may be flushed); the new level will take effect only at the next call of - - An integer value indicating the desired compression level. - A flush strategy to use. - - Before the call of , the stream state must be set as for a call of , since the - currently available input may have to be compressed and flushed. In particular, must be non-zero. - - - deflateParams returns if success, if the source stream - state was inconsistent or if a parameter was invalid, if was zero. - - - - - Initializes the compression dictionary from the given byte sequence without producing any compressed output. This function must be called - immediately after , before any call of . The compressor and decompressor must use - exactly the same dictionary (see ). - - A byte array - a dictionary. - The length of the dictionary byte array - - - The dictionary should consist of strings (byte sequences) that are likely to be encountered later in the data to be compressed, - with the most commonly used strings preferably put towards the end of the dictionary. Using a dictionary is most useful when the data - to be compressed is short and can be predicted with good accuracy; the data can then be compressed better than with the default empty dictionary. - - Depending on the size of the compression data structures selected by , a part of the dictionary may - in effect be discarded, for example if the dictionary is larger than the window size in . Thus the strings most likely - to be useful should be put at the end of the dictionary, not at the front. - Upon return of this function, adler is set to the Adler32 value of the dictionary; the decompresser may later use this value to determine - which dictionary has been used by the compressor. (The Adler32 value applies to the whole dictionary even if only a subset of the dictionary - is actually used by the compressor.) - - - deflateSetDictionary returns if success, or if a parameter - is invalid (such as null dictionary) or the stream state is inconsistent (for example if has already been - called for this stream or if the compression method is bsort). does not perform any compression: - this will be done by . - - - - - Flush as much pending output as possible. All output goes through this function so some applications may wish to - modify it to avoid allocating a large buffer and copying into it. - - - - - - Read a new buffer from the current input stream, update the adler32 and total number of bytes read. All input goes - through this function so some applications may wish to modify it to avoid allocating a large buffer and copying from it. - - - - - - Frees all inner buffers. - - - - - Exceptions that occur in ZStream - - - - - Default constructor. - - - - - Constructor which takes one parameter - an error message - - - - diff --git a/mpv.net/IronPython/Microsoft.Scripting.xml b/mpv.net/IronPython/Microsoft.Scripting.xml deleted file mode 100644 index c6b0e49..0000000 --- a/mpv.net/IronPython/Microsoft.Scripting.xml +++ /dev/null @@ -1,3837 +0,0 @@ - - - - Microsoft.Scripting - - - - - Class that represents compiler options. - Note that this class is likely to change when hosting API becomes part of .Net - - - - - This overload will be called when a SourceUnit is not available. This can happen if the code is being executed remotely, - since SourceUnit cannot be marshaled across AppDomains. - - - - - Hosting API counterpart for . - - - - - Engine that compiled this code. - - - - - Default scope for this code. - - - - - Executes code in a default scope. - - - - - Execute code within a given scope and returns the result. - - - - - Executes code in in a default scope and converts to a given type. - - - - - Execute code within a given scope and converts result to a given type. - - - - - Executes the code in an empty scope. - Returns an ObjectHandle wrapping the resulting value of running the code. - - - - - Executes the code in the specified scope. - Returns an ObjectHandle wrapping the resulting value of running the code. - - - - - Executes the code in an empty scope. - Returns an ObjectHandle wrapping the resulting value of running the code. - - If an exception is thrown the exception is caught and an ObjectHandle to - the exception is provided. - - - Use this API to handle non-serializable exceptions (exceptions might not be serializable due to security restrictions) - or if an exception serialization loses information. - - - - - Executes the expression in the specified scope and return a result. - Returns an ObjectHandle wrapping the resulting value of running the code. - - If an exception is thrown the exception is caught and an ObjectHandle to - the exception is provided. - - - Use this API to handle non-serializable exceptions (exceptions might not be serializable due to security restrictions) - or if an exception serialization loses information. - - - - - Provides documentation against live objects for use in a REPL window. - - - - - Gets the available members defined on the provided object. - - - - - Gets the overloads available for the provided object if it is invokable. - - - - - Gets the available members on the provided remote object. - - - - - Gets the overloads available for the provided remote object if it is invokable. - - - - - The host can use this class to track for errors reported during script parsing and compilation. - Hosting API counterpart for . - - - - - Bridges ErrorSink and ErrorListener. - Errors reported by language compilers to ErrorSink are forwarded to the ErrorListener provided by the host. - - - This proxy is created in the scenario when the compiler is processing a single SourceUnit. - Therefore it could maintain one to one mapping from SourceUnit to ScriptSource. - In a case, which shouldn't happen, that the compiler reports an error in a different SourceUnit we just create - a new instance of the ScriptSource each time. - - TODO: Consider compilation of multiple source units and creating a hashtable mapping SourceUnits to ScriptSources - within the context of compilation unit. - - - - - Bridges ErrorListener and ErrorSink. It provides the reverse functionality as ErrorSinkProxyListener - - - - - Stores information needed to setup a language - - - - - Creates a new LanguageSetup - - assembly qualified type name of the language - provider - - - - Creates a new LanguageSetup with the provided options - TODO: remove this overload? - - - - - Creates a new LanguageSetup with the provided options - - - - - Gets an option as a strongly typed value. - - - - - The assembly qualified type name of the language provider - - - - - Display name of the language. If empty, it will be set to the first - name in the Names list. - - - - - Case-insensitive language names. - - - - - Case-insensitive file extension, optionally starts with a dot. - - - - - Option names are case-sensitive. - - - - - Provides documentation about a member in a live object. - - - - - The name of the member - - - - - The kind of the member if it's known. - - - - - Specifies the type of member. - - - - - ObjectOperations provide a large catalogue of object operations such as member access, conversions, - indexing, and things like addition. There are several introspection and tool support services available - for more advanced hosts. - - You get ObjectOperation instances from ScriptEngine, and they are bound to their engines for the semantics - of the operations. There is a default instance of ObjectOperations you can share across all uses of the - engine. However, very advanced hosts can create new instances. - - - - - Returns true if the object can be called, false if it cannot. - - Even if an object is callable Call may still fail if an incorrect number of arguments or type of arguments are provided. - - - - - Invokes the provided object with the given parameters and returns the result. - - The prefered way of calling objects is to convert the object to a strongly typed delegate - using the ConvertTo methods and then invoking that delegate. - - - - - Invokes a member on the provided object with the given parameters and returns the result. - - - - - Creates a new instance from the provided object using the given parameters, and returns the result. - - - - - Gets the member name from the object obj. Throws an exception if the member does not exist or is write-only. - - - - - Gets the member name from the object obj and converts it to the type T. Throws an exception if the - member does not exist, is write-only, or cannot be converted. - - - - - Gets the member name from the object obj. Returns true if the member is successfully retrieved and - stores the value in the value out param. - - - - - Returns true if the object has a member named name, false if the member does not exist. - - - - - Removes the member name from the object obj. - - - - - Sets the member name on object obj to value. - - - - - Sets the member name on object obj to value. This overload can be used to avoid - boxing and casting of strongly typed members. - - - - - Gets the member name from the object obj. Throws an exception if the member does not exist or is write-only. - - - - - Gets the member name from the object obj and converts it to the type T. Throws an exception if the - member does not exist, is write-only, or cannot be converted. - - - - - Gets the member name from the object obj. Returns true if the member is successfully retrieved and - stores the value in the value out param. - - - - - Returns true if the object has a member named name, false if the member does not exist. - - - - - Removes the member name from the object obj. - - - - - Sets the member name on object obj to value. - - - - - Sets the member name on object obj to value. This overload can be used to avoid - boxing and casting of strongly typed members. - - - - - Converts the object obj to the type T. The conversion will be explicit or implicit depending on - what the langauge prefers. - - - - - Converts the object obj to the type type. The conversion will be explicit or implicit depending on - what the langauge prefers. - - - - - Converts the object obj to the type T. Returns true if the value can be converted, false if it cannot. - - The conversion will be explicit or implicit depending on what the langauge prefers. - - - - - Converts the object obj to the type type. Returns true if the value can be converted, false if it cannot. - - The conversion will be explicit or implicit depending on what the langauge prefers. - - - - - Converts the object obj to the type T including explicit conversions which may lose information. - - - - - Converts the object obj to the type type including explicit conversions which may lose information. - - - - - Converts the object obj to the type T including explicit conversions which may lose information. - - Returns true if the value can be converted, false if it cannot. - - - - - Converts the object obj to the type type including explicit conversions which may lose information. - - Returns true if the value can be converted, false if it cannot. - - - - - Converts the object obj to the type T including implicit conversions. - - - - - Converts the object obj to the type type including implicit conversions. - - - - - Converts the object obj to the type T including implicit conversions. - - Returns true if the value can be converted, false if it cannot. - - - - - Converts the object obj to the type type including implicit conversions. - - Returns true if the value can be converted, false if it cannot. - - - - - Performs a generic unary operation on the specified target and returns the result. - - - - - Performs a generic unary operation on the strongly typed target and returns the value as the specified type - - - - - Performs the generic binary operation on the specified targets and returns the result. - - - - - Peforms the generic binary operation on the specified strongly typed targets and returns - the strongly typed result. - - - - - Performs addition on the specified targets and returns the result. Throws an exception - if the operation cannot be performed. - - - - - Performs subtraction on the specified targets and returns the result. Throws an exception - if the operation cannot be performed. - - - - - Raises the first object to the power of the second object. Throws an exception - if the operation cannot be performed. - - - - - Multiplies the two objects. Throws an exception - if the operation cannot be performed. - - - - - Divides the first object by the second object. Throws an exception - if the operation cannot be performed. - - - - - Performs modulus of the 1st object by the second object. Throws an exception - if the operation cannot be performed. - - - - - Shifts the left object left by the right object. Throws an exception if the - operation cannot be performed. - - - - - Shifts the left object right by the right object. Throws an exception if the - operation cannot be performed. - - - - - Performs a bitwise-and of the two operands. Throws an exception if the operation - cannot be performed. - - - - - Performs a bitwise-or of the two operands. Throws an exception if the operation - cannot be performed. - - - - - Performs a exclusive-or of the two operands. Throws an exception if the operation - cannot be performed. - - - - - Compares the two objects and returns true if the left object is less than the right object. - Throws an exception if hte comparison cannot be performed. - - - - - Compares the two objects and returns true if the left object is greater than the right object. - Throws an exception if hte comparison cannot be performed. - - - - - Compares the two objects and returns true if the left object is less than or equal to the right object. - Throws an exception if hte comparison cannot be performed. - - - - - Compares the two objects and returns true if the left object is greater than or equal to the right object. - Throws an exception if hte comparison cannot be performed. - - - - - Compares the two objects and returns true if the left object is equal to the right object. - Throws an exception if the comparison cannot be performed. - - - - - Compares the two objects and returns true if the left object is not equal to the right object. - Throws an exception if hte comparison cannot be performed. - - - - - Returns a string which describes the object as it appears in source code - - - - - Returns a string representation of the object in a language specific object display format. - - - - - Returns a list of strings which contain the known members of the object. - - - - - Returns a string providing documentation for the specified object. - - - - - Returns a list of signatures applicable for calling the specified object in a form displayable to the user. - - - - - Returns true if the remote object is callable. - - - - - Invokes the specified remote object with the specified remote parameters. - - Though delegates are preferable for calls they may not always be usable for remote objects. - - - - - Invokes the specified remote object with the local parameters which will be serialized - to the remote app domain. - - - - - Creates a new remote instance from the provided remote object using the given parameters, and returns the result. - - - - - Creates a new remote instance from the provided remote object using the given parameters, and returns the result. - - - - - Sets the remote object as a member on the provided remote object. - - - - - Sets the member name on the remote object obj to value. This overload can be used to avoid - boxing and casting of strongly typed members. - - - - - Gets the member name on the remote object. Throws an exception if the member is not defined or - is write-only. - - - - - Gets the member name on the remote object. Throws an exception if the member is not defined or - is write-only. - - - - - Gets the member name on the remote object. Returns false if the member is not defined or - is write-only. - - - - - Tests to see if the member name is defined on the remote object. - - - - - Removes the member from the remote object - - - - - Converts the remote object into the specified type returning a handle to - the new remote object. The conversion will be explicit or implicit depending on - what the langauge prefers. - - - - - Converts the remote object into the specified type returning a handle to - the new remote object. The conversion will be explicit or implicit depending on - what the langauge prefers. - - - - - Converts the remote object into the specified type returning a handle to - the new remote object. Returns true if the value can be converted, - false if it cannot. The conversion will be explicit or implicit depending on - what the langauge prefers. - - - - - Converts the remote object into the specified type returning a handle to - the new remote object. Returns true if the value can be converted, - false if it cannot. The conversion will be explicit or implicit depending on - what the langauge prefers. - - - - - Converts the object obj to the type T including explicit conversions which may lose information. - - - - - Converts the object obj to the type type including explicit conversions which may lose information. - - - - - Converts the object obj to the type T including explicit conversions which may lose information. - - Returns true if the value can be converted, false if it cannot. - - - - - Converts the object obj to the type type including explicit conversions which may lose information. - - Returns true if the value can be converted, false if it cannot. - - - - - Converts the object obj to the type T including implicit conversions. - - - - - Converts the object obj to the type type including implicit conversions. - - - - - Converts the object obj to the type T including implicit conversions. - - Returns true if the value can be converted, false if it cannot. - - - - - Converts the object obj to the type type including implicit conversions. - - Returns true if the value can be converted, false if it cannot. - - - - - Unwraps the remote object and converts it into the specified type before - returning it. - - - - - Performs the specified unary operator on the remote object. - - - - - Performs the specified binary operator on the remote object. - - - - - Adds the two remote objects. Throws an exception if the operation cannot be performed. - - - - - Subtracts the 1st remote object from the second. Throws an exception if the operation cannot be performed. - - - - - Raises the 1st remote object to the power of the 2nd. Throws an exception if the operation cannot be performed. - - - - - Multiplies the two remote objects. Throws an exception if the operation cannot be performed. - - - - - Divides the 1st remote object by the 2nd. Throws an exception if the operation cannot be performed. - - - - - Performs modulus on the 1st remote object by the 2nd. Throws an exception if the operation cannot be performed. - - - - - Shifts the 1st remote object left by the 2nd remote object. Throws an exception if the operation cannot be performed. - - - - - Shifts the 1st remote object right by the 2nd remote object. Throws an exception if the operation cannot be performed. - - - - - Performs bitwise-and on the two remote objects. Throws an exception if the operation cannot be performed. - - - - - Performs bitwise-or on the two remote objects. Throws an exception if the operation cannot be performed. - - - - - Performs exclusive-or on the two remote objects. Throws an exception if the operation cannot be performed. - - - - - Compares the two remote objects and returns true if the 1st is less than the 2nd. Throws an exception if the operation cannot be performed. - - - - - Compares the two remote objects and returns true if the 1st is greater than the 2nd. Throws an exception if the operation cannot be performed. - - - - - Compares the two remote objects and returns true if the 1st is less than or equal to the 2nd. Throws an exception if the operation cannot be performed. - - - - - Compares the two remote objects and returns true if the 1st is greater than or equal to than the 2nd. Throws an exception if the operation cannot be performed. - - - - - Compares the two remote objects and returns true if the 1st is equal to the 2nd. Throws an exception if the operation cannot be performed. - - - - - Compares the two remote objects and returns true if the 1st is not equal to the 2nd. Throws an exception if the operation cannot be performed. - - - - - Returns a string representation of the object in a langauge specific object display format. - - - - - Returns a list of strings which contain the known members of the remote object. - - - - - Returns a string providing documentation for the specified remote object. - - - - - Returns a list of signatures applicable for calling the specified object in a form displayable to the user. - - - - - Helper to unwrap an object - in the future maybe we should validate the current app domain. - - - - - Helper to unwrap multiple objects - - - - - Provides documentation for a single overload of an invokable object. - - - - - The name of the invokable object. - - - - - The documentation for the overload or null if no documentation is available. - - - - - The parameters for the invokable object. - - - - - Information about the return value. - - - - - Provides documentation for a single parameter. - - - - - The name of the parameter - - - - - The type name of the parameter or null if no type information is available. - - - - - Provides addition information about the parameter such as if it's a parameter array. - - - - - Gets the documentation string for this parameter or null if no documentation is available. - - - - - Indications extra information about a parameter such as if it's a parameter array. - - - - - Advanced APIs for HAPI providers. These methods should not be used by hosts. - They are provided for other hosting API implementers that would like to leverage existing HAPI and - extend it with language specific functionality, for example. - - - - is a null reference. - is remote. - - - e is a null reference. - is remote. - - - is a null reference. - is remote. - - - is a null reference. - is remote. - - - is a null reference. - is remote. - - - is a null reference. - is remote. - - - is a null reference. - is a null reference. - is a transparent proxy. - - - - Performs a callback in the ScriptEngine's app domain and returns the result. - - - - - Creates a new DocumentationOperations object from the given DocumentationProvider. - - - - - Represents a language in Hosting API. - Hosting API counterpart for . - - - - - Returns a default ObjectOperations for the engine. - - Because an ObjectOperations object caches rules for the types of - objects and operations it processes, using the default ObjectOperations for - many objects could degrade the caching benefits. Eventually the cache for - some operations could degrade to a point where ObjectOperations stops caching and - does a full search for an implementation of the requested operation for the given objects. - - Another reason to create a new ObjectOperations instance is to have it bound - to the specific view of a ScriptScope. Languages may attach per-language - behavior to a ScriptScope which would alter how the operations are performed. - - For simple hosting situations, this is sufficient behavior. - - - - - - - Returns a new ObjectOperations object. See the Operations property for why you might want to call this. - - - - - Returns a new ObjectOperations object that inherits any semantics particular to the provided ScriptScope. - - See the Operations property for why you might want to call this. - - - - - Executes an expression. The execution is not bound to any particular scope. - - The engine doesn't support code execution. - is a null reference. - - - - Executes an expression within the specified scope. - - The engine doesn't support code execution. - is a null reference. - is a null reference. - - - - Executes an expression within a new scope and converts result to the given type. - - The engine doesn't support code execution. - is a null reference. - - - - Executes an expression within the specified scope and converts result to the given type. - - The engine doesn't support code execution. - is a null reference. - is a null reference. - - - - Executes content of the specified file in a new scope and returns that scope. - - The engine doesn't support code execution. - is a null reference. - - - - Executes content of the specified file against the given scope. - - The . - The engine doesn't support code execution. - is a null reference. - is a null reference. - - - - Executes the expression in the specified scope and return a result. - Returns an ObjectHandle wrapping the resulting value of running the code. - - - - - Executes the code in an empty scope. - Returns an ObjectHandle wrapping the resulting value of running the code. - - - - - Executes the expression in the specified scope and return a result. - Returns an ObjectHandle wrapping the resulting value of running the code. - - If an exception is thrown the exception is caught and an ObjectHandle to - the exception is provided. - - - Use this API in case the exception is not serializable (for example, due to security restrictions) or its serialization - loses information that you need to access. - - - - - Executes the code in an empty scope. - Returns an ObjectHandle wrapping the resulting value of running the code. - - If an exception is thrown the exception is caught and an ObjectHandle to - the exception is provided. - - - Use this API in case the exception is not serializable (for example, due to security restrictions) or its serialization - loses information that you need to access. - - - - - Creates a new ScriptScope using the default storage container - - - - - Creates a new ScriptScope whose storage contains the provided dictionary of objects - - Accesses to the ScriptScope will turn into get,set, and delete members against this dictionary - - - - - Creates a new ScriptScope whose storage is an arbitrary object. - - Accesses to the ScriptScope will turn into get, set, and delete members against the object. - - - - - This method returns the ScriptScope in which a ScriptSource of given path was executed. - - The ScriptSource.Path property is the key to finding the ScriptScope. Hosts need - to make sure they create a ScriptSource and set its Path property appropriately. - - GetScope is primarily useful for tools that need to map files to their execution scopes. For example, - an editor and interpreter tool might run a file Foo that imports or requires a file Bar. - - The editor's user might later open the file Bar and want to execute expressions in its context. - The tool would need to find Bar's ScriptScope for setting the appropriate context in its interpreter window. - This method helps with this scenario. - - - - - Return a ScriptSource object from string contents with the current engine as the language binding. - - The default SourceCodeKind is AutoDetect. - - The ScriptSource's Path property defaults to null. - - - - - Return a ScriptSource object from string contents with the current engine as the language binding. - - The ScriptSource's Path property defaults to null. - - - - - Return a ScriptSource object from string contents with the current engine as the language binding. - - The default SourceCodeKind is AutoDetect. - - - - - Return a ScriptSource object from string contents. These are helpers for creating ScriptSources' with the right language binding. - - - - - Return a ScriptSource object from file contents with the current engine as the language binding. - - The path's extension does NOT have to be in ScriptRuntime.GetRegisteredFileExtensions - or map to this language engine with ScriptRuntime.GetEngineByFileExtension. - - The default SourceCodeKind is File. - - The ScriptSource's Path property will be the path argument. - - The encoding defaults to System.Text.Encoding.Default. - - - - - Return a ScriptSource object from file contents with the current engine as the language binding. - - The path's extension does NOT have to be in ScriptRuntime.GetRegisteredFileExtensions - or map to this language engine with ScriptRuntime.GetEngineByFileExtension. - - The default SourceCodeKind is File. - - The ScriptSource's Path property will be the path argument. - - - - - Return a ScriptSource object from file contents with the current engine as the language binding. - - The path's extension does NOT have to be in ScriptRuntime.GetRegisteredFileExtensions - or map to this language engine with ScriptRuntime.GetEngineByFileExtension. - - The ScriptSource's Path property will be the path argument. - - - - - This method returns a ScriptSource object from a System.CodeDom.CodeObject. - This is a factory method for creating a ScriptSources with this language binding. - - The expected CodeDom support is extremely minimal for syntax-independent expression of semantics. - - Languages may do more, but hosts should only expect CodeMemberMethod support, - and only sub nodes consisting of the following: - CodeSnippetStatement - CodeSnippetExpression - CodePrimitiveExpression - CodeMethodInvokeExpression - CodeExpressionStatement (for holding MethodInvoke) - - - - - This method returns a ScriptSource object from a System.CodeDom.CodeObject. - This is a factory method for creating a ScriptSources with this language binding. - - The expected CodeDom support is extremely minimal for syntax-independent expression of semantics. - - Languages may do more, but hosts should only expect CodeMemberMethod support, - and only sub nodes consisting of the following: - CodeSnippetStatement - CodeSnippetExpression - CodePrimitiveExpression - CodeMethodInvokeExpression - CodeExpressionStatement (for holding MethodInvoke) - - - - - This method returns a ScriptSource object from a System.CodeDom.CodeObject. - This is a factory method for creating a ScriptSources with this language binding. - - The expected CodeDom support is extremely minimal for syntax-independent expression of semantics. - - Languages may do more, but hosts should only expect CodeMemberMethod support, - and only sub nodes consisting of the following: - CodeSnippetStatement - CodeSnippetExpression - CodePrimitiveExpression - CodeMethodInvokeExpression - CodeExpressionStatement (for holding MethodInvoke) - - - - - This method returns a ScriptSource object from a System.CodeDom.CodeObject. - This is a factory method for creating a ScriptSources with this language binding. - - The expected CodeDom support is extremely minimal for syntax-independent expression of semantics. - - Languages may do more, but hosts should only expect CodeMemberMethod support, - and only sub nodes consisting of the following: - CodeSnippetStatement - CodeSnippetExpression - CodePrimitiveExpression - CodeMethodInvokeExpression - CodeExpressionStatement (for holding MethodInvoke) - - - - - These methods return ScriptSource objects from stream contents with the current engine as the language binding. - - The default SourceCodeKind is File. - - The encoding defaults to Encoding.Default. - - - - - These methods return ScriptSource objects from stream contents with the current engine as the language binding. - - The default SourceCodeKind is File. - - - - - These methods return ScriptSource objects from stream contents with the current engine as the language binding. - - The encoding defaults to Encoding.Default. - - - - - This method returns a ScriptSource with the content provider supplied with the current engine as the language binding. - - This helper lets you own the content provider so that you can implement a stream over internal host data structures, such as an editor's text representation. - - - - - This method returns a language-specific service. - - It provides a point of extensibility for a language implementation - to offer more functionality than the standard engine members discussed here. - - Commonly available services include: - TokenCategorizer - Provides standardized tokenization of source code - ExceptionOperations - Provides formatting of exception objects. - DocumentationProvidera - Provides documentation for live object. - - - - - This property returns readon-only LanguageOptions this engine is using. - - - The values are determined during runtime initialization and read-only afterwards. - You can change the settings via a configuration file or explicitly using ScriptRuntimeSetup class. - - - - - This property returns the ScriptRuntime for the context in which this engine executes. - - - - - This property returns the engine's version as a string. The format is language-dependent. - - - - - Sets the search paths used by the engine for loading files when a script wants - to import or require another file of code. - - The language doesn't allow to set search paths. - - - - Gets the search paths used by the engine for loading files when a script wants - to import or require another file of code. - - - - - ScriptHost is collocated with ScriptRuntime in the same app-domain. - The host can implement a derived class to consume some notifications and/or - customize operations like TryGetSourceUnit,ResolveSourceUnit, etc. - - The areguments to the the constructor of the derived class are specified in ScriptRuntimeSetup - instance that enters ScriptRuntime initialization. - - If the host is remote with respect to DLR (i.e. also with respect to ScriptHost) - and needs to access objects living in its app-domain it can pass MarshalByRefObject - as an argument to its ScriptHost subclass constructor. - - - - - The runtime the host is attached to. - - - - - Invoked after the initialization of the associated Runtime is finished. - The host can override this method to perform additional initialization of runtime (like loading assemblies etc.). - - - - - Invoked after a new language is loaded into the Runtime. - The host can override this method to perform additional initialization of language engines. - - - - - Provides hosting to DLR. Forwards DLR requests to the ScriptHost. - - - - - Provides host-redirectable IO streams used by DLR languages for default IO. - - - - - Used if the host stores the output as binary data. - - Binary stream to write data to. - Encoding used to convert textual data written to the output by the script. - - - - Used if the host handles both kinds of data (textual and binary) by itself. - - - - - Represents a Dynamic Language Runtime in Hosting API. - Hosting API counterpart for . - - - - - Creates ScriptRuntime in the current app-domain and initialized according to the the specified settings. - Creates an instance of host class specified in the setup and associates it with the created runtime. - Both Runtime and ScriptHost are collocated in the current app-domain. - - - - - Creates a new runtime with languages set up according to the current application configuration - (using System.Configuration). - - - - - Creates ScriptRuntime in the current app-domain and initialized according to the the specified settings. - Creates an instance of host class specified in the setup and associates it with the created runtime. - Both Runtime and ScriptHost are collocated in the specified app-domain. - - - - - - - - - Gets engine for the specified language. - - - - - Looks up the engine for the specified language. If the engine hasn't been created in this Runtime, it is instantiated here. - The method doesn't lock nor send notifications to the host. - - - - - path is empty, contains one or more of the invalid characters defined in GetInvalidPathChars or doesn't have an extension. - - - - path is null - file extension does not map to language engine - language does not have any search paths - file does exist in language's search path - - - - This property returns the "global object" or name bindings of the ScriptRuntime as a ScriptScope. - - You can set the globals scope, which you might do if you created a ScriptScope with an - IAttributesCollection so that your host could late bind names. - - - - - This method walks the assembly's namespaces and name bindings to ScriptRuntime.Globals - to represent the types available in the assembly. Each top-level namespace name gets - bound in Globals to a dynamic object representing the namespace. Within each top-level - namespace object, nested namespace names are bound to dynamic objects representing each - tier of nested namespaces. When this method encounters the same namespace-qualified name, - it merges names together objects representing the namespaces. - - - - - - Stores information needed to setup a ScriptRuntime - - - - - The list of language setup information for languages to load into - the runtime - - - - - Indicates that the script runtime is in debug mode. - This means: - - 1) Symbols are emitted for debuggable methods (methods associated with SourceUnit). - 2) Debuggable methods are emitted to non-collectable types (this is due to CLR limitations on dynamic method debugging). - 3) JIT optimization is disabled for all methods - 4) Languages may disable optimizations based on this value. - - - - - Ignore CLR visibility checks - - - - - Can be any derived class of ScriptHost. When set, it allows the - host to override certain methods to control behavior of the runtime - - - - - Option names are case-sensitive. - - - - - Arguments passed to the host type when it is constructed - - - - - Reads setup from .NET configuration system (.config files). - If there is no configuration available returns an empty setup. - - - - - Reads setup from a specified XML stream. - - - - - Reads setup from a specified XML file. - - - - - A ScriptScope is a unit of execution for code. It consists of a global Scope which - all code executes in. A ScriptScope can have an arbitrary initializer and arbitrary - reloader. - - ScriptScope is not thread safe. Host should either lock when multiple threads could - access the same module or should make a copy for each thread. - - Hosting API counterpart for . - - - - - Gets an engine for the language associated with this scope. - Returns invariant engine if the scope is language agnostic. - - - - - Gets a value stored in the scope under the given name. - - The specified name is not defined in the scope. - is a null reference. - - - - Gets a value stored in the scope under the given name. - Converts the result to the specified type using the conversion that the language associated with the scope defines. - If no language is associated with the scope, the default CLR conversion is attempted. - - The specified name is not defined in the scope. - is a null reference. - - - - Tries to get a value stored in the scope under the given name. - - is a null reference. - - - - Tries to get a value stored in the scope under the given name. - Converts the result to the specified type using the conversion that the language associated with the scope defines. - If no language is associated with the scope, the default CLR conversion is attempted. - - is a null reference. - - - - Sets the name to the specified value. - - is a null reference. - - - - Gets a handle for a value stored in the scope under the given name. - - The specified name is not defined in the scope. - is a null reference. - - - - Tries to get a handle for a value stored in the scope under the given name. - Returns true if there is such name, false otherwise. - - is a null reference. - - - - Sets the name to the specified value. - - - The value held by the handle isn't from the scope's app-domain and isn't serializable or MarshalByRefObject. - - or is a null reference. - - - - Determines if this context or any outer scope contains the defined name. - - is a null reference. - - - - Removes the variable of the given name from this scope. - - true if the value existed in the scope before it has been removed. - is a null reference. - - - - Gets a list of variable names stored in the scope. - - - - - Gets an array of variable names and their values stored in the scope. - - - - - Hosting counterpart for . - - - - - Identification of the source unit. Assigned by the host. - The format and semantics is host dependent (could be a path on file system or URL). - null for anonymous script source. - Cannot be an empty string. - - - - - Compile the ScriptSource into CompileCode object that can be executed - repeatedly in its default scope or in other scopes without having to recompile the code. - - Code cannot be compiled. - - - - Errors are reported to the specified listener. - Returns null if the parser cannot compile the code due to errors. - - - - - Errors are reported to the specified listener. - Returns null if the parser cannot compile the code due to error(s). - - - - - Errors are reported to the specified listener. - Returns null if the parser cannot compile the code due to error(s). - - - - - Executes the code in the specified scope. - Returns an object that is the resulting value of running the code. - - When the ScriptSource is a file or statement, the engine decides what is - an appropriate value to return. Some languages return the value produced - by the last expression or statement, but languages that are not expression - based may return null. - - Code cannot be compiled. - - - - Executes the source code. The execution is not bound to any particular scope. - - - - - Executes the code in a specified scope and converts the result to the specified type. - The conversion is language specific. - - - - - Executes the code in an empty scope and converts the result to the specified type. - The conversion is language specific. - - - - - Executes the code in an empty scope. - Returns an ObjectHandle wrapping the resulting value of running the code. - - - - - Executes the code in the specified scope. - Returns an ObjectHandle wrapping the resulting value of running the code. - - - - - Executes the code in an empty scope. - Returns an ObjectHandle wrapping the resulting value of running the code. - - If an exception is thrown the exception is caught and an ObjectHandle to - the exception is provided. - - - Use this API to handle non-serializable exceptions (exceptions might not be serializable due to security restrictions) - or if an exception serialization loses information. - - - - - Executes the expression in the specified scope and return a result. - Returns an ObjectHandle wrapping the resulting value of running the code. - - If an exception is thrown the exception is caught and an ObjectHandle to - the exception is provided. - - - Use this API to handle non-serializable exceptions (exceptions might not be serializable due to security restrictions) - or if an exception serialization loses information. - - - - - Runs a specified code as if it was a program launched from OS command shell. - and returns a process exit code indicating the success or error condition - of executing the code. - - Exact behavior depends on the language. Some languages have a dedicated "exit" exception that - carries the exit code, in which case the exception is cought and the exit code is returned. - The default behavior returns the result of program's execution converted to an integer - using a language specific conversion. - - Code cannot be compiled. - - - - Detects the encoding of the content. - - - An encoding that is used by the reader of the script source to transcode its content to Unicode text. - Null if the content is already textual and no transcoding is performed. - - - Note that the default encoding specified when the script source is created could be overridden by - an encoding that is found in the content preamble (Unicode BOM or a language specific encoding preamble). - In that case the preamble encoding is returned. Otherwise, the default encoding is returned. - - An I/O error occurs. - - - - Reads specified range of lines (or less) from the source unit. - - 1-based number of the first line to fetch. - The number of lines to fetch. - - Which character sequences are considered line separators is language specific. - If language doesn't specify otherwise "\r", "\n", "\r\n" are recognized line separators. - - An I/O error occurs. - - - - Reads a specified line. - - 1-based line number. - Line content. Line separator is not included. - An I/O error occurs. - - Which character sequences are considered line separators is language specific. - If language doesn't specify otherwise "\r", "\n", "\r\n" are recognized line separators. - - - - - Gets script source content. - - Entire content. - An I/O error occurs. - - The result includes language specific preambles (e.g. "#coding:UTF-8" encoding preamble recognized by Ruby), - but not the preamble defined by the content encoding (e.g. BOM). - The entire content of the source unit is encoded by single encoding (if it is read from binary stream). - - - - - The current internal state of the scanner. - - - - - The current startLocation of the scanner. - - - - - Move the tokenizer past the next token and return its category. - - The token information associated with the token just scanned. - - - - Move the tokenizer past the next token. - - False if the end of stream has been reached, true otherwise. - - - - Get all tokens over a block of the stream. - - - - The scanner should return full tokens. If startLocation + length lands in the middle of a token, the full token - should be returned. - - s - Tokens are read until at least given amount of characters is read or the stream ends. - A enumeration of tokens. - - - - Scan from startLocation to at least startLocation + length. - - Tokens are read until at least given amount of characters is read or the stream ends. - - This method is used to determine state at arbitrary startLocation. - - False if the end of stream has been reached, true otherwise. - - - - This structure represents an immutable integer interval that describes a range of values, from Start to End. - - It is closed on the left and open on the right: [Start .. End). - - - - - Dynamically choose between interpreting, simple compilation and compilation - that takes advantage of runtime history. - - - - - The number of iterations before the interpreter starts compiling.s - - - - - Display exception detail (callstack) when exception gets caught - - - - - Whether to gather performance statistics. - - - - - Initial file search paths provided by the host. - - - - - Reads an option whose value is expected to be a collection of non-null strings. - Reaturns a read-only copy of the option's value. - - - - - Abstracts system operations that are used by DLR and could potentially be platform specific. - The host can implement its PAL to adapt DLR to the platform it is running on. - For example, the Silverlight host adapts some file operations to work against files on the server. - - - - Invalid path. - - - Invalid path. - - - - Represents a language context. Typically there is at most 1 context - associated with each language, but some languages may use more than one context - to identify code that should be treated differently. Contexts are used during - member and operator lookup. - - - - - Registers a language within the system with the specified name. - - - - - Looks up the context ID for the specified context identifier - - - - - Singleton for each language. - - - - - Must not be called under a lock as it can potentially call a user code. - - The language context's implementation failed to instantiate. - - - - Gets a value indicating whether the application is in debug mode. - This means: - - 1) Symbols are emitted for debuggable methods (methods associated with SourceUnit). - 2) Debuggable methods are emitted to non-collectable types (this is due to CLR limitations on dynamic method debugging). - 3) JIT optimization is disabled for all methods - 4) Languages may disable optimizations based on this value. - - - - - Ignore CLR visibility checks. - - - - - Provides language specific documentation for live objects. - - - - - ObjectOperations provide a large catalogue of object operations such as member access, conversions, - indexing, and things like addition. There are several introspection and tool support services available - for more advanced hosts. - - You get ObjectOperation instances from ScriptEngine, and they are bound to their engines for the semantics - of the operations. There is a default instance of ObjectOperations you can share across all uses of the - engine. However, very advanced hosts can create new instances. - - - - a dictionary of SiteKey's which are used to cache frequently used operations, logically a set - - - the # of sites we had created at the last cleanup - - - the total number of sites we've ever created - - - the number of sites required before we'll try cleaning up the cache... - - - the minimum difference between the average that is required to remove - - - the maximum number we'll remove on a single cache cleanup - - - the number of sites we should clear after if we can't make progress cleaning up otherwise - - - - Calls the provided object with the given parameters and returns the result. - - The prefered way of calling objects is to convert the object to a strongly typed delegate - using the ConvertTo methods and then invoking that delegate. - - - - - Invokes a member on the provided object with the given parameters and returns the result. - - - - - Invokes a member on the provided object with the given parameters and returns the result. - - - - - Creates a new instance from the provided object using the given parameters, and returns the result. - - - - - Gets the member name from the object obj. Throws an exception if the member does not exist or is write-only. - - - - - Gets the member name from the object obj and converts it to the type T. Throws an exception if the - member does not exist, is write-only, or cannot be converted. - - - - - Gets the member name from the object obj. Returns true if the member is successfully retrieved and - stores the value in the value out param. - - - - - Returns true if the object has a member named name, false if the member does not exist. - - - - - Removes the member name from the object obj. - - - - - Sets the member name on object obj to value. - - - - - Sets the member name on object obj to value. This overload can be used to avoid - boxing and casting of strongly typed members. - - - - - Gets the member name from the object obj. Throws an exception if the member does not exist or is write-only. - - - - - Gets the member name from the object obj and converts it to the type T. The conversion will be explicit or implicit - depending on what the langauge prefers. Throws an exception if the member does not exist, is write-only, or cannot be converted. - - - - - Gets the member name from the object obj. Returns true if the member is successfully retrieved and - stores the value in the value out param. - - - - - Returns true if the object has a member named name, false if the member does not exist. - - - - - Removes the member name from the object obj. Returns true if the member was successfully removed - or false if the member does not exist. - - - - - Sets the member name on object obj to value. - - - - - Sets the member name on object obj to value. This overload can be used to avoid - boxing and casting of strongly typed members. - - - - - Converts the object obj to the type T. The conversion will be explicit or implicit - depending on what the langauge prefers. - - - - - Converts the object obj to the type type. The conversion will be explicit or implicit - depending on what the langauge prefers. - - - - - Converts the object obj to the type T. Returns true if the value can be converted, false if it cannot. - - The conversion will be explicit or implicit depending on what the langauge prefers. - - - - - Converts the object obj to the type type. Returns true if the value can be converted, false if it cannot. - - The conversion will be explicit or implicit depending on what the langauge prefers. - - - - - Convers the object obj to the type T including explicit conversions which may lose information. - - - - - Converts the object obj to the type type including explicit conversions which may lose information. - - - - - Converts the object obj to the type type including explicit conversions which may lose information. - - Returns true if the value can be converted, false if it cannot. - - - - - Converts the object obj to the type T. Returns true if the value can be converted, false if it cannot. - - - - - Convers the object obj to the type T including implicit conversions. - - - - - Converts the object obj to the type type including implicit conversions. - - - - - Converts the object obj to the type type including implicit conversions. - - Returns true if the value can be converted, false if it cannot. - - - - - Converts the object obj to the type T. Returns true if the value can be converted, false if it cannot. - - - - - Performs a generic unary operation on the strongly typed target and returns the value as the specified type - - - - - Peforms the generic binary operation on the specified strongly typed targets and returns - the strongly typed result. - - - - - Returns a list of strings which contain the known members of the object. - - - - - Returns a string representation of the object in a language specific object display format. - - - - - Gets or creates a dynamic site w/ the specified type parameters for the provided binder. - - - This will either get the site from the cache or create a new site and return it. The cache - may be cleaned if it's gotten too big since the last usage. - - - - - Gets or creates a dynamic site w/ the specified type parameters for the provided binder. - - - This will either get the site from the cache or create a new site and return it. The cache - may be cleaned if it's gotten too big since the last usage. - - - - - Gets or creates a dynamic site w/ the specified type parameters for the provided binder. - - - This will either get the site from the cache or create a new site and return it. The cache - may be cleaned if it's gotten too big since the last usage. - - - - - Gets or creates a dynamic site w/ the specified type parameters for the provided binder. - - - This will either get the site from the cache or create a new site and return it. The cache - may be cleaned if it's gotten too big since the last usage. - - - - - Gets or creates a dynamic site w/ the specified type parameters for the provided binder. - - - This will either get the site from the cache or create a new site and return it. The cache - may be cleaned if it's gotten too big since the last usage. - - - - - Helper to create to get or create the dynamic site - called by the GetSite methods. - - - - - Removes items from the cache that have the lowest usage... - - - - - Helper class for tracking all of our unique dynamic sites and their - usage patterns. We hash on the combination of the binder and site type. - - We also track the hit count and the key holds the site associated w/ the - key. Logically this is a set based upon the binder and site-type but we - store it in a dictionary. - - - - - DLR requires any Hosting API provider to implement this class and provide its instance upon Runtime initialization. - DLR calls on it to perform basic host/system dependent operations. - - - - - Abstracts system operations that are used by DLR and could potentially be platform specific. - - - - - Helper for storing information about stack frames. - - - - - Singleton LanguageContext which represents a language-neutral LanguageContext - - - - - Internal class which binds a LanguageContext, StreamContentProvider, and Encoding together to produce - a TextContentProvider which reads binary data with the correct language semantics. - - - - - Provides language specific facilities which are typically called by the runtime. - - - - - Provides the ContextId which includes members that should only be shown for this LanguageContext. - - ContextId's are used for filtering by Scope's. - - - - - Gets the ScriptDomainManager that this LanguageContext is running within. - - - - - Whether the language can parse code and create source units. - - - - - Gets the scope associated with a file, or null if none was available - - - - - Creates a new ScriptScope using the default storage container - - - - - Creates a new ScriptScope whose storage contains the provided dictionary of objects - - Accesses to the ScriptScope will turn into get,set, and delete members against this dictionary - - - - - Creates a new ScriptScope whose storage is an arbitrary object. - - Accesses to the ScriptScope will turn into get, set, and delete members against the object. - - - - - Provides access to setting variables in scopes. - - By default this goes through ObjectOperations which can be rather slow. - Languages can override this to provide fast customized access which avoids - ObjectOperations. Languages can provide fast access to commonly used scope - types for that language. Typically this includes ScopeStorage and any other - classes which the language themselves uses for backing of a Scope. - - - - - Provides access to try getting variables in scopes. - - By default this goes through ObjectOperations which can be rather slow. - Languages can override this to provide fast customized access which avoids - ObjectOperations. Languages can provide fast access to commonly used scope - types for that language. Typically this includes ScopeStorage and any other - classes which the language themselves uses for backing of a Scope. - - - - - Provides access to getting variables in scopes and converting the result. - - By default this goes through ObjectOperations which can be rather slow. - Languages can override this to provide fast customized access which avoids - ObjectOperations. Languages can provide fast access to commonly used scope - types for that language. Typically this includes ScopeStorage and any other - classes which the language themselves uses for backing of a Scope. - - - - - Provides access to getting variables in scopes. - - By default this goes through ObjectOperations which can be rather slow. - Languages can override this to provide fast customized access which avoids - ObjectOperations. Languages can provide fast access to commonly used scope - types for that language. Typically this includes ScopeStorage and any other - classes which the language themselves uses for backing of a Scope. - - - - - Provides a text reader for source code that is to be read from a given stream. - - The stream open for reading. The stream must also allow seeking. - An encoding that should be used if the stream doesn't have Unicode or language specific preamble. - the path of the source unit if available - The reader. - An I/O error occurs. - - - - Creates the language specific CompilerOptions object for compilation of code not bound to any particular scope. - The language should flow any relevant options from LanguageContext to the newly created options instance. - - - - - Creates the language specific CompilerOptions object for compilation of code bound to a given scope. - - - - - Parses the source code within a specified compiler context. - The source unit to parse is held on by the context. - - null on failure. - Could also set the code properties and line/file mappings on the source unit. - - - - Creates a conversion binder. - - If explicitCast is true then the binder should do explicit conversions. - If explicitCast is false then the binder should do implicit conversions. - - If explicitCast is null it is up to the language to select the conversions - which closest match their normal behavior. - - - - - Gets the member names associated with the object - By default, only returns IDO names - - - - - Returns a string representation of the object in a language specific object display format. - - Dynamic sites container that could be used for any dynamic dispatches necessary for formatting. - Object to format. - A string representation of object. - - - - This attribute marks a parameter that is not allowed to be null. - It is used by the method binding infrastructure to generate better error - messages and method selection. - - - - - This attribute marks a parameter whose type is an array that is not allowed to have null items. - It is used by the method binding infrastructure to generate better error - messages and method selection. - - - - - Wraps a an IDictionary[object, object] and exposes it as an IDynamicMetaObjectProvider so that - users can access string attributes using member accesses. - - - - - Represents a host-provided variables for executable code. The variables are - typically backed by a host-provided dictionary. Languages can also associate per-language - information with the context by using scope extensions. This can be used for tracking - state which is used across multiple executions, for providing custom forms of - storage (for example object keyed access), or other language specific semantics. - - Scope objects are thread-safe as long as their underlying storage is thread safe. - - Script hosts can choose to use thread safe or thread unsafe modules but must be sure - to constrain the code they right to be single-threaded if using thread unsafe - storage. - - - - - Creates a new scope with a new empty thread-safe dictionary. - - - - - Creates a new scope which is backed by an arbitrary object for it's storage. - - - - - - Gets the ScopeExtension associated with the provided ContextId. - - - - - Sets the ScopeExtension to the provided value for the given ContextId. - - The extension can only be set once. The returned value is either the new ScopeExtension - if no value was previously set or the previous value. - - - - - Gets or sets a collection of environment variables. - - - - - Event for when a host calls LoadAssembly. After hooking this - event languages will need to call GetLoadedAssemblyList to - get any assemblies which were loaded before the language was - loaded. - - - - - Only host should redirect I/O. - - - - - Exposes a IDictionary[string, object] as a dynamic object. Gets/sets/deletes turn - into accesses on the underlying dictionary. - - - - - The current internal state of the scanner. - - - - - The current startLocation of the scanner. - - - - - Move the tokenizer past the next token and return its category. - - The token information associated with the token just scanned. - - - - Move the tokenizer past the next token. - - False if the end of stream has been reached, true otherwise. - - - - Get all tokens over a block of the stream. - - - - The scanner should return full tokens. If startLocation + length lands in the middle of a token, the full token - should be returned. - - - Tokens are read until at least given amount of characters is read or the stream ends. - A enumeration of tokens. - - - - Scan from startLocation to at least startLocation + length. - - The mininum number of characters to process while getting tokens. - - This method is used to determine state at arbitrary startLocation. - - False if the end of stream has been reached, true otherwise. - - - - This attribute is used to mark a parameter that can accept any keyword parameters that - are not bound to normal arguments. The extra keyword parameters will be - passed in a dictionary which is created for the call. - - Most languages which support params dictionaries will support the following types: - IDictionary<string, anything> - IDictionary<object, anything> - Dictionary<string, anything> - Dictionary<object, anything> - IDictionary - IAttributesCollection (deprecated) - - For languages which don't have language level support the user will be required to - create and populate the dictionary by hand. - - This attribute is the dictionary equivalent of the System.ParamArrayAttribute. - - - public static void KeywordArgFunction([ParamsDictionary]IDictionary<string, object> dict) { - foreach (var v in dict) { - Console.WriteLine("Key: {0} Value: {1}", v.Key, v.Value); - } - } - - Called from Python: - - KeywordArgFunction(a = 2, b = "abc") - - will print: - Key: a Value = 2 - Key: b Value = abc - - - - - Provides optimized and cacheable support for scope storage. - - This is the default object used for storing values in a scope. - - - - The implementation uses a case-insensitive dictionary which holds - onto ScopeVariableIgnoreCase objects. The SVIC's hold onto ScopeVariable - objects for each possible casing. - - - - - Gets the named value from the scope optionally ignoring case. - - If the named value is not present an InvalidOperationException is raised. - - - - - Attempts to get the named value from the scope optionally ignoring the case. - - Returns true if the value is present, false if it is not. - - - - - Sets the named value in the scope optionally ignoring the case. - - - - - Deletes the named value from the scope optionally ignoring the case. - - - - - Checks if the named value is present in the scope optionally ignoring the case. - - - - - Gets the IScopeVariable for the scope optionally ignoring case. - - The IScopeVariable can be held onto and get/set/deleted without performing - a dictionary lookup on subsequent accesses. - - - - - Gets the ScopeVariable for the scope in a case-sensitive manner. - - The ScopeVariable can be held onto and get/set/deleted without performing - a dictionary lookup on subsequent accesses. - - - - - Gets the ScopeVariableIgnoreCase for the scope in a case-insensitive manner. - - The ScopeVariable can be held onto and get/set/deleted without performing - a dictionary lookup on subsequent accesses. - - - - - Provides convenient case-sensitive value access. - - - - - Returns all of the member names which currently have values in the scope. - - The list contains all available casings. - - - - - Returns all of the member names and their associated values from the scope. - - The list contains all available casings. - - - - - Provides a common interface for accessing both case sensitive and - case insensitive variable storage. - - - - - True if the scope has a value, false if it does not. - - - - - Atempts to get the value. If a value is assigned it returns true otherwise - it returns false. - - - - - Sets the current value in the scope. - - - - - Removes the current value from the scope. - - - - - Boxes the value for storage in a scope. Languages or consumers of the scope - can save this value and use it to get/set the current value in the scope for - commonly accessed values. - - ScopeVariables are case sensitive and will only refer to a single value. - - - - - True if the scope has a value, false if it does not. - - - - - Atempts to get the value. If a value is assigned it returns true otherwise - it returns false. - - - - - Sets the current value in the scope. - - - - - Removes the current value from the scope. - - - - - Boxes the value for storage in a scope. Languages or consumers of the scope - can save this value and use it to get/set the current value in the scope for - commonly accessed values. - - ScopeVariablesIgnoreCase are case insensitive and may access different casings - depending on how other gets/sets occur in the scope. - - - - - True if the scope has a value, false if it does not. - - - - - Atempts to get the value. If a value is assigned it returns true otherwise - it returns false. - - - - - Sets the current value in the scope. - - - - - Removes the current value from the scope. - - - - - ScriptCode is an instance of compiled code that is bound to a specific LanguageContext - but not a specific ScriptScope. The code can be re-executed multiple times in different - scopes. Hosting API counterpart for this class is CompiledCode. - - - - - Provides a factory to create streams over one source of binary content. - - StreamContentProvider's are used when opening a file of an unknown encoding. The - StreamContentProvider will be wrapped in a TextContentProvider provided by the language - which can support a language specific way of interpreting the binary data into text. - - For example some languages allow a marker at the beginning of the file which specifies - the encoding of the rest of the file. - - - - - Creates a new Stream which is backed by the content the StreamContentProvider was created for. - - For example if the StreamContentProvider was backing a file then GetStream re-opens the file and returns - the new stream. - - This method may be called multiple times. For example once to compile the code and again to get - the source code to display error messages. - - - - - See also Microsoft.VisualStudio.Package.TokenTriggers. - - - - - Source code is a syntactically correct. - - - - - Source code represents an empty statement/expression. - - - - - Source code is already invalid and no suffix can make it syntactically correct. - - - - - Last token is incomplete. Source code can still be completed correctly. - - - - - Last statement is incomplete. Source code can still be completed correctly. - - - - - Defines a kind of the source code. The parser sets its initial state accordingly. - - - - - The code is an expression. - - - - - The code is a sequence of statements. - - - - - The code is a single statement. - - - - - The code is a content of a file. - - - - - The code is an interactive command. - - - - - The language parser auto-detects the kind. A syntax error is reported if it is not able to do so. - - - - - Converts a generic ICollection of T into an array of T. - - If the collection is already an array of T the original collection is returned. - - - - - Wraps the provided enumerable into a ReadOnlyCollection{T} - - Copies all of the data into a new array, so the data can't be - changed after creation. The exception is if the enumerable is - already a ReadOnlyCollection{T}, in which case we just return it. - - - - - Console input stream (Console.OpenStandardInput) has a bug that manifests itself if reading small amounts of data. - This class wraps the standard input stream with a buffer that ensures that enough data are read from the underlying stream. - - - - - Requires the range [offset, offset + count] to be a subset of [0, array.Count]. - - Offset or count are out of range. - - - - Requires the range [offset, offset + count] to be a subset of [0, array.Count]. - - Offset or count are out of range. - - - - Requires the array and all its items to be non-null. - - - - - Requires the enumerable collection and all its items to be non-null. - - - - - Requires the range [offset, offset + count] to be a subset of [0, array.Count]. - - Array is null. - Offset or count are out of range. - - - - Emits an object delegate(CallSite, object * paramCount, object) that's suitable for use in a non-strongly typed call site. - Use this helper only for delegates with more parameters than Func has. - - - - - Source code reader. - - - - - Gets the encoding that is used by the reader to convert binary data read from an underlying binary stream. - Null if the reader is reading from a textual source (not performing any byte to character transcoding). - - - - - Seeks the first character of a specified line in the text stream. - - Line number. The current position is assumed to be line #1. - - Returns true if the line is found, false otherwise. - - - - - Provides a StreamContentProvider for a stream of content backed by a file on disk. - - - - - Represents a location in source code. - - - - - Creates a new source location. - - The index in the source stream the location represents (0-based). - The line in the source stream the location represents (1-based). - The column in the source stream the location represents (1-based). - - - - The index in the source stream the location represents (0-based). - - - - - The line in the source stream the location represents (1-based). - - - - - The column in the source stream the location represents (1-based). - - - - - Compares two specified location values to see if they are equal. - - One location to compare. - The other location to compare. - True if the locations are the same, False otherwise. - - - - Compares two specified location values to see if they are not equal. - - One location to compare. - The other location to compare. - True if the locations are not the same, False otherwise. - - - - Compares two specified location values to see if one is before the other. - - One location to compare. - The other location to compare. - True if the first location is before the other location, False otherwise. - - - - Compares two specified location values to see if one is after the other. - - One location to compare. - The other location to compare. - True if the first location is after the other location, False otherwise. - - - - Compares two specified location values to see if one is before or the same as the other. - - One location to compare. - The other location to compare. - True if the first location is before or the same as the other location, False otherwise. - - - - Compares two specified location values to see if one is after or the same as the other. - - One location to compare. - The other location to compare. - True if the first location is after or the same as the other location, False otherwise. - - - - Compares two specified location values. - - One location to compare. - The other location to compare. - 0 if the locations are equal, -1 if the left one is less than the right one, 1 otherwise. - - - - A location that is valid but represents no location at all. - - - - - An invalid location. - - - - - A minimal valid location. - - - - - Whether the location is a valid location. - - True if the location is valid, False otherwise. - - - - Stores the location of a span of text in a source file. - - - - - Constructs a new span with a specific start and end location. - - The beginning of the span. - The end of the span. - - - - The start location of the span. - - - - - The end location of the span. Location of the first character behind the span. - - - - - Length of the span (number of characters inside the span). - - - - - A valid span that represents no location. - - - - - An invalid span. - - - - - Whether the locations in the span are valid. - - - - - Compares two specified Span values to see if they are equal. - - One span to compare. - The other span to compare. - True if the spans are the same, False otherwise. - - - - Compares two specified Span values to see if they are not equal. - - One span to compare. - The other span to compare. - True if the spans are not the same, False otherwise. - - - - Identification of the source unit. Assigned by the host. - The format and semantics is host dependent (could be a path on file system or URL). - Empty string for anonymous source units. - - - - - LanguageContext of the language of the unit. - - - - - Reads specified range of lines (or less) from the source unit. - Line numbers starts with 1. - - - - - Errors are reported to the specified sink. - Returns null if the parser cannot compile the code due to error(s). - - - - - Executes against a specified scope. - - - - - Executes against a specified scope and reports errors to the given error sink. - - - - - Executes in a new scope created by the language. - - - - - Executes in a new scope created by the language. - - - - - Executes in a new scope created by the language. - - - - - Unmapped span. - - - - - Provides a factory to create TextReader's over one source of textual content. - - TextContentProvider's are used when reading from a source which is already decoded - or has a known specific decoding. - - For example a text editor might provide a TextContentProvider whose backing is - an in-memory text buffer that the user can actively edit. - - - - - Creates a new TextReader which is backed by the content the TextContentProvider was created for. - - This method may be called multiple times. For example once to compile the code and again to get - the source code to display error messages. - - - - - A token marking an end of stream. - - - - - A space, tab, or newline. - - - - - A block comment. - - - - - A single line comment. - - - - - A documentation comment. - - - - - A numeric literal. - - - - - A character literal. - - - - - A string literal. - - - - - A regular expression literal. - - - - - A keyword. - - - - - A directive (e.g. #line). - - - - - A punctuation character that has a specific meaning in a language. - - - - - A token that operates as a separator between two language elements. - - - - - An identifier (variable, $variable, @variable, @@variable, $variable$, function!, function?, [variable], i'variable', ...) - - - - - Braces, parenthesis, brackets. - - - - - Errors. - - - - - Strongly-typed and parameterized string factory. - - - - - A string like "Cannot access member {1} declared on type {0} because the type contains generic parameters." - - - - - A string like "Type '{0}' is missing or cannot be loaded." - - - - - A string like "static property "{0}" of "{1}" can only be read through a type, not an instance" - - - - - A string like "static property "{0}" of "{1}" can only be assigned to through a type, not an instance" - - - - - A string like "Method precondition violated" - - - - - A string like "Invalid argument value" - - - - - A string like "Non-empty string required" - - - - - A string like "Non-empty collection required" - - - - - A string like "must by an Exception instance" - - - - - A string like "Type of test must be bool" - - - - - A string like "Type of the expression must be bool" - - - - - A string like "Empty string is not a valid path." - - - - - A string like "Invalid delegate type (Invoke method not found)." - - - - - A string like "expected only static property" - - - - - A string like "Property doesn't exist on the provided type" - - - - - A string like "Field doesn't exist on provided type" - - - - - A string like "Type doesn't have constructor with a given signature" - - - - - A string like "Type doesn't have a method with a given name." - - - - - A string like "Type doesn't have a method with a given name and signature." - - - - - A string like "Count must be non-negative." - - - - - A string like "arrayType must be an array type" - - - - - A string like "Either code or target must be specified." - - - - - A string like "Type parameter is {0}. Expected a delegate." - - - - - A string like "Cannot cast from type '{0}' to type '{1}" - - - - - A string like "unknown member type: '{0}'. " - - - - - A string like "RuleBuilder can only be used with delegates whose first argument is CallSite." - - - - - A string like "no instance for call." - - - - - A string like "Missing Test." - - - - - A string like "Missing Target." - - - - - A string like "The operation requires a non-generic type for {0}, but this represents generic types only" - - - - - A string like "Invalid operation: '{0}'" - - - - - A string like "Finally already defined." - - - - - A string like "Can not have fault and finally." - - - - - A string like "Fault already defined." - - - - - A string like "Cannot create default value for type {0}." - - - - - A string like "Unhandled convert: {0}" - - - - - A string like "{0}.{1} has no publiclly visible method." - - - - - A string like "Global/top-level local variable names must be unique." - - - - - A string like "Generating code from non-serializable CallSiteBinder." - - - - - A string like "Specified path is invalid." - - - - - A string like "Dictionaries are not hashable." - - - - - A string like "language already registered." - - - - - A string like "The method or operation is not implemented." - - - - - A string like "No exception." - - - - - A string like "Extension type {0} must be public." - - - - - A string like "Already initialized." - - - - - A string like "CreateScopeExtension must return a scope extension." - - - - - A string like "Invalid number of parameters for the service." - - - - - A string like "Invalid type of argument {0}; expecting {1}." - - - - - A string like "Cannot change non-caching value." - - - - - A string like "Field {0} is read-only" - - - - - A string like "Property {0} is read-only" - - - - - A string like "Expected event from {0}.{1}, got event from {2}.{3}." - - - - - A string like "expected bound event, got {0}." - - - - - A string like "Expected type {0}, got {1}." - - - - - A string like "can only write to member {0}." - - - - - A string like "No code to compile." - - - - - A string like "Invalid stream type: {0}." - - - - - A string like "Queue empty." - - - - - A string like "Enumeration has not started. Call MoveNext." - - - - - A string like "Enumeration already finished." - - - - - A string like "can't add another casing for identifier {0}" - - - - - A string like "can't add new identifier {0}" - - - - - A string like "Type '{0}' doesn't provide a suitable public constructor or its implementation is faulty: {1}" - - - - - A string like "Invalid output directory." - - - - - A string like "Invalid assembly name or file extension." - - - - - A string like "Cannot emit constant {0} ({1})" - - - - - A string like "No implicit cast from {0} to {1}" - - - - - A string like "No explicit cast from {0} to {1}" - - - - - A string like "name '{0}' not defined" - - - - - A string like "No default value for a given type." - - - - - A string like "Specified language provider type is not registered." - - - - - A string like "can't read from property" - - - - - A string like "can't write to property" - - - - - A string like "Cannot create instance of {0} because it contains generic parameters" - - - - - A string like "Non-verifiable assembly generated: {0}:\nAssembly preserved as {1}\nError text:\n{2}\n" - - - - - Strongly-typed and parameterized exception factory. - - - - - ArgumentException with message like "Either code or target must be specified." - - - - - InvalidOperationException with message like "Type parameter is {0}. Expected a delegate." - - - - - InvalidOperationException with message like "Cannot cast from type '{0}' to type '{1}" - - - - - InvalidOperationException with message like "unknown member type: '{0}'. " - - - - - InvalidOperationException with message like "RuleBuilder can only be used with delegates whose first argument is CallSite." - - - - - InvalidOperationException with message like "no instance for call." - - - - - InvalidOperationException with message like "Missing Test." - - - - - InvalidOperationException with message like "Missing Target." - - - - - TypeLoadException with message like "The operation requires a non-generic type for {0}, but this represents generic types only" - - - - - ArgumentException with message like "Invalid operation: '{0}'" - - - - - InvalidOperationException with message like "Finally already defined." - - - - - InvalidOperationException with message like "Can not have fault and finally." - - - - - InvalidOperationException with message like "Fault already defined." - - - - - ArgumentException with message like "Cannot create default value for type {0}." - - - - - ArgumentException with message like "Unhandled convert: {0}" - - - - - InvalidOperationException with message like "{0}.{1} has no publiclly visible method." - - - - - ArgumentException with message like "Global/top-level local variable names must be unique." - - - - - ArgumentException with message like "Generating code from non-serializable CallSiteBinder." - - - - - ArgumentException with message like "Specified path is invalid." - - - - - ArgumentTypeException with message like "Dictionaries are not hashable." - - - - - InvalidOperationException with message like "language already registered." - - - - - NotImplementedException with message like "The method or operation is not implemented." - - - - - InvalidOperationException with message like "No exception." - - - - - ArgumentException with message like "Extension type {0} must be public." - - - - - InvalidOperationException with message like "Already initialized." - - - - - InvalidImplementationException with message like "CreateScopeExtension must return a scope extension." - - - - - ArgumentException with message like "Invalid number of parameters for the service." - - - - - ArgumentException with message like "Invalid type of argument {0}; expecting {1}." - - - - - ArgumentException with message like "Cannot change non-caching value." - - - - - MissingMemberException with message like "Field {0} is read-only" - - - - - MissingMemberException with message like "Property {0} is read-only" - - - - - ArgumentException with message like "Expected event from {0}.{1}, got event from {2}.{3}." - - - - - ArgumentTypeException with message like "expected bound event, got {0}." - - - - - ArgumentTypeException with message like "Expected type {0}, got {1}." - - - - - MemberAccessException with message like "can only write to member {0}." - - - - - InvalidOperationException with message like "No code to compile." - - - - - ArgumentException with message like "Invalid stream type: {0}." - - - - - InvalidOperationException with message like "Queue empty." - - - - - InvalidOperationException with message like "Enumeration has not started. Call MoveNext." - - - - - InvalidOperationException with message like "Enumeration already finished." - - - - - InvalidOperationException with message like "can't add another casing for identifier {0}" - - - - - InvalidOperationException with message like "can't add new identifier {0}" - - - - - ArgumentException with message like "Invalid output directory." - - - - - ArgumentException with message like "Invalid assembly name or file extension." - - - - - ArgumentException with message like "Cannot emit constant {0} ({1})" - - - - - ArgumentException with message like "No implicit cast from {0} to {1}" - - - - - ArgumentException with message like "No explicit cast from {0} to {1}" - - - - - MissingMemberException with message like "name '{0}' not defined" - - - - - ArgumentException with message like "No default value for a given type." - - - - - ArgumentException with message like "Specified language provider type is not registered." - - - - - InvalidOperationException with message like "can't read from property" - - - - - InvalidOperationException with message like "can't write to property" - - - - - ArgumentException with message like "Cannot create instance of {0} because it contains generic parameters" - - - - - System.Security.VerificationException with message like "Non-verifiable assembly generated: {0}:\nAssembly preserved as {1}\nError text:\n{2}\n" - - - - diff --git a/mpv.net/MainForm.cs b/mpv.net/MainForm.cs index bfb7129..11b4533 100644 --- a/mpv.net/MainForm.cs +++ b/mpv.net/MainForm.cs @@ -30,7 +30,7 @@ namespace mpvnet SetFormPosSize(); Instance = this; Hwnd = Handle; - ChangeFullscreen((mpv.mpvConv.ContainsKey("fullscreen") && mpv.mpvConv["fullscreen"] == "yes") || (mpv.mpvConv.ContainsKey("fs") && mpv.mpvConv["fs"] == "yes")); + ChangeFullscreen((mp.mpvConv.ContainsKey("fullscreen") && mp.mpvConv["fullscreen"] == "yes") || (mp.mpvConv.ContainsKey("fs") && mp.mpvConv["fs"] == "yes")); CMS = new ContextMenuStripEx(components); CMS.Opened += CMS_Opened; ContextMenuStrip = CMS; @@ -44,15 +44,15 @@ namespace mpvnet public void BuildMenu() { - if (!File.Exists(mpv.InputConfPath)) + if (!File.Exists(mp.InputConfPath)) { - if (!Directory.Exists(mpv.mpvConfFolderPath)) - Directory.CreateDirectory(mpv.mpvConfFolderPath); + if (!Directory.Exists(mp.mpvConfFolderPath)) + Directory.CreateDirectory(mp.mpvConfFolderPath); - File.WriteAllText(mpv.InputConfPath, Properties.Resources.input_conf); + File.WriteAllText(mp.InputConfPath, Properties.Resources.input_conf); } - foreach (var i in File.ReadAllText(mpv.InputConfPath).SplitLinesNoEmpty()) + foreach (var i in File.ReadAllText(mp.InputConfPath).SplitLinesNoEmpty()) { if (!i.Contains("#menu:")) continue; @@ -73,7 +73,7 @@ namespace mpvnet var menuItem = CMS.Add(path, () => { try { - mpv.CommandString(cmd, false); + mp.CommandString(cmd, false); } catch (Exception e) { @@ -95,9 +95,9 @@ namespace mpvnet private void mpv_PlaybackRestart() { - var fn = mpv.GetStringProp("filename"); + var fn = mp.GetStringProp("filename"); BeginInvoke(new Action(() => { Text = fn + " - mpv.net " + Application.ProductVersion; })); - var fp = mpv.mpvConfFolderPath + "history.txt"; + var fp = mp.mpvConfFolderPath + "history.txt"; if (LastHistory != fn && File.Exists(fp)) { @@ -166,19 +166,19 @@ namespace mpvnet case 0x0100: // WM_KEYDOWN case 0x0101: // WM_KEYUP case 0x020A: // WM_MOUSEWHEEL - if (mpv.MpvWindowHandle != IntPtr.Zero) - Native.SendMessage(mpv.MpvWindowHandle, m.Msg, m.WParam, m.LParam); + if (mp.MpvWindowHandle != IntPtr.Zero) + Native.SendMessage(mp.MpvWindowHandle, m.Msg, m.WParam, m.LParam); break; case 0x203: // Native.WM.LBUTTONDBLCLK if (!IsMouseInOSC()) - mpv.CommandString("cycle fullscreen"); + mp.CommandString("cycle fullscreen"); break; case 0x0214: // WM_SIZING var rc = Marshal.PtrToStructure(m.LParam); var r = rc; NativeHelp.SubtractWindowBorders(Handle, ref r); int c_w = r.Right - r.Left, c_h = r.Bottom - r.Top; - float aspect = mpv.VideoSize.Width / (float)mpv.VideoSize.Height; + float aspect = mp.VideoSize.Width / (float)mp.VideoSize.Height; int d_w = (int)(c_h * aspect - c_w); int d_h = (int)(c_w / aspect - c_h); int[] d_corners = { d_w, d_h, -d_w, -d_h }; @@ -198,10 +198,10 @@ namespace mpvnet void SetFormPosSize() { - if (IsFullscreen || mpv.VideoSize.Width == 0) return; + if (IsFullscreen || mp.VideoSize.Width == 0) return; var wa = Screen.GetWorkingArea(this); int h = (int)(wa.Height * 0.6); - int w = (int)(h * mpv.VideoSize.Width / (float)mpv.VideoSize.Height); + int w = (int)(h * mp.VideoSize.Width / (float)mp.VideoSize.Height); Point middlePos = new Point(Left + Width / 2, Top + Height / 2); var r = new Native.RECT(new Rectangle(0, 0, w, h)); NativeHelp.AddWindowBorders(Handle, ref r); @@ -227,7 +227,7 @@ namespace mpvnet base.OnDragDrop(e); if (e.Data.GetDataPresent(DataFormats.FileDrop)) - mpv.LoadFiles(e.Data.GetData(DataFormats.FileDrop) as String[]); + mp.LoadFiles(e.Data.GetData(DataFormats.FileDrop) as String[]); } protected override void OnMouseDown(MouseEventArgs e) @@ -249,7 +249,7 @@ namespace mpvnet var p2 = PointToScreen(e.Location); if (Math.Abs(p1.X - p2.X) < 10 && Math.Abs(p1.Y - p2.Y) < 10) - mpv.Command("quit"); + mp.Command("quit"); } protected override void OnMouseMove(MouseEventArgs e) @@ -257,7 +257,7 @@ namespace mpvnet base.OnMouseMove(e); // send mouse command to make OSC show - mpv.CommandString($"mouse {e.X} {e.Y}"); + mp.CommandString($"mouse {e.X} {e.Y}"); if (CursorHelp.IsPosDifferent(LastCursorPosChanged)) CursorHelp.Show(); @@ -267,7 +267,7 @@ namespace mpvnet { base.OnFormClosed(e); IsCloseRequired = false; - mpv.Command("quit"); + mp.Command("quit"); } bool IsMouseInOSC() @@ -292,11 +292,11 @@ namespace mpvnet private void MainForm_Load(object sender, EventArgs ea) { - mpv.Init(); - mpv.ObserveBoolProp("fullscreen", MpvChangeFullscreen); - mpv.Shutdown += Mpv_AfterShutdown; - mpv.VideoSizeChanged += Mpv_VideoSizeChanged; - mpv.PlaybackRestart += mpv_PlaybackRestart; + mp.Init(); + mp.ObserveBoolProp("fullscreen", MpvChangeFullscreen); + mp.Shutdown += Mpv_AfterShutdown; + mp.VideoSizeChanged += Mpv_VideoSizeChanged; + mp.PlaybackRestart += mpv_PlaybackRestart; } } } \ No newline at end of file diff --git a/mpv.net/Misc.cs b/mpv.net/Misc.cs index 771eb1d..95e950f 100644 --- a/mpv.net/Misc.cs +++ b/mpv.net/Misc.cs @@ -1,14 +1,8 @@ -using System; -using System.Collections; +using System.Collections; using System.Collections.Generic; using System.Runtime.InteropServices; using System.Windows.Forms; -using IronPython.Hosting; -using Microsoft.Scripting.Hosting; - -using static mpvnet.StaticUsing; - namespace mpvnet { public class Misc @@ -49,28 +43,4 @@ namespace mpvnet return MessageBox.Show(message, Application.ProductName, MessageBoxButtons.OKCancel, MessageBoxIcon.Question); } } - - public class PyScript - { - ScriptEngine engine; - ScriptScope scope; - - public PyScript(string code) - { - try - { - engine = Python.CreateEngine(); - scope = engine.CreateScope(); - scope.ImportModule("clr"); - engine.Execute("import clr", scope); - engine.Execute("clr.AddReference(\"mpvnet\")", scope); - engine.Execute("from mpvnet import *", scope); - engine.Execute(code, scope); - } - catch (Exception ex) - { - MsgError(ex.ToString()); - } - } - } } \ No newline at end of file diff --git a/mpv.net/Properties/AssemblyInfo.cs b/mpv.net/Properties/AssemblyInfo.cs index c683297..641fc7b 100644 --- a/mpv.net/Properties/AssemblyInfo.cs +++ b/mpv.net/Properties/AssemblyInfo.cs @@ -32,5 +32,5 @@ using System.Runtime.InteropServices; // You can specify all the values or you can default the Build and Revision Numbers // by using the '*' as shown below: // [assembly: AssemblyVersion("1.0.*")] -[assembly: AssemblyVersion("1.0.0.0")] -[assembly: AssemblyFileVersion("1.0.0.0")] +[assembly: AssemblyVersion("1.1.0.0")] +[assembly: AssemblyFileVersion("1.1.0.0")] diff --git a/mpv.net/PyScript.cs b/mpv.net/PyScript.cs new file mode 100644 index 0000000..e746a1b --- /dev/null +++ b/mpv.net/PyScript.cs @@ -0,0 +1,33 @@ +using System; + +using IronPython.Hosting; +using Microsoft.Scripting.Hosting; + +using static mpvnet.StaticUsing; + +namespace mpvnet +{ + public class PyScript + { + ScriptEngine engine; + ScriptScope scope; + + public PyScript(string code) + { + try + { + engine = Python.CreateEngine(); + scope = engine.CreateScope(); + scope.ImportModule("clr"); + engine.Execute("import clr", scope); + engine.Execute("clr.AddReference(\"mpvnet\")", scope); + engine.Execute("from mpvnet import *", scope); + engine.Execute(code, scope); + } + catch (Exception ex) + { + MsgError(ex.ToString()); + } + } + } +} \ No newline at end of file diff --git a/mpv.net/libmpv.cs b/mpv.net/libmpv.cs index 82295c3..d133589 100644 --- a/mpv.net/libmpv.cs +++ b/mpv.net/libmpv.cs @@ -29,6 +29,9 @@ namespace mpvnet [DllImport("mpv-1.dll", CallingConvention = CallingConvention.Cdecl)] public static extern int mpv_get_property(IntPtr mpvHandle, byte[] name, mpv_format format, ref IntPtr data); + [DllImport("mpv-1.dll", CallingConvention = CallingConvention.Cdecl)] + public static extern int mpv_get_property(IntPtr mpvHandle, byte[] name, mpv_format format, ref double data); + [DllImport("mpv-1.dll", CallingConvention = CallingConvention.Cdecl)] public static extern int mpv_set_property(IntPtr mpvHandle, byte[] name, mpv_format format, ref byte[] data); @@ -102,7 +105,8 @@ namespace mpvnet MPV_EVENT_PLAYBACK_RESTART = 21, MPV_EVENT_PROPERTY_CHANGE = 22, MPV_EVENT_CHAPTER_CHANGE = 23, - MPV_EVENT_QUEUE_OVERFLOW = 24 + MPV_EVENT_QUEUE_OVERFLOW = 24, + MPV_EVENT_HOOK = 25 } public enum mpv_format @@ -168,7 +172,6 @@ namespace mpvnet [StructLayout(LayoutKind.Sequential)] public struct mpv_event_property { - [MarshalAs(UnmanagedType.LPUTF8Str)] public string name; public mpv_format format; public IntPtr data; diff --git a/mpv.net/mpv.cs b/mpv.net/mp.cs similarity index 69% rename from mpv.net/mpv.cs rename to mpv.net/mp.cs index 26d4534..fafa086 100644 --- a/mpv.net/mpv.cs +++ b/mpv.net/mp.cs @@ -4,6 +4,7 @@ using System.Diagnostics; using System.Drawing; using System.IO; using System.Linq; +using System.Reflection; using System.Runtime.InteropServices; using System.Text; using System.Threading.Tasks; @@ -13,36 +14,43 @@ using static mpvnet.libmpv; using static mpvnet.Native; using static mpvnet.StaticUsing; +using PyRT = IronPython.Runtime; + namespace mpvnet { public delegate void MpvBoolPropChangeHandler(string propName, bool value); - public class mpv + public class mp { - public static event Action Shutdown; - public static event Action LogMessage; - public static event Action GetPropertyReply; - public static event Action ClientMessage; - public static event Action PlaybackRestart; public static event Action VideoSizeChanged; - public static event Action EndFile; - public static event Action SetPropertyReply; - public static event Action CommandReply; - public static event Action StartFile; - public static event Action FileLoaded; - public static event Action TracksChanged; - public static event Action TrackSwitched; - public static event Action Idle; - public static event Action Pause; - public static event Action Unpause; - public static event Action Tick; - public static event Action ScriptInputDispatch; - public static event Action VideoReconfig; - public static event Action AudioReconfig; - public static event Action MetadataUpdate; - public static event Action Seek; - public static event Action ChapterChange; - public static event Action QueueOverflow; + // Lua/JS evens libmpv events + + // MPV_EVENT_NONE + public static event Action Shutdown; // shutdown MPV_EVENT_SHUTDOWN + public static event Action LogMessage; // log-message MPV_EVENT_LOG_MESSAGE + public static event Action GetPropertyReply; // get-property-reply MPV_EVENT_GET_PROPERTY_REPLY + public static event Action SetPropertyReply; // set-property-reply MPV_EVENT_SET_PROPERTY_REPLY + public static event Action CommandReply; // command-reply MPV_EVENT_COMMAND_REPLY + public static event Action StartFile; // start-file MPV_EVENT_START_FILE + public static event Action EndFile; // end-file MPV_EVENT_END_FILE + public static event Action FileLoaded; // file-loaded MPV_EVENT_FILE_LOADED + public static event Action TracksChanged; // MPV_EVENT_TRACKS_CHANGED + public static event Action TrackSwitched; // MPV_EVENT_TRACK_SWITCHED + public static event Action Idle; // idle MPV_EVENT_IDLE + public static event Action Pause; // MPV_EVENT_PAUSE + public static event Action Unpause; // MPV_EVENT_UNPAUSE + public static event Action Tick; // tick MPV_EVENT_TICK + public static event Action ScriptInputDispatch; // MPV_EVENT_SCRIPT_INPUT_DISPATCH + public static event Action ClientMessage; // client-message MPV_EVENT_CLIENT_MESSAGE + public static event Action VideoReconfig; // video-reconfig MPV_EVENT_VIDEO_RECONFIG + public static event Action AudioReconfig; // audio-reconfig MPV_EVENT_AUDIO_RECONFIG + public static event Action MetadataUpdate; // MPV_EVENT_METADATA_UPDATE + public static event Action Seek; // seek MPV_EVENT_SEEK + public static event Action PlaybackRestart; // playback-restart MPV_EVENT_PLAYBACK_RESTART + // MPV_EVENT_PROPERTY_CHANGE + public static event Action ChapterChange; // MPV_EVENT_CHAPTER_CHANGE + public static event Action QueueOverflow; // MPV_EVENT_QUEUE_OVERFLOW + public static event Action Hook; // MPV_EVENT_HOOK public static IntPtr MpvHandle; public static IntPtr MpvWindowHandle; @@ -104,24 +112,19 @@ namespace mpvnet public static void LoadScripts() { - string[] extensions = { ".lua", ".js" }; - string[] scripts = Directory.GetFiles(Application.StartupPath + "\\Scripts"); + string[] jsLua = { ".lua", ".js" }; + string[] startupScripts = Directory.GetFiles(Application.StartupPath + "\\Scripts"); - foreach (var scriptPath in scripts) - { - string ext = Path.GetExtension(scriptPath); + foreach (var scriptPath in startupScripts) + if (jsLua.Contains(Path.GetExtension(scriptPath).ToLower())) + mp.Command("load-script", $"{scriptPath}"); - if (extensions.Contains(ext.ToLower())) - mpv.Command("load-script", $"{scriptPath}"); - } - - foreach (var scriptPath in scripts) - { - string ext = Path.GetExtension(scriptPath); - - if (ext == ".py") + foreach (var scriptPath in startupScripts) + if (Path.GetExtension(scriptPath) == ".py") PyScripts.Add(new PyScript(File.ReadAllText(scriptPath))); - } + + foreach(var scriptPath in Directory.GetFiles(mp.mpvConfFolderPath + "scripts", "*.py")) + PyScripts.Add(new PyScript(File.ReadAllText(scriptPath))); } public static void EventLoop() @@ -240,10 +243,83 @@ namespace mpvnet case mpv_event_id.MPV_EVENT_QUEUE_OVERFLOW: QueueOverflow?.Invoke(); break; + case mpv_event_id.MPV_EVENT_HOOK: + Hook?.Invoke(); + break; } } } + public class EventObject + { + public PyRT.PythonFunction PythonFunction { get; set; } + public EventInfo EventInfo { get; set; } + public Delegate Delegate { get; set; } + + public void Invoke() + { + PyRT.Operations.PythonCalls.Call(PythonFunction); + } + + public void InvokeEndFileEventMode(EndFileEventMode arg) + { + PyRT.Operations.PythonCalls.Call(PythonFunction, new[] { arg }); + } + + public void InvokeStrings(string[] arg) + { + PyRT.Operations.PythonCalls.Call(PythonFunction, new[] { arg }); + } + } + + private static List EventObjects = new List(); + + public static void register_event(string name, PyRT.PythonFunction pyFunc) + { + foreach (var eventInfo in typeof(mp).GetEvents()) + { + if (eventInfo.Name.ToLower() == name.Replace("-", "")) + { + EventObject eventObject = new EventObject(); + EventObjects.Add(eventObject); + eventObject.PythonFunction = pyFunc; + MethodInfo mi; + + if (eventInfo.EventHandlerType == typeof(Action)) + { + mi = eventObject.GetType().GetMethod(nameof(EventObject.Invoke)); + } + else if (eventInfo.EventHandlerType == typeof(Action)) + { + mi = eventObject.GetType().GetMethod(nameof(EventObject.InvokeEndFileEventMode)); + } + else if (eventInfo.EventHandlerType == typeof(Action)) + { + mi = eventObject.GetType().GetMethod(nameof(EventObject.InvokeStrings)); + } + else + throw new Exception(); + + eventObject.EventInfo = eventInfo; + Delegate handler = Delegate.CreateDelegate(eventInfo.EventHandlerType, eventObject, mi); + eventObject.Delegate = handler; + eventInfo.AddEventHandler(eventObject, handler); + } + } + } + + public static void unregister_event(PyRT.PythonFunction pyFunc) + { + foreach (var eventObjects in EventObjects) + if (eventObjects.PythonFunction == pyFunc) + eventObjects.EventInfo.RemoveEventHandler(eventObjects, eventObjects.Delegate); + } + + public static void commandv(params string[] args) + { + Command(args); + } + public static void Command(params string[] args) { if (MpvHandle == IntPtr.Zero) @@ -307,6 +383,22 @@ namespace mpvnet return lpBuffer.ToInt32(); } + public static double get_property_number(string name) + { + return GetDoubleProp(name); + } + + public static double GetDoubleProp(string name, bool throwException = true) + { + double val = 0; + int err = mpv_get_property(MpvHandle, GetUtf8Bytes(name), mpv_format.MPV_FORMAT_DOUBLE, ref val); + + if (err < 0 && throwException) + throw new Exception($"{name}: {(mpv_error)err}"); + else + return val; + } + public static void SetIntProp(string name, int value) { Int64 val = value; @@ -344,9 +436,9 @@ namespace mpvnet foreach (string i in args) if (!i.StartsWith("--") && File.Exists(i)) - mpv.Command("loadfile", i, "append"); + mp.Command("loadfile", i, "append"); - mpv.SetStringProp("playlist-pos", "0", false); + mp.SetStringProp("playlist-pos", "0", false); foreach (string i in args) { @@ -356,27 +448,27 @@ namespace mpvnet { string left = i.Substring(2, i.IndexOf("=") - 2); string right = i.Substring(left.Length + 3); - mpv.SetStringProp(left, right); + mp.SetStringProp(left, right); } else - mpv.SetStringProp(i.Substring(2), "yes"); + mp.SetStringProp(i.Substring(2), "yes"); } } } public static void LoadFiles(string[] files) { - int count = mpv.GetIntProp("playlist-count"); + int count = mp.GetIntProp("playlist-count"); foreach (string file in files) - mpv.Command("loadfile", file, "append"); + mp.Command("loadfile", file, "append"); - mpv.SetIntProp("playlist-pos", count); + mp.SetIntProp("playlist-pos", count); for (int i = 0; i < count; i++) - mpv.Command("playlist-remove", "0"); + mp.Command("playlist-remove", "0"); - mpv.LoadFolder(); + mp.LoadFolder(); } private static bool WasFolderLoaded; diff --git a/mpv.net/mpv.net.csproj b/mpv.net/mpv.net.csproj index 47a4234..e9a8ea1 100644 --- a/mpv.net/mpv.net.csproj +++ b/mpv.net/mpv.net.csproj @@ -132,6 +132,7 @@ Component + @@ -141,7 +142,7 @@ MainForm.cs - + diff --git a/release.ps1 b/release.ps1 index 372e247..6ce9e92 100644 --- a/release.ps1 +++ b/release.ps1 @@ -9,4 +9,4 @@ $addonDir = $targetDir + "\Addons" Remove-Item $addonDir -Recurse -Include *mpvnet.exe, *mpvnet.exe.config, *mpvnet.pdb $7zPath = "C:\Program Files\7-Zip\7z.exe" $args = "a -t7z -mx9 $targetDir.7z -r $targetDir\*" -Start-Process -FilePath $7zPath -ArgumentList $args \ No newline at end of file +#Start-Process -FilePath $7zPath -ArgumentList $args \ No newline at end of file