ABCNET

Краткое описание

ABCNET - альтернатива модулю PABCSystem для всего NET. Ориентирована на русскоязычную аудиторию. Более подробно об ABCNET можно узнать в презентации (желательно просматривать через Power Point).

Минимальные требования

NET Framework 4.0

Организация проекта

• Alvin Seville (руководитель проекта и основатель NETMouse-projects)
• ProMix0 (главный разработчик)
• egor2812 (поддержка)

Правила работы с Issue и Pull Requests для пользователей

Цель проекта

Обеспечить пользователей PascalABC.NET PABCSystem-подобным функционалом за пределами данного языка. Но, в то же время, не предоставлять множество обёрток для работы с типами NET, а стимулировать обучающихся изучать данную платформу.

Выучите одну библиотеку один раз и используйте её на любом NET-языке!

Принципы проекта

• Оптимизация важна
• Простота функционала
• Избегание использования специфических возможностей компиляторов

Варианты использования

PascalABC.NET

Через скачивание архива напрямую

Скачайте архив ABCNET.rar и разархивируйте его в папку с программой (не в директорию PascalABC.NET из Program Files (x86)).

Через пакетный менеджер NuGet в режиме проекта

Установите NuGet-пакет NETMouseProjectsOrganization.ABCNET через Подключённые сборки->Добавить сборку->NuGet.

Рекомендуемый шаблон кода

Используйте следующий шаблон кода для написания программы через ABCNET в PascalABC.NET:

{$reference ABCNET.dll} // Уберите данную строку, если используйте ABCNET в режиме проекта и подключили её как NuGet-пакет.
uses ABCNET.Utils;
uses ABCNET.Extensions;
begin
  // code here
end.

Visual Studio 2019

Через скачивание архива напрямую

Скачайте архив и разархивируйте его в любую папку. Подключите библиотеку через <project>->Add->Reference. Используйте следующий шаблон кода для написания программы через ABCNET на C#:

Через пакетный менеджер NuGet

Установите NuGet-пакет NETMouseProjectsOrganization.ABCNET через <project>->Manage NuGet Packages->Browse.

Рекомендуемый шаблон кода

Используйте следующий шаблон кода для написания программы через ABCNET на C#:

using ABCNET.Utils;
using ABCNET.Extensions;

namespace TestProgram
{
    internal class Program
    {
        private static void Main(string[] args)
        {
            // code here
        }
    }
}

Порты

• ABCPy (для Python)
• ABCJava (для Java)
• ABCCPlusPlus (для C++)

Для разработчиков

Жизненный цикл ABCNET

Любая версия должна содержать не более 25 Issue.

• Первые 5 Issue затрагивают API библиотеки (по их количеству ведётся версионирование).
• Вторые 5 Issue (необязательные) затрагивают API библиотеки.
• Третьи 5 Issue (необязательные) затрагивают исправления API библиотеки (bug-small и bug-critical).
• Четвёртые 5 Issue (необязательные) затрагивают примеры для API библиотеки.
• Пятые 5 Issue (необязательные) затрагивают внутренние изменения, которые не видны пользователям.

Формат версии: x.y.z, где:

• x - major-версия, принимает любое неотрицательное значение.
• y - minor-версия, принимает значение 0 и 5.
• z - количество закрытых Issue, касающихся API библиотеки.

Каждая major-версия закрывает в сумме ровно 100 (при учёте необязательных) Issue по API-библиотеки и состоит из двух minor-версий. Каждая сборка minor-версии закрывает в сумме ровно 5 Issue по API-библиотеки.

Инструменты разработки

Обязательные инструменты

• IDE - Visual Studio 2019, Repl.it
• Пллагины для Visual Studio 2019 - File Nesting
• Декомпилятор - dotPeek
• VCS - Git с Git Bash
• Язык автоматизации - Bash
• Фреймворки - NET Framework 4.0, NUnit

Рекомендуемые инструменты

• IDE - myCompiler
• Пллагины для Visual Studio 2019 - Roslynator 2019, CodeMaid, Markdown Editor, File Icons, Trailing Whitespace Visualizer

---

Если Вы не знакомы с GitHub, но Вам есть что сообщить или предложить нам, пожалуйста, воспользуйтесь данной формой.