From d95614ecb34255c14047d37ab7d5631142a88183 Mon Sep 17 00:00:00 2001
From: YPermitin <ypermitin@yandex.ru>
Date: Tue, 14 Apr 2020 20:34:51 +0500
Subject: [PATCH] =?UTF-8?q?=D0=94=D0=BE=D0=B1=D0=B0=D0=B2=D0=BB=D0=B5?=
 =?UTF-8?q?=D0=BD=D0=BE=20=D0=BE=D0=BF=D0=B8=D1=81=D0=B0=D0=BD=D0=B8=D0=B5?=
 =?UTF-8?q?=20=D1=80=D0=B5=D0=BF=D0=BE=D0=B7=D0=B8=D1=82=D0=BE=D1=80=D0=B8?=
 =?UTF-8?q?=D1=8F=20=D0=B8=20=D0=BF=D1=80=D0=B8=D0=BC=D0=B5=D1=80=D1=8B=20?=
 =?UTF-8?q?=D0=B8=D1=81=D0=BF=D0=BE=D0=BB=D1=8C=D0=B7=D0=BE=D0=B2=D0=B0?=
 =?UTF-8?q?=D0=BD=D0=B8=D1=8F=20=D0=B1=D0=B8=D0=B1=D0=BB=D0=B8=D0=BE=D1=82?=
 =?UTF-8?q?=D0=B5=D0=BA=D0=B8?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md | 101 ++++++++++++++++++++++++++++++++++++++++++++++++++++--
 1 file changed, 99 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 7b11097..cdb7e0c 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,99 @@
-# YY.EventLogAssistant
-Библиотека для чтения файлов журнала регистрации платформы 1С:Предприятие 8.x
+# Помощник чтения данных журнала регистрации 1С:Предприятие 8.x
+
+Библиотека для чтения файлов журнала регистрации платформы 1С:Предприятие 8.x. Поддерживается как старый текстовый формат (*.lgf, *.lgp), так и новый формат SQLite-базы (*.lgd).
+
+# Состав репозитория
+
+* **YY.EventLogReaderAssistant** - исходный код библиотеки
+* **YY.EventLogReaderAssistant.Tests** - unit-тесты для проверки работоспособности библиотеки.
+* **YY.EventLogReaderAssistantConsoleApp** - консольное приложение с примерами использования библиотеки.
+
+# Примеры использования
+
+Для примера создадим консольное приложение с таким содержимом в методе "Main()":
+
+```csharp
+private static int _eventNumber = 0;
+
+static void Main(string[] args)
+{
+    if (args.Length == 0)
+        return;
+
+    // Каталог хранения файлов журнала регистрации.
+    // Может быть указан конкретный файл журнала (*.lgd / *.lgf)
+    string dataDirectoryPath = args[0];
+    Console.WriteLine($"{DateTime.Now}: Инициализация чтения логов \"{dataDirectoryPath}\"...");
+
+    // Инициализация объекта чтения логов
+    using (EventLogReader reader = EventLogReader.CreateReader(dataDirectoryPath))
+    {
+        // Устанавливаем обработчики событий
+        reader.AfterReadEvent += Reader_AfterReadEvent;
+        reader.AfterReadFile += Reader_AfterReadFile;
+        reader.BeforeReadEvent += Reader_BeforeReadEvent;
+        reader.BeforeReadFile += Reader_BeforeReadFile;
+        reader.OnErrorEvent += Reader_OnErrorEvent;
+
+        // Выводим общее количество собыитй
+        Console.WriteLine($"{DateTime.Now}: Всего событий к обработке: ({reader.Count()})...");
+        Console.WriteLine();
+        Console.WriteLine();
+        
+        // Последовательно читаем все события журнала
+        while (reader.Read())
+        {
+            // reader.CurrentRow - данные текущего события
+            _eventNumber += 1;
+        }
+    }
+
+    Console.WriteLine($"{DateTime.Now}: Для выхода нажмите любую клавишу...");
+    Console.ReadKey();
+}
+```
+Для удобной обработки результатов чтения и других связанных событий можно использовать события (инициализировали подписки на события выше), но не обязательно. Для подписки доступны события:
+
+* **BeforeReadFile** - перед чтением файла.
+* **AfterReadFile** - после чтения файла.
+* **BeforeReadEvent** - перед чтением события.
+* **AfterReadEvent** - после чтения события.
+* **OnErrorEvent** - событие при возникновении ошибки.
+
+Пример обработчиков событий.
+
+```csharp
+private static void Reader_BeforeReadFile(EventLogReader sender, BeforeReadFileEventArgs args)
+{
+    Console.WriteLine($"{DateTime.Now}: Начало чтения файла \"{args.FileName}\"");
+    Console.WriteLine($"{DateTime.Now}: {_eventNumber}");
+}
+
+private static void Reader_AfterReadFile(EventLogReader sender, AfterReadFileEventArgs args)
+{
+    Console.WriteLine($"{DateTime.Now}: Окончание чтения файла \"{args.FileName}\"");
+}
+
+private static void Reader_BeforeReadEvent(EventLogReader sender, BeforeReadEventArgs args)
+{
+    Console.SetCursorPosition(0, Console.CursorTop - 1);
+    Console.WriteLine($"{DateTime.Now}: (+){_eventNumber}");
+}
+
+private static void Reader_AfterReadEvent(EventLogReader sender, AfterReadEventArgs args)
+{
+    Console.SetCursorPosition(0, Console.CursorTop - 1);
+    Console.WriteLine($"{DateTime.Now}: [+]{_eventNumber}");
+}
+
+private static void Reader_OnErrorEvent(EventLogReader sender, OnErrorEventArgs args)
+{
+    Console.WriteLine($"{DateTime.Now}: Ошибка чтения логов \"{args.Exception}\"");
+}
+```
+
+В объекта "EventLogReader" также есть возможность обращаться к ссылочным данным журнала (приложения, пользователи, уровни событий, статус транзакции и другое).
+
+# Лицензия
+
+MIT - делайте все что посчитаете нужным. Никакой гарантии и никаких ограничений по использованию.
\ No newline at end of file