http://blog.taniquetil.com.ar/esContents © 2023 <a href="mailto:facundo@taniquetil.com.ar">Facundo Batista</a> CC BY-NC-SAMon, 29 May 2023 18:51:58 GMTNikola (getnikola.com)http://blogs.law.harvard.edu/tech/rsshttp://blog.taniquetil.com.ar/posts/0610/Facundo Batista<p>Un tema que se ha visto varias veces, tanto en la lista de PyAr como en la vida real, es que los desarrolladores que no estuvieron involucrados en proyectos grandes, o que sólo estuvieron metidos en uno o dos sistemas (más allá el tamaño), no saben muy bien qué estructura, o qué forma, darle a un proyecto nuevo.</p> <p>Es totalmente comprensible. La estructura a tener depende de muchos factores: de la complejidad del proyecto, de cuan listo lo deja uno para empaquetarlo, de la prolijidad del desarrollador, etc.</p> <p>Lo notable es que (en mi experiencia) el proyecto aunque nazca pequeño, siempre conviene que esté ordenado. Y que la forma de ordenarlo, qué estructura darle, cambia en función de las necesidades (como decía arriba) pero que siempre es bueno tener alguna.</p> <p>En función de todo esto es que paso a contarles qué estructura tiene hoy <a class="reference external" href="http://encuentro.taniquetil.com.ar/">Encuentro</a>. No es la mejor del mundo, pero es la que a mí me funciona en este y otros proyectos. Y es una buena base como para que alguien que no tiene idea sepa para qué lado ir ordenando los tantos.</p> <p>El código en sí lo pueden ver <a class="reference external" href="http://bazaar.launchpad.net/~facundo/encuentro/trunk/files">acá</a> o si tienen instalado <em>bazaar</em> pueden hacer <code class="docutils literal">bzr branch lp:encuentro</code> y exploran el código de forma local.</p> <p>Bueno, a los bifes.</p> <section id="el-codigo-util-en-si"> <h2>El código "útil" en sí</h2> <p>Tenemos dos archivos y varios directorios...</p> <ul class="simple"> <li><p><code class="docutils literal">test</code>: Este es un script que básicamente ejecuta todas las comprobaciones que necesitamos para asegurarnos que el proyecto está "verde". En el caso de encuentro, corre las pruebas de unidad (las que están en el directorio <code class="docutils literal">tests</code>, ver abajo), luego corre un verificador estático de código genérico (<code class="docutils literal">pylint</code>) y finalmente otro verificador puntual para <code class="docutils literal">pep 8</code>.</p></li> <li><p><code class="docutils literal">version.txt</code>: La versión del programa. La tengo separada sólo por consistencia: me gusta que esté en un sólo lado así es la misma para todos los que la necesitan (<code class="docutils literal">setup.py</code>, para mostrarlo al arrancar, o cuando el usuario pide info del programa, etc).</p></li> <li><p><code class="docutils literal">bin/</code>: Aquí (normalmente) hay un sólo archivo, con el nombre del proyecto: <code class="docutils literal">encuentro</code>. Este es el script de inicio, el que arranca todo el sistema ya sea cuando lo ejecutamos desde el proyecto mismo, desde un <em>tarball</em> descomprimido, e incluso es el que va a parar a <code class="docutils literal">/usr/bin</code> cuando se instala. Este es el único que es ejecutable, el resto del sistema son sólo módulos.</p></li> <li><p><code class="docutils literal">encuentro/</code>: Es el directorio principal del proyecto (por eso el nombre). Acá tenemos todo el código "de producción" del proyecto, con su estructura interna. Por lo pronto, en este mismo directorio están todos los módulos que tienen que ver con el funcionamiento interno de Encuentro.</p></li> <li><p><code class="docutils literal">encuentro/ui/</code>: Aquí tenemos todo el código que necesitamos para armar la Interfaz del Usuario del programa. También tiene que ver con el funcionamiento interno de Encuentro, pero es sólo el manejo de la interfaz. La separación de qué va aquí o qué va directamente en <code class="docutils literal">encuentro/</code> a veces es complicada.</p></li> <li><p><code class="docutils literal">encuentro/ui/media/</code>: Todas las imágenes, audios, etc, que necesitamos para que funcione la UI en sí.</p></li> <li><p><code class="docutils literal">encuentro/logos/</code>: También imágenes, pero que se usan como identificación del programa en sí. Aunque algunas se usan en la parte de UI, están todas acá porque también se usan en otros contextos (por ejemplo, en la instalación del paquete).</p></li> <li><p><code class="docutils literal">tests/</code>: Los tests de unidad del proyecto, normalmente un montón de archivos cuyo nombre arranca con <code class="docutils literal">test_</code> pero también pueden haber otros (módulos o no) para dar soporte a las pruebas.</p></li> </ul> </section> <section id="otros-directorios"> <h2>Otros directorios</h2> <p>Estos son directorios puntuales que tengo para Encuentro. Algunos se repiten con otros proyectos, otros no.</p> <ul class="simple"> <li><p><code class="docutils literal">qtreactor</code>: El módulo de integración entre Qt (el framework de interfaz gráfica que <a class="reference external" href="http://blog.taniquetil.com.ar/posts/0603">estoy usando</a>) y Twisted (una biblioteca asincrónica que uso para trabajar con la red).</p></li> <li><p><code class="docutils literal">server</code>: Cuando le decimos al programa "local" de Encuentro que actualice los episodios, se baja algunos archivos comprimidos de mi server, con toda la metadata. Estos archivos comprimidos se generan una vez al día a partir de los sitios webs de Encuentro, Conectate, BACUA, etc. El código para realizar todo esto está en este directorio.</p></li> <li><p><code class="docutils literal">web</code>: Todos los archivos necesarios para montar <a class="reference external" href="http://encuentro.taniquetil.com.ar/">el sitio web del proyecto</a>.</p></li> <li><p><code class="docutils literal">windows</code>: Imágenes, configuraciones, y explicaciones necesarias para armar el .exe en Windows y luego armar con eso el instalador final que se distribuye.</p></li> </ul> </section> <section id="otros-archivos"> <h2>Otros archivos</h2> <p>Estos son otros archivos que no tienen demasiada relación entre sí, pero que son importantes en distintos momentos de la vida del proyecto:</p> <ul class="simple"> <li><p><code class="docutils literal">AUTHORS, COPYING</code>: Info legal: cuales son las personas que participaron del proyecto, y la licencia del mismo.</p></li> <li><p><code class="docutils literal">LEEME.txt, README.txt, AYUDA.txt</code>: Textos de ayuda para la persona que llega por primera vez al proyecto (viéndolo desde los archivos fuente). Está en dos idiomas, pero como Encuentro es inherentemente para personas que hablan castellano, el LEEME es el que tiene la info posta.</p></li> <li><p><code class="docutils literal">anuncio.txt, pasos_release.txt</code>: Recordatorios y textos preparados para mí (o para el que haga la release del proyecto... que vengo siendo siempre yo, :p).</p></li> <li><p><code class="docutils literal">pylintrc</code>: Un archivo de configuración para el verificador estático de código que mencionaba arriba.</p></li> <li><p><code class="docutils literal">setup.py, MANIFEST.in</code>: Script principal de empaquetamiento e instalación, más un archivo que podríamos decir de configuración del mismo.</p></li> <li><p><code class="docutils literal">encuentro.desktop, source_encuentro.py</code>: Dos archivitos necesarios en sistemas Debian/Ubuntu (al menos). El primero le pasa al sistema info para poner el programa en el menú del usuario, y el otro es usado en caso de que el programa crashee, para informar automáticamente del problema.</p></li> </ul> </section>directoriosdiseñolayoutsoftwarehttp://blog.taniquetil.com.ar/posts/0610/Fri, 24 May 2013 00:43:56 GMT