Renames Chaos Proxy to Developer Proxy. Closes #20

Author: waldekmastykarz

README.md

@@ -1,8 +1,8 @@
-# Microsoft Graph Chaos Proxy
+# Microsoft Graph Developer Proxy
 
 **Build with Microsoft Graph. Reliably**
 
-Microsoft Graph Chaos Proxy allows you to verify that your application, that uses Microsoft Graph, correctly handles errors that can happen when the application is used at scale. With Graph Chaos Proxy you can:
+Microsoft Graph Developer Proxy allows you to verify that your application, that uses Microsoft Graph, correctly handles errors that can happen when the application is used at scale. With Graph Developer Proxy you can:
 
 - **simulate Microsoft Graph API errors**, to verify that your application handles them gracefully when deployed at scale,
 - **mock Microsoft Graph API responses**, to use your application with test data
@@ -11,9 +11,9 @@ Microsoft Graph Chaos Proxy allows you to verify that your application, that use
 
 API errors are hard to replicate because they occur only in specific circumstances, often when the application is under heavy load. Because developers typically work on their own tenants, they can only verify if their application properly handles errors after the application has been deployed to production and put under heavy load. This makes for a poor developer experience.
 
-With Graph Chaos Proxy you can see how your application responds to different errors that could be returned by the API.
+With Graph Developer Proxy you can see how your application responds to different errors that could be returned by the API.
 
-You can test your existing applications without any changes, even if you don't have access to their code and they're not using Microsoft Graph SDKs. Graph Chaos Proxy registers itself as a proxy on your machine and intercepts all network traffic. It passes through all requests and only responds to requests to the Microsoft Graph API.
+You can test your existing applications without any changes, even if you don't have access to their code and they're not using Microsoft Graph SDKs. Graph Developer Proxy registers itself as a proxy on your machine and intercepts all network traffic. It passes through all requests and only responds to requests to the Microsoft Graph API.
 
 ## Features
 
@@ -34,42 +34,42 @@ You can test your existing applications without any changes, even if you don't h
 
 ## Usage
 
-### Install Graph Chaos Proxy
+### Install Graph Developer Proxy
 
 To install the proxy is easy
 
-- Download the latest version of the ZIP file for your operating system from the [Releases](https://github.com/microsoftgraph/msgraph-chaos-proxy/releases) page 
+- Download the latest version of the ZIP file for your operating system from the [Releases](https://github.com/microsoftgraph/msgraph-developer-proxy/releases) page 
 - Extract the archive to a folder of your choice
 
-Graph Chaos Proxy doesn't need an installation and you can run it from any location on your machine.
+Graph Developer Proxy doesn't need an installation and you can run it from any location on your machine.
 
 > **Tip**
 >
-> To fully benefit of all features of Graph Chaos Proxy, add its location to the environment path. That way, you'll be able to start it from any directory and will be able to use project-specific mocks.
+> To fully benefit of all features of Graph Developer Proxy, add its location to the environment path. That way, you'll be able to start it from any directory and will be able to use project-specific mocks.
 
 ### First-time use
 
 #### Windows
 
-When started, Graph Chaos Proxy automatically registers itself as a system-wide proxy on your machine.
+When started, Graph Developer Proxy automatically registers itself as a system-wide proxy on your machine.
 
-When you start Graph Chaos Proxy for the first time, you'll be prompted to install a local certificate. This certificate is necessary to decrypt requests to the Microsoft Graph API.
+When you start Graph Developer Proxy for the first time, you'll be prompted to install a local certificate. This certificate is necessary to decrypt requests to the Microsoft Graph API.
 
-After installing the certificate, you'll be also prompted to allow Graph Chaos Proxy to communicate on your private and public network.
+After installing the certificate, you'll be also prompted to allow Graph Developer Proxy to communicate on your private and public network.
 
 #### macOS
 
-- make the Graph Chaos Proxy binary executable:
-  - open terminal and change the working directory to the location of Graph Chaos Proxy
-  - run `chmod +x ./msgraph-chaos-proxy`
-  - open the location of Graph Chaos Proxy in Finder
-  - on the keyboard press **Option** and open the context menu of the **msgraph-chaos-proxy** executable. From the context menu, choose **Open**, in the dialog choose **Open**
+- make the Graph Developer Proxy binary executable:
+  - open terminal and change the working directory to the location of Graph Developer Proxy
+  - run `chmod +x ./msgraph-developer-proxy`
+  - open the location of Graph Developer Proxy in Finder
+  - on the keyboard press **Option** and open the context menu of the **msgraph-developer-proxy** executable. From the context menu, choose **Open**, in the dialog choose **Open**
 - trust the certificate to decrypt SSL traffic:
   - Open **KeyChain Access**
   - in the search box, search for **Titanium Root Certificate Authority**
   - open the certificate and in the **Trust** section, set **Always Trust**
   - close the certificate window and confirm changes
-- set Graph Chaos Proxy as your system proxy:
+- set Graph Developer Proxy as your system proxy:
   - in **Network preferences**, select your adapter and click the **Advanced...** button
   - open **Proxies**
   - select **Secure Web Proxy (HTTPS)**
@@ -92,17 +92,17 @@ Depending on the configured fail ratio, the proxy will either pass the request t
 >
 > When closing the proxy, press the Enter key in the proxy's window, so that the proxy unregisters itself from your machine. If you terminate the proxy's process, you will lose network connection. To restore your connection in such case, start the proxy again, and close it by pressing Enter.
 
-### Uninstall Graph Chaos Proxy
+### Uninstall Graph Developer Proxy
 
-Remove the folder with proxy from your disk. Graph Chaos Proxy doesn't create any additional files or registry entries (Windows) on your machine. Remove the certificate installed by Graph Chaos Proxy.
+Remove the folder with proxy from your disk. Graph Developer Proxy doesn't create any additional files or registry entries (Windows) on your machine. Remove the certificate installed by Graph Developer Proxy.
 
 On macOS remove the **~/.config/rootCert.pfx** file.
 
 ## Configuration
 
 ### Mock responses
 
-Graph Chaos Proxy offers you the ability to define mock responses to specific Graph API calls. This capability is invaluable if you want to test your application with specific test cases or want to demonstrate your application with a set of data that is often time-sensitive and inconvenient to manage on an actual Microsoft 365 tenant.
+Graph Developer Proxy offers you the ability to define mock responses to specific Graph API calls. This capability is invaluable if you want to test your application with specific test cases or want to demonstrate your application with a set of data that is often time-sensitive and inconvenient to manage on an actual Microsoft 365 tenant.
 
 #### Mock responses structure
 
@@ -321,7 +321,7 @@ for request `GET /v1.0/users/48d31887-5fad-4d73-a9f5-3c356e68a038`, the proxy wo
 
 #### Respond to requests with binary data
 
-For some requests you might want to respond with binary data like documents or images. In Graph Chaos Proxy, you can define a binary response by setting the `responseBody` to a string value that starts with `@` followed by file path relative to the current working directory, for example:
+For some requests you might want to respond with binary data like documents or images. In Graph Developer Proxy, you can define a binary response by setting the `responseBody` to a string value that starts with `@` followed by file path relative to the current working directory, for example:
 
 ```json
 {
@@ -342,7 +342,7 @@ When you call `GET /v1.0/users/[email protected]/photo/$value`, you'll get the ima
 
 ### Settings
 
-Graph Chaos Proxy comes with several settings that you can use to control how the proxy should run. You can configure these settings by defining them in the `appsettings.json` file in the proxy's installation folder or using options in the command line.
+Graph Developer Proxy comes with several settings that you can use to control how the proxy should run. You can configure these settings by defining them in the `appsettings.json` file in the proxy's installation folder or using options in the command line.
 
 Setting|Description|Command-line option|Allowed values|Default value
 --|--|--|--|--
@@ -356,20 +356,20 @@ Setting|Description|Command-line option|Allowed values|Default value
 #### Example usage:
 
 ```
-msgraph-chaos-proxy.exe --port 8080 --failure-rate 50 --no-mocks --allowed-errors 429 503
+msgraph-developer-proxy.exe --port 8080 --failure-rate 50 --no-mocks --allowed-errors 429 503
 ```
 
 Will configure the proxy listening on port 8080 to fail 50% of requests with an http status code of either 429 or 503 and ignore any mock responses that may have been provided in the `responses.json` file
 
 ## Frequently Asked Questions
 
-### Does Graph Chaos Proxy upload any data to Microsoft?
+### Does Graph Developer Proxy upload any data to Microsoft?
 
 No, it doesn't. While the proxy intercepts all network traffic on your machine, it doesn't upload any data to Microsoft.
 
-### I've got no internet connection after using Graph Chaos Proxy
+### I've got no internet connection after using Graph Developer Proxy
 
-If you terminate the Graph Chaos Proxy process, the proxy won't be able to unregister itself and you won't have network connection on your machine. To restore network connection, start the proxy and close it by pressing Enter, which will gracefully close the proxy unregistering it on your machine and restoring the regular network connection.
+If you terminate the Graph Developer Proxy process, the proxy won't be able to unregister itself and you won't have network connection on your machine. To restore network connection, start the proxy and close it by pressing Enter, which will gracefully close the proxy unregistering it on your machine and restoring the regular network connection.
 
 ### I keep getting 429 responses
 

msgraph-chaos-proxy/Program.cs

@@ -3,7 +3,7 @@ Microsoft Visual Studio Solution File, Format Version 12.00
 # Visual Studio Version 17
 VisualStudioVersion = 17.3.32901.215
 MinimumVisualStudioVersion = 10.0.40219.1
-Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "msgraph-chaos-proxy", "msgraph-chaos-proxy\msgraph-chaos-proxy.csproj", "{A1047491-5E52-4755-B5D7-17B3774E35FC}"
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "msgraph-developer-proxy", "msgraph-developer-proxy\msgraph-developer-proxy.csproj", "{A1047491-5E52-4755-B5D7-17B3774E35FC}"
 EndProject
 Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Solution Items", "Solution Items", "{1CC1EC7F-4839-43C8-9980-9BCB19609FA9}"
 	ProjectSection(SolutionItems) = preProject

msgraph-chaos-proxy.sln renamed to msgraph-developer-proxy.sln

@@ -10,7 +10,7 @@
       "request": "launch",
       "preLaunchTask": "build",
       // If you have changed target frameworks, make sure to update the program path.
-      "program": "${workspaceFolder}/bin/Debug/net6.0/msgraph-chaos-proxy.dll",
+      "program": "${workspaceFolder}/bin/Debug/net6.0/msgraph-developer-proxy.dll",
       "args": [],
       "cwd": "${workspaceFolder}",
       // For more information about the 'console' field, see https://aka.ms/VSCode-CS-LaunchJson-Console

msgraph-chaos-proxy/.vscode/launch.json renamed to msgraph-developer-proxy/.vscode/launch.json

@@ -7,7 +7,7 @@
       "type": "process",
       "args": [
         "build",
-        "${workspaceFolder}/msgraph-chaos-proxy.csproj",
+        "${workspaceFolder}/msgraph-developer-proxy.csproj",
         "/property:GenerateFullPaths=true",
         "/consoleloggerparameters:NoSummary"
       ],
@@ -19,7 +19,7 @@
       "type": "process",
       "args": [
         "publish",
-        "${workspaceFolder}/msgraph-chaos-proxy.csproj",
+        "${workspaceFolder}/msgraph-developer-proxy.csproj",
         "/property:GenerateFullPaths=true",
         "/consoleloggerparameters:NoSummary"
       ],
@@ -33,7 +33,7 @@
         "watch",
         "run",
         "--project",
-        "${workspaceFolder}/msgraph-chaos-proxy.csproj"
+        "${workspaceFolder}/msgraph-developer-proxy.csproj"
       ],
       "problemMatcher": "$msCompile"
     }

msgraph-chaos-proxy/.vscode/tasks.json renamed to msgraph-developer-proxy/.vscode/tasks.json

@@ -9,7 +9,7 @@
 using Titanium.Web.Proxy.Models;
 using Titanium.Web.Proxy.Network;
 
-namespace Microsoft.Graph.ChaosProxy {
+namespace Microsoft.Graph.DeveloperProxy {
     internal enum FailMode {
         Throttled,
         Random,
@@ -70,14 +70,14 @@ public class ChaosEngine {
             }
         };
 
-        private readonly ChaosProxyConfiguration _config;
+        private readonly ProxyConfiguration _config;
         private readonly Random _random;
         private ProxyServer? _proxyServer;
         private ExplicitProxyEndPoint? _explicitEndPoint;
         private readonly Dictionary<string, DateTime> _throttledRequests;
         private readonly ConsoleColor _color;
 
-        public ChaosEngine(ChaosProxyConfiguration config) {
+        public ChaosEngine(ProxyConfiguration config) {
             _config = config ?? throw new ArgumentNullException(nameof(config));
             _config.InitResponsesWatcher();
 
@@ -136,7 +136,7 @@ public async Task Run(CancellationToken? cancellationToken) {
             }
 
             // wait here (You can use something else as a wait function, I am using this as a demo)
-            Console.WriteLine("Press Enter to stop the Microsoft Graph Chaos Proxy");
+            Console.WriteLine("Press Enter to stop the Microsoft Graph Developer Proxy");
             Console.ReadLine();
 
             // Unsubscribe & Quit
@@ -263,7 +263,7 @@ private static string GetMoveToSdkUrl(Request request) {
             return "https://aka.ms/move-to-graph-js-sdk";
         }
 
-        private static void ProcessMockResponse(SessionEventArgs e, ResponseComponents responseComponents, ChaosProxyMockResponse matchingResponse) {
+        private static void ProcessMockResponse(SessionEventArgs e, ResponseComponents responseComponents, ProxyMockResponse matchingResponse) {
             if (matchingResponse.ResponseCode is not null) {
                 responseComponents.ErrorStatus = (HttpStatusCode)matchingResponse.ResponseCode;
             }
@@ -304,7 +304,7 @@ private static void ProcessMockResponse(SessionEventArgs e, ResponseComponents r
             }
         }
 
-        private ChaosProxyMockResponse? GetMatchingMockResponse(Request request) {
+        private ProxyMockResponse? GetMatchingMockResponse(Request request) {
             if (_config.NoMocks ||
                 _config.Responses is null ||
                 !_config.Responses.Any()) {
@@ -330,7 +330,7 @@ _config.Responses is null ||
             return mockResponse;
         }
 
-        private void UpdateProxyResponse(SessionEventArgs e, ResponseComponents responseComponents, ChaosProxyMockResponse? matchingResponse) {
+        private void UpdateProxyResponse(SessionEventArgs e, ResponseComponents responseComponents, ProxyMockResponse? matchingResponse) {
             if (responseComponents.ErrorStatus == HttpStatusCode.TooManyRequests) {
                 var retryAfterDate = DateTime.Now.AddSeconds(retryAfterInSeconds);
                 _throttledRequests[BuildThrottleKey(e.HttpClient.Request)] = retryAfterDate;

msgraph-chaos-proxy/ChaosEngine.cs renamed to msgraph-developer-proxy/ChaosEngine.cs

@@ -1,6 +1,6 @@
 using System.Text.Json.Serialization;
 
-namespace Microsoft.Graph.ChaosProxy {
+namespace Microsoft.Graph.DeveloperProxy {
     internal class ErrorResponseBody {
         [JsonPropertyName("error")]
         public ErrorResponseError Error { get; set; }

msgraph-chaos-proxy/ErrorResponseBody.cs renamed to msgraph-developer-proxy/ErrorResponseBody.cs

@@ -0,0 +1,4 @@
+using Microsoft.Graph.DeveloperProxy;
+using System.CommandLine;
+
+return await new ProxyHost().GetRootCommand().InvokeAsync(args);