Index

26 de junio de 2014

Aptana. Un IDE para desarrollo web

Hace unos meses escribía en el blog que estaba buscando un IDE para desarrollo web el cliente. Al final no me he dedicado tanto a web-cliente como pensaba y he estado jugando más en la parte de backend sobre todo con nodejs.

Dado que es el primer IDE (para web) que pruebo y tampoco tengo gran experiencia en desarrollo web me resulta difícil hacer una buena revisión, pero aquí van algunos pros y contras de programar Javascript en Aptana desde el punto de vista de alguien que viene de Java+Eclipse.

Contras

* El debugger de Apata es incompatible con la última versión de firebug por lo que debes instalar una más antigua. Tuve unos cuantos problemas intentando instalarlo y no he sido capaz de hacer un cambio en el código y recargar la página sin tener que relanzar todo firefox a través del debugger. En resumen el debugger no he sido capaz de hacerlo funcionar de una forma cómoda y he vuelto a firebug.
* El preview de la página cuando está puesto el código del google analytics hace que se cierre aptana.
* Para que el Code Assist funcione correctamente, hay que tener unos ficheros de documentación en un formato especial (ScriptDoc), y practicamente ninguna librería los tiene.
* En el «Save Action» sólo se pueden quitar los trailing spaces, estaría bien que permitiera al menos reformatear el código
* No es capaz de navegar por ocurrencias correctamente. Si marco una variable no soy capaz de moverme entre las apariciones de esa variable (Ctrl + .) como en java. Tampoco es capaz de encontrar desde donde se llama a una función (aunque este es un problema genérico de los lenguajes dinámicos). Aquí hay un listado de funcionalidades aunque no está del todo actualizado. No he probado a documentar las funciones con ScriptDoc, tal vez así el editor sea más inteligente.
* La documentación es escasa
* Así como cuando programo en Java todo el equipo usa Eclipse, con web no pasa lo mismo. Así que la idea de tener que crear workspaces y proyectos dentro del workspace llenos de directorios de configuración ocultos me resulta conceptualmente incómodo.

Pros

* Me gusta la consola interactiva. Puedo probar código sin tener que abrir la consola javascript del navegador.
* Me gusta el Content Assist de html, creo que funciona bastante bien.
* Al margen del problema con el debugger, me gusta la funcionalidad de preview ( https://wiki.appcelerator.org/display/tis/Side-by-Side+Previewing ). Me permite poner en dos pestañas paralelas mi código (html, css, js) y el navegador empotrado de aptana, al salvar uno de los ficheros la previsualización se recarga automáticamente. Está bien para ir viendo como queda. Una pena que no haya encontrado forma de debuguear desde el preview.
* Me gusta el «Go To Declaration (F3)», aunque se equivoca de vez en cuando, si por ejemplo has estado haciendo pruebas en otro fichero, poniéndolo a las funciones el mismo nombre puede saltar a la que no es.
* Me gusta la buena integración (heredada de eclipse) con el escritorio. Poder copiar un fichero en el explorador de archivos y pegarlo en una vista de aptana, o copiar un snippet de código de una página web y pegarlo en Aptana creando automáticamente un nuevo fichero
* El sistema de templates para no arrancar proyectos como una página en blanco funciona bien.
* Es relativamente fácil, extender la funcionalidad a través de Snippets y Rubles. Aunque los Rubles hay que escribirlos en Ruby

Enlaces de interés sobre aptana

* Una revisión genérica de Aptana.
* Documentación sobre html, css, y javascript

Conclusiones

Me da la impresión de que la mayoría de opiniones favorables vienen de gente que lo uso en su día cuando no había opciones libres/gratuitas mejores. Además da la impresión de que el proyecto está muerto desde que lo compró Appcelerator.

Creo que el caso de uso más favorable para Aptana es que ya estés usando el IDE en el backend (ruby, php, python) y sólo toques ocasionalmente el cliente por lo que no te merece cambiar de entorno.

4 de mayo de 2014

Memrise, una plataforma para memorización

Llevo un tiempo haciendo algunos cursos en memrise.com. Una página que dice usar los últimos descubrimientos científicos para mejorar la forma en la que aprendemos:

Memrise is based on several important scientific discoveries about how we learn. First, our system of mems (mnemonics and memory aids) promotes elaborate encoding- encouraging the learning brain to do more by engaging the imagination, and thus helping lay down stronger, more durable memories.

Secondly, Memrise makes use of Spaced Repetition, helping you review items at expertly spaced intervals to help you maintain them in memory in the most efficient manner possible. Reminders space out in time as your knowledge for an item gets deeper, meaning you don’t forget, but don’t waste time reviewing what you already know.

Third, Memrise systematically exploits the Testing Effect, which shows that by actively recalling a memory, you strengthen it. Because the degree of strengthening to a memory correlates with the difficulty of the test, Memrise automatically makes the tests more difficult over time, again helping you boost your learning in the best way possible.

Tiene cursos de todo tipo y en bastantes idiomas distintos, pero al contrario de lo que dice en la página no está enfocada hacia el aprendizaje si no hacia la memorización. Digamos que con este sistema no vas a aprender inglés, ni química, ni a desarrollar pensamiento espacial, pero aprenderás nuevo vocabulario, la tabla periódica o las capitales del mundo.

Lo que menos me gusta de Memrise es la calidad irregular de los cursos. Son los propios usuarios los que los crean por lo que hay de todo, y es difícil saber a priori cual está bien y cual está mal. La forma en que son ordenados en la web no coincide con mis criterios. Los comentarios que dejé en algún curso comentando errores nunca fueron respondidos, …

Los cursos que más me han gustado son:

* Administración territorial de españa. Es el único de geografía que he visto que incluye mapas en el proceso de memorización. Al contrario que la mayoría que son sólo una ristra de textos tipo país – capital, este muestra un pequeño mapa de ubicación como elemento principal de la memorización.
* Curso completo de inglés. Este me ha gustado porque se limita al apredizaje de vocabulario o frases sencillas sin dobles traducciones. Además todas las palabras incluyen un audio de pronunciación, y aparece un ejemplo de uso en una frase.

En resumen, la página tiene posibilidades como demuestran los dos cursos que he citado pero la calidad de los cursos por ahora es regular. Es una pena por ejemplo que no se pudiera «copiar» un curso, modificarlo y republicarlo mejorado. Si publicaran el código de la página o hicieran una especie de github de cursos con forks y pull-request creo que tendría muchas más posibilidades.

Por ahora el único éxito que le veo, es quien quiera pasarse 10′ al día en la página en lugar de en el facebook, o profesores con un poquito de innovación en la sangre que se curren cursos en la plataforma como complemento para sus clases.

30 de abril de 2014

Trabajar con Word (docx) y Excel (xls y xlsx) desde Java

Iconos Word y Excel de MS Office En Cartolab hemos trabajado ultimamente en procesar y generar documentos de Excel (xls y xlsx) y de Word (docx) desde Java. Tras probar algunas librerías open source las que estamos usando son:

Apache POI Spreadsheet para hojas de cálculo de Excel. Es fácil de usar y funciona bien tanto para los formatos binarios antiguos de xls (Excel 97-2007) como para xlsx (Excel 2007 OOXML). El How-To y la Quick Guide de la web son suficientes para empezar a escribir código.

Docx4j para documentos docx (OpenXML de Word 2007). La mejor forma de usarla es crear un documento vacio o con las cabeceras y pies de página desde Word o LibreOffice y definir en él los estilos. Desde nuestro código abrimos el documento y vamos añadiendo nuevos párrafos u otros elementos asignándole los estilos que hemos definido mediante el método addStyledParagraphOfText(styleID, text);. El styleID lo obtendremos consultado el fichero styles.xml que está comprimido dentro del docx. Si tenemos que hacer cosas más elaboradas el código se complica bastante pero al menos permite hacerlas. Para arrancar puedes leer como substituir placeholders por tu propio contenido, este otro artículo un poco más general y los ejemplos de código que vienen con la librería.

Para trabajar con documentos .doc de Word también probamos con Apache POI pero es complicado de usar y el resultado no es demasiado bueno. Así que por ahora no tenemos una alternativa válida para este formato.

En algún otro momento también hicimos pruebas con:

JasperReports que está muy bien para generar pdf pero el odt y el word lo saca maquetado en forma de tablas por lo que no nos valía.
iText. Que en versiones antiguas de la librería permitía sacar los resultados en rtf y era sencilla de emplear. Pero las últimas versiones se ha creado una nueva librería que no hemos probado todavía.

En esta pregunta de StackOverflow dan más alternativas. ¿Alguien usa otras librerías, preferiblemente open source y gratuitas, distintas a estas?

5 de abril de 2014

Serie: Los Soprano

La casualidad hizo que empezara a ver Los Soprano el día anterior a la muerte de Gandolfini.

Es difícil (si no imposible) aportar algo sobre la serie que no haya sido contado ya. Y mucho menos sobre ese famoso final del que se han escrito sesudos ensayos (contiene spoilers).

Yo empecé a verla con ánimo crítico, me la comparaban con The Wire y eso eran palabras mayores. No cometas ese error. Son series distintas y no tienen nada que ver. Y cada una es muy grande a su modo. Si tuviera que escoger una me seguiría quedando con The Wire, por lo que me aporta como contexto, pero Los Soprano, con Gandolfini a la cabeza es inolvidable e increiblemente entretenida.

No te la pierdas (en idioma original).

30 de marzo de 2014

Organizar los ficheros de routes en nodejs – expressjs

Una de las tecnologías que estamos probando en Cartolab para aplicaciones web es nodejs con express como framework. Hay un montón de tutoriales de como empezar a usarlos, pero a poco que escribas empiezas a preguntarte como organizar el código, y ahí empiezan los problemas. express es un framework no opinativo, es decir proporciona un montón de utilidades pero da liberar total al usuario sobre como mezclarlas, así que se van desarrollando distintos modos de hacerlo.

La primera pregunta en mi casa sobre organizar el código fue acerca de los ficheros bajo el directorio routes. Podemos entender las routes de express como el equivalente al controlador en ese patrón llamado MVC que cada framework implementa como quiere, o viéndolo de otro modo como el mapeo entre una url y una función.

Vamos a ver cuatro estrategias distintas, cada una con sus ventajas e incovenientes.

Todo en app.js

La versión que se suele emplear en los tutoriales de iniciación. Escribimos en un único fichero todo el código de la aplicación.

Poco código boilerplate
Añadir una nueva url implica tocar un sólo fichero
Nada reusable
Sólo válido para proyectos pequeños

Es tan sencillo como escribir el mapeo antes de crear el servidor y usar funciones anónimas para la lógica

 app.get('/', function(){res.send('root page'}); 

Mapear en app y la lógica en ficheros distintos

Este es el segundo ejemplo más habitual. Las url se definen en el fichero principal y las funcionalidades se agrupan en distintos ficheros bajo el directorio routes.

Añadir una nueva url implica tocar como mínimo dos ficheros
Favorece la reutilización, pero siempre debemos colocar las url a mano
Implica escribir más código que en el anterior y perder legibilidad

A pesar de que es muy habitual ver esto no me gusta porque no ganamos demasiado, y tener que hacer cambios en dos ficheros acaba introduciendo errores.

 // app.js var routes = require('./routes'); // Coje el fichero ./routes/index.js por defecto var user = require('./routes/user');

app.get('/', routes.index);
app.get('/users', user.list);

 // routes/user.js exports.list = function(req, res){ res.send("respond with a resource"); }; 

 // routes/index.js exports.index = function(req, res){ res.send("root page"); }; 

Hacer el objeto app global y derivar todo hacia los ficheros de routes

Evitamos declarar app como variable local, para poder usarla en el resto de ficheros sin tener que preocuparnos de pasar parámetros. El código queda muy limpio pero se dificulta el testing y se pueden introducir bugs difíciles de detectar.

A mi me gusta esta aproximación cuando tenemos poco código y queremos hacer algo rápido, pero hay que ser consciente de los problemas que tiene.

No es una muy buena práctica hacer app global, en el siguiente punto vemos una mejora. Pero al hacerlo así obtenemos código más legible
Es bastante modular (excepto por hacer app global)
Es bastante legible
Hay separación de conceptos, cada fichero se encarga de unas determinadas url y funcionalidades

Referencias

Veamos como quedaría la implementación

 // app.js app = express(); //IMPORTANT! define the global app variable prior to requiring routes! require('./routes'); 

 // routes/index.js require('./main'); require('./users'); 

 // routes/main.js app.get('/', function(req, res) { res.send("root page"); }); 

 // routes/users.js. list() could be an anonymous function, this is only for showing it in another way.

function list(req, res) {
res.send("user list");
};

app.get("/users", list);

Inyectar app en los ficheros de routes

Es similar al ejemplo anterior, pero el objeto principal es inyectado en los controladores en lugar de usarlo como una variable global. Sacrificamos un poco de legibilidad (hay que meter bastante código «inútil») pero a cambio ganamos en modularidad y testabilidad.

Veamos una posible implementación, teniendo en cuenta que este código no lo he visto en ningún sitio, lo he escrito a partir del artículo de dailyjs y podría tener algún otro problema.

A mi esta es la aproximación que más me gusta, cuando el código aumenta y no nos queremos ir a soluciones más complicadas.

 // app.js var app = express(); // ... app.use(express.json()); require('./routes')(app); // Must be called after app.use(express.json()) and urlencoded; 

 // routes/index.js module.exports = function(app) { require('./main')(app); require('./users')(app); }; 

 // routes/main.js module.exports = function(app) { function index(req, res) { res.send("root page"); }; app.get('/', index); }; 

Otras estrategias

Hay estrategias más complejas, que por ahora no me ha hecho falta probar.