YALLA.NET is Yet Another Logging Library Abstraction for .NET.

Figure 1: Deployment diagram

Note
This is the YALLA.NET documentation. For the (unrelated) node.js library please refer to node-yalla.

YALLA.NET offers the following features:

• Rich-yet-intuitive APIs
• Detailed caller information (file name, member name and line number)
• cross-platform support
• A variety of log sources and targets
• A variety of configuration options
• Apache License

As shown in Figure 1 above, YALLA.NET supports a variety of use cases, which include the following:

1. Application Code Source: Your application code either requires the addition of logging functionality, or offers logging functionality that requires modification.

2. Library Code Source: Your library code either requires the addition of logging functionality, or offers logging functionality that requires modification.

3. Platform Facility Target: Your application or library code requires logging functionality with one or more platform-specific facilities.

Note
This is a preliminary release with limited functionality.Application Code Source, Library Code Source and Platform Facility Target are currently the only supported use cases.

In order to start using YALLA.NET in an application/service or a library, you need to add the YALLA.NET Core library as a dependency to your project. If you haven't already, install the Yalla.Core NuGet package .

In order for your application to produce YALLA.NET log(s), you need to add YALLA.NET as a dependency to the main project(s) (The YALLA.NET Core dependency will be added for you.). If you haven't already, install the Yalla NuGet package . The current version is Version 0.3.0.

The logging system must be properly initialized at application startup. The recommended method is Configure.

The logging system must be properly terminated at application teardown. The recommended method is Shutdown.

Detailed YALLA.NET API information may be found in the Reference section.

The following platforms are supported:

• .NET Framework 4
• Silverlight 5
• Windows 8 (WIP)
• Windows Phone 8.1 (WIP)
• Windows Phone Silverlight 8 (WIP)
• Xamarin.Android (WIP)
• Xamarin.iOS (WIP)
• Xamarin.OSX (WIP)
• Portable Class Libraries

Note
This is a preliminary release with limited functionality. .NET Framework 4 (or later), Silverlight 5 and Portable Class Libraries are currently the only supported platforms.

The following log sources are supported:

• Managed code
• Native code (through COM interop)
• Google APIs Client
• .NET Trace

Note
This is a preliminary release with limited functionality. Support for new sources is added on a nearly daily basis.

The following log targets are supported:

• Standard output
• Error output
• Debug output
• Trace
• Event log (WIP)

Note
This is a preliminary release with limited functionality. Support for new targets is added on a nearly daily basis.

• Application Configuration XML
• Library Configuration XML
• Standalone XML
• Standalone XAML
• JSON (WIP)

Note
This is a preliminary release with limited functionality.Application Configuration XML, Library Configuration XML, Standalone XML and Standalone XAML are currently the only supported configuration sources.

• Yaniv Kessler

Copyright © Dmitry Shechtman 2015

Licensed under the Apache License, Version 2.0 (the "License").

You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Tasks

Other Resources