Refactor: Замена "&Наследует" на "&Расширяет" в интерфейсах и обновление зависимостей

- Заменены все использования "&Наследует" на "&Расширяет" в определениях интерфейсов для миграции на extends
- Обновлена версия пакета collectionos с 0.8.1 до 0.8.2.
- Обновлена версия зависимости разработки "decorator" с 2.0.2 до 2.0.3.
- Добавлена зависимость разработки "extends" версии 0.2.0.
- Обновлена документация README.md для описания коллекций и представлений.
- Обновлен тест "ПроверитьРеализациюИнтерфейсов.os" для использования валидатора реализации из extends.

bugfix: Для тестов подтягивать локальные зависимости

Fix: Сборка на 1.x

- Изменен тест `ПроверитьРеализациюИнтерфейсов.os` на `ПовторяемыйТест(1)` для скрытия от 1testrunner.
- Закомментирована зависимость разработки `extends` в `packagedef`, ввиду того что extends требует 2.0

fix: Пытаемся заставить 1testrunner не падать

Fix: Сборка на 1.x в тесте ПроверитьРеализациюИнтерфейсов.os

- Добавлен комментарий для совместимости с 1.x
- Закомментирована директива #Использовать extends, так как она требует 2.0

Author: sfaqer

.github/workflows/testing.yml

@@ -17,7 +17,10 @@ jobs:
             test_engine: '1testrunner'
           - oscript_version: 'dev'
             test_engine: 'oneunit'
+            additional_oscript_packages: extends
+
     uses: autumn-library/workflows/.github/workflows/test.yml@oneunit
     with:
       oscript_version: ${{ matrix.oscript_version }}
       test_engine: ${{ matrix.test_engine }}
+      additional_oscript_packages: ${{ matrix.additional_oscript_packages }}

README.md

@@ -2,35 +2,64 @@
 
 КоллекшонОС это фреймворк коллекций для OneScript
 
-## Особенности
-Начиная с версии OneScript 2.0 появилась возможность обходить собственные классы коллекции циклом `Для каждого`, особенность описанная ниже актуальна для более ранних версий движка:
+## Коллекции
 
-Так как в OneScript нет возможности сделать класс обходимым, то все представленные коллекции нельзя обойти циклом `Для каждого`, вместо этого вы можете воспользоваться итератором:
+Фреймворк предоставляет следующие коллекции
 
-```bsl
-СписокМассив = Новый СписокМассив;
-СписокМассив.Добавить(1);
-СписокМассив.Добавить(2);
-СписокМассив.Добавить(3);
+### Множества
 
-Итератор = СписокМассив.Итератор();
+Множества - неиндексированные коллекции уникальных элементов.
 
-Пока Итератор.ЕстьСледующий() Цикл
+1. МножествоСоответствие - Множество, реализованное на базе соответствия.
+1. МножествоКарта - Множество, реализованное на базе карты.
 
-    Элемент = Итератор.Следующий();
+### Списки
 
-    Сообщить(Элемент);
+Спики - индексированные коллекции элементов.
 
-КонецЦикла;
+1. СписокМассив - Список, реализованный на базе массива.
 
-// > 1
-// > 2
-// > 3
-```
+### Карты
+
+Карты - Коллекции пар ключ-значение.
+
+1. КартаСоответствие - Карта, реализованная на базе соответствия.
+
+### Очереди
+
+Очереди - коллекции элементов, в которых элементы добавляются в конец и извлекаются из начала.
+
+1. ОчередьМассив - Очередь, реализованная на базе массива.
+1. ПриоритетнаяОчередь - Очередь, реализованная на базе массива, которая сортируются элементы в порядке заданным компаратором.
+1. ОчередьОтложенных - Потокобезопасная очередь, частный случай приоритетной очереди, элементы которой должны иметь метод `Задержка` которые возвращает количество миллисекунд до того как элемент станет доступным для извлечения, элементы очереди сортируются в порядке возрастания задержек.
+
+## Представления
+
+Представления - специальные объекты "обёртки" для коллекций, в конструктор которой передаётся коллекция, и которая предоставляет дополнительные гарантии.
+
+### Синхронизированные
+
+Синхронизированные представления предоставляют потокобезопасные обёртки для коллекций.
 
-## Диаграмма классов:
+1. СинхронизированнаяКоллекция - Представление реализующее интерфейс `Коллекция`.
+1. СинхронизированноеМножество - Объект реализующий интерфейс `Множество`.
+1. СинхронизированныйСписок - Объект реализующий интерфейс `Список`.
+1. СинхронизированнаяКарта - Объект реализующий интерфейс `Карта`.
+1. СинхронизированнаяОчередь - Объект реализующий интерфейс `Очередь`.
+
+### Фиксированные
+
+Фиксированные представления предоставляют неизменяемые обёртки для коллекций.
+
+1. ФиксированнаяКоллекция - Представление реализующее интерфейс `ЧитаемаяКоллекция`.
+1. ФиксированноеМножество - Объект реализующий интерфейс `ЧитаемоеМножество`.
+1. ФиксированныйСписок - Объект реализующий интерфейс `ЧитаемыйСписок`.
+1. ФиксированнаяКарта - Объект реализующий интерфейс `ЧитаемаяКарта`.
+
+## Диаграмма классов
 
 ### Обходимое
+
 ---
 
 ```mermaid
@@ -80,6 +109,7 @@ class СинхронизированнаяКоллекция {
 ```
 
 ### Множество
+
 ---
 
 ```mermaid
@@ -115,6 +145,7 @@ class СинхронизированноеМножество {
 ```
 
 ### Список
+
 ---
 
 ```mermaid
@@ -161,6 +192,7 @@ class СинхронизированныйСписок {
 ```
 
 ### Очередь
+
 ---
 
 ```mermaid
@@ -205,6 +237,7 @@ class СинхронизированнаяОчередь {
 ```
 
 ### Карта
+
 ---
 
 ```mermaid
@@ -261,6 +294,7 @@ class СинхронизированнаяКарта {
 ```
 
 ### Итератор
+
 ---
 
 ```mermaid

packagedef

@@ -1,5 +1,5 @@
 Описание.Имя("collectionos")
-        .Версия("0.8.1")
+        .Версия("0.8.2")
         .Автор("Кирилл Черненко")
         .АдресАвтора("https://github.com/sfaqer")
         .Описание("Фреймворк коллекций для OneScript")
@@ -20,5 +20,8 @@
         .РазработкаЗависитОт("coverage", "0.7.0")
         .РазработкаЗависитОт("fs", "1.2.0")
         .РазработкаЗависитОт("asserts", "1.4.0")
-        .РазработкаЗависитОт("decorator", "2.0.2")
+        .РазработкаЗависитОт("decorator", "2.0.3")
+        // Вообще разработка конечно зависит, но ввиду того что extends требует 2.0+,
+        // а нужен он только для одного теста, то пока так.
+        // .РазработкаЗависитОт("extends", "0.2.0")
 ;

src/internal/Классы/Интерфейсы/Итератор.os

@@ -4,7 +4,7 @@
 КонецПроцедуры
 
 &Интерфейс
-&Наследует("ЧитающийИтератор")
+&Расширяет("ЧитающийИтератор")
 Процедура ПриСозданииОбъекта()
 	ВызватьИсключение "Нельзя создать экземпляр интерфейса";
 КонецПроцедуры

src/internal/Классы/Интерфейсы/Карта.os

@@ -242,7 +242,7 @@
 КонецФункции
 
 &Интерфейс
-&Наследует("ЧитаемаяКарта")
+&Расширяет("ЧитаемаяКарта")
 Процедура ПриСозданииОбъекта()
 	ВызватьИсключение "Нельзя создать экземпляр интерфейса";
 КонецПроцедуры

src/internal/Классы/Интерфейсы/Коллекция.os

@@ -84,7 +84,7 @@
 КонецФункции
 
 &Интерфейс
-&Наследует("ЧитаемаяКоллекция")
+&Расширяет("ЧитаемаяКоллекция")
 Процедура ПриСозданииОбъекта()
 	ВызватьИсключение "Нельзя создать экземпляр интерфейса";
 КонецПроцедуры

src/internal/Классы/Интерфейсы/Множество.os

@@ -1,6 +1,6 @@
 &Интерфейс
-&Наследует("ЧитаемоеМножество")
-&Наследует("Коллекция")
+&Расширяет("ЧитаемоеМножество")
+&Расширяет("Коллекция")
 Процедура ПриСозданииОбъекта()
 	ВызватьИсключение "Нельзя создать экземпляр интерфейса";
 КонецПроцедуры

src/internal/Классы/Интерфейсы/Очередь.os

@@ -20,8 +20,8 @@
 КонецФункции
 
 &Интерфейс
-&Наследует("ЧитаемаяОчередь")
-&Наследует("Коллекция")
+&Расширяет("ЧитаемаяОчередь")
+&Расширяет("Коллекция")
 Процедура ПриСозданииОбъекта()
 	ВызватьИсключение "Нельзя создать экземпляр интерфейса";
 КонецПроцедуры

src/internal/Классы/Интерфейсы/Список.os

@@ -105,8 +105,8 @@
 КонецФункции
 
 &Интерфейс
-&Наследует("ЧитаемыйСписок")
-&Наследует("Коллекция")
+&Расширяет("ЧитаемыйСписок")
+&Расширяет("Коллекция")
 Процедура ПриСозданииОбъекта()
 	ВызватьИсключение "Нельзя создать экземпляр интерфейса";
 КонецПроцедуры

src/internal/Классы/Интерфейсы/СписокИтератор.os

@@ -15,7 +15,7 @@
 КонецПроцедуры
 
 &Интерфейс
-&Наследует("Итератор")
+&Расширяет("Итератор")
 Процедура ПриСозданииОбъекта()
 	ВызватьИсключение "Нельзя создать экземпляр интерфейса";
 КонецПроцедуры