C# 脚本运行环境CS-script

C# Script execution engine; ----------------------------------------------------------------------------------------- The MIT License (MIT) Copyright (c) 2014 Oleg Shilo Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. ----------------------------------------------------------------------------------------- Contact: csscript.support@gmail.com ----------------------------------------------------------------------------------------- Installation: Precondition: .NET runtime must be installed. You can download it from here or from other well known locations: http://www.microsoft.com/download/en/details.aspx?id=17851 Despite the fact that you can select earlier versions of .NET as a target .NET Framework version 4.5 is required for CS-Script to function properly. To install: 1. extract content of the cs-script.zip on your HD 2. run css_config.exe or install.cmd (it will bring the configuration console) 3. adjust the CS-Script settings in the configuration console according your needs (e.g. enabled debuggers, shell extensions...) To uininstall: 1. run css_config.exe 2. press 'Deactivate' button on the 'General' tab in the configuration console OR 1. run unistall.cmd To upgrade: No special steps are required. Just do as for normal installation according instructions above. NOTE: - After running css_config.exe from some third-party file navigation utilities (e.g. Total Commander) it might be required to restart this utility in order for changes to take effect. ----------------------------------------------------------------------------------------- Installing on "Windows 7 family" OS If during the installation you have "System.IO.FileNotFoundException: Could not load file or assembly 'CSScriptLibrary" error this can be due to the new Win& security measures. You may want to "Unblock" all CS-Script files you downloaded. This can be done either manually or with Sysinternals Streams.exe utility: http://www.rogoff.uk.com/blog/post/How-to-bulk-unblock-files-in-Windows-7-or-Server-2008.aspx ----------------------------------------------------------------------------------------- Running: Script engine can be run in two different modes: as a console application (cscs.exe) and as a WinExe application (csws.exe). C# Script execution engine. Version 3.8.13.0. Copyright (C) 2004-2014 Oleg Shilo. Usage: cscs.exe <switch 1> <switch 2> <file> [params] [//x] <switch 1> /? - Display help info. /e - Compile script into console application executable. /ew - Compile script into Windows application executable. /c - Use compiled file (cache file .compiled) if found (to improve performance). /ca - Compile script file into assembly (cache file .compiled) without execution. /cd - Compile script file into assembly (.dll) without execution. /co:<options> - Pass compiler options directly to the language compiler (e.g. /co:/d:TRACE pass /d:TRACE option to C# compiler or /co:/platform:x86 to produce Win32 executable) /s - Print content of sample script file (e.g. cscs.exe /s > sample.cs). /ac | /autoclass - Automatically generates wrapper class if the script does not define any class of its own: using System; void Main() { Console.WriteLine("Hello World!"); } <switch 2> /nl - No logo mode: No banner will be shown/printed at execution time. /dbg | /d - Force compiler to include debug information. /l - 'local'(makes the script directory a 'current directory') /v - Prints CS-Script version information /verbose - prints runtime information during the script execution (applicable for console clients only) /noconfig[:<file>] - Do not use default CS-Script config file or use alternative one. Value "out" of the <file> is reserved for creating the config file (css_config.xml) with the default settings. (e.g. cscs.exe /noconfig sample.cs cscs.exe /noconfig:c:\cs-script\css_VB.dat sample.vb) /sconfig[:<file>] - Use script config file or custom config file as a .NET application configuration file. This option might be useful for running scripts, which usually cannot be executed without configuration file (e.g. WCF, Remoting). (e.g. if /sconfig is used the expected config file name is <script_name>.cs.config or <script_name>.exe.config if /sconfig:myApp.config is used the expected config file name is myApp.config) /r:<assembly 1>:<assembly N> - Use explicitly referenced assembly. It is required only for rare cases when namespace cannot be resolved into assembly. (e.g. cscs.exe /r:myLib.dll myScript.cs). /dir:<directory 1>,<directory N> - Add path(s) to the assembly probing directory list. (e.g. cscs.exe /dir:C:\MyLibraries myScript.cs). /co:<options> - Passes compiler options directy to the language compiler. (e.g. /co:/d:TRACE pass /d:TRACE option to C# compiler). /precompiler[:<file 1>,<file N>] - specifies custom precompiler file(s). This can be either script or assembly file. If no file(s) specified prints the code template for the custom precompiler. There is a special reserved word 'nodefault' to be used as a file name. It instructs script engine to prevent loading any built-in precompilers like the one for removing shebang before the execution. (see Precompilers chapter in the documentation) file - Specifies name of a script file to be run. params - Specifies optional parameters for a script file to be run. //x - Launch debugger just before starting the script. ************************************** Script specific syntax ************************************** Engine directives: ------------------------------------ //css_import <file>[, preserve_main][, rename_namespace(<oldName>, <newName>)]; Alias - //css_imp There are also another two aliases //css_include and //css_inc. They are equivalents of //css_import <file>, preserve_main If $this (or $this.name) is specified as part of <file> it will be replaced at execution time with the main script full name (or file name only). file - name of a script file to be imported at compile-time. <preserve_main> - do not rename 'static Main' oldName - name of a namespace to be renamed during importing newName - new name of a namespace to be renamed during importing This directive is used to inject one script into another at compile time. Thus code from one script can be exercised in another one. 'Rename' clause can appear in the directive multiple times. ------------------------------------ //css_nuget [-noref] package0[,package1]..[,packageN]; Downloads/Installs the NuGet package. It also