Skip to content

Commit 65ea995

Browse files
committed
readme updates for version 4
1 parent f6467a8 commit 65ea995

File tree

3 files changed

+39
-26
lines changed

3 files changed

+39
-26
lines changed

LICENSE.txt

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
MIT License
22

3-
Copyright (c) 2008-2018 Peter van der Woude
3+
Copyright (c) 2008-2018 Peter van der Woude, Simon Cropp
44

55
Permission is hereby granted, free of charge, to any person obtaining a copy
66
of this software and associated documentation files (the "Software"), to deal

README.md

Lines changed: 27 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -42,38 +42,44 @@ The ultimate goal is the developer receiving a formatted exception report - see
4242

4343
## Some Important Features
4444

45-
- Gathers and reports on inner exceptions and accepts multiple exceptions
45+
- Gathers inner exceptions and accepts multiple exceptions
4646
- Option to send a report silently (and asynchronously) ie without showing a dialog
47-
- Support for sending a report to a RESTful API/WebService (v3.0)
48-
- Easily attach additional files to an email (automatically compressed into a single zip file) - useful for including log/config files etc to help with diagnosis
49-
- Support for using the user's Windows email client (SimpleMAPI) - in addition to using SMTP mail server (and, of course, the WebService option)
50-
- The solution includes a Demo App for testing config and sending reports via Email/WebService
47+
- Send a report to a RESTful API/WebService (v3.0)
48+
- Send a report via SMTP (Email)
49+
- Send a report via Email Client (SimpleMAPI) - Support for automatically attaching files
50+
and compressing attached files into a single zip file) - useful for including log and
51+
config files to help with troubleshooting
52+
- The report sent to the developer can be in the format:
53+
- Plain Text
54+
- HTML
55+
- Markdown
56+
- Custom - your own Handlebar/Mustache template can be used to create the report
57+
- The report includes exception stack traces, time/version and important system
58+
information (using WMI) such as CPU,
59+
memory, OSLanguage, Windows version etc - as well as a list of all referenced
60+
assemblies (with versions) being used by the current executable
61+
62+
### Demos & Help
63+
- The solution includes a Demo App for testing config and sending reports via
64+
Email/WebService
5165
- The solution also includes a .NET Core REST/WebService project to demonstrate the requirements of sending reports to a WebService
52-
- The report that is sent is plain text and includes exception stack traces, various related data such time/version and important system information (using WMI) such as CPU, memory, Windows version - as well as a list of all referenced assemblies (with versions) being used by the current executable
5366

5467
## Sample Report
5568

56-
This is a sample of the plain text report:
69+
Here is a sample of the preset Plain Text report:
5770

5871
```text
59-
-----------------------------
60-
[General Info]
72+
====================
6173
6274
Application: ExceptionReporter Demo App
63-
Version: 2.2.1
75+
Version: 4.0
6476
Region: English (Australia)
65-
Machine: PANDAMAN
66-
User: JohnGruber
67-
Date: 30/05/2017
68-
Time: 12:40 AM
69-
70-
User Explanation:
77+
Date: 25/08/2018
78+
Time: 2:40 PM
7179
72-
JohnGruber said "I just pressed Connect and this happened"
73-
-----------------------------
80+
User Explanation: "I just pressed Connect and this error showed immediately"
7481
75-
[Exception Info 1]
76-
82+
[Full Stack Trace]
7783
Top-level Exception
7884
Type: System.IO.IOException
7985
Message: Unable to establish a connection with the Foo bank account service. The error number is #FFF474678.
@@ -121,7 +127,6 @@ Operating System
121127
ExceptionReporter has a dependency on the [.NET4 Framework](https://en.wikipedia.org/wiki/.NET_Framework_version_history#.NET_Framework_4) - so can go as low as supporting Windows XP
122128

123129
There is a suite of Unit Tests to support ExceptionReporter using [Moq](https://github.com/Moq/moq4/wiki/Quickstart) and [NUnit](https://nunit.org/) libraries.
124-
Coverage is not as high as it should be but we're working on that.
125-
The tests run every commit via AppVeyor
130+
We're always working toward higher coverage and the tests run every commit via AppVeyor
126131

127132
[![Build status](https://ci.appveyor.com/api/projects/status/e2b3sruf4fpmcohm?svg=true)](https://ci.appveyor.com/project/PandaWood/exceptionreporter-net)

src/ExceptionReporter/ExceptionReporter.csproj

Lines changed: 11 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -26,9 +26,9 @@
2626
<Title>ExceptionReporter.NET</Title>
2727
<Description>ExceptionReporter is a .NET component that gathers detailed information on an Exception and the application/system running it. It allows the user to copy, save or email a report to the developer</Description>
2828
<NeutralLanguage>en</NeutralLanguage>
29-
<PackageReleaseNotes>https://github.com/PandaWood/ExceptionReporter.NET/releases/tag/3.0</PackageReleaseNotes>
29+
<PackageReleaseNotes>https://github.com/PandaWood/ExceptionReporter.NET/releases/tag/4.0</PackageReleaseNotes>
3030
<PackageTags>exception-reporting,crash-reporting</PackageTags>
31-
<ReleaseVersion>3.0.1</ReleaseVersion>
31+
<ReleaseVersion>4.0</ReleaseVersion>
3232
<SynchReleaseVersion>false</SynchReleaseVersion>
3333
<SchemaVersion>2.0</SchemaVersion>
3434
<NuGetPackageImportStamp>
@@ -50,7 +50,7 @@
5050
<ErrorReport>prompt</ErrorReport>
5151
<WarningLevel>4</WarningLevel>
5252
<DocumentationFile>bin\Debug\ExceptionReporter.NET.xml</DocumentationFile>
53-
<CustomCommands>
53+
<CustomCommands>
5454
</CustomCommands>
5555
<AllowUnsafeBlocks>false</AllowUnsafeBlocks>
5656
<NoStdLib>false</NoStdLib>
@@ -171,6 +171,14 @@
171171
<ItemGroup>
172172
<EmbeddedResource Include="Templates\EmailIntroTemplate.text" />
173173
</ItemGroup>
174+
<ItemGroup>
175+
<Content Include="..\..\LICENSE.txt">
176+
<Link>LICENSE.txt</Link>
177+
</Content>
178+
<Content Include="..\..\README.md">
179+
<Link>README.md</Link>
180+
</Content>
181+
</ItemGroup>
174182
<Import Project="$(MSBuildToolsPath)\Microsoft.CSharp.targets" />
175183
<!-- To modify your build process, add your task inside one of the targets below and uncomment it.
176184
Other similar extension points exist, see Microsoft.Common.targets.

0 commit comments

Comments
 (0)