Initial support for Cassette MSBuild compile-time bundle generation.

Author: Daniel15

.gitignore

@@ -4,6 +4,7 @@ src/SharedAssemblyVersionInfo.cs
 src/**/*.nuspec
 !src/template.nuspec
 site/jekyll/_site
+src/React.Sample.Cassette/cassette-cache
 
 ## Ignore Visual Studio temporary files, build results, and
 ## files generated by popular Visual Studio add-ons.

src/Cassette.React/AssemblyRegistration.cs

@@ -0,0 +1,43 @@
+/*
+ *  Copyright (c) 2014, Facebook, Inc.
+ *  All rights reserved.
+ *
+ *  This source code is licensed under the BSD-style license found in the
+ *  LICENSE file in the root directory of this source tree. An additional grant 
+ *  of patent rights can be found in the PATENTS file in the same directory.
+ */
+
+using React;
+using React.TinyIoC;
+
+namespace Cassette.React
+{
+	/// <summary>
+	/// Handles registration of ReactJS.NET components that are only applicable
+	/// to Cassette when used in MSBuild.
+	/// </summary>
+	public class AssemblyRegistration : IAssemblyRegistration
+	{
+		/// <summary>
+		/// Registers components in the React IoC container
+		/// </summary>
+		/// <param name="container">Container to register components in</param>
+		public void Register(TinyIoCContainer container)
+		{
+			if (MSBuildUtils.IsInMSBuild())
+			{
+				RegisterForMSBuild(container);
+			}
+		}
+
+		/// <summary>
+		/// Registers components specific to the MSBuild environment in the React IoC container.
+		/// </summary>
+		/// <param name="container">Container to register components in</param>
+		private void RegisterForMSBuild(TinyIoCContainer container)
+		{
+			container.Register<ICache, NullCache>();
+			container.Register<IFileSystem, SimpleFileSystem>();
+		}
+	}
+}

src/Cassette.React/Cassette.React.csproj

@@ -56,11 +56,15 @@
     <Compile Include="..\SharedAssemblyVersionInfo.cs">
       <Link>Properties\SharedAssemblyVersionInfo.cs</Link>
     </Compile>
+    <Compile Include="AssemblyRegistration.cs" />
+    <Compile Include="CassetteMSBuildStartup.cs" />
     <Compile Include="InsertIntoPipelineJsxBundleProcessor.cs" />
     <Compile Include="JsxBundleProcessor.cs" />
     <Compile Include="JsxCompiler.cs" />
     <Compile Include="JsxFileSearchModifier.cs" />
+    <Compile Include="MSBuildUtils.cs" />
     <Compile Include="Properties\AssemblyInfo.cs" />
+    <Compile Include="ReactContainerConfiguration.cs" />
   </ItemGroup>
   <ItemGroup>
     <None Include="Cassette.React.nutrans" />

src/Cassette.React/CassetteMSBuildStartup.cs

@@ -0,0 +1,41 @@
+/*
+ *  Copyright (c) 2014, Facebook, Inc.
+ *  All rights reserved.
+ *
+ *  This source code is licensed under the BSD-style license found in the
+ *  LICENSE file in the root directory of this source tree. An additional grant 
+ *  of patent rights can be found in the PATENTS file in the same directory.
+ */
+
+using System;
+using System.Diagnostics;
+using React;
+
+namespace Cassette.React
+{
+	/// <summary>
+	/// Cassette has two modes of operating - Web (ASP.NET) and MSBuild. IoC registration for web
+	/// is already covered by React.Web. For the MSBuild mode, we need to initialise ReactJS.NET's
+	/// IoC container here.
+	/// </summary>
+	public class CassetteMSBuildStartup : IStartUpTask
+	{
+		/// <summary>
+		/// Handles initialisation of ReactJS.NET in Cassette. Only relevant when running in an
+		/// MSBuild context.
+		/// </summary>
+		public void Start()
+		{
+			if (!MSBuildUtils.IsInMSBuild())
+			{
+				return;
+			}
+
+			// All "per-request" registrations should be singletons in MSBuild, since there's no
+			// such thing as a "request"
+			// TODO: Should these be per-task instead, once non-Cassette MSBuild support
+			// is introduced?
+			Initializer.Initialize(requestLifetimeRegistration: registration => registration.AsSingleton());
+		}
+	}
+}

src/Cassette.React/JsxBundleProcessor.cs

@@ -10,6 +10,7 @@
 using System;
 using Cassette.BundleProcessing;
 using Cassette.Scripts;
+using React;
 
 namespace Cassette.React
 {
@@ -20,14 +21,17 @@ namespace Cassette.React
 	public class JsxBundleProcessor : IBundleProcessor<ScriptBundle>
 	{
 		private readonly CassetteSettings _settings;
+		private readonly IReactEnvironment _environment;
 
 		/// <summary>
 		/// Initializes a new instance of the <see cref="JsxBundleProcessor"/> class.
 		/// </summary>
 		/// <param name="settings">Cassette settings.</param>
-		public JsxBundleProcessor(CassetteSettings settings)
+		/// <param name="environment">The ReactJS.NET environment</param>
+		public JsxBundleProcessor(CassetteSettings settings, IReactEnvironment environment)
 		{
 			_settings = settings;
+			_environment = environment;
 		}
 
 		/// <summary>
@@ -41,7 +45,7 @@ public void Process(ScriptBundle bundle)
 				if (asset.Path.EndsWith(".jsx", StringComparison.InvariantCultureIgnoreCase))
 				{
 					asset.AddAssetTransformer(
-						new CompileAsset(new JsxCompiler(), _settings.SourceDirectory)
+						new CompileAsset(new JsxCompiler(_environment), _settings.SourceDirectory)
 					);
 				}
 			}

src/Cassette.React/JsxCompiler.cs

@@ -17,6 +17,17 @@ namespace Cassette.React
 	/// </summary>
 	public class JsxCompiler : ICompiler
 	{
+		private readonly IReactEnvironment _environment;
+
+		/// <summary>
+		/// Initializes a new instance of the <see cref="JsxCompiler"/> class.
+		/// </summary>
+		/// <param name="environment">The ReactJS.NET environment</param>
+		public JsxCompiler(IReactEnvironment environment)
+		{
+			_environment = environment;
+		}
+
 		/// <summary>
 		/// Compiles the specified JSX file into JavaScript
 		/// </summary>
@@ -25,8 +36,7 @@ public class JsxCompiler : ICompiler
 		/// <returns>JavaScript</returns>
 		public CompileResult Compile(string source, CompileContext context)
 		{
-			var environment = AssemblyRegistration.Container.Resolve<IReactEnvironment>();
-			var output = environment.TransformJsx(source);
+			var output = _environment.TransformJsx(source);
 			return new CompileResult(output, Enumerable.Empty<string>());
 		}
 	}

src/Cassette.React/MSBuildUtils.cs

@@ -0,0 +1,36 @@
+/*
+ *  Copyright (c) 2014, Facebook, Inc.
+ *  All rights reserved.
+ *
+ *  This source code is licensed under the BSD-style license found in the
+ *  LICENSE file in the root directory of this source tree. An additional grant 
+ *  of patent rights can be found in the PATENTS file in the same directory.
+ */
+
+using System;
+using System.Diagnostics;
+
+namespace Cassette.React
+{
+	/// <summary>
+	/// Utility methods for interacting with Cassette in a MSBuild environment.
+	/// </summary>
+	public static class MSBuildUtils
+	{
+		/// <summary>
+		/// Determines if the current process is MSBuild
+		/// </summary>
+		/// <returns><c>true</c> if we are currently in MSBuild</returns>
+		public static bool IsInMSBuild()
+		{
+			try
+			{
+				return Process.GetCurrentProcess().ProcessName.StartsWith("MSBuild");
+			}
+			catch (Exception)
+			{
+				return false;
+			}
+		}
+	}
+}

src/Cassette.React/ReactContainerConfiguration.cs

@@ -0,0 +1,43 @@
+/*
+ *  Copyright (c) 2014, Facebook, Inc.
+ *  All rights reserved.
+ *
+ *  This source code is licensed under the BSD-style license found in the
+ *  LICENSE file in the root directory of this source tree. An additional grant 
+ *  of patent rights can be found in the PATENTS file in the same directory.
+ */
+
+using CassetteTinyIoCContainer = Cassette.TinyIoC.TinyIoCContainer;
+using ReactTinyIoCContainer = React.TinyIoC.TinyIoCContainer;
+using React;
+
+namespace Cassette.React
+{
+	/// <summary>
+	/// Cassette IoC configuration for ReactJS.NET
+	/// </summary>
+	public class ReactContainerConfiguration : IConfiguration<CassetteTinyIoCContainer>
+	{
+		/// <summary>
+		/// Configures the specified Cassette IoC container.
+		/// </summary>
+		/// <param name="container">The IoC container.</param>
+		public void Configure(CassetteTinyIoCContainer container)
+		{
+			// Register ReactJS.NET's IoC container inside Cassette's.
+			container.Register<ReactTinyIoCContainer>(global::React.AssemblyRegistration.Container);
+			RegisterPassthru<IReactEnvironment>(container);
+		}
+
+		/// <summary>
+		/// Registers a component in Cassette's IoC container that just delegates resolution to 
+		/// ReactJS.NET's IoC container.
+		/// </summary>
+		/// <typeparam name="T">Type to register</typeparam>
+		/// <param name="container">Cassette's IoC container</param>
+		private void RegisterPassthru<T>(CassetteTinyIoCContainer container) where T : class
+		{
+			container.Register<T>((c, overloads) => global::React.AssemblyRegistration.Container.Resolve<T>());
+		}
+	}
+}

src/React.Sample.Cassette/Cassette.targets

@@ -0,0 +1,22 @@
+<?xml version="1.0" encoding="utf-8" ?>
+<!--
+    The web application csproj file has been modified to execute the Bundle target.
+    So after a build, the Cassette bundles will be saved into a cache directory.
+-->
+<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">    
+    <UsingTask AssemblyFile="$(OutputPath)\Cassette.MSBuild.dll" TaskName="CreateBundles"/>
+    <Target Name="Bundle">
+        <CreateBundles />
+        <!--
+        CreateBundles has the following optional properties:
+            Source: The root directory of the web application.
+            Bin:    The directory containing the web application assemblies. Default is "bin".
+            Output: The directory to save the created bundles to. Default is "cassette-cache".
+            AppVirtualPath: The web application's virtual path. Default is "/".
+            IncludeOtherFiles: When true, non-bundled files such as images referenced by stylesheets are also copied to the output directory. Default is false.
+            
+        The Web.config must also have the following section:
+            <cassette cacheDirectory="cassette-cache" />
+        -->
+    </Target>
+</Project>

src/React.Sample.Cassette/React.Sample.Cassette.csproj

@@ -49,6 +49,9 @@
     <Reference Include="Cassette.Aspnet">
       <HintPath>..\packages\Cassette.Aspnet.2.4.1\lib\net40\Cassette.Aspnet.dll</HintPath>
     </Reference>
+    <Reference Include="Cassette.MSBuild">
+      <HintPath>..\packages\Cassette.MSBuild.2.4.1\lib\net40\Cassette.MSBuild.dll</HintPath>
+    </Reference>
     <Reference Include="Cassette.Views">
       <HintPath>..\packages\Cassette.Views.2.4.1\lib\net40\Cassette.Views.dll</HintPath>
     </Reference>
@@ -177,6 +180,9 @@
   <ItemGroup>
     <Content Include="Content\Sample.jsx" />
   </ItemGroup>
+  <ItemGroup>
+    <Content Include="Cassette.targets" />
+  </ItemGroup>
   <PropertyGroup>
     <VisualStudioVersion Condition="'$(VisualStudioVersion)' == ''">10.0</VisualStudioVersion>
     <VSToolsPath Condition="'$(VSToolsPath)' == ''">$(MSBuildExtensionsPath32)\Microsoft\VisualStudio\v$(VisualStudioVersion)</VSToolsPath>
@@ -205,6 +211,9 @@
       </FlavorProperties>
     </VisualStudio>
   </ProjectExtensions>
+	<Target Name="Bundle" AfterTargets="Build">
+		<Exec Command="&quot;$(msbuildtoolspath)\msbuild.exe&quot; $(ProjectDirectory)cassette.targets /p:OutputPath=$(OutputPath) /t:Bundle /nr:false" />
+	</Target>
   <!-- To modify your build process, add your task inside one of the targets below and uncomment it. 
        Other similar extension points exist, see Microsoft.Common.targets.
   <Target Name="BeforeBuild">