psql rosetta

Btrieve/Pervasive.SQL/ZEN: проект репозитория примера кода Rosetta

Идея

Предоставьте документированный пример кода для всех методов доступа к базе данных, поддерживаемых Pervasive.SQL, на всех платформах с использованием всех популярных языков. Предпочтительно полезно как для начинающих, так и для опытных пользователей в качестве справочного руководства.

Имя

Видеть:

• Розеттский камень
• Розеттский кодекс

Фон

В течение многих лет меня поражало, что примеров кода/кодирования мало. Кроме того, они менялись с течением времени (поддерживаемые платформы, языки), но больше всего застряли во времени. Не очень привлекательно для начинающего, независимо от того, будет ли он новичком в языке программирования или в Pervasive.SQL. За прошедшие годы у меня появились идеи, как это улучшить, и я приложил некоторые усилия к написанию кода. Предстоящая задача весьма обширна. Особенно, если человек хочет хорошо работать. Идеи меняются, между ними появляются новые проекты или задачи и т. д. Короче говоря, это заняло некоторое время, и результат сильно отличался от первоначально ожидаемого, поскольку моей первой идеей было написать одно эталонное приложение, которое позже можно было бы портировать на другие языки. платформы.

Макет

На основе параграфа «Методы доступа к базе данных» в онлайн-документации Actian Pervasive.SQL V13 я создал сценарий оболочки Bash (mk_dirs.sh), приняв единственный аргумент — имя языка программирования, который создает структуру каталогов, в которой перечислены все методы доступа к базе данных в виде подкаталогов. Используя этот сценарий, я был вынужден изучить и задокументировать все (?!) возможности, какими бы странными они ни были. Все подкаталоги содержат собственный файл ReadMe с уценкой, описывающий (не)возможности и код, если он предусмотрен. Все языки программирования имеют файл уценки ReadMe в корневом каталоге, описывающий все тонкости, что реализовано, а что нет, а также файл уценки результатов для регистрации того, что было протестировано на какой платформе.

Отсутствующие файлы и авторские права

Целью было не нарушать авторские права, поэтому заголовки необходимо копировать из SDK, которые можно загрузить с веб-сайта Actian. То же самое касается, например, кода, который можно скопировать/вставить с веб-сайта. Было бы здорово, если бы пример кода (и заголовки) был доступен из репозитория. Просматривая Github, можно найти файлы заголовков, защищенные авторским правом. Я оставляю Акциану добавить их.

Улучшения

Я очень приветствую улучшения, комментарии и другие вклады. Лично я могу придумать мнение:

• Весь код должен соответствовать стандартам кодирования.
• Рефакторинг/чистка кода.
• Весь код должен быть очень богат комментариями. Аннотируйте все вызовы базы данных.
• Весь код должен быть максимально защищенным: если возникает ошибка, о ней следует сообщить или хотя бы зарегистрировать.
• Весь код должен быть должным образом протестирован. Желательно на всех актуальных платформах. Что, в свою очередь, должно быть задокументировано.
• Код должен быть написан или адаптирован для других платформ. В частности: Mac, IOS, Android.
• Некоторые очевидные языки/платформы отсутствуют. В частности: Win/VS: c#, VB.net, Win/Embarcadero C++, Win/MingW или другой GNU C/C++, IOS/Objective C, Android/Java, Mac/обеспечение совместимости/поддержки сценариев bash-shell.
• Кроме того, некоторые языки, которые раньше поддерживались/были важны, еще не имеют примера кода. Что приходит на ум: Кобол, Дельфи,...? А некоторые уже не важны: (Visual) Basic (до .net), Pascal, Turboc (DOS), Watcom C/C++ (DOS).
• Некоторые «языки» не очень наглядны, поскольку они, похоже, требуют серьезного шаблонного подхода, управления проектами и/или интеграции в IDE. ASP.NET является примером.
• Интегрированные платформы не указаны. Например Magic. Наверное, нет смысла их перечислять. Другие платформы, использовавшиеся в прошлом: Clarion и Power Builder.
• Еще одна тема, требующая внимания, — это веб-разработка. Можно подумать о: Windows/ASP, Python/Flask, Python/Django, Ruby/Ruby-on-rails и Javascript, NodeJS. Опционально расширяется новыми разработками в блоке, такими как Dart/Flutter, Meteor и т. д., хотя многие из них основаны на Javascript.
• Драйверы. В настоящее время особенно приходит на ум одно: SQLAlchemy-Pervasive: ему требуется серьезный уход.
• В настоящее время большое внимание уделяется подключению к базе данных. В конечном счете, приложение, поддерживающее командную строку, проклятия (TUI), графический интерфейс при использовании всех вызовов, доступных в API (Btrieve, Btrieve2, ODBC, JDBC), было бы настоящим бонусом. Он будет служить для демонстрации, иллюстрируя, как следует использовать вызовы, и, очевидно, станет отличным тестом, особенно если код можно будет запускать с использованием автоматизации тестирования. Это будет очень важно правильно спроектировать и реализовать. Некоторые маленькие шаги в этом процессе были бы просто замечательными.

Я полностью осознаю, что большая часть кода не соответствует вышеуказанным стандартам. Рефакторинг всего кода занял бы много времени, что могло бы отложить первоначальный выпуск или, возможно, даже предотвратить его. По этой причине я публикую код, который не соответствует моим взглядам на правильное кодирование.

Кредиты

См. файл Credits.md. Этот файл применяется ко всему проекту.

Лицензия

См. файл License.md. Этот файл применяется ко всему проекту.

Предупреждения

Для полноты и единообразия все методы доступа, упомянутые в руководстве программиста, перечислены как опции для всех языков. Комбинации могут быть весьма абсурдными или экзотическими. Очевидно, что особенно они не реализованы (пока) и/или не протестированы должным образом. Весь код и документация в этом репозитории предоставляются «как есть». Я ни в коем случае не являюсь экспертом во всех представленных языках. Цель состоит в том, чтобы, по крайней мере, предоставить работающий код, который является очень низким стандартом, но, к сожалению, не является чем-то необычным. Сочинения о программировании и программной инженерии могут заполнить книжные полки. Давайте не будем идти туда сейчас. Будем надеяться, что качество кода со временем повысится, если люди, владеющие определенным языком, будут участвовать и улучшать код. Большая часть кода тестируется только в Linux, если не указано иное. Для повышения зрелости и ясности по этому предмету были добавлены таблицы результатов тестов.