oscript-library · khorevaa · Jan 5, 2018 · Jan 5, 2018 · Jan 5, 2018 · Jan 5, 2018
diff --git a/README.md b/README.md
@@ -10,6 +10,7 @@
 
 Данная библиотека для языка OScript, позволяет создавать консольные приложения с разбором и проверкой аргументов.
 
+[Документация и описание публичного API](docs/README.md)
 ## Быстрый старт
 
 ### Пример простого приложения

diff --git a/docs/readme.md b/docs/readme.md
diff --git a/packagedef b/packagedef
@@ -10,7 +10,7 @@
         .Описание("Данный пакет облегчает создание консольных приложений на Oscript")
         .ВерсияСреды("1.0.18")
         .ВключитьФайл("src")
-        .ВключитьФайл("doc")
+        .ВключитьФайл("docs")
         //.ВключитьФайл("tests")
         .ВключитьФайл("package-loader.os")
         .ВключитьФайл("packagedef")

diff --git a/src/core/Классы/cmd/КомандаПриложения.os b/src/core/Классы/cmd/КомандаПриложения.os
diff --git a/src/core/Классы/cmd/ПараметрКоманды.os b/src/core/Классы/cmd/ПараметрКоманды.os
diff --git a/src/core/Классы/lexer/Лексер.os → src/core/Классы/internal/lexer/Лексер.os b/src/core/Классы/lexer/Лексер.os → src/core/Классы/internal/lexer/Лексер.os
diff --git a/src/core/Классы/parser/АргументыПарсера.os → ...лассы/internal/parser/АргументыПарсера.os b/src/core/Классы/parser/АргументыПарсера.os → ...лассы/internal/parser/АргументыПарсера.os
diff --git a/src/core/Классы/parser/ВсеОпцииПарсера.os → ...Классы/internal/parser/ВсеОпцииПарсера.os b/src/core/Классы/parser/ВсеОпцииПарсера.os → ...Классы/internal/parser/ВсеОпцииПарсера.os
diff --git a/src/core/Классы/parser/КонтекстПарсеров.os → ...лассы/internal/parser/КонтекстПарсеров.os b/src/core/Классы/parser/КонтекстПарсеров.os → ...лассы/internal/parser/КонтекстПарсеров.os
diff --git a/src/core/Классы/parser/ЛюбойСимвол.os → ...ore/Классы/internal/parser/ЛюбойСимвол.os b/src/core/Классы/parser/ЛюбойСимвол.os → ...ore/Классы/internal/parser/ЛюбойСимвол.os
diff --git a/...e/Классы/parser/ОпцииЗавершениеПарсера.os → ...internal/parser/ОпцииЗавершениеПарсера.os b/...e/Классы/parser/ОпцииЗавершениеПарсера.os → ...internal/parser/ОпцииЗавершениеПарсера.os
diff --git a/src/core/Классы/parser/ОпцияПарсера.os → ...re/Классы/internal/parser/ОпцияПарсера.os b/src/core/Классы/parser/ОпцияПарсера.os → ...re/Классы/internal/parser/ОпцияПарсера.os
diff --git a/src/core/Классы/parser/Парсер.os → src/core/Классы/internal/parser/Парсер.os b/src/core/Классы/parser/Парсер.os → src/core/Классы/internal/parser/Парсер.os
diff --git a/src/core/Классы/path/ВыборСовпадений.os → ...e/Классы/internal/path/ВыборСовпадений.os b/src/core/Классы/path/ВыборСовпадений.os → ...e/Классы/internal/path/ВыборСовпадений.os
diff --git a/src/core/Классы/path/Совпадение.os → src/core/Классы/internal/path/Совпадение.os b/src/core/Классы/path/Совпадение.os → src/core/Классы/internal/path/Совпадение.os
diff --git a/src/core/Классы/tools/ЧтениеСтроки.os → ...ore/Классы/internal/tools/ЧтениеСтроки.os b/src/core/Классы/tools/ЧтениеСтроки.os → ...ore/Классы/internal/tools/ЧтениеСтроки.os
diff --git a/src/core/Классы/types/ТипБулево.os → src/core/Классы/internal/types/ТипБулево.os b/src/core/Классы/types/ТипБулево.os → src/core/Классы/internal/types/ТипБулево.os
diff --git a/src/core/Классы/types/ТипДатаВремя.os → ...ore/Классы/internal/types/ТипДатаВремя.os b/src/core/Классы/types/ТипДатаВремя.os → ...ore/Классы/internal/types/ТипДатаВремя.os
diff --git a/src/core/Классы/types/ТипДлительность.os → .../Классы/internal/types/ТипДлительность.os b/src/core/Классы/types/ТипДлительность.os → .../Классы/internal/types/ТипДлительность.os
diff --git a/src/core/Классы/types/ТипМассивДат.os → ...ore/Классы/internal/types/ТипМассивДат.os b/src/core/Классы/types/ТипМассивДат.os → ...ore/Классы/internal/types/ТипМассивДат.os
diff --git a/src/core/Классы/types/ТипМассивСтрок.os → ...e/Классы/internal/types/ТипМассивСтрок.os b/src/core/Классы/types/ТипМассивСтрок.os → ...e/Классы/internal/types/ТипМассивСтрок.os
diff --git a/src/core/Классы/types/ТипМассивЧисел.os → ...e/Классы/internal/types/ТипМассивЧисел.os b/src/core/Классы/types/ТипМассивЧисел.os → ...e/Классы/internal/types/ТипМассивЧисел.os
diff --git a/src/core/Классы/types/ТипСтрока.os → src/core/Классы/internal/types/ТипСтрока.os b/src/core/Классы/types/ТипСтрока.os → src/core/Классы/internal/types/ТипСтрока.os
diff --git a/src/core/Классы/types/ТипЧисло.os → src/core/Классы/internal/types/ТипЧисло.os b/src/core/Классы/types/ТипЧисло.os → src/core/Классы/internal/types/ТипЧисло.os
diff --git a/src/core/Классы/КонсольноеПриложение.os b/src/core/Классы/КонсольноеПриложение.os
@@ -1,52 +1,52 @@
-Перем Команда; 
+// Класс ПараметрКоманды, для доступа к установленному значению из вне
+Перем ФлагВерсия Экспорт;
+// Строковое представление версии приложения
 Перем ВерсияПриложения Экспорт;
+
+Перем Команда; 
 Перем НаименованиеПриложения;
 Перем ОписаниеПриложения;
 
-Перем ДействиеВыполнения Экспорт;
-Перем ДействиеПередВыполнением Экспорт;
-Перем ДействиеПослеВыполнения Экспорт;
-
-Перем ФлагВерсия Экспорт;
-
-Перем ТипОпцииКоманды;
-
-Процедура ПриСозданииОбъекта(Знач Наименование, Знач Описание, Знач КлассРеализацииОсновныйКоманды = Неопределено)
-
-	НаименованиеПриложения = Наименование;
-	ОписаниеПриложения = Описание;
-
-	Если КлассРеализацииОсновныйКоманды = Неопределено Тогда
-		КлассРеализацииОсновныйКоманды = ЭтотОбъект;
-	КонецЕсли;
-
-	Команда = Новый КомандаПриложения(Наименование, Описание, КлассРеализацииОсновныйКоманды, ЭтотОбъект);
-
-	ТипОпцииКоманды = Новый Структура;
-	ТипОпцииКоманды.Вставить("Опция", "Опция");
-	ТипОпцииКоманды.Вставить("Аргумент", "Аргумент");
-
-КонецПроцедуры
 
+// Процедура добавляет версию приложения,
+// при вызове данной опции, показывается установленная версия и 
+// завершается выполнение с кодом (0)
+//
+// Параметры:
+//   Наименование - строка - имя опции, в строке допустимо задавать синоним через пробел, например "v version"
+//   СтрокаВерсии - строка - версия, приложения
 Процедура Версия(Наименование, СтрокаВерсии) Экспорт
 
 	ВерсияПриложения = СтрокаВерсии;
 	ФлагВерсия = Команда.Опция(Наименование, Ложь, "показать версию и выйти");
 
 КонецПроцедуры
 
+// Процедура позволяет переопределить стандартную строку использования приложения
+//
+// Параметры:
+//   СтрокаСпек - строка - переопределенная строка использования приложения
 Процедура УстановитьСпек(Знач СтрокаСпек) Экспорт
 
 	Команда.Спек = СтрокаСпек;
 
 КонецПроцедуры
 
+// Возвращает основную команду приложения
+//
+// Возвращаемое значение:
+//   Команда - класс КомандаПриложения
 Функция ПолучитьКоманду() Экспорт
 
 	Возврат Команда;
 
 КонецФункции
 
+// Основная процедура запуска приложения
+//
+// Параметры:
+//   АргументыКоманднойСтрокиВходящие - Массив - Элементы <Строка>, необзательный,
+//                                               Если, не передано считывает из АргументыКоманднойСтроки
 Процедура Запустить(АргументыКоманднойСтрокиВходящие = Неопределено) Экспорт
 
 	Аргументы = АргументыКоманднойСтроки;
@@ -60,36 +60,101 @@
 
 КонецПроцедуры
 
+// Функция добавляет команду приложение и возвращает экземпляр данной команды 
+//
+// Параметры:
+//   ИмяКоманды - строка - в строке допустимо задавать синоним через пробел, например "exec e"
+//   ОписаниеКоманды - строка - описание команды для справки
+//   КлассРеализацииКоманды - объект - класс, объект реализующий функции выполнения команды.
+//                                     Так же используется, для автоматической настройки опций и параметров команды
+//
+// Возвращаемое значение:
+//   Команда - класс КомандаПриложения
 Функция ДобавитьКоманду(ИмяКоманды, ОписаниеКоманды, КлассРеализацииКоманды) Экспорт
 
 	Возврат Команда.ДобавитьПодкоманду(ИмяКоманды, ОписаниеКоманды, КлассРеализацииКоманды);
 
 КонецФункции
 
+// Процедура устанавливает процедуру "ВыполнитьКоманду" выполнения для приложения
+//
+// Параметры:
+//   КлассРеализации - объект - класс, объект реализующий процедуру выполнения команды.
+//   ИмяПроцедуры - строка - имя процедуры, отличное от стандартного "ВыполнитьКоманду"
+//
 Процедура УстановитьОсновноеДействие(КлассРеализации, ИмяПроцедуры = "ВыполнитьКоманду") Экспорт
 
 	Команда.УстановитьДействиеВыполнения(КлассРеализации, ИмяПроцедуры);
 
 КонецПроцедуры
 
+// Процедура устанавливает процедуру "ПередВыполнениемКоманды" выполнения для приложения
+// запускаемую перед выполнением "ВыполнитьКоманду"
+//
+// Параметры:
+//   КлассРеализации - объект - класс, объект реализующий процедуру выполнения команды.
+//   ИмяПроцедуры - строка - имя процедуры, отличное от стандартного "ПередВыполнениемКоманды"
+//
 Процедура УстановитьДействиеПередВыполнением(КлассРеализации, ИмяПроцедуры = "ПередВыполнениемКоманды") Экспорт
 
 	Команда.УстановитьДействиеПередВыполнением(КлассРеализации, ИмяПроцедуры);
 
 КонецПроцедуры
 
+// Процедура устанавливает процедуру "ПослеВыполненияКоманды" выполнения для приложения
+// запускаемую после выполнением "ВыполнитьКоманду"
+//
+// Параметры:
+//   КлассРеализации - объект - класс, объект реализующий процедуру выполнения команды.
+//   ИмяПроцедуры - строка - имя процедуры, отличное от стандартного "ПослеВыполненияКоманды"
+//
 Процедура УстановитьДействиеПослеВыполнения(КлассРеализации, ИмяПроцедуры = "ПослеВыполненияКоманды") Экспорт
 
 	Команда.УстановитьДействиеПослеВыполнения(КлассРеализации, ИмяПроцедуры);
 
 КонецПроцедуры
 
+// Функция добавляет опцию приложения и возвращает экземпляр данной опции 
+//
+// Параметры:
+//   Имя      - строка - имя опции, в строке допустимо задавать синоним через пробел, например "s some-opt"
+//   Значение - строка - значение опции по умолчанию
+//   Описание - объект - описание опции для справки.
+//
+// Возвращаемое значение:
+//   Команда - класс ПараметрКоманды
+// 
+// Дополнительно смотри справку по классу ПараметрКоманды
 Функция Опция(Имя, Значение = "", Описание = "") Экспорт
 
 	Возврат Команда.Опция(Имя, Значение, Описание);
 
 КонецФункции
 
+// Функция добавляет аргумент приложения и возвращает экземпляр данной аргумента 
+//
+// Параметры:
+//   Имя      - строка - имя аргумента, в строке допустимо использование только из БОЛЬШИХ латинских букв, например "ARG"
+//   Значение - строка - значение аргумента по умолчанию
+//   Описание - объект - описание аргумента для справки.
+//
+// Возвращаемое значение:
+//   Команда - класс ПараметрКоманды
+// 
+// Дополнительно смотри справку по классу ПараметрКоманды
+Функция Аргумент(Имя, Значение = "", Описание = "") Экспорт
+
+	Возврат Команда.Аргумент(Имя, Значение, Описание);
+
+КонецФункции
+
+// Предопределенная процедура выполнения приложения, если не задана процедура в классе. 
+// Выводит справку, по работе с приложением и завершает работу с кодом "1"
+// Переопределяется, процедурой "УстановитьОсновноеДействие"
+//
+// Параметры:
+//   Команда  - класс КомандаПриложения - инстанс класс, для доступа к опция и аргументам выполняемой команды
+//
 Процедура ВыполнитьКоманду(Знач Команда) Экспорт
 
 	Сообщить("Не корректное использование"+ Символы.ПС);
@@ -98,8 +163,15 @@
 
 КонецПроцедуры
 
-Функция Аргумент(Имя, Значение = "", Описание = "") Экспорт
-
-	Возврат Команда.Аргумент(Имя, Значение, Описание);
+Процедура ПриСозданииОбъекта(Знач Наименование, Знач Описание, Знач КлассРеализацииОсновныйКоманды = Неопределено)
 
-КонецФункции
+	НаименованиеПриложения = Наименование;
+	ОписаниеПриложения = Описание;
+
+	Если КлассРеализацииОсновныйКоманды = Неопределено Тогда
+		КлассРеализацииОсновныйКоманды = ЭтотОбъект;
+	КонецЕсли;
+
+	Команда = Новый КомандаПриложения(Наименование, Описание, КлассРеализацииОсновныйКоманды, ЭтотОбъект);
+
+КонецПроцедуры