Después de escribir el código del proyecto Python, ¿cómo empaquetarlo y publicarlo?
Xiaoshuai b La postura correcta para aprender Python
Una vez que haya terminado de escribir su código, ¿desea usarlo para otros? ¿Cómo empaquetar el código de su proyecto?
Hola, ¿es de código abierto?
A continuación, Xiaoshuai b le dirá cómo empaquetar su código.
Tomemos el todo que demostramos la última vez como ejemplo. Después de escribir el código, el directorio del código se ve así:
En el directorio de todo, los archivos están todos juntos. Podemos simplemente dividirlo así:
Cree un directorio de paquetes aquí, coloque los archivos de código fuente en él y luego organice los archivos de plantilla y los archivos de base de datos en categorías separadas.
En el paquete, también está creando un sentido inicial de qué ceremonia .py.
Para que otros sepan que se está tomando este proyecto en serio, puede crear un directorio de pruebas en el archivo del proyecto y probar su código en él:
Entonces, ¿puede crear una LICENCIA para ilustrar cómo se puede utilizar su proyecto? ¿Necesito declarar la fuente? ¿Está disponible comercialmente? Otros usan tu proyecto para hacer cosas, cómo evitar que te atrapen y vayan a la cárcel, etc.
Hay varios tipos de acuerdos de código abierto, si no sabe mucho al respecto, puede mirar este que escribí antes: ¿Qué significan los acuerdos de código abierto declarados por GitHub?
Luego, cree un archivo README para explicar qué hace su proyecto, cómo usarlo y otras descripciones.
Ahora el directorio de archivos de su proyecto tiene un aspecto un poco humano:
A continuación, necesitamos crear un archivo-setup.py más importante, este archivo se usa principalmente para describir la información de su proyecto, de modo que la herramienta de empaquetado de setuptools pueda ayudarlo a empaquetar el proyecto.
Cree un archivo setup.py en el directorio raíz y escriba la información de su proyecto de la siguiente manera:
¿Qué significa cada parámetro? Déjame explicarte:
long_description: Para obtener una descripción larga del proyecto, podemos leerlo directamente desde el archivo README que acaba de escribir.
name: el nombre del paquete que define, puede usar letras, números y guiones bajos para garantizar la unicidad.
versión: el número de versión del proyecto.
autor: Su (autor) nombre.
author_email: Su dirección de correo electrónico (autor).
descripción: una breve descripción del proyecto.
long_description_content_type: el tipo de marca que se utiliza para el contenido de descripciones largas, generalmente markdown o rst.
url: la dirección de la página de inicio de su proyecto, o puede vincular directamente a la dirección de Github de su proyecto.
include_package_data: si se deben agregar archivos que no sean py.
package_data: una lista de archivos adicionales que deben agregarse a Python.
paquetes: use setuptool directamente para encontrar una lista de todos los paquetes relevantes para su proyecto.
clasificadores: explicación adicional, por ejemplo, lo que está escrito aquí es para la versión Python3, usando el protocolo MIT, independientemente del sistema operativo.
python_requires: requisitos de la versión de python.
Así que ahora, el directorio de su proyecto debería verse así:
Entonces se puede empaquetar.
Si no ha instalado las herramientas de configuración y la rueda antes, puede instalar una ola primero:
python3 -m pip install - actualizar la rueda de setuptools
Luego, en el directorio raíz de su proyecto, use el siguiente comando para empaquetar:
python3 setup.py sdist bdist_wheel
En este momento, su directorio agregará dichos archivos:
De esta manera, incluso si está empaquetado, en el directorio dist, los archivos fuente que terminan en tar.gz son los archivos fuente de su proyecto, y la distribución que termina en .whl es la compilación para que otros la usen.
Entonces, ¿cómo publicas tu proyecto empaquetado para que otros lo usen?
De hecho, lo he dicho antes, hablemos brevemente de ello aquí:
Instale el hilo primero:
python3 -m pip install twine
Luego use twine para cargar sus archivos empaquetados en pypi:
dist / * de carga de hilo
En este momento, le pedirá que ingrese la contraseña de la cuenta de pypi:
¿Y si no hay? Para registrarse para uno, vaya al siguiente enlace para registrarse:
https://pypi.org/account/register/
Luego ingrese la contraseña de su cuenta, puede cargarla:
En este momento, otros pueden instalar su proyecto a través de pip:
como esto:
Entonces puedes usar tu paquete para otros:
Cuando pip install, en realidad descarga el archivo whl que cargó y lo instala:
Si no desea abrir el código fuente y solo desea usarlo para sus amigos, también puede enviarle directamente los archivos en el directorio dist, dejar que lo instale y lo use:
Ok, lo anterior es el intercambio que te trajo Xiaoshuai b hoy, espero que te sea útil, entonces nos veremos la próxima vez, ¡paz!