.gitignore

@@ -14,3 +14,10 @@ obj/
 /TestResult.xml
 docs/_build
 .vs
+artifacts/
+build/
+tools/
+!tools/packages.config
+!tools/NuGet.config
+.vscode
+.idea

.travis.yml

@@ -1,7 +1,12 @@
 language: csharp
+mono:
+ - weekly
+
 solution: src/SharpRaven.sln
+
 sudo: false
-install:
-  - make
+dotnet: 2.0.0
+dist: trusty
+
 script:
-  - make test
+  - ./build.sh --verbosity diagnostic --target Travis

README.md

@@ -1,13 +1,29 @@
-Usage
-=====
-Instantiate the client with your DSN:
+<p align="center">
+  <a href="https://sentry.io" target="_blank" align="center">
+    <img src="https://sentry-brand.storage.googleapis.com/sentry-logo-black.png" width="280">
+  </a>
+  <br />
+</p>
+
+Official [Sentry](https://sentry.io/for/csharp/) SDK for .NET.
+===========
+
+|                      |             Stable             |      Pre-release     |
+| -------------------: | :----------------------------: | :------------------: |
+|           **GitHub** |    [![GitHub release][1]][2]   |           -          |
+|       **SharpRaven** |       [![NuGet][3]][4]         |   [![NuGet][5]][4]   |
+| **SharpRaven.Nancy** |       [![NuGet][6]][7]         |   [![NuGet][8]][7]   |
+|     **Travis Build** |      [![Master][12]][14]       | [![Develop][13]][14] |
+|   **AppVeyor Build** |      [![Master][9]][10]        | [![Develop][15]][10] |
+
+## Usage
+Instantiate the client with your 'Data Source Name' (DSN):
 
 ```csharp
-var ravenClient = new RavenClient("http://public:secret@example.com/project-id");
+var ravenClient = new RavenClient("https://public@sentry.io/project-id");
 ```
 
-Capturing Exceptions
---------------------
+### Capturing Exceptions
 Call out to the client in your catch block:
 
 ```csharp
@@ -16,24 +32,22 @@ try
     int i2 = 0;
     int i = 10 / i2;
 }
-catch (Exception e)
+catch (Exception exception)
 {
-    ravenClient.CaptureException(e);
+    ravenClient.Capture(new SentryEvent(exception));
 }
 ```
 
-Logging Non-Exceptions
-----------------------
+### Logging Non-Exceptions
 You can capture a message without being bound by an exception:
 
 ```csharp
-ravenClient.CaptureMessage("Hello World!");
+ravenClient.Capture(new SentryEvent("Hello World!"));
 ```
 
-Additional Data
----------------
-You can add additional data to the [`Exception.Data`](https://msdn.microsoft.com/en-us/library/system.exception.data.aspx)
-property on exceptions thrown about in your solution:
+### Additional Data
+You can add additional data to the [`Exception.Data`][ex] property on
+exceptions thrown about in your solution:
 
 ```csharp
 try
@@ -47,61 +61,34 @@ catch (Exception exception)
 }
 ```
 
-The data `SomeKey` and `SomeValue` will be captured and presented in the `extra` property on Sentry.
+The data `SomeKey` and `SomeValue` will be captured and presented in the `extra`
+property on Sentry.
 
-Additionally, the capture methods allow you to provide additional data to be sent with your request.
-`CaptureException` supports both the `tags` and `extra` properties, and `CaptureMessage` additionally
-supports the `level` property.
+Additionally, the `SentryEvent` class allow you to provide extra data to be
+sent with your request, such as `ErrorLevel`, `Fingerprint`, a custom `Message`
+and `Tags`.
 
-The full argument specs are:
+### Async Support
+In the .NET 4.5 or later build of SharpRaven, there's an `async` version of the `Capture`
+method as well:
 
 ```csharp
-string CaptureException(Exception exception,
-                        SentryMessage message = null,
-                        ErrorLevel level = ErrorLevel.Error,
-                        IDictionary<string, string> tags = null,
-                        string[] fingerprint = null,
-                        object extra = null)
-
-string CaptureMessage(SentryMessage message,
-                      ErrorLevel level = ErrorLevel.Info,
-                      IDictionary<string, string> tags = null,
-                      string[] fingerprint = null,
-                      object extra = null)
-
+async Task<string> CaptureAsync(SentryEvent @event);
 ```
 
-Async Support
--------------
-In the .NET 4.5 build of SharpRaven, there are `async` versions of the above methods as well:
+### Nancy Support
+You can install the
+[SharpRaven.Nancy][nuget-nancy] package to capture the HTTP context in
+[Nancy][nancy] applications. It will auto-register on the `IPipelines.OnError`
+event, so all unhandled exceptions will be sent to Sentry.
 
-```csharp
-Task<string> CaptureExceptionAsync(Exception exception,
-                                   SentryMessage message = null,
-                                   ErrorLevel level = ErrorLevel.Error,
-                                   IDictionary<string, string> tags = null,
-                                   string[] fingerprint = null,
-                                   object extra = null);
-
-Task<string> CaptureMessageAsync(SentryMessage message,
-                                 ErrorLevel level = ErrorLevel.Info,
-                                 IDictionary<string, string> tags = null,
-                                 string[] fingerprint = null,
-                                 object extra = null);
-```
-
-Nancy Support
--------------
-You can install the [SharpRaven.Nancy](https://www.nuget.org/packages/SharpRaven.Nancy) package to capture the HTTP context
-in [Nancy](http://nancyfx.org/) applications. It will auto-register on the `IPipelines.OnError` event, so all unhandled
-exceptions will be sent to Sentry.
-
-The only thing you have to do is provide a DSN, either by registering an instance of the `Dsn` class in your container:
+The only thing you have to do is provide a DSN, either by registering an
+instance of the `Dsn` class in your container:
 
 ```csharp
 protected override void ApplicationStartup(TinyIoCContainer container, IPipelines pipelines)
 {
-    container.Register(new Dsn("http://public:secret@example.com/project-id"));
+    container.Register(new Dsn("https://public@sentry.io/project-id"));
 }
 ```
 
@@ -113,13 +100,14 @@ or through configuration:
     <section name="sharpRaven" type="SharpRaven.Nancy.NancyConfiguration, SharpRaven.Nancy" />
   </configSections>
   <sharpRaven>
-    <dsn value="http://public:secret@example.com/project-id" />
+    <dsn value="https://public@sentry.io/project-id" />
   </sharpRaven>
 </configuration>
 ```
 
-The DSN will be picked up by the auto-registered `IRavenClient` instance, so if you want to send events to
-Sentry, all you have to do is add a requirement on `IRavenClient` in your classes:
+The DSN will be picked up by the auto-registered `IRavenClient` instance, so if
+you want to send events to Sentry, all you have to do is add a requirement on
+`IRavenClient` in your classes:
 
 ```csharp
 public class LoggingModule : NancyModule
@@ -133,27 +121,66 @@ public class LoggingModule : NancyModule
 }
 ````
 
-Debugging SharpRaven
---------------------
-
-If an exception is raised internally to `RavenClient` it is logged to the Console. To extend this behaviour use
-the property `ErrorOnCapture`:
+### Debugging SharpRaven
+If an exception is raised internally to `RavenClient` it is logged to the
+`Console`. To extend this behaviour use the property `ErrorOnCapture`:
 
 ```csharp
-ravenClient.ErrorOnCapture = exception => {
-    // custom code here
+ravenClient.ErrorOnCapture = exception =>
+{
+    // Custom code here
 };
 ````
 
+You can also hook into the `BeforeSend` function to inspect or manipulate the
+data being sent to Sentry before it is sent:
+
+```csharp
+ravenClient.BeforeSend = requester =>
+{
+    // Here you can log data from the requester
+    // or replace it entirely if you want.
+    return requester;
+};
+```
 
-Get it!
--------
-You can clone and build SharpRaven yourself, but for those of us who are happy with prebuilt binaries, there's [a NuGet package](https://www.nuget.org/packages/SharpRaven).
 
-Resources
----------
-* [![Build Status](http://teamcity.codebetter.com/app/rest/builds/buildType:(id:bt1000)/statusIcon)](http://teamcity.codebetter.com/viewType.html?buildTypeId=bt1000&guest=1)
-* [![Join the chat at https://gitter.im/getsentry/raven-csharp](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/getsentry/raven-csharp?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
-* [Code](http://github.com/getsentry/raven-csharp)
-* [Mailing List](https://groups.google.com/group/getsentry)
-* [IRC](irc://irc.freenode.net/sentry) (irc.freenode.net, #sentry)
+## Get it!
+You can clone and build SharpRaven yourself, but for those of us who are happy
+with prebuilt binaries, there's NuGet packages of both
+[SharpRaven][nuget] and
+[SharpRaven.Nancy][nuget-nancy].
+
+## Resources
+* [![Join the chat at https://gitter.im/getsentry/raven-csharp][gitter-badge]][gitter-link]
+* [Code][github]
+* [Bug Tracker](https://github.com/getsentry/raven-csharp/issues)
+* [Forum][forum]
+* [Mailing List][mail]
+* [IRC][irc] (`#sentry` on `irc.freenode.net`)
+* Follow [@getsentry](https://twitter.com/getsentry) on Twitter for updates
+
+ [1]: https://img.shields.io/github/release/getsentry/raven-csharp.svg
+ [2]: https://github.com/getsentry/raven-csharp/releases/latest
+ [3]: https://img.shields.io/nuget/v/SharpRaven.svg
+ [4]: https://www.nuget.org/packages/SharpRaven
+ [5]: https://img.shields.io/nuget/vpre/SharpRaven.svg
+ [6]: https://img.shields.io/nuget/v/SharpRaven.Nancy.svg
+ [7]: https://www.nuget.org/packages/SharpRaven.Nancy
+ [8]: https://img.shields.io/nuget/vpre/SharpRaven.Nancy.svg
+ [9]: https://img.shields.io/appveyor/ci/sentry/raven-csharp/master.svg
+[10]: https://ci.appveyor.com/project/sentry/raven-csharp
+[12]: https://travis-ci.org/getsentry/raven-csharp.svg?branch=master
+[13]: https://travis-ci.org/getsentry/raven-csharp.svg?branch=develop
+[14]: https://travis-ci.org/getsentry/raven-csharp
+[15]: https://img.shields.io/appveyor/ci/sentry/raven-csharp/develop.svg
+[ex]: https://msdn.microsoft.com/en-us/library/system.exception.data.aspx
+[gitter-badge]: https://badges.gitter.im/Join%20Chat.svg
+[gitter-link]: https://gitter.im/getsentry/raven-csharp?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge
+[github]: http://github.com/getsentry/raven-csharp/develop/src
+[mail]: https://groups.google.com/group/getsentry
+[forum]: https://forum.sentry.io/c/sdks
+[irc]: irc://irc.freenode.net/sentry
+[nuget]: https://www.nuget.org/packages/SharpRaven
+[nuget-nancy]: https://www.nuget.org/packages/SharpRaven.Nancy
+[nancy]: http://nancyfx.org/

appveyor.yml

@@ -0,0 +1,8 @@
+environment:
+  NuGetOrgApiKey:
+    secure: pAgSjPrAcwxzQMP32ya83+Hy+g3uS2J5ubnjv49d9urupYC5xJLVqcPOpnJ4ChYn
+version: 1.0.{build}
+image: Visual Studio 2017
+build_script:
+- ps: .\build.ps1 -Target AppVeyor -Verbosity Diagnostic
+test: off