Công cụ đóng gói trong Python là gì?
|
Tại buổi gặp mặt Python Frederick tuần trước, tôi đã nói chuyện về bao bì Python. Mục đích của tôi là đề cập đến cách thức hoạt động của bao bì và cách xây dựng một gói cơ bản. Trong suốt buổi nói chuyện, chúng tôi đã sử dụng một số công cụ mà tôi nghĩ là rất quan trọng để phát hành gói Python cho PyPI. Tôi sẽ mô tả những công cụ này và lý do tại sao tôi nghĩ chúng quan trọng Show
chất độctox là một công cụ tuyệt vời để kiểm tra bao bì. Với lệnh Phiên bản ngắn của running tox trông giống như Lệnh này sẽ chạy bộ thử nghiệm của gói đối với Python 3. 6. Tôi thích nó khi các lệnh thanh lịch. Để làm được điều đó, nhà phát triển phải cho tox biết cách chạy bộ thử nghiệm. Cấu hình này được thực hiện trong tệp Trong ví dụ này, bạn sẽ thay đổi Tôi thấy rằng việc sử dụng tox giúp tôi tránh được các lỗi đóng gói khó phát hiện (bạn có biết chúng tồn tại không?) và nói chung là tuyệt vời để thử nghiệm trên nhiều phiên bản Python quanh cosợi xe là một công cụ quan trọng trong bộ công cụ của nhà đóng gói vì một lý do. nó cho phép bạn tải lên PyPI qua HTTPS. Ngược lại, Mặc dù có vẻ ngớ ngẩn nhưng bạn cần một gói riêng để tải lên an toàn qua HTTPS. Tôi cho rằng có những lý do chính đáng cho yêu cầu đó mà tôi không biết Tóm lượcHệ sinh thái Python có tài liệu tuyệt vời về đóng gói tại Hướng dẫn sử dụng bao bì Python. Bài đăng này nhằm mục đích giới thiệu nhẹ nhàng về một vài công cụ rất có giá trị khi bạn muốn làm việc với các gói (Vâng, tôi biết một "gói" về mặt kỹ thuật được gọi là "phân phối" trong biệt ngữ Python thích hợp, nhưng tôi đã sử dụng thuật ngữ này vì nó được chấp nhận rộng rãi hơn trong nhiều ngôn ngữ lập trình. ) Thư viện này cung cấp các tiện ích triển khai các thông số kỹ thuật về khả năng tương tác rõ ràng có một hành vi đúng (ví dụ:. PEP 440) hoặc hưởng lợi rất nhiều từ việc có một triển khai được chia sẻ duy nhất (ví dụ:. PEP 425) Dự án đóng gói bao gồm những điều sau đây. xử lý phiên bản, chỉ định, đánh dấu, yêu cầu, thẻ, tiện ích Lịch sử dự ánVui lòng xem lại THAY ĐỔI. tệp đầu tiên hoặc tài liệu Nhật ký thay đổi cho các thay đổi gần đây và lịch sử dự án Pipenv là một công cụ đóng gói dành cho Python giúp giải quyết một số vấn đề phổ biến liên quan đến quy trình làm việc điển hình bằng cách sử dụng Ngoài việc giải quyết một số vấn đề phổ biến, nó hợp nhất và đơn giản hóa quy trình phát triển thành một công cụ dòng lệnh duy nhất Hướng dẫn này sẽ giới thiệu những vấn đề mà Pipenv giải quyết và cách quản lý các phần phụ thuộc Python của bạn với Pipenv. Ngoài ra, nó sẽ đề cập đến cách Pipenv phù hợp với các phương pháp phân phối gói trước đây Tiền thưởng miễn phí. Nhấp vào đây để truy cập lớp học 5 ngày miễn phí chỉ cho bạn cách tránh các sự cố quản lý phụ thuộc phổ biến với các công cụ như Pip, PyPI, Virtualenv và các tệp yêu cầu Các vấn đề mà Pipenv giải quyếtĐể hiểu được lợi ích của Pipenv, điều quan trọng là phải xem qua các phương pháp hiện tại để đóng gói và quản lý phụ thuộc trong Python Hãy bắt đầu với một tình huống điển hình về việc xử lý các gói của bên thứ ba. Sau đó, chúng tôi sẽ xây dựng cách triển khai một ứng dụng Python hoàn chỉnh Loại bỏ các quảng cáoQuản lý phụ thuộc với package_c>=1.0,<=2.0 package_a package_b 0Hãy tưởng tượng bạn đang làm việc trên một dự án Python sử dụng gói của bên thứ ba như Vì vậy, bạn quyết định đưa phần phụ thuộc Tuyệt vời, mọi thứ hoạt động tốt tại địa phương và sau khi hack ứng dụng của bạn một lúc, bạn quyết định chuyển nó sang sản xuất. Đây là nơi mọi thứ trở nên hơi đáng sợ… Tệp Vì lợi ích của ví dụ này, giả sử rằng một phiên bản mới của Bây giờ, giả sử bạn triển khai ứng dụng của mình vào sản xuất và thực hiện một “Nhưng này, nó hoạt động trên máy của tôi. ” —Bản thân tôi đã từng đến đó, và đó không phải là một cảm giác tuyệt vời Tại thời điểm này, bạn biết rằng phiên bản Việc ghim phần phụ thuộc của Hãy nhớ rằng bản thân Một lần nữa, vì lợi ích của ví dụ này, giả sử một phiên bản mới của Khi bạn thực hiện Vấn đề thực sự ở đây là bản dựng không mang tính quyết định. Ý tôi là, với cùng một đầu vào (tệp Giải pháp điển hình cho vấn đề này là sử dụng Việc thực thi Với các phụ thuộc được ghim này, bạn có thể đảm bảo rằng các gói được cài đặt trong môi trường sản xuất của bạn khớp chính xác với các gói trong môi trường phát triển của bạn, vì vậy sản phẩm của bạn không bị hỏng bất ngờ. Thật không may, “giải pháp” này lại dẫn đến một loạt vấn đề mới Bây giờ bạn đã chỉ định các phiên bản chính xác của mọi gói bên thứ ba, bạn chịu trách nhiệm cập nhật các phiên bản này, mặc dù chúng là phần phụ thuộc của Trước tiên, bạn cần lưu ý rằng có vấn đề với phiên bản bạn có. Sau đó, bạn cần tải phiên bản mới trong môi trường sản xuất của mình trước khi ai đó khai thác lỗ hổng bảo mật. Vì vậy, bạn phải thay đổi thủ công Sự thật là bạn thực sự không quan tâm phiên bản nào của câu hỏi thực sự là. “Làm cách nào để bạn cho phép các bản dựng xác định cho dự án Python của mình mà không chịu trách nhiệm cập nhật các phiên bản của phần phụ thuộc?” Loại bỏ các quảng cáo Phát triển các dự án với các phụ thuộc khác nhauHãy chuyển hướng một chút để nói về một vấn đề phổ biến khác phát sinh khi bạn làm việc trên nhiều dự án. Hãy tưởng tượng rằng Theo mặc định, Python cố gắng lưu trữ tất cả các gói bên thứ ba của bạn ở một vị trí trên toàn hệ thống. Điều này có nghĩa là mỗi khi bạn muốn chuyển đổi giữa Giải pháp tiêu chuẩn là sử dụng một môi trường ảo có bộ lưu trữ gói của bên thứ ba và có thể thực thi Python của riêng nó. Bằng cách đó, Pipenv được tích hợp tính năng quản lý môi trường ảo để bạn có một công cụ duy nhất để quản lý gói của mình Độ phân giải phụ thuộcÝ tôi là gì khi giải quyết sự phụ thuộc? Giả sử Lý tưởng nhất là khi bạn cố gắng cài đặt Thật không may, hiện tại bản thân pip không có độ phân giải phụ thuộc thực sự, nhưng có một vấn đề mở để hỗ trợ nó Cách pip sẽ xử lý tình huống trên như sau
Đây là nơi rắc rối (có khả năng) bắt đầu Nếu phiên bản của “Giải pháp” cho vấn đề này là chỉ định phạm vi cần thiết cho phụ thuộc phụ ( Tuy nhiên, cũng giống như trước đây, giờ đây bạn đang trực tiếp quan tâm đến bản thân với các yếu tố phụ thuộc ( Lý tưởng nhất là công cụ cài đặt của bạn đủ thông minh để cài đặt các gói đáp ứng tất cả các yêu cầu mà bạn không cần chỉ định rõ ràng các phiên bản phụ thuộc Giới thiệu PipenvBây giờ chúng tôi đã giải quyết các vấn đề, hãy xem cách Pipenv giải quyết chúng Đầu tiên, hãy cài đặt nó Khi bạn đã hoàn thành việc đó, bạn có thể quên đi Pipenv sử dụng Ví dụ sử dụngHãy bắt đầu lại với việc tạo ứng dụng Python tuyệt vời của bạn. Đầu tiên, sinh ra một vỏ trong môi trường ảo để cô lập sự phát triển của ứng dụng này Điều này sẽ tạo ra một môi trường ảo nếu một môi trường chưa tồn tại. Pipenv tạo tất cả các môi trường ảo của bạn ở một vị trí mặc định. Nếu bạn muốn thay đổi hành vi mặc định của Pipenv, có một số Bạn có thể buộc tạo môi trường Python 2 hoặc 3 bằng các đối số tương ứng là
Bây giờ bạn có thể cài đặt gói bên thứ 3 mà bạn cần, Bạn sẽ thấy một cái gì đó như sau trong thiết bị đầu cuối của mình Bạn sẽ nhận thấy rằng có hai tệp được tạo, một tệp Nếu bạn muốn cài đặt thứ gì đó trực tiếp từ hệ thống kiểm soát phiên bản (VCS), bạn có thể. Bạn chỉ định các vị trí tương tự như cách bạn làm như vậy với Lưu ý đối số Giả sử bạn cũng có một số bài kiểm tra đơn vị cho ứng dụng tuyệt vời này và bạn muốn sử dụng Việc cung cấp đối số Các phần khác nhau tách biệt các phần phụ thuộc chỉ cần thiết để phát triển với phần phụ thuộc cần thiết để mã cơ sở thực sự hoạt động. Thông thường, điều này sẽ được thực hiện với các tệp yêu cầu bổ sung như Được rồi, giả sử bạn có mọi thứ hoạt động trong môi trường phát triển cục bộ của mình và bạn đã sẵn sàng đưa nó vào sản xuất. Để làm điều đó, bạn cần khóa môi trường của mình để có thể đảm bảo rằng bạn có môi trường tương tự trong quá trình sản xuất Thao tác này sẽ tạo/cập nhật Bây giờ, sau khi bạn nhận được mã và Điều này yêu cầu Pipenv bỏ qua Tệp khóa cho phép các bản dựng xác định bằng cách chụp nhanh tất cả các phiên bản của gói trong một môi trường (tương tự như kết quả của Bây giờ, giả sử một nhà phát triển khác muốn thực hiện một số bổ sung cho mã của bạn. Trong tình huống này, họ sẽ lấy mã, bao gồm cả Thao tác này sẽ cài đặt tất cả các phần phụ thuộc cần thiết cho quá trình phát triển, bao gồm cả phần phụ thuộc thông thường và phần phụ thuộc mà bạn đã chỉ định với đối số
Đây là một lưu ý quan trọng vì nó giải quyết một số vấn đề trước đây chúng ta đã thảo luận. Để chứng minh, giả sử một phiên bản mới của một trong các phần phụ thuộc của bạn có sẵn. Vì bạn không cần phiên bản cụ thể của phần phụ thuộc này nên bạn không chỉ định phiên bản chính xác trong Bây giờ, bạn thực hiện các thay đổi của mình đối với mã và chạy một số thử nghiệm để xác minh mọi thứ vẫn hoạt động như mong đợi. (Bạn có các bài kiểm tra đơn vị phải không?) Bây giờ, giống như trước đây, bạn khóa môi trường của mình bằng Như bạn có thể thấy từ kịch bản này, bạn không còn phải ép buộc các phiên bản chính xác mà bạn không thực sự cần để đảm bảo môi trường sản xuất và phát triển của bạn giống nhau. Bạn cũng không cần phải luôn cập nhật các phụ thuộc phụ mà bạn “không quan tâm. ” Quy trình công việc này với Pipenv, kết hợp với thử nghiệm xuất sắc của bạn, khắc phục các sự cố khi thực hiện thủ công tất cả hoạt động quản lý phụ thuộc của bạn Loại bỏ các quảng cáoPhương pháp tiếp cận giải quyết phụ thuộc của PipenvPipenv sẽ cố gắng cài đặt các phụ thuộc phụ đáp ứng tất cả các yêu cầu từ các phụ thuộc cốt lõi của bạn. Tuy nhiên, nếu có các phụ thuộc xung đột ( Như đã cảnh báo, bạn cũng có thể hiển thị biểu đồ phụ thuộc để hiểu các phụ thuộc cấp cao nhất của mình và các phụ thuộc phụ của chúng Lệnh này sẽ in ra một cấu trúc dạng cây hiển thị các phần phụ thuộc của bạn. Đây là một ví dụ Từ đầu ra của Ngoài ra, bạn có thể đảo ngược cây để hiển thị các thành phần phụ thuộc với cha yêu cầu nó Cây đảo ngược này có thể hữu ích hơn khi bạn đang cố gắng tìm ra các phụ thuộc phụ xung đột PipfilePipfile dự định thay thế Cú pháp của Lý tưởng nhất là bạn không nên có bất kỳ phụ thuộc phụ nào trong Pipfile. KhóaTệp này cho phép các bản dựng xác định bằng cách chỉ định các yêu cầu chính xác để tái tạo một môi trường. Nó chứa các phiên bản chính xác cho các gói và hàm băm để hỗ trợ xác minh an toàn hơn, điều này cũng. Một tệp ví dụ có thể trông giống như sau. Lưu ý rằng cú pháp của tệp này là JSON và tôi đã loại trừ các phần của tệp bằng Lưu ý phiên bản chính xác được chỉ định cho mọi phụ thuộc. Ngay cả các phụ thuộc phụ như Cần lưu ý một lần nữa rằng bạn không bao giờ được thay đổi tệp này bằng tay. Nó có nghĩa là được tạo ra với Các tính năng bổ sung của PipenvMở gói của bên thứ ba trong trình chỉnh sửa mặc định của bạn bằng lệnh sau Thao tác này sẽ mở gói Bạn có thể chạy một lệnh trong môi trường ảo mà không cần khởi chạy shell Kiểm tra các lỗ hổng bảo mật (và yêu cầu PEP 508) trong môi trường của bạn Bây giờ, giả sử bạn không cần gói nữa. Bạn có thể gỡ cài đặt nó Ngoài ra, giả sử bạn muốn xóa hoàn toàn tất cả các gói đã cài đặt khỏi môi trường ảo của mình Bạn có thể thay thế Pipenv hỗ trợ tự động tải các biến môi trường khi tệp Cuối cùng, đây là một số lệnh nhanh để tìm xem đồ đạc ở đâu. Cách tìm ra môi trường ảo của bạn ở đâu Làm thế nào để tìm ra nơi dự án nhà của bạn là Phân phối góiBạn có thể hỏi tất cả điều này hoạt động như thế nào nếu bạn định phân phối mã của mình dưới dạng gói Có, tôi cần phân phối mã của mình dưới dạng góiPipenv hoạt động như thế nào với các tệp Có rất nhiều sắc thái cho câu hỏi đó. Đầu tiên, tệp Điều này có nghĩa là các dự án như flit có thể sử dụng Tất cả những gì đang được nói, trong tương lai gần Đây là quy trình công việc được đề xuất khi bạn đang sử dụng
Để làm rõ, hãy đặt các yêu cầu tối thiểu của bạn vào Tôi không cần phân phối mã của mình dưới dạng góiTuyệt quá. Nếu bạn đang phát triển một ứng dụng không nhằm mục đích phân phối hoặc cài đặt (trang web cá nhân, ứng dụng dành cho máy tính để bàn, trò chơi hoặc tương tự), bạn không thực sự cần một Trong tình huống này, bạn có thể sử dụng kết hợp Tôi đã có một package_c>=1.0,<=2.0 package_a package_b 0. Làm cách nào để chuyển đổi sang $ twine upload dist/* 017?Nếu bạn chạy
Nếu bạn đã ghim các phiên bản chính xác trong tệp Nếu bạn không có bất kỳ yêu cầu phiên bản cụ thể nào cho các phần phụ thuộc của mình, bạn có thể sử dụng ký tự đại diện Nếu bạn cảm thấy lo lắng về việc cho phép bất kỳ phiên bản nào với Tất nhiên, luôn cập nhật các bản phát hành mới cũng có nghĩa là bạn chịu trách nhiệm đảm bảo mã của mình vẫn hoạt động như mong đợi khi các gói thay đổi. Điều này có nghĩa là một bộ thử nghiệm là cần thiết cho toàn bộ quy trình Pipenv này nếu bạn muốn đảm bảo các bản phát hành mã của mình hoạt động hiệu quả Bạn cho phép các gói cập nhật, chạy thử nghiệm, đảm bảo tất cả chúng đều vượt qua, khóa môi trường của bạn và sau đó bạn có thể yên tâm khi biết rằng mình chưa giới thiệu các thay đổi vi phạm. Nếu mọi thứ bị hỏng do phụ thuộc, bạn có một số bài kiểm tra hồi quy để viết và có thể có thêm một số hạn chế đối với các phiên bản phụ thuộc Ví dụ: nếu
Tùy chọn 1 được ưu tiên hơn vì nó đảm bảo rằng mã của bạn đang sử dụng các phụ thuộc cập nhật nhất. Tuy nhiên, Tùy chọn 2 mất ít thời gian hơn và không yêu cầu thay đổi mã, chỉ hạn chế về phụ thuộc Bạn cũng có thể cài đặt từ các tệp yêu cầu với cùng đối số Nếu bạn có Ngoài ra, bạn có thể thực hiện theo cách khác và tạo các tệp yêu cầu từ Cái gì tiếp theo?Đối với tôi, có vẻ như tiến trình tự nhiên cho hệ sinh thái Python sẽ là một hệ thống xây dựng sử dụng Điều đó đang được nói, tôi có thể thấy một tương lai nơi phần Pipenv có đáng để kiểm tra không?Chắc chắn. Ngay cả khi đó chỉ là một cách để hợp nhất các công cụ bạn đã sử dụng ( Bạn không còn phải đau đầu trong việc tự mình quản lý các phiên bản của mọi thứ chỉ để đảm bảo rằng bạn có thể tái tạo môi trường phát triển của mình. Với Ngoài tất cả những điều đó, có vẻ như định dạng Tài liệu tham khảo, đọc thêm, thảo luận thú vị, v.v.
Tiền thưởng miễn phí. Nhấp vào đây để truy cập lớp học 5 ngày miễn phí chỉ cho bạn cách tránh các sự cố quản lý phụ thuộc phổ biến với các công cụ như Pip, PyPI, Virtualenv và các tệp yêu cầu Đánh dấu là đã hoàn thành Xem ngay Hướng dẫn này có một khóa học video liên quan do nhóm Real Python tạo. Xem nó cùng với hướng dẫn bằng văn bản để hiểu sâu hơn. Làm việc với Pipenv 🐍 Thủ thuật Python 💌 Nhận một Thủ thuật Python ngắn và hấp dẫn được gửi đến hộp thư đến của bạn vài ngày một lần. Không có thư rác bao giờ. Hủy đăng ký bất cứ lúc nào. Được quản lý bởi nhóm Real Python Gửi cho tôi thủ thuật Python » Giới thiệu về Alexander VanTol Alexander là một Pythonista cuồng nhiệt, người dành thời gian cho nhiều dự án sáng tạo khác nhau liên quan đến lập trình, âm nhạc và viết sáng tạo » Thông tin thêm về AlexanderMỗi hướng dẫn tại Real Python được tạo bởi một nhóm các nhà phát triển để nó đáp ứng các tiêu chuẩn chất lượng cao của chúng tôi. Các thành viên trong nhóm đã làm việc trong hướng dẫn này là Aldren Đan Joanna Bậc thầy Kỹ năng Python trong thế giới thực Với quyền truy cập không giới hạn vào Python thực Tham gia với chúng tôi và có quyền truy cập vào hàng nghìn hướng dẫn, khóa học video thực hành và cộng đồng các Pythonistas chuyên gia Nâng cao kỹ năng Python của bạn » Bậc thầy Kỹ năng Python trong thế giới thực Tham gia với chúng tôi và có quyền truy cập vào hàng ngàn hướng dẫn, khóa học video thực hành và cộng đồng Pythonistas chuyên gia Nâng cao kỹ năng Python của bạn » Bạn nghĩ sao? Đánh giá bài viết này Tweet Chia sẻ Chia sẻ EmailBài học số 1 hoặc điều yêu thích mà bạn đã học được là gì? Mẹo bình luận. Những nhận xét hữu ích nhất là những nhận xét được viết với mục đích học hỏi hoặc giúp đỡ các sinh viên khác. và nhận câu trả lời cho các câu hỏi phổ biến trong cổng thông tin hỗ trợ của chúng tôi Ví dụ về gói trong Python là gì?Một gói về cơ bản là một thư mục chứa các tệp Python và một tệp có tên __init__. py. Điều này có nghĩa là mọi thư mục bên trong đường dẫn Python chứa tệp có tên __init__. py, sẽ được Python coi là một gói
Làm cách nào để đóng gói một ứng dụng Python?Sử dụng pip là cách thông thường nhất và được hỗ trợ tốt nhất để đóng gói ứng dụng Python để tái sử dụng . Chỉ cần lấy thư mục ứng dụng của bạn và trang bị cho nó một thiết lập. py, biến nó thành một gói có thể cài đặt pip. |
