source 'https://rubygems.org'

gem 'github-pages'

remote: https://rubygems.org/

specs:

RedCloth (4.2.9)

activesupport (4.2.0)

i18n (~> 0.7)

json (~> 1.7, >= 1.7.7)

minitest (~> 5.1)

thread_safe (~> 0.3, >= 0.3.4)

tzinfo (~> 1.1)

blankslate (2.1.2.4)

celluloid (0.16.0)

timers (~> 4.0.0)

classifier-reborn (2.0.3)

fast-stemmer (~> 1.0)

coffee-script (2.3.0)

coffee-script-source

execjs

coffee-script-source (1.8.0)

colorator (0.1)

execjs (2.2.2)

fast-stemmer (1.0.2)

ffi (1.9.6-x64-mingw32)

gemoji (2.1.0)

github-pages (32)

RedCloth (= 4.2.9)

github-pages-health-check (~> 0.2)

jekyll (= 2.4.0)

jekyll-coffeescript (= 1.0.1)

jekyll-mentions (= 0.2.1)

jekyll-redirect-from (= 0.6.2)

jekyll-sass-converter (= 1.2.0)

jekyll-sitemap (= 0.6.3)

jemoji (= 0.4.0)

kramdown (= 1.5.0)

liquid (= 2.6.1)

maruku (= 0.7.0)

mercenary (~> 0.3)

pygments.rb (= 0.6.0)

rdiscount (= 2.1.7)

redcarpet (= 3.1.2)

terminal-table (~> 1.4)

github-pages-health-check (0.2.1)

net-dns (~> 0.6)

public_suffix (~> 1.4)

hitimes (1.2.2)

html-pipeline (1.9.0)

activesupport (>= 2)

nokogiri (~> 1.4)

i18n (0.7.0)

jekyll (2.4.0)

classifier-reborn (~> 2.0)

colorator (~> 0.1)

jekyll-coffeescript (~> 1.0)

jekyll-gist (~> 1.0)

jekyll-paginate (~> 1.0)

jekyll-sass-converter (~> 1.0)

jekyll-watch (~> 1.1)

kramdown (~> 1.3)

liquid (~> 2.6.1)

mercenary (~> 0.3.3)

pygments.rb (~> 0.6.0)

redcarpet (~> 3.1)

safe_yaml (~> 1.0)

toml (~> 0.1.0)

jekyll-coffeescript (1.0.1)

coffee-script (~> 2.2)

jekyll-gist (1.1.0)

jekyll-mentions (0.2.1)

html-pipeline (~> 1.9.0)

jekyll (~> 2.0)

jekyll-paginate (1.1.0)

jekyll-redirect-from (0.6.2)

jekyll (~> 2.0)

jekyll-sass-converter (1.2.0)

sass (~> 3.2)

jekyll-sitemap (0.6.3)

jekyll-watch (1.2.1)

listen (~> 2.7)

jemoji (0.4.0)

gemoji (~> 2.0)

html-pipeline (~> 1.9)

jekyll (~> 2.0)

json (1.8.2)

kramdown (1.5.0)

liquid (2.6.1)

listen (2.8.5)

celluloid (>= 0.15.2)

rb-fsevent (>= 0.9.3)

rb-inotify (>= 0.9)

maruku (0.7.0)

mercenary (0.3.5)

mini_portile (0.6.2)

minitest (5.5.1)

net-dns (0.8.0)

nokogiri (1.6.6.2-x64-mingw32)

mini_portile (~> 0.6.0)

parslet (1.5.0)

blankslate (~> 2.0)

posix-spawn (0.3.9)

public_suffix (1.4.6)

pygments.rb (0.6.0)

posix-spawn (~> 0.3.6)

yajl-ruby (~> 1.1.0)

rb-fsevent (0.9.4)

rb-inotify (0.9.5)

ffi (>= 0.5.0)

rdiscount (2.1.7)

redcarpet (3.1.2)

safe_yaml (1.0.4)

sass (3.4.10)

terminal-table (1.4.5)

thread_safe (0.3.4)

timers (4.0.1)

hitimes

toml (0.1.2)

parslet (~> 1.5.0)

tzinfo (1.2.2)

thread_safe (~> 0.1)

yajl-ruby (1.1.0)

x64-mingw32

github-pages

highlighter: pygments

<h1><img src="/images/logo_230.png" alt="{{ page.title }}" /> {% if page.tagline %} <small>{{ page.tagline }}</small>{% endif %}</h1>

layout: post

title: "A new file system"

tagline: "Playing better with .NET solutions."

category: Releases

tags: [changes]

{% include JB/setup %}

With scriptcs version 0.13 we decided to make some changes to help scriptcs run more smoothly together with existing .NET solutions. A problem which existed until now was the occasional inability to run scriptcs from within the folder of a regular .NET solution due to problematic assemblies in `packages` or `bin` folders. These would be assemblies which were not installed in order to be used from scriptcs, but rather from the .NET solution, and cause errors or warnings when running scriptcs. In particular, developers and users of build systems based on scriptcs, e.g. [PVC](http://pvcbuild.com/) and [Bau](https://github.com/bau-build/bau), were often tripped up by this.

The problem occured because, until now, the file system conventions used by regular .NET and scriptcs overlapped. They both used `packages.config`, `packages/` and `nuget.config` for NuGet package management and scriptcs searched `bin/` for binaries, a folder often used for other purposes in a .NET solution.

Starting with version 0.13, we've changed our conventions to isolate our file system artifacts from interference with a regular .NET solution.

<pre>

.cache -> .scriptcs_cache

bin/ -> scriptcs_bin/

packages/ -> scriptcs_packages/

nuget.config -> scriptcs_nuget.config

packages.config -> scriptcs_packages.config

</pre>

When you run scriptcs 0.13, it will detect 'legacy' file system artifacts (those shared with regular .NET) and automatically migrate them. To ensure anything outside scriptcs keeps functioning (e.g. an existing .NET solution), the existing artifacts are left in place, and copies are made instead. The only artifact which is renamed is `.cache` (to `.scriptcs_cache`) since this was never shared with regular .NET, but has still had it's named change for consistency.

E.g. if your folder looked like this *before* running scriptcs 0.13 (you may not have all of these artifacts):

<img src="/images/2015-02-02-before.png" />

you will see this output when running scriptcs 0.13:

<img src="/images/2015-02-02-during.png" />

and you your folder will end up looking like this:

<img src="/images/2015-02-02-after.png" />

If you don't need the original artifacts, feel free to delete them. It would be very difficult to automatically detect, with certainty, whether or not they're required so we thought we'd leave it to you to decide.

Another nice effect of this changed is a potential increase in performance. When scriptcs starts up, it scans `bin/` and `packages/` for modules and script packs. Previously, a large .NET solution may have many assemblies in these folders, not required for script execution, and this would result in a performance hit. With the new file system conventions, only those assemblies needed for script execution are scanned and that should speed things up in many cases.

If you are hosting scriptcs in your own application and you want to perform automatic migration, you will need to call `scriptServices.FileSystemMigrator.Migrate()` at an appropriate place in your application.

Our hope is that these changes will smooth out any friction you may have running scriptcs in environments shared with regular .NET solutions and projects. In the majority of cases, the upgrade to scriptcs 0.13 should be seamless. Migration to the new conventions is automatic and the only burden left on you is to remove any unwanted 'legacy' artifacts. If you do have any problems, please don't hesitate to let us know by [raising an issue](https://github.com/scriptcs/scriptcs/issues).

By the way, the file system changes are not the only changes in scriptcs version 0.13. For full details of what is contained in this release, please see the [release notes](https://github.com/scriptcs/scriptcs/releases/tag/v0.13).