Debugging
=========

**Energy.Core.Bug** is the library's internal debugging and exception logging helper. It is used by many other classes to report errors, trace execution, and log diagnostic information.

Writing messages
----------------

```csharp
Energy.Core.Bug.Write("Application started");
Energy.Core.Bug.Write("E001", "Error description");
Energy.Core.Bug.Write("E002", () => "Lazy message");
```

Catching exceptions
-------------------

```csharp
try
{
    int.Parse("not a number");
}
catch (Exception exception)
{
    Energy.Core.Bug.Catch(exception);
    Energy.Core.Bug.Catch("E003", exception);
}
```

Exception messages
------------------

```csharp
string message = Energy.Core.Bug.ExceptionMessage(exception);
string messageTrace = Energy.Core.Bug.ExceptionMessage(exception, true);
```

Suppression
-----------

```csharp
Energy.Core.Bug.Suppress("E001");
Energy.Core.Bug.Suppress("E0*", false);

if (Energy.Core.Bug.IsSuppressed("E001"))
{
    // ...
}
```

Debug output
------------

```csharp
string output = Energy.Core.Bug.FormatDebugOutput("E001", "Message");
string output2 = Energy.Core.Bug.FormatDebugOutput("Message");
```

Entry
-----

**Energy.Core.Bug.Entry** is a simple code/message pair.

Logger
------

Set a logger to receive bug messages.

```csharp
Energy.Core.Bug.Logger = Energy.Core.Log.Default;
```

Summary
-------

| Method | Description |
|--------|-------------|
| `Write(string)` | Write a debug message. |
| `Write(string, string)` | Write a coded message. |
| `Write(string, Func<string>)` | Write a lazy message. |
| `Write(Exception)` | Write an exception. |
| `Catch(Exception)` | Catch and log an exception. |
| `ExceptionMessage(Exception)` | Format exception message. |
| `Suppress(string)` | Suppress a message code. |
| `IsSuppressed(string)` | Check if a code is suppressed. |
| `Clear()` | Clear suppression list. |