first commit

Author: lastunicorn

.gitignore

@@ -0,0 +1,37 @@
+# RequestR - Getting Started
+
+## 1) Create the Request and Request Handler classes
+
+The request can be any C# class.
+
+```csharp
+internal class PresentProductsRequest
+{
+}
+```
+
+The request handler must implement the `IRequestHandler` interface.
+
+```csharp
+internal class PresentProductsRequestHandler : IRequestHandler<PresentProductsRequest, List<Product>>
+{
+    public List<Product> Handle(PresentProductsRequest request)
+    {
+        // Return the list of products.
+    }
+}
+```
+
+## 2) Create the Request Bus and register the Request Handler
+
+```csharp
+RequestBus requestBus = new RequestBus();
+requestBus.RegisterHandler<PresentProductsRequestHandler>();
+```
+
+## 3) Send a new Request
+
+```csharp
+PresentProductsRequest request = new PresentProductsRequest();
+List<Product> products = requestBus.Send<PresentProductsRequest, List<Product>>(request);
+```

LICENSE

@@ -0,0 +1,63 @@
+###############################################################################
+# Set default behavior to automatically normalize line endings.
+###############################################################################
+* text=auto
+
+###############################################################################
+# Set default behavior for command prompt diff.
+#
+# This is need for earlier builds of msysgit that does not have it on by
+# default for csharp files.
+# Note: This is only used by command line
+###############################################################################
+#*.cs     diff=csharp
+
+###############################################################################
+# Set the merge driver for project and solution files
+#
+# Merging from the command prompt will add diff markers to the files if there
+# are conflicts (Merging from VS is not affected by the settings below, in VS
+# the diff markers are never inserted). Diff markers may cause the following 
+# file extensions to fail to load in VS. An alternative would be to treat
+# these files as binary and thus will always conflict and require user
+# intervention with every merge. To do so, just uncomment the entries below
+###############################################################################
+#*.sln       merge=binary
+#*.csproj    merge=binary
+#*.vbproj    merge=binary
+#*.vcxproj   merge=binary
+#*.vcproj    merge=binary
+#*.dbproj    merge=binary
+#*.fsproj    merge=binary
+#*.lsproj    merge=binary
+#*.wixproj   merge=binary
+#*.modelproj merge=binary
+#*.sqlproj   merge=binary
+#*.wwaproj   merge=binary
+
+###############################################################################
+# behavior for image files
+#
+# image files are treated as binary by default.
+###############################################################################
+#*.jpg   binary
+#*.png   binary
+#*.gif   binary
+
+###############################################################################
+# diff behavior for common document formats
+# 
+# Convert binary document formats to text before diffing them. This feature
+# is only available from the command line. Turn it on by uncommenting the 
+# entries below.
+###############################################################################
+#*.doc   diff=astextplain
+#*.DOC   diff=astextplain
+#*.docx  diff=astextplain
+#*.DOCX  diff=astextplain
+#*.dot   diff=astextplain
+#*.DOT   diff=astextplain
+#*.pdf   diff=astextplain
+#*.PDF   diff=astextplain
+#*.rtf   diff=astextplain
+#*.RTF   diff=astextplain

readme.md

@@ -0,0 +1,5 @@
+.vs/
+bin/
+obj/
+*.suo
+*.user

sources/.gitattributes

@@ -0,0 +1,22 @@
+// RequestR
+// Copyright (C) 2021 Dust in the Wind
+// 
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+// 
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+// GNU General Public License for more details.
+// 
+// You should have received a copy of the GNU General Public License
+// along with this program.  If not, see <http://www.gnu.org/licenses/>.
+
+namespace DustInTheWind.RequestR.Demo
+{
+    internal class PresentProductsRequest
+    {
+    }
+}

sources/.gitignore

@@ -0,0 +1,28 @@
+// RequestR
+// Copyright (C) 2021 Dust in the Wind
+// 
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+// 
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+// GNU General Public License for more details.
+// 
+// You should have received a copy of the GNU General Public License
+// along with this program.  If not, see <http://www.gnu.org/licenses/>.
+
+using System.Collections.Generic;
+
+namespace DustInTheWind.RequestR.Demo
+{
+    internal class PresentProductsRequestHandler : IRequestHandler<PresentProductsRequest, List<Product>>
+    {
+        public List<Product> Handle(PresentProductsRequest request)
+        {
+            return new List<Product>();
+        }
+    }
+}

sources/RequestR.Demo/PresentProductsRequest.cs

@@ -0,0 +1,27 @@
+// RequestR
+// Copyright (C) 2021 Dust in the Wind
+// 
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+// 
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+// GNU General Public License for more details.
+// 
+// You should have received a copy of the GNU General Public License
+// along with this program.  If not, see <http://www.gnu.org/licenses/>.
+
+namespace DustInTheWind.RequestR.Demo
+{
+    internal class Product
+    {
+        public string Name { get; set; }
+
+        public uint Quantity { get; set; }
+
+        public decimal Price { get; set; }
+    }
+}

sources/RequestR.Demo/PresentProductsRequestHandler.cs

@@ -0,0 +1,44 @@
+// RequestR
+// Copyright (C) 2021 Dust in the Wind
+// 
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+// 
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+// GNU General Public License for more details.
+// 
+// You should have received a copy of the GNU General Public License
+// along with this program.  If not, see <http://www.gnu.org/licenses/>.
+
+using System;
+using System.Collections.Generic;
+
+namespace DustInTheWind.RequestR.Demo
+{
+    internal class Program
+    {
+        private static void Main(string[] args)
+        {
+            // Setup request bus
+            RequestBus requestBus = new RequestBus();
+            requestBus.RegisterHandler<PresentProductsRequestHandler>();
+
+            // Send request
+            PresentProductsRequest request = new PresentProductsRequest();
+            List<Product> products = requestBus.Send<PresentProductsRequest, List<Product>>(request);
+
+            // Display response
+            foreach (Product product in products)
+            {
+                Console.WriteLine();
+                Console.WriteLine("Product: " + product.Name);
+                Console.WriteLine("Price: " + product.Price);
+                Console.WriteLine("Quantity: " + product.Quantity);
+            }
+        }
+    }
+}

sources/RequestR.Demo/Product.cs

@@ -0,0 +1,14 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+      <TargetFramework>net5.0</TargetFramework>
+      <AssemblyName>DustInTheWind.RequestR.Demo</AssemblyName>
+      <RootNamespace>DustInTheWind.RequestR.Demo</RootNamespace>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <ProjectReference Include="..\RequestR\RequestR.csproj" />
+  </ItemGroup>
+
+</Project>