psql rosetta

Btrieve / Pervasive.SQL / ZEN: proyecto de repositorio de ejemplo de código Rosetta

Idea

Proporcione código de ejemplo documentado para todos los métodos de acceso a bases de datos admitidos por Pervasive.SQL en todas las plataformas utilizando todos los lenguajes populares. Preferiblemente útil tanto para principiantes como para usuarios avanzados como guía de referencia.

Nombre

Ver:

• Piedra Roseta
• Código Rosetta

Fondo

Durante muchos años me llamó la atención que los ejemplos de código/codificación eran escasos. También variaron con el tiempo (plataformas, idiomas admitidos), pero sobre todo se estancaron en el tiempo. No es muy atractivo para un principiante, ya sea que sea nuevo en un lenguaje de programación o en Pervasive.SQL. A lo largo de los años, desarrollé ideas sobre cómo mejorar esto e hice algunos esfuerzos escribiendo código. La tarea que tenemos por delante es bastante extensa. Especialmente si uno quiere hacer un trabajo adecuado. Las ideas cambian, se interponen nuevos proyectos o tareas, etc. En pocas palabras, tomó algo de tiempo y el resultado es muy diferente de lo que se anticipó inicialmente, ya que mi primera idea era escribir una aplicación de referencia única que luego podría portar a otros idiomas. plataformas.

Disposición

Basado en el párrafo Métodos de acceso a la base de datos en la documentación en línea de Actian Pervasive.SQL V13, creé un shellscript Bash (mk_dirs.sh), tomando como único argumento el nombre del lenguaje de programación, lo que crea una estructura de directorio que enumera todos los métodos de acceso a la base de datos como subdirectorios. Al usar este script me vi obligado a investigar y documentar todas (?!) posibilidades, sin importar cuán extrañas fueran. Todos los subdirectorios contienen su propio archivo Léame de rebajas que describe las (im)posibilidades y el código, si se proporciona. Todos los lenguajes de programación tienen un archivo Léame de rebajas en su directorio raíz que describe los entresijos, lo que se implementa y lo que no, así como un archivo de rebajas de Resultados para registrar lo que se ha probado en cada plataforma.

Archivos faltantes versus derechos de autor

El objetivo era no infringir ningún derecho de autor, por lo que los encabezados deben copiarse de los SDK que se pueden descargar del sitio web de Actian. Lo mismo ocurre, por ejemplo, con el código que se puede copiar y pegar desde el sitio web. Sería fantástico si el código de ejemplo (y los encabezados) pudieran estar disponibles desde un repositorio. Al buscar en Github, se pueden encontrar archivos de encabezado con derechos de autor. Dejo que Actian los agregue.

Mejoras

Agradezco mucho mejoras, comentarios y otras contribuciones. Personalmente se me ocurre una vista:

• Todo el código debe cumplir con los estándares de codificación.
• Refactorización/limpieza de código.
• Todo el código debe ser muy rico en comentarios. Anota todas las llamadas a la base de datos.
• Todo el código debe ser muy defensivo: si ocurre un error, debe informarse o al menos registrarse.
• Todo el código debe probarse adecuadamente. Preferiblemente en todas las plataformas relevantes. Lo cual a su vez debería estar documentado.
• El código debe escribirse o adaptarse para otras plataformas. En particular: Mac, IOS, Android
• Faltan algunos idiomas/plataformas obvios. En particular: Win/VS: c#, VB.net, Win/Embarcadero C++, Win/MingW u otro GNU C/C++, IOS/Objective C, Android/Java, Mac/hacer que los scripts de bash-shell sean compatibles/soportantes.
• Además, algunos idiomas que solían ser compatibles o eran importantes aún no tienen código de muestra. ¿Qué te viene a la mente: Cobol, Delphi,...? Y algunos ya no son importantes: (Visual) Basic (pre .net), Pascal, Turboc (DOS), Watcom C/C++ (DOS)
• Algunos 'lenguajes' no son muy demostrables ya que parecen requerir una estricta repetición, gestión de proyectos y/o integración en un IDE. ASP.NET es un ejemplo.
• Las plataformas integradas no figuran en la lista. Por ejemplo Magic Probablemente no tenga sentido enumerarlos. Otras plataformas utilizadas en el pasado: Clarion y Power Builder
• Otro tema que requiere atención es el desarrollo basado en web. Se puede pensar en: Windows/ASP, Python/Flask, Python/Django, Ruby/Ruby-on-rails y Javascript, NodeJS. Opcionalmente ampliado con nuevos chicos del bloque como Dart/Flutter, Meteor, etc. aunque muchos de ellos están basados ​​en Javascript.
• Conductores. Actualmente me viene a la mente especialmente uno: SQLAlchemy-Pervasive: necesita un poco de atención y cariño.
• Actualmente, se presta especial atención a la conectividad de bases de datos. En última instancia, una aplicación que admita línea de comandos, curses (TUI) y GUI mientras utiliza todas las llamadas disponibles en las API (Btrieve, Btrieve2, ODBC, JDBC) sería una verdadera ventaja. Serviría para demostraciones, ilustraría cómo se deben usar las llamadas y obviamente proporcionaría una excelente prueba, especialmente si el código pudiera ejecutarse mediante la automatización de pruebas. Esto sería algo importante para diseñar e implementar correctamente. Algunos pequeños pasos en este proceso por sí solos serían geniales.

Soy plenamente consciente de que la mayoría del código no cumple con los estándares anteriores. Refactorizar todo el código llevaría mucho tiempo, lo que pospondría el lanzamiento inicial o incluso lo impediría. Por este motivo, estoy publicando código que no coincide con mis opiniones sobre la codificación adecuada.

Créditos

Consulte el archivo Credits.md. Este archivo se aplica a todo el proyecto.

Licencia

Consulte el archivo License.md. Este archivo se aplica a todo el proyecto.

Advertencias

En aras de la integridad y la uniformidad, todos los métodos de acceso mencionados en el manual del programador se enumeran como opciones para todos los idiomas. Las combinaciones pueden ser bastante absurdas o exóticas. Obviamente, especialmente aquellos que no están implementados (aún) y/o probados adecuadamente. Todo el código y la documentación de este repositorio se proporcionan tal cual. De ninguna manera soy un experto en todos los idiomas proporcionados. El objetivo es al menos ofrecer un código que funcione, lo cual es un estándar muy bajo, pero desafortunadamente no es infrecuente. Escribir sobre programación versus ingeniería de software puede llenar las estanterías. No vayamos allí ahora. Con suerte, la calidad del código aumentará con el tiempo si personas expertas en un determinado idioma participan y mejoran el código. La mayor parte del código se prueba en Linux únicamente a menos que se indique lo contrario. Para mejorar la madurez y la claridad sobre este tema, se han agregado tablas de resultados de las pruebas.