├── .gitattributes
├── .gitignore
├── .paket
├── paket.bootstrapper.exe
└── paket.targets
├── .travis.yml
├── CONTRIBUTING.md
├── LICENSE.md
├── README.md
├── appveyor.yml
├── build.cmd
├── build.fsx
├── build.sh
├── buildConfig.fsx
├── doc
├── Caching.fsx
├── DevelopReadme.md
├── IntroExamples.fsx
├── ReleaseNotes.md
├── content
│ ├── img
│ │ ├── back_to_top.png
│ │ ├── github-blue.png
│ │ ├── github.png
│ │ ├── logo-template.pdn
│ │ └── logo.png
│ ├── prism.css
│ ├── prism.js
│ ├── style.css
│ └── tips.js
└── templates
│ ├── docpage-index.cshtml
│ ├── docpage.cshtml
│ ├── reference
│ ├── module.cshtml
│ ├── namespaces.cshtml
│ ├── part-members.cshtml
│ ├── part-nested.cshtml
│ └── type.cshtml
│ ├── template-color.tex
│ ├── template-math.tex
│ └── template.cshtml
├── generateDocs.fsx
├── lib
└── README.md
├── nuget
└── Yaaf.FSharp.Scripting.nuspec
├── packages
└── Yaaf.AdvancedBuilding
│ └── content
│ ├── build.cmd
│ ├── build.sh
│ ├── build.targets
│ ├── buildConfigDef.fsx
│ ├── buildInclude.fsx
│ ├── downloadNugetInclude.fsx
│ └── generateDocsInclude.fsx
├── paket.dependencies
├── paket.lock
└── src
├── .gitignore
├── SharedAssemblyInfo.fs
├── Yaaf.FSharp.Scripting.sln
├── nuget.config
├── source
└── Yaaf.FSharp.Scripting
│ ├── AssemblyInfo.fs
│ ├── Script.fsx
│ ├── Yaaf.FSharp.Scripting.fsproj
│ ├── YaafFSharpScripting.fs
│ ├── app.config
│ └── paket.references
└── test
└── Test.Yaaf.FSharp.Scripting
├── App.config
├── ExtensionMethodTests.fs
├── FsiArgsTest.fs
├── FsiSessionTests.fs
├── Test.Yaaf.FSharp.Scripting.fsproj
├── UnquoteFix.fs
└── paket.references
/.gitattributes:
--------------------------------------------------------------------------------
1 | # Auto detect text files
2 | * text=auto
3 |
4 | # Custom for Visual Studio
5 | *.cs diff=csharp text=auto eol=lf
6 | *.fs diff=csharp text=auto eol=lf
7 | *.fsi diff=csharp text=auto eol=lf
8 | *.fsx diff=csharp text=auto eol=lf
9 | *.sln text eol=crlf merge=union
10 | *.csproj merge=union
11 | *.vbproj merge=union
12 | *.fsproj merge=union
13 | *.dbproj merge=union
14 |
15 | # Standard to msysgit
16 | *.doc diff=astextplain
17 | *.DOC diff=astextplain
18 | *.docx diff=astextplain
19 | *.DOCX diff=astextplain
20 | *.dot diff=astextplain
21 | *.DOT diff=astextplain
22 | *.pdf diff=astextplain
23 | *.PDF diff=astextplain
24 | *.rtf diff=astextplain
25 | *.RTF diff=astextplain
26 |
--------------------------------------------------------------------------------
/.gitignore:
--------------------------------------------------------------------------------
1 | ## Ignore Visual Studio temporary files, build results, and
2 | ## files generated by popular Visual Studio add-ons.
3 |
4 | # User-specific files
5 | *.suo
6 | *.user
7 | *.sln.docstates
8 |
9 | # Xamarin Studio / monodevelop user-specific
10 | *.userprefs
11 |
12 | # Build results
13 |
14 | [Dd]ebug/
15 | [Rr]elease/
16 | x64/
17 | build/
18 | [Bb]in/
19 | [Oo]bj/
20 |
21 | # Enable "build/" folder in the NuGet Packages folder since NuGet packages use it for MSBuild targets
22 | !packages/*/build/
23 |
24 | # MSTest test Results
25 | [Tt]est[Rr]esult*/
26 | [Bb]uild[Ll]og.*
27 |
28 | *_i.c
29 | *_p.c
30 | *.ilk
31 | *.meta
32 | *.obj
33 | *.pch
34 | *.pdb
35 | *.mdb
36 | *.pgc
37 | *.pgd
38 | *.rsp
39 | *.sbr
40 | *.tlb
41 | *.tli
42 | *.tlh
43 | *.tmp
44 | *.tmp_proj
45 | *.log
46 | *.svclog
47 | *.vspscc
48 | *.vssscc
49 | .builds
50 | *.pidb
51 | *.log
52 | *.scc
53 | XmlWriter
54 |
55 | # Visual C++ cache files
56 | ipch/
57 | *.aps
58 | *.ncb
59 | *.opensdf
60 | *.sdf
61 | *.cachefile
62 |
63 | # Visual Studio profiler
64 | *.psess
65 | *.vsp
66 | *.vspx
67 |
68 | # Guidance Automation Toolkit
69 | *.gpState
70 |
71 | # ReSharper is a .NET coding add-in
72 | _ReSharper*/
73 | *.[Rr]e[Ss]harper
74 |
75 | # TeamCity is a build add-in
76 | _TeamCity*
77 |
78 | # DotCover is a Code Coverage Tool
79 | *.dotCover
80 |
81 | # NCrunch
82 | *.ncrunch*
83 | .*crunch*.local.xml
84 |
85 | # Installshield output folder
86 | [Ee]xpress/
87 |
88 | # DocProject is a documentation generator add-in
89 | DocProject/buildhelp/
90 | DocProject/Help/*.HxT
91 | DocProject/Help/*.HxC
92 | DocProject/Help/*.hhc
93 | DocProject/Help/*.hhk
94 | DocProject/Help/*.hhp
95 | DocProject/Help/Html2
96 | DocProject/Help/html
97 |
98 | # Click-Once directory
99 | publish/
100 |
101 | # Publish Web Output
102 | *.Publish.xml
103 |
104 | # Enable nuget.exe in the .nuget folder (though normally executables are not tracked)
105 | !.nuget/NuGet.exe
106 |
107 | # Windows Azure Build Output
108 | csx
109 | *.build.csdef
110 |
111 | # Windows Store app package directory
112 | AppPackages/
113 |
114 | # Others
115 | sql/
116 | *.Cache
117 | ClientBin/
118 | [Ss]tyle[Cc]op.*
119 | ~$*
120 | *~
121 | *.dbmdl
122 | *.[Pp]ublish.xml
123 | *.pfx
124 | *.publishsettings
125 |
126 | # RIA/Silverlight projects
127 | Generated_Code/
128 |
129 | # Backup & report files from converting an old project file to a newer
130 | # Visual Studio version. Backup files are not needed, because we have git ;-)
131 | _UpgradeReport_Files/
132 | Backup*/
133 | UpgradeLog*.XML
134 | UpgradeLog*.htm
135 |
136 | # SQL Server files
137 | App_Data/*.mdf
138 | App_Data/*.ldf
139 |
140 |
141 | #LightSwitch generated files
142 | GeneratedArtifacts/
143 | _Pvt_Extensions/
144 | ModelManifest.xml
145 |
146 | # =========================
147 | # Windows detritus
148 | # =========================
149 |
150 | # Windows image file caches
151 | Thumbs.db
152 | ehthumbs.db
153 |
154 | # Folder config file
155 | Desktop.ini
156 |
157 | # Recycle Bin used on file shares
158 | $RECYCLE.BIN/
159 |
160 | # Mac desktop service store files
161 | .DS_Store
162 |
163 | # ===================================================
164 | # Exclude F# project specific directories and files
165 | # ===================================================
166 |
167 | .fake/*
168 |
169 | # NuGet Packages Directory
170 | packages/*
171 | !packages/Yaaf.AdvancedBuilding
172 | packages/Yaaf.AdvancedBuilding/*
173 | !packages/Yaaf.AdvancedBuilding/content
174 |
175 | gh-pages/
176 |
177 | # Generated documentation folder
178 | docs/output/
179 |
180 | # Temp folder used for publishing docs
181 | temp/
182 | # Where binaries get build into
183 | build/
184 | # Where test binaries get build into
185 | /test/
186 |
187 | # Test results produced by build
188 | TestResults.xml
189 |
190 | # Nuget outputs
191 | *.nuspec
192 | !nuget/*.nuspec
193 | nuget/*.nupkg
194 |
195 |
196 | release.cmd
197 | release.sh
198 | localpackages/
199 | paket-files
200 | *.orig
201 | .paket/paket.exe
202 | docs/content/license.md
203 | docs/content/release-notes.md
204 |
205 |
--------------------------------------------------------------------------------
/.paket/paket.bootstrapper.exe:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/matthid/Yaaf.FSharp.Scripting/f99c04bde0d3cd071475b023acf61fef6b8e8da1/.paket/paket.bootstrapper.exe
--------------------------------------------------------------------------------
/.paket/paket.targets:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 | true
6 |
7 | true
8 | $(MSBuildThisFileDirectory)
9 | $(MSBuildThisFileDirectory)..\
10 |
11 |
12 |
13 | $(PaketToolsPath)paket.exe
14 | $(PaketToolsPath)paket.bootstrapper.exe
15 | "$(PaketExePath)"
16 | mono --runtime=v4.0.30319 $(PaketExePath)
17 | "$(PaketBootStrapperExePath)"
18 | mono --runtime=v4.0.30319 $(PaketBootStrapperExePath)
19 |
20 | $(PaketCommand) restore
21 | $(PaketBootStrapperCommand)
22 |
23 | RestorePackages; $(BuildDependsOn);
24 |
25 |
26 |
27 |
28 |
29 |
30 |
31 |
32 |
33 |
34 |
35 |
36 |
--------------------------------------------------------------------------------
/.travis.yml:
--------------------------------------------------------------------------------
1 | language: csharp
2 |
3 | sudo: false # use the new container-based Travis infrastructure
4 |
5 | script:
6 | - ./build.sh All
7 |
8 | notifications:
9 | webhooks:
10 | urls:
11 | - https://webhooks.gitter.im/e/a43d3bdbdee36cd658ea
12 | on_success: change # options: [always|never|change] default: always
13 | on_failure: always # options: [always|never|change] default: always
14 | on_start: false # default: false
--------------------------------------------------------------------------------
/CONTRIBUTING.md:
--------------------------------------------------------------------------------
1 | # Yaaf.FSharp.Scripting
2 |
3 | ## Contributing (Code)
4 |
5 | Just fork the project an send a pull request to discuss and merge the changes.
6 | Please send the pull request against the `develop` branch as the master branch is used for merging releases.
7 | See http://nvie.com/posts/a-successful-git-branching-model/ for details.
8 |
9 | ## Contributing (Documentation)
10 |
11 | The documentation is generated from the repository so you can help improving the documentation by editing the files in the `/doc` folder.
12 | You can even edit a page directly on github by clicking the edit button ([for example this page](https://github.com/matthid/Yaaf.FSharp.Scripting/blob/develop/CONTRIBUTING.md)).
13 | See also https://help.github.com/articles/editing-files-in-your-repository/
14 | (don't forget to send a pull request back after forking and changing something).
15 |
16 | ## Licensing
17 |
18 | This project is subject to the terms and conditions defined in file ['LICENSE.md'](https://github.com/matthid/Yaaf.FSharp.Scripting/blob/develop/LICENSE.md), which is part of this source code package.
19 |
20 | You can find licenses of the programs this project depends on in either the "lib/$Project" folder or on their nuget page.
--------------------------------------------------------------------------------
/LICENSE.md:
--------------------------------------------------------------------------------
1 | Apache License
2 | ==============
3 |
4 | _Version 2.0, January 2004_
5 | _<>_
6 |
7 | ### Terms and Conditions for use, reproduction, and distribution
8 |
9 | #### 1. Definitions
10 |
11 | “License” shall mean the terms and conditions for use, reproduction, and
12 | distribution as defined by Sections 1 through 9 of this document.
13 |
14 | “Licensor” shall mean the copyright owner or entity authorized by the copyright
15 | owner that is granting the License.
16 |
17 | “Legal Entity” shall mean the union of the acting entity and all other entities
18 | that control, are controlled by, or are under common control with that entity.
19 | For the purposes of this definition, “control” means **(i)** the power, direct or
20 | indirect, to cause the direction or management of such entity, whether by
21 | contract or otherwise, or **(ii)** ownership of fifty percent (50%) or more of the
22 | outstanding shares, or **(iii)** beneficial ownership of such entity.
23 |
24 | “You” (or “Your”) shall mean an individual or Legal Entity exercising
25 | permissions granted by this License.
26 |
27 | “Source” form shall mean the preferred form for making modifications, including
28 | but not limited to software source code, documentation source, and configuration
29 | files.
30 |
31 | “Object” form shall mean any form resulting from mechanical transformation or
32 | translation of a Source form, including but not limited to compiled object code,
33 | generated documentation, and conversions to other media types.
34 |
35 | “Work” shall mean the work of authorship, whether in Source or Object form, made
36 | available under the License, as indicated by a copyright notice that is included
37 | in or attached to the work (an example is provided in the Appendix below).
38 |
39 | “Derivative Works” shall mean any work, whether in Source or Object form, that
40 | is based on (or derived from) the Work and for which the editorial revisions,
41 | annotations, elaborations, or other modifications represent, as a whole, an
42 | original work of authorship. For the purposes of this License, Derivative Works
43 | shall not include works that remain separable from, or merely link (or bind by
44 | name) to the interfaces of, the Work and Derivative Works thereof.
45 |
46 | “Contribution” shall mean any work of authorship, including the original version
47 | of the Work and any modifications or additions to that Work or Derivative Works
48 | thereof, that is intentionally submitted to Licensor for inclusion in the Work
49 | by the copyright owner or by an individual or Legal Entity authorized to submit
50 | on behalf of the copyright owner. For the purposes of this definition,
51 | “submitted” means any form of electronic, verbal, or written communication sent
52 | to the Licensor or its representatives, including but not limited to
53 | communication on electronic mailing lists, source code control systems, and
54 | issue tracking systems that are managed by, or on behalf of, the Licensor for
55 | the purpose of discussing and improving the Work, but excluding communication
56 | that is conspicuously marked or otherwise designated in writing by the copyright
57 | owner as “Not a Contribution.”
58 |
59 | “Contributor” shall mean Licensor and any individual or Legal Entity on behalf
60 | of whom a Contribution has been received by Licensor and subsequently
61 | incorporated within the Work.
62 |
63 | #### 2. Grant of Copyright License
64 |
65 | Subject to the terms and conditions of this License, each Contributor hereby
66 | grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free,
67 | irrevocable copyright license to reproduce, prepare Derivative Works of,
68 | publicly display, publicly perform, sublicense, and distribute the Work and such
69 | Derivative Works in Source or Object form.
70 |
71 | #### 3. Grant of Patent License
72 |
73 | Subject to the terms and conditions of this License, each Contributor hereby
74 | grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free,
75 | irrevocable (except as stated in this section) patent license to make, have
76 | made, use, offer to sell, sell, import, and otherwise transfer the Work, where
77 | such license applies only to those patent claims licensable by such Contributor
78 | that are necessarily infringed by their Contribution(s) alone or by combination
79 | of their Contribution(s) with the Work to which such Contribution(s) was
80 | submitted. If You institute patent litigation against any entity (including a
81 | cross-claim or counterclaim in a lawsuit) alleging that the Work or a
82 | Contribution incorporated within the Work constitutes direct or contributory
83 | patent infringement, then any patent licenses granted to You under this License
84 | for that Work shall terminate as of the date such litigation is filed.
85 |
86 | #### 4. Redistribution
87 |
88 | You may reproduce and distribute copies of the Work or Derivative Works thereof
89 | in any medium, with or without modifications, and in Source or Object form,
90 | provided that You meet the following conditions:
91 |
92 | * **(a)** You must give any other recipients of the Work or Derivative Works a copy of
93 | this License; and
94 | * **(b)** You must cause any modified files to carry prominent notices stating that You
95 | changed the files; and
96 | * **(c)** You must retain, in the Source form of any Derivative Works that You distribute,
97 | all copyright, patent, trademark, and attribution notices from the Source form
98 | of the Work, excluding those notices that do not pertain to any part of the
99 | Derivative Works; and
100 | * **(d)** If the Work includes a “NOTICE” text file as part of its distribution, then any
101 | Derivative Works that You distribute must include a readable copy of the
102 | attribution notices contained within such NOTICE file, excluding those notices
103 | that do not pertain to any part of the Derivative Works, in at least one of the
104 | following places: within a NOTICE text file distributed as part of the
105 | Derivative Works; within the Source form or documentation, if provided along
106 | with the Derivative Works; or, within a display generated by the Derivative
107 | Works, if and wherever such third-party notices normally appear. The contents of
108 | the NOTICE file are for informational purposes only and do not modify the
109 | License. You may add Your own attribution notices within Derivative Works that
110 | You distribute, alongside or as an addendum to the NOTICE text from the Work,
111 | provided that such additional attribution notices cannot be construed as
112 | modifying the License.
113 |
114 | You may add Your own copyright statement to Your modifications and may provide
115 | additional or different license terms and conditions for use, reproduction, or
116 | distribution of Your modifications, or for any such Derivative Works as a whole,
117 | provided Your use, reproduction, and distribution of the Work otherwise complies
118 | with the conditions stated in this License.
119 |
120 | #### 5. Submission of Contributions
121 |
122 | Unless You explicitly state otherwise, any Contribution intentionally submitted
123 | for inclusion in the Work by You to the Licensor shall be under the terms and
124 | conditions of this License, without any additional terms or conditions.
125 | Notwithstanding the above, nothing herein shall supersede or modify the terms of
126 | any separate license agreement you may have executed with Licensor regarding
127 | such Contributions.
128 |
129 | #### 6. Trademarks
130 |
131 | This License does not grant permission to use the trade names, trademarks,
132 | service marks, or product names of the Licensor, except as required for
133 | reasonable and customary use in describing the origin of the Work and
134 | reproducing the content of the NOTICE file.
135 |
136 | #### 7. Disclaimer of Warranty
137 |
138 | Unless required by applicable law or agreed to in writing, Licensor provides the
139 | Work (and each Contributor provides its Contributions) on an “AS IS” BASIS,
140 | WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied,
141 | including, without limitation, any warranties or conditions of TITLE,
142 | NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE. You are
143 | solely responsible for determining the appropriateness of using or
144 | redistributing the Work and assume any risks associated with Your exercise of
145 | permissions under this License.
146 |
147 | #### 8. Limitation of Liability
148 |
149 | In no event and under no legal theory, whether in tort (including negligence),
150 | contract, or otherwise, unless required by applicable law (such as deliberate
151 | and grossly negligent acts) or agreed to in writing, shall any Contributor be
152 | liable to You for damages, including any direct, indirect, special, incidental,
153 | or consequential damages of any character arising as a result of this License or
154 | out of the use or inability to use the Work (including but not limited to
155 | damages for loss of goodwill, work stoppage, computer failure or malfunction, or
156 | any and all other commercial damages or losses), even if such Contributor has
157 | been advised of the possibility of such damages.
158 |
159 | #### 9. Accepting Warranty or Additional Liability
160 |
161 | While redistributing the Work or Derivative Works thereof, You may choose to
162 | offer, and charge a fee for, acceptance of support, warranty, indemnity, or
163 | other liability obligations and/or rights consistent with this License. However,
164 | in accepting such obligations, You may act only on Your own behalf and on Your
165 | sole responsibility, not on behalf of any other Contributor, and only if You
166 | agree to indemnify, defend, and hold each Contributor harmless for any liability
167 | incurred by, or claims asserted against, such Contributor by reason of your
168 | accepting any such warranty or additional liability.
169 |
170 | _END OF TERMS AND CONDITIONS_
171 |
--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
1 | # Yaaf.FSharp.Scripting
2 |
3 | ## [Documentation](https://matthid.github.io/Yaaf.FSharp.Scripting/)
4 |
5 | [](https://gitter.im/matthid/Yaaf?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
6 |
7 | ## Build status
8 |
9 | **Development Branch**
10 |
11 | [](https://travis-ci.org/matthid/Yaaf.FSharp.Scripting)
12 | [](https://ci.appveyor.com/project/matthid/yaaf-fsharp/branch/develop)
13 |
14 | **Master Branch**
15 |
16 | [](https://travis-ci.org/matthid/Yaaf.FSharp.Scripting)
17 | [](https://ci.appveyor.com/project/matthid/yaaf-fsharp/branch/master)
18 |
19 | ## NuGet
20 |
21 |
31 |
32 | ## Include as source file
33 |
34 | ### Paket
35 |
36 | You can include the functionality directly into your application by using paket source files:
37 |
38 | `paket.dependencies`:
39 |
40 | ```
41 | github matthid/Yaaf.FSharp.Scripting src/source/Yaaf.FSharp.Scripting/YaafFSharpScripting.fs
42 | ```
43 |
44 | `paket.references`:
45 |
46 | ```
47 | File: YaafFSharpScripting.fs
48 | ```
49 |
50 | See http://fsprojects.github.io/Paket/github-dependencies.html for details.
51 |
52 |
53 | ### NuGet
54 |
55 | The `YaafFSharpScripting.fs` source code file is included in the nuget package as well.
56 | You can find it in `content/YaafFSharpScripting.fs`.
57 | By adding the source code file (as reference) to your project you don't need
58 | to add a nuget dependency (`Yaaf.FSharp.Scripting`) to your final package.
59 |
60 | ## Quick intro
61 |
62 | This library tries to improve the scripting capabilities of FSharp.
63 |
64 | It builds on top of FSharp.Compiler.Service but provides a nice an clean API:
65 |
66 | ```fsharp
67 | open Yaaf.FSharp.Scripting
68 | use fsiSession = ScriptHost.CreateNew()
69 | fsiSession.Reference (@"C:\MyAssembly.dll")
70 | fsiSession.Open ("MyAssembly")
71 |
72 | // hook 25 into the session with name test (ie "let test = 25")
73 | // this works with any object
74 | fsiSession.Let "test" 25
75 |
76 | // Get a value out of the evaluator
77 | let v = fsiSession.EvalExpression "test"
78 | assert (v = 25)
79 |
80 | // Try to get a value (with handling error cases)
81 | match fsiSession.Handle fsiSession.EvalExpression "test" with
82 | | InvalidExpressionType e ->
83 | // not of type int
84 | // e.Value contains the result object, e.ExpectedType the expected type (int in this case)
85 | ()
86 | | InvalidCode e ->
87 | // couldn't get app value (compiler error, not defined or exception in the running code)
88 | // e.Input is the given text, e.Result is the compiler or the script output
89 | // Note: script exceptions are written as strings within e.Result
90 | ()
91 | | Result r ->
92 | // r is the value.
93 | ()
94 |
95 | // Get the output of the snippet
96 | let v = fsiSession.EvalInteractionWithOutput """printf "test" """
97 | assert (v.Output.ScriptOutput = "test")
98 |
99 | // Get the error message of the compilation
100 | try fsiSession.EvalInteraction """ Some_Invalid_F# """
101 | with :? FsiEvaluationException ev ->
102 | printfn "FSI said: %s" ev.Result.Error.FsiOutput
103 | printfn "Complete Error: %O" ev
104 |
105 | // Load scripts
106 | fsiSession.EvalScript "Script.fsx"
107 |
108 | ```
109 |
110 | The library also provides some nice members which are missing in FSharp.Compiler.Service:
111 |
112 | ```fsharp
113 | open Yaaf.FSharp.Scripting
114 | open FSharp.Compiler.SourceCodeServices
115 |
116 | // A Assembly -> FSharpEntity mapping (extension) function
117 | let fsAssembly = FSharpAssembly.FromAssembly typeof.Assembly
118 |
119 | // A extension method to find the entity type
120 | let fsType = fsAssembly.Value.FindType typeof
121 | ```
122 |
123 | And some extensions for System.Type to get the FSharp type name
124 |
125 | ```fsharp
126 | // with concrete types.
127 | let def = typeof