Categorías
Python

Cómo publicar un paquete de Python de código abierto a PyPI

 

Tabla de Contenidos

  • Instalación y configuración de código de Visual Studio para el pitón DevelopmentExtensions para Python DevelopmentVisual Estudio código de configuración Archivos
  • Extensiones

  • para el desarrollo de Python
  • código de Visual Studio archivos de configuración
  • Iniciar un nuevo Python ProgramEntering Python CodeRunning Python CodePython pelusa Soporte
  • Introducir el código de Python
  • ejecutar código Python
  • Python pelusa Soporte
  • Edición de una existente Python Proyecto
  • Prueba

  • Soporte
  • compatibilidad de depuración
  • Git Integración
  • Conclusión
    Extensiones

  • para la configuración del código de Visual Studio Desarrollo Python
  • archivos
  • Introducir el código de Python
  • ejecutar código Python Python
  • pelusa Soporte

Mira ahora Este tutorial tiene un vídeo relacionado curso creado por el equipo del real Python. Mira que junto con el tutorial escrito para profundizar su comprensión: Desarrollo Python en código de Visual Studio (Guía de instalación)

Uno de los editores de código más fresco disponible para los programadores, código de Visual Studio, es un código abierto y extensible, luz- editor de peso disponible en todas las plataformas. Son estas cualidades que hacen de código de Visual Studio de Microsoft muy popular, y una gran plataforma para el desarrollo de Python.

En este artículo, aprenderá acerca del desarrollo de Python en el código de Visual Studio, incluida la forma de:

  • Instalar Visual Studio Código
  • Descubrir e instalar extensiones que hacen que el desarrollo de Python fácil
  • Escribir una simple aplicación Python
  • Aprende a ejecutar y depurar los programas existentes de Python en código VS
  • Conectar código de Visual Studio a Git y Github para compartir el código con el mundo

Nosotros suponemos que está familiarizado con el desarrollo de Python y ya tienen algún tipo de Python instalado en su sistema (Python 2.7, Python 3.6 / 3.7, Anaconda, u otros). Se proporcionan capturas de pantalla y demos para Ubuntu y Windows. Debido código de Visual Studio se ejecuta en todas las plataformas, es posible que vea ligeramente diferentes elementos de la interfaz de usuario y puede ser necesario modificar ciertos comandos. Bono

gratuito: 5 pensamientos sobre Python Maestría, un curso gratuito para los desarrolladores de Python que muestra la hoja de ruta y la mentalidad que necesita para tomar sus habilidades de Python al siguiente nivel.

Instalación y configuración de código de Visual Studio para el Desarrollo Python

Instalación de código de Visual Studio es muy accesible en cualquier plataforma. Las instrucciones completas para Windows, Mac y Linux están disponibles, y el editor se actualiza cada mes con nuevas características y correcciones de errores. Usted puede encontrar todo en el sitio web de Visual Studio Código:

En caso de que se preguntan, Código Visual Studio (o Código VS para abreviar) comparte casi nada que no sea un nombre con su homónimo basado en Windows más grande, Visual Studio.

Código Visual Studio ha incorporado soporte para múltiples idiomas y un modelo de extensión con un rico ecosistema de apoyo a otros. Código VS se actualiza mensualmente, y puede mantenerse al día en el blog de Microsoft Python. Microsoft incluso hace que el Código GitHub VS repo disponibles para cualquier persona para clonar y contribuir. (Búsqueda del PR inundación.)

El VS Código de interfaz de usuario está bien documentado, así que no será un refrito aquí:

Extensiones

para el desarrollo de Python

Como se indicó anteriormente, Código VS apoya el desarrollo en varios lenguajes de programación a través un modelo de extensión bien documentada. La extensión de Python permite el desarrollo de Python en el código de Visual Studio, con las siguientes características:

  • soporte para Python 3.4 y superior, así como Python finalización 2.7 Código
  • con el apoyo de IntelliSense

  • pelusa
  • Depuración
  • Código

  • fragmentos
  • soporte de pruebas unidad uso
  • automática de Conda y entornos virtuales
  • Código

  • edición en entornos Jupyter y Jupyter Cuadernos

Visuales extensiones Estudio Código cubrir más que la programación de las capacidades del lenguaje:

  • mapas de teclas permiten a los usuarios ya están familiarizados con Atom , Sublime texto, Emacs, Vim, PyCharm, u otros ambientes para sentirse como en casa.
  • Temas personalizar la interfaz de usuario si le gusta la codificación a la luz, oscuro, o algo más colorido. paquetes
  • lenguaje proveen una experiencia localizada.

mapas de teclas permiten ya los usuarios familiarizados con Atom, Sublime Text, Emacs, Vim, PyCharm, u otros entornos se sientan como en casa.

Temas personalizar la interfaz de usuario si le gusta la codificación a la luz, oscuro, o algo más colorido. paquetes

lenguaje proveen una experiencia localizada.

Aquí están algunos otras extensiones y ajustes que encuentro útil:

  • GitLens ofrece toneladas de útiles Git cuenta directamente en la ventana de edición, incluyendo anotaciones culpa y características de exploración de repositorios.
  • Auto Save es fácilmente enciende al seleccionar Archivo, Guardar automáticamente en el menú. El tiempo de retardo predeterminado es de 1000 milisegundos, que también es configurable.
  • configuración de sincronización le permite sincronizar la configuración de código VS a través de diferentes instalaciones que utilizan GitHub. Si se trabaja en diferentes máquinas, esto ayuda a mantener su entorno consistente a través de ellos.
  • estibador le permite rápida y fácilmente con el trabajo del estibador, ayudando autor Dockerfile y estibador-compose.yml, empaquetar y desplegar sus proyectos, e incluso generar los archivos adecuados acoplables para su proyecto.

GitLens ofrece toneladas de útiles Git cuenta directamente en la ventana de edición, incluyendo anotaciones culpa y características de exploración de repositorios.

Auto Save es fácilmente enciende al seleccionar Archivo, Guardar automáticamente en el menú. El tiempo de retardo predeterminado es de 1000 milisegundos, que también es configurable.

configuración de sincronización le permite sincronizar la configuración de código VS a través de diferentes instalaciones que utilizan GitHub. Si se trabaja en diferentes máquinas, esto ayuda a mantener su entorno consistente a través de ellos.

estibador le permite rápida y fácilmente con el trabajo del estibador, ayudando autor Dockerfile y estibador-compose.yml, empaquetar y desplegar sus proyectos, e incluso generar los archivos adecuados acoplables para su proyecto.

Por supuesto, es posible descubrir otras extensiones útiles a medida que use el código VS. Por favor comparta sus descubrimientos y los ajustes en los comentarios!

Descubrimiento y la instalación de nuevas extensiones y temas se puede acceder haciendo clic en el icono de Extensiones en la Barra de Actividad. Puede buscar palabras clave que utilizan extensiones, ordenar los resultados de numerosas maneras, e instalar las extensiones de forma rápida y sencilla. Para este artículo, instale la extensión de Python Python de escribir este artículo Extensiones en la barra de actividad, y haciendo clic en Instalar :

Usted puede encontrar e instalar cualquiera de las extensiones mencionadas anteriormente de la misma manera .

código de Visual Studio archivos de configuración

Una cosa importante a mencionar es que código de Visual Studio es altamente configurable a través de la configuración del usuario y del espacio de trabajo. Ajustes de usuario

son globales en todas las instancias de Visual Studio Código, mientras que los ajustes de espacio de trabajo local de la carpeta específica o espacio de trabajo del proyecto. Opciones Área de trabajo dan toneladas Código VS de flexibilidad, y me llaman a cabo ajustes de área de trabajo a lo largo de este artículo. la configuración del espacio de trabajo se almacenan como archivos .json en una carpeta local para el área de trabajo de proyecto llamado .vscode.

iniciar un nuevo programa de Python

Vamos a empezar nuestra exploración del desarrollo de Python en el código de Visual Studio con un nuevo programa en Python. En Código VS, pulsar Ctrl + N para abrir un nuevo archivo. (También puede seleccionar Archivo , Nueva en el menú.)

Nota: El Código Estudio de interfaz de usuario de Visual proporciona la paleta de comandos, desde donde se puede buscar y ejecutar cualquier comando sin salir del teclado. Abrir la paleta de comandos usando Ctrl + Shift + P, Tipo de archivo: Nuevo archivo, y pulsa Intro para abrir un nuevo fichero.

No importa cómo llegar allí, debería ver una ventana de código VS que se parece a lo siguiente:

Una vez que se abre un nuevo archivo, que puede ser la introducción del código.

Introducir el código de Python

Para nuestro código de prueba, vamos a código rápidamente la criba de Eratóstenes (que encuentra todos los primos menores que un número dado). Comience a escribir el siguiente código en la nueva pestaña que acaba de abrir:

sieve = [True] * 101
for i in range(2, 100):

Debería ver algo similar a esto:

espera, ¿qué está pasando? ¿Por qué no en Visual Studio Código haciendo cualquier resaltado de palabras clave, cualquier auto-formato, ni nada realmente útil? ¿Lo que da?

La respuesta es que, en este momento, Código VS no sabe qué tipo de archivo que está tratando. El buffer se llama Sin título-1, y si nos fijamos en la esquina inferior derecha de la ventana, verá las palabras texto sin formato .

Para activar la extensión de Python, guarde el archivo (seleccionando Archivo , Guardar en el menú, Archivo: Guardar archivo de la paleta de comandos, o simplemente usando Ctrl + S) como sieve.py. Código VS verá la extensión .py e interpretar correctamente el archivo como código Python. Ahora su ventana debe tener este aspecto:

que es mucho mejor! Código VS vuelve a formatear automáticamente el archivo como Python, que se puede verificar mediante la inspección del modo de idioma en la esquina inferior izquierda.

Si tiene varias instalaciones de Python (como Python 2.7, Python 3.x, o Anaconda), puede cambiar la que Python intérprete utiliza código VS haciendo clic en el indicador de modo de idioma, o la selección de Python: Elija un intérprete de la paleta de comandos . Código VS es compatible con el formato utilizando PEP8 por defecto, pero se puede seleccionar negro o yapf si lo desea.

Vamos a añadir el resto del código Tamiz ahora. Para ver IntelliSense en el trabajo, escriba el código directamente en lugar de cortar y pegar, y usted debería ver algo como esto:

Aquí está el código completo de un tamiz básico de Eratóstenes:

sieve = [True] * 101
for i in range(2, 100):
if sieve[i]:
print(i)
for j in range(i*i, 100, i):
sieve[j] = False

A medida que escribe este código, VS código sangra automáticamente las líneas de bajo y si frases para usted correctamente, añade paréntesis de cierre, y hace sugerencias para usted. Ese es el poder de IntelliSense trabajando para usted.

Ejecución de Python Código

Ahora que el código se haya completado, se puede ejecutar. No hay ninguna necesidad de salir del editor para hacer esto: Código Visual Studio puede ejecutar este programa directamente en el editor. Guarde el archivo (usando Ctrl + S), a continuación, haga clic derecho en la ventana del editor y seleccione Archivo Run Python en la Terminal :

debería ver el panel terminal aparece en la parte inferior de la ventana, con su código muestra de salida.

Python pelusa Soporte

Es posible que haya visto un pop-up aparece mientras estabas escribiendo, afirmando que pelusa no estaba disponible. Se puede instalar rápidamente el apoyo de pelusa que aparecen, que por defecto es pylint. Código VS también es compatible con otros borra de. Aquí está la lista completa en el momento de escribir estas líneas:

página

  • pylint
  • flake8
  • mypy
  • pydocstyle
  • PEP8
  • Prospector
  • pyllama
  • bandido

El pitón pelusa ha obtener información detallada sobre cómo configurar cada una desfibradora.

Nota : La elección de la desfibradora es un ajuste del espacio de trabajo del proyecto, y no un ajuste de usuario global.

Edición de un proyecto existente Python

En la Criba de Eratóstenes ejemplo, se crea un solo archivo de Python. Eso está muy bien como un ejemplo, pero muchas veces, vamos a crear proyectos más grandes y trabajar en ellos durante un período de tiempo más largo. Un nuevo flujo de trabajo típico proyecto podría tener este aspecto:

  • Crear una carpeta para guardar el proyecto (que puede incluir un nuevo proyecto GitHub)
  • cambio a la nueva carpeta
  • Crear el código Python inicial utilizando el nombre de archivo de código de comando. py

mediante código de Visual Studio en un proyecto de Python (en contraposición a un único archivo de Python) abre toneladas más funcionalidad que permite Código VS verdad brilla. Vamos a echar un vistazo a cómo funciona con un proyecto más amplio.

tarde en el milenio anterior, cuando era un programador mucho más joven, me escribió un programa de cálculo que las ecuaciones Analizada escritos en notación infija, utilizando una adaptación del algoritmo de playa de vías de Edsger Dijkstra.

Para demostrar las características centradas en proyectos de código de Visual Studio, que comenzaron recrear el algoritmo playa de vías como una biblioteca de evaluación ecuación en Python. Para continuar a seguir, no dude en clonar el repositorio local.

Una vez creada la carpeta localmente, puede abrir la carpeta entera en el Código VS rápidamente. Mi método preferido (como se mencionó anteriormente) se modifica de la siguiente manera, pues ya tengo la carpeta y los archivos básicos creado:

cd /patho/project
code .

Código VS entiende, y va a utilizar, cualquier virtualenv, pipenv, o entornos CONDA se ve cuando se abre de esta manera. Ni siquiera necesita para iniciar el entorno virtual como el primero! Incluso puede abrir una carpeta de la interfaz de usuario, utilizando Archivo, Abrir carpeta en el menú, Ctrl + K, Ctrl + O desde el teclado, o Archivo : Abrir carpeta de la paleta de comandos.

Para mi proyecto de biblioteca de ecuaciones eval, esto es lo que veo:

Cuando código de Visual Studio abre la carpeta, sino que también abre los archivos de la última vez que había abierto. (Esto es configurable.) Puede abrir, editar, ejecutar y depurar todo el archivo incluido. La vista del explorador en la barra de actividad de la izquierda le da una visión de todos los archivos de la carpeta y muestra cómo existen muchos archivos no guardados en el conjunto actual de pestañas.

Pruebas de Soporte

Código VS puede reconocer automáticamente Python existente pruebas escritas en el marco unittest, o la PYtest o marcos nariz si esos marcos están instalados en el entorno actual. Tengo una unidad de prueba escrito en unittest para la biblioteca de ecuaciones eval, que se puede utilizar para este ejemplo.

Para ejecutar las pruebas unitarias existentes, de cualquier archivo de Python en el proyecto, haga clic derecho y seleccione Ejecutar Corriente de prueba Unidad de Archivo . Se le pedirá que especifique el marco de pruebas, donde en el proyecto para la búsqueda de pruebas, y el patrón de nombre de archivo de sus pruebas utilizan.

Todos estos ajustes se guardan como espacio de trabajo en su archivo .vscode / settings.json local y puede modificarse allí. Para este proyecto ecuación, selecciona unittest, la carpeta actual, y el patrón * _test.py.

Una vez que el marco de pruebas está configurado y las pruebas se han descubierto, puede ejecutar todas las pruebas haciendo clic ejecutar pruebas en la barra de estado y seleccionando una opción de la paleta de comandos:

Incluso se puede ejecutar pruebas individuales mediante la apertura del archivo de prueba en el Código VS, al hacer clic ejecutar pruebas en la barra de estado, y seleccionando la Ejecutar prueba Unidad Método … y la prueba específica que se ejecuten. Esto hace que sea trivial para hacer frente a fallos de las pruebas individuales y las pruebas sólo no volver a correr, que es un gran ahorro de tiempo! Los resultados del ensayo se muestran en el panel de salida bajo Python prueba de log .

compatibilidad de depuración

Aunque Código VS es un editor de código, depuración de Python directamente en el código VS es posible. Código VS ofrece muchas de las características que se esperan de un depurador de código bueno, incluyendo: la variable

  • seguimiento automático
  • reloj expresiones
  • puntos de interrupción
  • llamada pila de inspección

Usted puede verlos todos como parte de la depuración Ver en la Barra de Actividad:

el depurador puede controlar Python aplicaciones que se ejecutan en la incorporada en el terminal externo instancia terminal o una. Se puede adjuntar a un ya abiertos Python, e incluso puede depuración de Django y el frasco de aplicaciones. código

depuración en un solo archivo de Python es tan sencillo como iniciar el depurador utilizando F5. Se utiliza F10 y F11 para pasar por encima y en las funciones respectivamente, y Shift + F5 para salir del depurador. Los puntos de interrupción se establecen con F9, o con el ratón haciendo clic en el margen izquierdo de la ventana del editor.

Antes de empezar a depurar proyectos más complicados, incluyendo aplicaciones Django o frasco, lo que necesita para configurar y luego seleccione una configuración de depuración. Configuración de la configuración de depuración es relativamente sencillo. Desde el punto de vista de depuración , seleccione el menú desplegable de configuración , a continuación, Añadir configuración y seleccione Python :

código de Visual Studio creará un archivo de configuración de depuración en la carpeta actual llamada .vscode / launch.json, que le permite a las configuraciones de instalación de Python específicos, así como los ajustes para depurar aplicaciones específicas, como Django y el frasco.

Es posible incluso realizar la depuración remota, y las plantillas de depuración Jinja y Django. Cierre el archivo launch.json en el editor y seleccione la configuración apropiada para su aplicación desde el menú desplegable de configuración .

Git Integración

Código VS

ha incorporado en el apoyo a la gestión de control de código fuente, y viene con soporte para Git y Github sacarlo de la caja. Puede instalar la compatibilidad con otros de SCM en Código VS, y utilizarlos al lado del otro. control de código fuente es accesible desde el punto de vista Fuente de control :

Si su carpeta de proyecto contiene una carpeta .git, Código VS activa automáticamente la gama completa de funcionalidad Git / GitHub. Estas son algunas de las muchas tareas que puede realizar:

  • confirma archivos para empujar cambios Git
  • a, y extraer los cambios de, repositorios remotos
  • de salida existente o crear nuevas ramas y etiquetas
  • Ver y conflictos de fusión resolución
  • Ver diffs

Toda esta funcionalidad está disponible directamente desde la interfaz de usuario Código VS:

Código VS también reconocerá los cambios realizados fuera del editor y comportarse adecuadamente.

confirmar los cambios recientes en el código VS es un proceso bastante sencillo. M odified archivos se muestran en la vista Fuente de control con un marcador M , mientras que los nuevos archivos sin seguimiento están marcados con un T . La etapa de su cambios colocando el cursor sobre el archivo y haciendo clic en el signo más (+ ). Añadir un mensaje de registro en la parte superior de la vista y, a continuación, haga clic en la marca de verificación para confirmar los cambios:

Usted puede empujar commits locales a GitHub desde dentro del código VS así. Seleccionar sincronización en el menú Ver Fuente de control , o haga clic en Sincronizar hronize Los cambios en la barra de estado junto al indicador de rama.

Conclusión

código de Visual Studio es uno de los editores de propósito general más fresco y un gran candidato para el desarrollo de Python. En este artículo, usted aprendió:

  • Cómo instalar Código VS en cualquier plataforma
  • Cómo encontrar e instalar extensiones para permitir específico de Python cuenta con
  • Cómo Código VS hace que escribir una simple aplicación Python más fácil
  • cómo ejecutar y depurar programas Python existente dentro de VS Código
  • cómo trabajar con Git y GitHub repositorios de código VS

código de Visual Studio ha convertido en mi editor por defecto para Python y otras tareas, y espero que darle una oportunidad de convertirse en el suyo también .

Si tiene alguna pregunta o comentario, por favor, llegar en los comentarios a continuación. También hay mucha más información en el sitio web de Visual Studio Código de lo que podríamos cubrir aquí.

El autor envía gracias a Dan Taylor del equipo de código de Visual Studio de Microsoft por su tiempo y ayuda inestimable en este artículo.

Mira ahora Este tutorial tiene un vídeo relacionado curso creado por el equipo del Real Python. Mira que junto con el tutorial escrito para profundizar su comprensión: Desarrollo Python en código de Visual Studio (Guía de instalación)

Deja un comentario

Tu dirección de correo electrónico no será publicada. Los campos obligatorios están marcados con *