Cài đặt và kiểm tra cục bộ thư viện Python là một ý tưởng hay, đặc biệt là trước khi tải nó lên PyPI
Bạn có thể đã tự kiểm tra phần mềm trong và sau quá trình phát triển nhưng có quá nhiều thành phần mới sau khi đóng gói. Việc xây dựng và cài đặt thư viện đặc biệt hữu ích và bạn có nhiều tùy chọn sẽ giúp bạn hiểu rõ hơn về cách đóng gói và đảm bảo hoạt động trơn tru khi cuối cùng bạn tải thư viện của mình lên PyPI
Đừng lo lắng, chúng tôi đã cố gắng hết sức để giải thích rõ ràng tất cả các bước và tùy chọn này bên dưới
Thời gian dự kiến
10 phút
Cấp độ kỹ năng
Upper-Intermediate
bài tập
na
Bài viết từ Series
1. Giới thiệu
2- Sẵn sàng
3- Cấp phép
4-Github
5- Các tập tin cần thiết
6- Kiểm tra cục bộ
7- Tải lên PyPI
Nhà cung cấp khóa học
Cung cấp bởi HolyPython. com
Cài đặt Thư viện nơi nó tồn tại
cài đặt thư viện bằng mã bên dưới
python setup.py install
Tòa nhà VS. cài đặt
thiết lập trăn. cài đặt py đã thực hiện hai bước. Nó xây dựng và sau đó cài đặt. Nhưng bạn thường không thấy bước xây dựng đó diễn ra khi nó xảy ra
python setup.py install
Nếu bạn muốn xây dựng riêng mà không cần cài đặt mặc dù nó cũng có thể. Bạn chỉ cần sử dụng mã này
python setup.py build
Cài đặt thư viện với pip cục bộ
Đây là lần cài đặt pip gần nhất mà khán giả của bạn sẽ trải nghiệm qua lệnh pip
Bằng cách này, thư viện của bạn sẽ được thêm vào thư mục gói trang web trong thư mục cài đặt Python của bạn. Thư mục cài đặt Python có thể khác nhau tùy theo thiết lập bạn đang sử dụng. Ví dụ, nó thường dưới
c. /Anaconda3/Lib/site-packages nếu bạn đang sử dụng Anaconda
Để tiến hành cài đặt theo cách này, chỉ cần đảm bảo rằng bạn đang chạy dấu nhắc lệnh [hoặc Anaconda Shell] trong thư mục nơi thiết lập của bạn. py đang cư trú. Sau đó chạy lệnh bên dưới [Có. có một dấu chấm. ]
pip install .
Gỡ cài đặt và cài đặt lại bằng pip trong quá trình kiểm tra
Khi bạn tiến hành các bài kiểm tra của mình, bạn có thể muốn thực hiện các thay đổi nhỏ và sau đó kiểm tra lại. Điều này có thể yêu cầu gỡ cài đặt và cài đặt lại thư viện của bạn để kiểm tra xem các thay đổi có đang diễn ra không
Xin lưu ý rằng đôi khi bạn cũng có thể cần phải đóng Dấu nhắc Lệnh, Dấu nhắc Anaconda hoặc Python IDE mà bạn đang làm việc, sau đó khởi động lại để thư viện tải lên mới mà không còn phần cũ trong bộ nhớ
Để gỡ cài đặt thư viện, chỉ cần chạy lệnh này
pip uninstall [LIBRARYNAME]
Thử nghiệm __init__. tập tin py
Một khía cạnh quan trọng khác của thử nghiệm cục bộ là thử nghiệm __init__. tập tin py
__trong đó__. tệp py chịu trách nhiệm tải lên các mô-đun và lớp cần thiết ở các giai đoạn thích hợp. Ví dụ: nếu mã nguồn của bạn nằm trong một thư mục mà bạn không muốn buộc người dùng thực hiện các tác vụ nhập lặp đi lặp lại. Ngoài ra, bạn không muốn bắt buộc người dùng phải nhập từng lớp mỗi khi họ nhập thư viện hoặc mô-đun
Trong trường hợp đó, chúng tôi sẽ phải làm điều gì đó như thế này mỗi khi chúng tôi nhập thư viện
- thư mục nhập khẩu
- nhập thư viện
- nhập lớp a
- nhập khẩu lớp b
Vì vậy, các nhà phát triển thường cố gắng loại bỏ các bước không cần thiết khỏi quy trình nhập và đạt được kết quả như thế này
- thư mục nhập khẩu
- nhập thư viện
- nhập lớp a
- nhập khẩu lớp b
và hy vọng mọi thứ liên quan sẽ được tải tự động. Điều này phụ thuộc vào cấu trúc phù hợp của __init__. tập tin py. Đừng lo lắng trong thực tế, đó là một vài dòng mã và không quá khó nhưng điều quan trọng là phải làm cho đúng và đôi khi có thể hơi phức tạp để làm như vậy. Giải thích và ví dụ dưới đây sẽ giúp bạn hiểu đúng
Thật hợp lý khi kiểm tra __init__. py và xem liệu nó có hoạt động bình thường thông qua cài đặt cục bộ không. Các tệp khác như Readme. md hoặc thiết lập. py sẽ gây ra lỗi trong quá trình cài đặt hoặc có lỗi có thể nhìn thấy khi có gì đó không ổn nhưng có thể chương trình bị trục trặc do __init__. py mặc dù cài đặt được thực thi thành công. Đó là lý do tại sao bạn nên thử nghiệm chương trình cục bộ theo nghĩa này.
Vì hành vi của tệp này có thể được quan sát trong và sau khi nhập, nên việc tận dụng các thử nghiệm cục bộ để xem liệu __init__ có hữu ích không. py đang làm những gì nó dự định làm
__trong đó__. tệp py được sử dụng để tải lên các mô-đun, thư viện và lớp khi thư viện được nhập
Ví dụ: khi thư viện của bạn tồn tại bên trong một thư mục, nếu bạn không bao gồm __init__ thích hợp. py, khi thư viện của bạn được nhập, nó sẽ chỉ nhập tên thư mục. Sau đó, người dùng sẽ phải tuân theo cấu trúc gọi lặp đi lặp lại, chẳng hạn như
thư viện. thư viện. lớp. hàm số
Thư viện đầu tiên trong ví dụ này chỉ là thư mục trong khi thư viện thứ hai là mô-đun Python thực tế
Bạn cũng có thể bao gồm nhiều __init__. tập tin py. Đó là thông lệ phổ biến để bao gồm một __init__. py trong thư mục gốc để đảm bảo nhập chính xác thư viện chính và sau đó là một số __init__. py khi cần đến nơi tồn tại các mô-đun. Trong cùng một thư mục với các mô-đun, bạn sẽ muốn đảm bảo rằng các lớp của các mô-đun này được khởi tạo bên trong __init__. tập tin py
Vì vậy, trong khi __init__. py trong thư mục gốc trông như thế này
from .ABCDEF import ABCDEF
__trong đó__. py trong thư mục của mô-đun có thể trông giống như thế này
from .ABCDEF import MyClassName
Ví dụ này chỉ để đưa ra ý tưởng và chương trình của bạn có thể có các nhu cầu cụ thể liên quan đến việc nhập các mô-đun và lớp. Bạn sẽ biết điều đó rõ nhất với tư cách là nhà phát triển và điều đó cũng có thể giúp bạn tìm ra cách kiểm tra cục bộ mã và cài đặt theo nghĩa đó
Ngoài ra, xin lưu ý rằng sau các bản cập nhật gần đây, việc bao gồm một dấu chấm trước nguồn nhập đã trở thành một bước cần thiết như trong các ví dụ về mã và việc quên dấu chấm đó có thể gây ra sự cố
Vì vậy, trong khi mã đầu tiên đang nhập thư viện thực tế từ thư mục chứa nó, thì trong mã thứ hai, một số Lớp nhất định đang được nhập từ chính thư viện thực tế
Bạn có thể xem thư viện Watermarkd trong Kho lưu trữ Github của Holypython để xem __init__. py đang hoạt động cả trong thư mục gốc và cả trong thư mục Watermarkd nơi có thể tìm thấy mã nguồn
Cảm ơn đã đọc hướng dẫn này. Sau khi bạn hoàn thành mọi thứ với các bài kiểm tra cục bộ và __init__. py, bước tiếp theo và cuối cùng để có thư viện trên PyPI là Tải gói lên Chỉ mục gói Python PyPI