PlasticSCM: Agregando un proyecto FoxPro 9 al control de código fuente

Por: Fernando D. Bozzo

Es muy probable que tengamos proyectos que no están bajo control de código con un SCM, tanto porque sean antiguos proyectos, como porque consideramos que no ameritaban estar controlados o simplemente porque recién se está comenzando en este mundo del control de código.

Por el motivo que sea, tenemos uno o varios proyectos que queremos controlar con el SCM, así que vamos a ver un ejemplo de los pasos y configuraciones desde cero para hacerlo, asumiendo que que ya tenemos Plastic instalado y configurado.

Para el ejemplo voy a usar el proyecto FoxUnit, que es uno de los proyectos Open Source de VFPX en CodePlex para hacer Unit Testing (testing automatizado de código) que suelo usar frecuentemente, y que lo tengo en el directorio c:\desa\FoxUnit:

Como se puede observar en la captura anterior, hay archivos temporales, restos de pruebas y los archivos nos están normalizados (capitalizados), por lo tanto el primer paso es hacer esa normalización, usando click-derecho en el nombre del directorio de FoxUnit, y eligiendo la opción "Enviar a" y luego "Normalize_FileNames.vbs", que es uno de los scripts incluidos en las herramientas FoxPro 9 para Plastic.

Una vez ejecutado, los archivos quedan así:

Ahora que tenemos los archivos normalizados, vamos a crear un repositorio llamado FoxUnit, con un workspace llamado igual, ya que tanto el directorio como el proyecto ya se llaman así. La creación del repositorio y workspace ya los expliqué en el artículo de Instalación de Plastic, la única diferencia es que si Plastic ya está instalado y se quiere crear un nuevo repositorio y workspace (en ese orden), se deben seleccionar las opciones del pabel izquierdo, dentro de "Repositorios & Workspaces"

Hay dos archivos de configuración para Plastic que se deben crear en todos los proyectos que se quieran controlar, y que son "filetypes.conf" e "ignore.conf"

El archivo de configuración filetypes.conf

El archivo "filetypes.conf" sirve para indicarle a Plastic el tipo (texto/binario) de ciertos archivos que por no ser estándares pueden ser reconocidos incorrectamente. Por ejemplo, todas las extensiones texto de FoxBin2Prg, el config.fpw de FoxPro y algunas otras, por defecto se suelen reconocer como binarios. El tipo de archivo se puede ver en las vistas de Items y Cambios Pendientes, en la columna "tipo".

Para FoxPro, el filetypes.conf suele tener este contenido:

# PlasticSCM custom file types.
# Syntax: <extension>:<type>
# Type can be 'txt' or 'bin'.
# Examples:
#     .cpp:txt
#     .jpg:bin
.cfg_:txt
.cfg:txt
.fpw:txt
.prg:txt
.pj2:txt
.vc2:txt
.sc2:txt
.fr2:txt
.lb2:txt
.db2:txt
.dc2:txt
.mn2:txt

Este archivo puede estar a nivel de repositorio o a nivel del sistema. Si está a nivel de repositorio, se debe poner en la raíz del workspace, y si es a nivel del sistema, suele estar en el directorio <PerfilDelUsuario>\Configuración local\Plastic5
Si se pone a nivel del repositorio (lo recomendable), también es útil ponerlo dentro del control de código, para que los desarrolladores que se unan al proyecto tengan automáticamente la misma configuración y así no deben volver a hacerla cada vez.

El archivo de configuración ignore.conf

El archivo "ignore.conf" le indica a Plastic qué archivos no queremos ver en las vistas de Items y Cambios Pendientes. Es un filtro visual, y al igual que el filetypes.conf, puede estar a nivel de repositorio o de sistema, y en las mismas ubicaciones ya comentadas.


Para FoxPro, el ignore.conf suele tener este contenido:

*.FXP
*.LNK
!/_iniciar aqui.lnk
*.SCC
*.TMP
*.BAK
*.ZIP
*.7Z
*/FXUResults.*
*/FXUPersist*.*
.plastic
.git

Es importante conocer su sintaxis, ya que permite hacer cosas muy útiles como ocultar ciertas extensiones pero mostrarlas en un directorio particular. La sintaxis permite indicar:

• Una extensión (ej: .fxp)
• Un archivo (ej: foxuser.dbf)
• Un archivo en una ruta específica relativa a la raíz del workspace (ej: /forms/unarchivo.xml)
• Un directorio (ej: .git)
• Una negación de las reglas generales que se aplicarán a un archivo en una ruta específica (ej: !/_Iniciar aqui.lnk)

Importante: Notar que las barras de directorio no son las de Windows (\), sino el símbolo dividido (/)

Este archivo también se puede actualizar desde la GUI de Plastic, en la vista de Items y de Cambios Pendientes, haciendo click-derecho sobre un archivo y eligiendo "Añadir a la lista de cambios ocultos" donde se mostrarán 3 opciones:

• archivo.ext
• .ext
• /ruta_absoluta/archivo.ext

Agregar el proyecto FoxPro a control de código

Al fin, ya tenemos todo preparado, configurado y normalizado para agregar el proyecto, por lo que regeneramos las vistas de texto, regeneramos los binarios, agregamos el README.txt y posteriormente agregamos todos los archivos relevantes, es decir, todos menos los archivos temporales o archivos de pruebas que no formen parte del proyecto:



Generación de los archivos de texto (tx2):

Agregado del README.txt:

Checkin del README.txt con un comentario:

El Explorador de ramas muestra el segundo changeset (el primero siempre es vacío):

Agregado el control de código de los archivos del proyecto y los tx2 generados:

Comentario de checkin y checkin final:

El Explorador de ramas muestra el tercer changeset (al anterior es el README.txt y el primero siempre es vacío):

Y ya está. A partir de aquí es crear ramas para comenzar a trabajar en ellas.


Hasta la próxima! =)

FoxPro 9 y PlasticSCM: Como deshacer un changeset sin borrarlo

Por: Fernando D. Bozzo

Hay ocasiones en las que necesitamos deshacer un changeset porque algo salió mal, y en esta situación tenemos 2 alternativas:

1) Borrar el changeset
2) Hacer un merge substractivo

Si bien en ambos casos podemos alcanzar el mismo objetivo, hay motivos para no eliminar un changeset y en su lugar hacer un merge substractivo:

• Si nuestro repositorio está sincronizado con un repositorio externo como GitHub, BitBucket u otro y el changeset que queremos deshacer ya está sincronizado, no podemos borrarlo, porque en cuanto sincronicemos nuevamente se volverá a restablecer como estaba
• Si el changeset que queremos deshacer no es el último, sino uno intermedio, puede ser contraproductivo tener que deshacer todos los changesets posteriores solo por este, además en esos changesets posteriores podría haber muchos cambios bien hechos y por ahi solo queremos deshacer una sola operación o cambio de archivo que se realizó en el changeset en cuestión
• Si queremos preservar el historial de todo lo hecho y en algún caso queremos volver a realizar los cambios que ahora vamos a deshacer
• Si el changeset lo queremos deshacer solo temporalmente, porque contiene un cambio sin terminar y haya que entregar una versión del software sin el mismo

Estos y otros motivos, son suficientes para hacer un merge substractivo.

¿Cómo se hace esto?

Muy fácil, se seleccionan dos changesets con el ratón (click en el changeset de la izquierda, y luego ctrl+click en el changeset de la derecha), luego un click-derecho en cualquiera de los dos changesets y se verán solo dos opciones:

- Merge Avanzado
- Mostrar diferencias entre changesets seleccionados

Con "Mostrar diferencias" podemos ver cuál es la situación que se deshará. Si hay archivos eliminados, entonces se mostrarán, y si hay cambios hechos, también.

Con "Merge Avanzado" se abre un segundo menú donde una se las opciones es "Merge substractivo", se elige esta opción y luego se elige "Procesar merges":

Como se observa, lo que antes se mostraba como eliminado, ahora se volverá a agregar. Una vez procesado el merge estos cambios pasarán a ser Cambios Pendientes todavía sin confirmar, que en el Explorador de ramas se verá así:

El último paso, es comprobar visualmente en la vista de Cambios Pendientes de que es todo correcto, y confirmar los cambios haciendo checkin.

Nota:
En esta misma pantalla conviene confirmar si los tipos de archivo están siendo bien reconocidos por Plastic, como por ejemplo los archivos sc2, vc2, pj2, etc, que genera FoxBin2Prg (en este caso los 4 marcados), ya que podrían estar incorrectamente identificados como "bin" en vez de "txt". En el caso de haber archivos mal identificados, aquí podemos arreglarlo, haciendo click-derecho sobre el archivo de texto, eligiendo "Cambiar tipo de revisión" y luego "texto" (o binario, según corresponda), y luego sí procedemos al checkin. Esto mismo se puede hacer en la ventana de items.

Así se ve el merge substractivo una vez hecho el checkin:

Dejo aquí un video corto con el ejemplo completo.
http://youtu.be/G8QhIsPnQrQ


Hasta la próxima!

Nueva versión v1.19.16 de FoxBin2Prg (arreglos)

Por: Fernando D. Bozzo

Está liberada la versión v.1.19.16 de FoxBin2Prg con los siguientes cambios:

• Arreglo bug vcx/scx: las propiedades pierden la visibilidad hidden/protected cuando no tienen valor asignado (Ryan Harris). Afecta a los binarios que tengan definidas propiedades así.
• Arreglo bug vcx/scx: valor character con longitud >255 en propiedad de addobject, se regenera con tag <fb2p_value> incluido (Ryan Harris). Difícilmente se encuentren propiedades con esta longitud de valor asignado en tiempo de diseño, pero si las hay, se estaban restaurando con un tag <fb2p_value> incluido como parte del valor. Afecta a los binarios que tengan definidas propiedades así.
• Arreglo bug vcx/scx: Al regenerar binario con procedimiento vacío hace que se cuelgue FoxPro al intentar modificar
• Arreglo bug scx/vcx: Si la clase tiene un comentario multilínea, el binario generado se puede corromper (Tested on: Ffc\_frxcursor.vcx). Otra rareza encontrada en uno de los archivos de las FCC que vienen con Fox, una librería con una clase cuyo comentario es multilínea (tiene un pedazo de documentación pegado dentro!). Afecta a los archivos tx2 generados, y a los binarios regenerados desde éstos.
• Arreglo bug: Si _memberdata contiene CR entre sus valores, esos valores pueden perderse al regenerar el tx2. Caso encontrado en un par de librerías de las FFC que vienen con Fox. Afecta a los archivos tx2 generados, y a los binarios regenerados desde éstos.
• Arreglo bug: Los valores de las propiedades con espacios a la derecha pierden esos espacios Caso encontrado en un par de librerías de las FFC que vienen con Fox. Afecta a los archivos tx2 generados, y a los binarios regenerados desde éstos.
• Arreglo de bug: cuando 2 o más métodos contienen el mismo nombre (ej: met y met2) se genera mal el tx2 (Ryan Harris). Afecta a librerías o forms que usen nombres de métodos contenidos dentro de otros nombres, por ejemplo, "mimetodo" esta contenido dentro de "mimetodo1" y dentro de "mimetodo2". Afecta a los archivos tx2 generados, y a los binarios regenerados desde éstos.

Como actualizar el FoxBin2Prg existente:
Con descargar el zip y reemplazar los archivos en el sitio que los hayan puesto antes es suficiente.


Link  de descarga:
https://vfpx.codeplex.com/releases/view/116407


 Saludos!

Nueva versión v2.4.10 de las herramientas FoxPro 9 para PlasticSCM

Por: Fernando D. Bozzo

Está liberada la versión v2.4.10 de las herramientas Visual FoxPro 9 para PlasticSCM, con los siguientes cambios:

- Actualizada la versión de FoxBin2Prg a la versión v1.19.16


Estas herramientas son un grupo de scripts vbs y programas Visual FoxPro 9 que se configuran dentro de PlasticSCM para poder invocar a FoxBin2Prg (incluye solo el EXE) desde dentro de la interfaz de Plastic.
El README.txt explica como se configura en Inglés y Español.


Como actualizar las existentes:
Con descargarlas y reemplazar los archivos en el sitio que los hayan puesto antes es suficiente.


Link de descarga:
https://github.com/fdbozzo/foxpro_plastic_diff_merge


Saludos!

FoxPro 9: Modificando un componente que ya está bajo control de código

Por: Fernando D. Bozzo

En esta nota ya partimos de la base de un componente que ya está bajo control de código, y que lo queremos modificar y subir nuevamente (proteger)

Los pasos son los siguientes:

1) Hacemos los cambios necesarios en nuestro form y lo cerramos


2) CLEAR ALL / CLOSE ALL en la ventana de comandos


3) Vamos a la vista de Cambios Pendientes en Plastic y la refrescamos

4) Seleccionamos cualquier archivo (no directorio), click-derecho y seleccionamos:
> Abrir / Abrir con (VFP) Cambios Pendientes: Regenerar versiones Texto


5) Se mostrará un mensaje de confirmación y se refrescará la vista automáticamente:

6) Ponemos un comentario describiendo lo hecho (es importante!) y hacemos Checkin de los cambios.
 Ojo: Prestar atención a lista de cambios que se muestra siempre, ya que indica qué se agregará, qué se modificará y qué se borrará.

Ups! Me da error!

Si al intentar realizar la conversión a texto o a binario sale el mensaje "Error 1705, Denegado el acceso al archivo", es porque el componente está abierto o fue modificado y no se hizo el CLEAR ALL / CLOSE ALL correspondiente:

Así que la solución es fácil: Se repite desde el punto 2 antes comentado.



¿A que es fácil? ;-)


Nota: Aunque el ejemplo comentado fue sobre un form, esta misma operativa se aplica al resto de binarios: clases, reportes, menus, el proyecto pjx, etc.


También puede interesarte:
PlasticSCM: Hice un checkin erróneo de un archivo nuevo ¿cómo lo arreglo?

FoxPro 9: Creando un componente y añadiéndolo al control de código PlasticSCM

[Esta nota fue extraída desde la nota sobre ramas, para mantenerla por separado]

Por: Fernando D. Bozzo

Todos sabemos crear un form, pero para agregarlo al control de código tenemos que hacerlo con cuidado y siguiendo unas sencillas reglas para evitar que el SCM nos dé problemas luego.

1) Se crea el form en una sesión de FoxPro dentro del directorio elegido para el espacio de trabajo:

MODIFY FORM forms\frm_test1

2) Se programa dentro del mismo lo que haga falta y al terminar se graba, cierra y CLEAR ALL (siempre!)

3) Se abre la GUI de Plastic y se va al vista de Items, seleccionando la opción Items del panel izquierdo, se pulsa el icono para refrescar la lista de archivos, se ubica el form (el scx, no el sct!) y con click-derecho sobre el mismo se elige "abrir / Abrir con FoxBin2Prg", lo que genera la vista texto y ajusta la capitalización de los binarios origen (SCX/SCT => scx/sct):

(NOTA: El punto 4 fue quitado porque ya no es necesario)

¿Porqué importa el ajuste de la capitalización de los archivos?

Tener la capitalización bien ajustada es fundamental para que luego no haya problemas con GitHub o que incluso el mismo Plastic los tome como archivos distintos.


Para quienes solo hayan trabajado con Windows, esto es raro, pero en otros sistemas operativos (Linux, Unix, Mac...) el mismo nombre con distintas capitalizaciones de mayúsculas/minúsculas lo trata como archivos distintos y por lo tanto se muestran ambos!, cosa que Windows no puede.

Nota: Una posible mejora en FoxBin2Prg para evitar el paso de regenerar el binario siempre, como el paso anterior, sería que haga un ajuste automático de capitalización de los archivos origen y no solo de los archivos destino, lo que dejaría todo el proceso en un solo paso.


5) Ahora que el archivo está normalizado (vean la capitalización en la captura de abajo), ya se puede agregar al control de código fuente, cosa que se hace una sola vez. Observen que la columna Estado muestra "Privado" para estos archivos nuevos. Esto es porque esos archivos todavía no están controlados por Plastic.

Prestar especial atención a los dos pasos anteriores de generación de texto y luego binario, porque si esto no se hace correctamente, luego puede pasar que se suba al SCM un archivo a medias o que no coincida con la versión texto, o que directamente no la tenga o que esté mal capitalizado, lo que es muy probable que pueda dar algún error al sincronizar con GiHub (solo si se configuró esta sincronización, que normalmente no es requerida), y no olvidarse del archivo del proyecto (PJX) que también debe convertirse!

En la imagen de arriba pueden observar que los archivos que agrego el control de código son los del formularios más la versión texto generada antes, y que los tres están correctamente capitalizados.


6) Finalmente, nos cambiamos a la vista de "Cambios Pendientes" (en el panel izquierdo), escribimos un comentario descriptivo de lo que hicimos, confirmamos visualmente (o sea, miramos) que los archivos que vamos a subir son los que deben ser (o sea, que no sean un .BAK u otra cosa), también verificamos si en la lista figura que se van a eliminar archivos (por las dudas) y si nos parece que todo está bien, pulsamos el botón Checkin.

Observen como los archivos tienen Estado "Añadido":

Felicitaciones! Han hecho su primer Checkin en Plastic! :-)


También puede interesarte:

FoxPro 9: Modificando un componente que ya está bajo control de código

PlasticSCM: Hice un checkin erróneo de un archivo nuevo ¿cómo lo arreglo?

PlasticSCM: Hice un checkin erróneo de un archivo nuevo ¿cómo lo arreglo?

Por: Fernando D. Bozzo

A todos nos puede pasar que estamos trabajando en algo, y en un momento dado queremos proteger los cambios, entonces vamos al SCM, elegimos los archivos y hacemos checkin.... pero luego nos damos cuenta de que cometimos un error, ¿cómo lo arreglamos?

   Si el error detectado es de capitalización de un archivo recién agregado, pero al cual todavía no hicimos checkin, es muy fácil: Ir a la ventana de Cambios Pendientes y seleccionar el botón "Deshacer cambios". Problema resuelto, se soluciona el problema de capitalización haciendo la conversión texto/binario que ya comenté en el punto 3 y 4 de la otra nota, y se repite el proceso de agregar el archivo.

   Si el error detectado es de capitalización de un archivo agregado y que además se le hizo checkin, entonces habrá que hacer una copia del mismo (en un zip por ejemplo) y eliminar el último changeset creado, así:


1) Seleccionamos el changeset anterior con click-derecho:

2) Elegimos la opción "Apuntar workspace a este changeset":

2.b) ¿Muestra un error?: Si les muestra un error como el de la imagen, pueden elegir entre las opciones que ven en la imagen, y que ahí mismo están explicadas:

3) Hacemos click-derecho en el changeset a borrar (siempre es el último) y elegimos "Borrar changeset":

4) Y listo, el changeset fue borrado y el nuevo changeset actual es el anterior:

5) Finalmente, como se ha borrado un changeset que en este caso consistía en archivos agregados al SCM, esto implica que Plastic los borrará del directorio de trabajo, y por eso hicimos el ZIP en un paso anterior. Simplemente se vuelven a descomprimir los archivos, se procesan con FoxBin2Prg (solo si son binarios Fox) pasándolos a texto y binario nuevamente, se comprueba la capitalización y se vuelven a agregar al control de código.


Esto también se puede hacer cuando se protege un cambio que no se quiere guardar, pero lo ideal es solo hacer el checkin cuando se tiene certeza de que lo que se sube es correcto.


Video de ejemplo:

FoxPro 9: Deshacer Merge de 2 ramas en PlasticSCM




Importante:
Para evitar estos inconvenientes, es mejor verificar visualmente la capitalización de los archivos justo antes de que se vayan a proteger, y no olvidar que cualquier form, clase, etc, que se haya modificado, se debe pasar primero a texto y luego del texto se debe pasar a binario otra vez, ya que en estos pasos también se hace el ajuste de la capitalización.

Otra cosa a estar atento es no subir cualquier archivo, es decir, el control de código fuente (SCM) es justamente para eso, para controlar los archivos de programa que hacemos, y no para proteger los archivos temporales (tmp) o los backup (bkp) u otro tipo de archivos que no tienen nada que ver con nuestro desarrollo.

Incluso es conveniente guardar la versión texto de las tablas (archivos DB2) y bases de datos (archivos DC2) generados con FoxBin2Prg, pero no guardar las tablas con datos, porque si no el espacio destinado para el código se agotaría bastante rápido. Recordar que todo esto se guarda en una base de datos de Plastic que se puede elegir entre la que viene por defecto  y que sirve para pequeños desarrollos o desarrollos personales (SQL Server CE - 4 GB por repositorio/proyecto), u otras bases de datos más potentes como SQL Server full, MySQL, Oracle u otras.


Nota Relacionada:
FoxPro 9 y PlasticSCM: Como deshacer un changeset sin borrarlo