FTP | CCD | Buscar | Trucos | Trabajo | Foros |
|
#1
|
||||
|
||||
Gran trabajo, ¡ Felicitaciones !
Un abrazo
__________________
Daniel Didriksen Guía de estilo - Uso de las etiquetas - La otra guía de estilo .... |
#2
|
||||
|
||||
Amigo Al.
Gracias por compartir tu trabajo.
__________________
Be water my friend. |
#3
|
||||
|
||||
Hola a todos,
¡Me uno a las felicitaciones Al! |
#4
|
||||
|
||||
Muchas gracias Al por compartir tu conocimiento y estas librerías con todos nosotros.
__________________
Buena caza y buen remar... http://mivaler.blogspot.com |
#6
|
||||
|
||||
Hola nuevamente Al
Estuve explorando un poco el codigo, pero aun no he puesto en marcha ninguna prueba Solamente tengo un par de comentarios para hacerte: - Me alegra que uses identificadores calificados. A mi tambien me gusta hacerlo y creo que crear bibliotecas publicas es una buena forma de impulsar al resto a que haga lo mismo. Solamente hay una pequeña diferencia en como lo hago yo; yo prefiero seguir la convencion que esta adoptando poco a poco Firemonkey, en la cual, el prefijo para los elementos del tipo enumerado ya no se usa Por ejemplo, de GHF.Sys, linea 528
Esto nos lleva a escribir codigo asi:
Yo creo que el prefijo que historicamente se uso en Delphi (pensando tambien en TAlignLayout --> alClient, alTop, etc) no es necesario si se usan identificadores calificados y "ensucia" el codigo fuente. Otro detalle que creo que es importante, veo que en tus unidades siempre activas la directiva de compilacion SCOPEDENUMS Ahora me entro la curiosidad, pero yo creo que lo mas seguro es compilar nuestros tipos enumerados con la directiva y luego volver a ponerla a OFF que es su valor por defecto. Es decir, asi es como yo declaro los tipos enumerados: Código PHP:
- Otra recomendacion es el uso de regiones para hacer el codigo mas legible. Las regiones te permiten [plegar?] porciones del codigo y denotarla con un nombre, para hacer mas facil la navegacion dentro de la unidad. Es mas largo hacer scroll en una unidad larga como por ejemplo las GHF.Sys y GH.SysEx. Tambien creo que es una buena idea usar una region para la licencia, que ocupa su buena porcion de espacio - El ultimo punto es el uso de la documentacion XML. Esta es una de las ultimas practicas que he adoptado, y ya me he acostumbrado. Consiste en documentar el codigo de forma tal que pueda ser util al momento de que el usuario use tu biblioteca, y no tenga que tener un manual de referencia para consultar. Esta documentacion XML se adjunta en la ventana que aparece cuando Delphi nos muestra cuales y que tipo de parametros recibe un metodo, el retorno de una funcion, etc Si hoy escribo alguna clase, metodo, funcion, tipo, lo que sea, sin incluir la documentacion XML, me siento mal conmigo mismo (es similar a tu comentario cuando hablamos de esto). De hecho en muchas ocasiones me ha pasado que es dificil explicar que es lo que deberia hacer el metodo en cuestion, y es cuando detecto un error de diseño que debe ser refactorizado incluso antes de escribir codigo; tambien existe el caso de que no se me ocurre como escribir el codigo, pero al escribir la documentacion luego se hace mas facil la implementacion El efecto logrado es el siguiente: Código PHP:
Las ultimas vesiones de Delphi, en sus bibliotecas mas nuevas, escriben esta documentacion en linea y me ha ayudado mucho, por ejemplo la unidad REST.Json Código PHP:
Última edición por Al González fecha: 20-11-2016 a las 20:29:23. Razón: Arreglar enlace |
#7
|
|||||
|
|||||
Cita:
Cita:
Cita:
Cita:
Cierto, lo haré también. Cita:
Última edición por Al González fecha: 20-11-2016 a las 20:28:37. |
#8
|
||||
|
||||
Hola Agustín. Me da mucho gusto notar el gran interés que muestras.
Intentaré responder a todas tus inquietudes, comenzando por esta: Cita:
Saludos. Al González. |
|
|
Temas Similares | ||||
Tema | Autor | Foro | Respuestas | Último mensaje |
Casi llegó a 14000 | ecfisa | La Taberna | 30 | 21-12-2011 21:39:55 |
Epa Epa!!! adivinen quien llegó a los 13K ? | ecfisa | La Taberna | 31 | 29-09-2011 16:01:56 |
Ya llegó a España. | marcoszorrilla | La Taberna | 1 | 25-11-2007 23:02:13 |
Al fin llego a los 1000! | D-MO | La Taberna | 9 | 01-08-2007 20:41:20 |
Llegó, llegó | roman | Noticias | 6 | 11-12-2004 11:12:29 |
|