Skip to content
Patricio López Juri edited this page Oct 16, 2015 · 15 revisions

Por Patricio López Juri (@mrpatiwi)

Ante cualquier problema consultar en el foro.

Instrucciones generales

Se recomienda remover la instalación de Python usando en Introducción a la Programación. Pues en el curso usamos la versión 3.4.x. La instalación de este está más abajo, pero asegúrate de seguir en orden esta guía.

De aquí en adelante todo se ejecutará en la Terminal.app que viene por defecto en OSX.

Getting Started

Lo primero es instalar las Command Line Tools de Xcode:

# Si ya habías bajado y ejecutado Xcode quizás no necesites esto
xcode-select --install

Los Package managers que nos permitirá instalar cualquier software de aquí en adelante.

Para instalar herramientas como lenguajes de programación, etc.

ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

Para instalar programas. La ventaja es que todos los que instalemos por acá son más fáciles de administrar y de borrar sin la necesidad de salir de la terminal.

brew install caskroom/cask/brew-cask

Por ejemplo, si queremos instalar Firefox:

brew cask install firefox

Otras acciones, tanto para brew y brewk cask, son:

  • uninstall para borrar paquetes.
  • search: para buscar paquetes.
  • update: para actualizar la lista total de paquetes. Es recomendable hacer esto antes de instalar cualquier cosa.
  • upgrade: actualiza los paquetes en base a la última versión disponible (que la consigue de update).
  • cleanup: para borrar los archivos de instalación que usan espacio.
  • help: para ver todos los comandos disponibles.

Opcional. La Terminal.app que viene por defecto es un poco pasada de moda, mejor usaremos una con más funcionalidades.

brew cask install iterm2

También pasaremos de shell común y corriente a ZSH.

brew install zsh zsh-completions

En particular a oh-my-zsh.

curl -L https://raw.github.com/robbyrussell/oh-my-zsh/master/tools/install.sh | sh

Ahora puedes cerrar la Terminal.app y abrir la nueva iTerm2.app. Puedes usar cualquiera de las dos de aquí en adelante.

Software obligatorio

Git es un control de versiones para nuestros proyectos. Sirve para ir creando respaldos, sincronizarse con un servidor y permitir la colaboración de varias personas en un mismo proyecto.

Viene por defecto instalado en OSX.

Configuración

Para evitar estar ingresando nuestos datos una y otra vez:

# Nos identificamos
git config --global user.name "NOMBRE APELLIDO"
git config --global user.email "correo@foo.com"

# Habilitamos los colores :)
git config --global color.ui auto

# Para evitar problemas de sincronización:
# Automaticamente, cada vez que intentemos subir algo,
# primero se asegurará de bajar lo que esté en la nube.
git config --global --bool pull.rebase true

# En algún momento podríamos tener problemas de 'merge'.
# El editor que viene por defecto es 'vim' y es muy poco amigable.
# Vamos a cambiarlo por 'nano' que es más simple :)
git config --global core.editor "nano"

Uso

A la acción de bajar un repositorio se le llama clone y la acción de actualizar se llama pull.

Introducción a Bash

Toda acción depende de donde estemos parados en la Terminal. Veamos los comandos más comunes para movernos por el computador a través de la terminal:

# Para mostrar donde estamos:
pwd

# Para ver el listado de carpetas y archivos:
ls

# Para entrar a una carpeta:
cd nombrecarpeta

# Si la carpeta tiene espacios ' ' en su nombre, se antepone un \ antes de cada uno.
# Por ejemplo, supongamos que queremos entrar a la carpeta 'mi carpeta'
cd mi\ carpeta

# Para retroceder
cd ..

Estos comandos son algunos de los que disponemos en Bash. Puedes encontrar más información para principiantes aquí.

Introducción a git

Ahora con git, para clonar el repositorio público del curso:

# Vamos al Escritorio, reemplaza 'patriciolopez' por el de tu computador.
cd /Users/patriciolopez/Desktop

# Clonamos el syllabus, se creará una carpeta con el nombre 'syllabus'
git clone https://github.com/IIC2233-2015-2/syllabus.git

# Vamos a la nueva carpeta
cd syllabus

# Abrimos el Finder. El '.' es para indicar que lo queremos abrir donde estamos parados.
open .

# Actualizamos el repo
git pull

Te recomendamos que hagas este tutorial de intrucción a git: Try Git.

Una vez listo, te recomendamos bajar esta hoja de referencia con los comandos típicos de git: Github Cheat Sheet

Recordar credenciales

Para evitar estar escribiendo nuestros datos una y otra vez, te recomiendo revisar: https://help.github.com/articles/caching-your-github-password-in-git/#platform-mac

Simplemente hacemos:

brew install python3

y listo!

Aprovechemos de instalar algunas librerías de Python por medio de su propio administrador de paquetes: pip.

Instalemos algunas librerías que usaremos durante el curso:

# En orden para evitar problemas.
pip3 install --upgrade simpy
pip3 install --upgrade numpy
pip3 install --upgrade matplotlib

PyQt 4

Bindings de Qt para interfaces gráficas multi-plataforma.

En algún momento durante el transcurso del semestre necesitaremos usar y desarrollar interfaces visuales. Para esto necesitamos PyQt.

Se instala así (es un archivo pesado y tomará unos minutos en instalarse):

brew install pyqt --with-python3

Si por casualidad lo instalaste sin el --with-python3, tenemos que borrar la instalación con brew uninstall pyqt y volver a instalarlo con el comando de arriba.

Para asegurarnos que se instaló bien ejecutamos este comando dentro de python3 y no debería generar errores:

import PyQt4

Interfaces de Desarrollo

Te presentamos 3 IDEs recomendadas por los ayudantes y la comunidad en general. Incluso puedes instalarlas todas y ver cuál te gusta más.

Código abierto y mantenida por Github. Bastante madura y con una comunidad muy activa.

brew cask install atom

Ahora tenemos los siguientes comandos:

  • atom: Abre el editor de texto.
    • Podemos usar atom . para abrirlo directamente en la carpeta donde estamos parados.
  • apm: Atom Package Manager, otro administrador de paquetes.

Instalaremos algunos plug-ins a través de apm en conjunto con pip para adaptarla al desarrollo en Python.

# Para avisarnos y corregirnos el código
pip3 install --upgrade pylint pep8 flake8

# Lo integramos con Atom
apm install linter linter-pylint linter-pep8 linter-flake8

# Para poder ejecutar código
apm install script

# Para autocompletar mientras programamos
apm install autocomplete-python

# Embellecedor de código cada vez que guardamos
pip3 install --upgrade autopep8
apm install atom-beautify

Puedes encontrar más plug-ins en: https://atom.io/packages

Uso

Lo principal es saber abrir la Paleta de Comandos con ⌘+SHIFT+P porque aquí podemos ejecutar casi todos los comandos disponibles buscándolos como texto.

Para ejecutar un archivo .py tienes que presionar ⌘+I.

Queda como tarea familiarizarse con la interfaz y con los atajos.

Es el más liviano, pero es pagado. Sin embargo, tiene un periodo de prueba infinito, pero que nos estará recordando cada cierta cantidad de uso que lo compremos.

brew cask install sublime-text3

También instalaremos las siguientes librerías para que nos ayudarán mantener un código bien formateado:

pip install --upgrade pylint pep8 flake8

Package Control & Anaconda

Para adaptarlo al desarrollo en Python, debemos instalar el Package Control.

Abrimos Sublime Text 3, vamos a Vista -> Mostrar consola y pegamos y ejecutamos el código que aparece aquí: https://packagecontrol.io/installation#st3

Al igual que en Atom, lo principal es saber abrir la Paleta de Comandos con ⌘+SHIFT+P porque aquí podemos ejecutar casi todos los comandos disponibles buscandolos como texto.

Ahora para instalar paquetes, presionamos ⌘+SHIFT+P y escribimos: Install Package.

Instalamos los siguientes paquetes en orden:

  • Anaconda
  • SublimeLinter
  • SublimeLinter-pylint
  • SublimeLinter-pep8
  • SublimeLinter-flake8

Puedes encontrar más paquetes en https://packagecontrol.io/browse

Configuración

Vamos a Preferences -> Settings - User y añadimos lo siguiente:

"tab_size": 4,
"translate_tabs_to_spaces": true

Nos debería quedar algo así, más o menos:

{
    "color_scheme": "Packages/User/SublimeLinter/Monokai (SL).tmTheme",
    "ignored_packages":
    [
        "Vintage"
    ],
    "tab_size": 4,
    "translate_tabs_to_spaces": true
}

Para poder ejecutar un archivo usando Python 3, tenemos que crear un sublime-build. Vamos a Tools -> Build System -> New Build System...

En el archivo que se abra escribimos:

{
    "cmd": ["python3", "-u", "$file"],
    "selector": "source.python",
    "file_regex": "file \"(...*?)\", line ([0-9]+)",
    "encoding": "utf8"
}

Y lo guardamos ⌘+S con el nombre Python3.sublime-build.

Uso

Para ejecutar un archivo .py, presionamos ⌘+B. Ojo que el archivo debe estar guardado para poder hacer esto, no puede ser "al aire".

Ahora, cuando quieras auto-formatear tu código para seguir el estandar PEP8, mientras estemos en un archivo .py, en la Paleta de Comandos ejecutamos la acción: Anaconda: Autoformat PEP8 Errors.

Queda como tarea familiarizarse con la interfaz y con los atajos.

Es el más completo. Tiene una versión gratis (Community) pero también puedes tener la versión completa (Pro) registrándote con tu Cuenta UC aquí.

Versión Community

brew cask install pycharm-ce

Versión Pro

brew cask install pycharm

Configuración

Debemos asegurarnos que estamos usando Python 3 como interprete. Para esto abrimos el programa, vamos a Configuración y lo declaramos en:

  • Default Project -> Project Interpreter:
    • En la casilla de Python Interpreter nos aseguramos que sea Python 3.
    • En nuestro caso debería ser: usr/local/Cellar/python3/.../bin/python3.4
  • Build, Execution, Deployment -> Console -> Python Console:
    • Exactamente lo mismo de recién.

Se recomienda habilitar la opción para mostrar los números de cada linea. Así es más fácil encontrar los errores al programar.

Esto se hace en Configuración, vamos a Editor -> General -> Appearence y seleccionamos Show line numbers.

Uso

Para ejecutar un archivo, hacemos Segundo click o Click derecho en uno, y presionamos Run.