Dignus.Log 1.0.0

Dignus.Log

Attribute-driven, zero-GC logging for the Dignus.
Fast format rendering, pluggable targets (console/file/database), and DI-backed configuration.

Highlights

• Flexible formatting: ${symbol[:format]} pipeline (ex: datetime, level, message, callsite)
• Attribute mapping: [LogElement("...")], [LogTarget("...")] auto-registration
• Zero-GC composition: pooled builders, no reflection on hot paths
• Multi-target routing: per-logger rules, min level filtering
• DI integration: targets resolved via Dignus.DependencyInjection
• Graceful shutdown: buffered drain & target dispose on process exit

Built-in Format Elements

• datetime (customizable format)
• level
• message
• callsite (filePath : lineNumber)
• callerFileName, callerFilePath, callerLineNumber
• literal (raw text)

Built-in Targets

Operational Notes

• Buffered write with lock-free signaling; drains on dispose
• Safe under concurrency; minimal allocations on hot path
• Default format: ${datetime} | ${level} | ${message}

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
	<targets>
		<target id ="consoleConfig" logTarget ="console" format="${datetime} | ${level} | ${message} ${callerFileName} : ${callerLineNumber}">
			<option category="color" id="Debug" value="DarkGray"/>
			<option category="color" id="Info" value="Green"/>
			<option category="color" id="Error" value="DarkRed"/>
			<option category="color" id="Fatal" value="Red"/>
		</target>
		<target id="fileConfig" logTarget ="file" format="${datetime} | ${level} | ${message} | ${callerFileName} : ${callerLineNumber}">
			<option category ="fileName" value="./logs/LogFile.txt"/>
			<option category ="archiveFileName" value ="./logs/archive/log.{#}.txt"/>
			<option category ="archiveRolling" value ="Day"/>
			<option category ="maxArchiveFiles" value ="7"/>
			<option category ="keepOpenFile" value="true"/>
      <option category ="autoFlush" value="true"/>
		</target>
		<target id ="databaseConfig" logTarget="database">
			<database dbConnection ="test"
                dbProvider="MySql.Data.MySqlClient.MySqlConnection, MySql.Data"
                keepConnectionOpen ="true"
                dbCommand="insert into log (logged, level, message)
										values (@logged, @level, @message);">

				<option category="parameter" id="@level" value="${level}"></option>
				<option category="parameter" id="@logged" value="${datetime}"></option>
				<option category="parameter" id="@message" value="${message}"></option>
				<option category="parameter" id="@callsite" value="${callerFileName} : ${callerLineNumber}"></option>
			</database>
		</target>
	</targets>
	<loggers>
		<logger id ="consoleConfig" minLogLevel="Debug"></logger>
		<logger id ="fileConfig" minLogLevel="Info"></logger>
		
	</loggers>
</configuration>