Hướng dẫn library for python - thư viện cho python
Hướng dẫn tạo package PythonTutorial này mình sẽ hướng dẫn cách tạo package cho một project Python cơ bản. Bao gồm: Show
Build simple projectĐầu tiên, mình sẽ tạo một simple project như sau:
Trong file 0 mình sẽ define một function 1:
Sau khi tạo xong, ta sẽ test thử module này nào:
Okay, đã tạo xong một simple project. Add necessary filesMột package cơ bản sẽ có structure như này:
Ta sẽ thêm từng thành phần vào project đã tạo ở bên trên. Đầu tiên, bạn cần định nghĩa 2 file:
Tiếp theo, bạn tạo một file 3. File này để làm gì ? 3 là một script build for setuptools. Trong đây sẽ chứa những thông tin về package của bạn:
Trong đó:
File 3 trên khá là cơ bản. Bạn có thể tìm hiểu đầy đủ tại đâySau khi tạo xong file 3, tiếp theo bạn cần tạo 1 file 6. File này để làm gì thì mình cũng không nhắc nữa nhé. Mình sẽ để tạm nội dung vào như sau:
Cuối cùng, ta sẽ cần tạo một LICENSE file. File này là rất quan trong khi bạn muốn upload package lên Python Package Index. Nếu bạn chỉ sử dụng ở mức độ giới hạn người dùng thì việc tạo file này không cần thiết cho lắm. File này sẽ nói về term khi người dùng cài đặt package này. Bạn có thể chọn license tại trang: https://choosealicense.com/. Ở ví dụ này, mình sẽ chọn MIT license: 0Bước tiếp theo, ta sẽ đóng gói package. Build the packageUpload to Python Package Index 1Build simple project 2Đầu tiên, mình sẽ tạo một simple project như sau: 3Trong file 0 mình sẽ define một function 1:Sau khi tạo xong, ta sẽ test thử module này nào: 4Okay, đã tạo xong một simple project.
Ta sẽ thêm từng thành phần vào project đã tạo ở bên trên. Đầu tiên, bạn cần định nghĩa 2 file:Tiếp theo, bạn tạo một file $ python Python 2.7.11 (default, May 16 2018, 08:55:09) [GCC 5.4.0 20160609] on linux2 Type "help", "copyright", "credits" or "license" for more information. >>> from app import sum >>> print(sum(1, 2)) 3 3. File này để làm gì ? $ python Python 2.7.11 (default, May 16 2018, 08:55:09) [GCC 5.4.0 20160609] on linux2 Type "help", "copyright", "credits" or "license" for more information. >>> from app import sum >>> print(sum(1, 2)) 3 3 là một script build for setuptools. Trong đây sẽ chứa những thông tin về package của bạn:Trong đó: name : tên package. Nếu sau này bạn có ý định upload lên pypi.org, thì bạn cần chắc chắn rằng tên đó chưa tồn tại trên hệ thống của 5. 5version : version của package. 6author : tên tác giả. 7author_email : email của tác giả. description : sort description package.long_description : full description package. Ta có thể đọc từ file 6 của mình.
8
9packages : danh sách các Python import package. Bạn có thể sử dụng 7 để làm tự động. Hoặc nếu bạn muốn làm bằng tay.classifiers: bổ sung thêm một số thông tin cho package. Như ví dụ trên, package chỉ tương thích với Python 2, under MIT lisense và là OS-independent. Danh sách classifiers bạn có thể tham khảo tại đây. |