Hướng dẫn can we create our own packages in python? - chúng ta có thể tạo các gói của riêng mình trong python không?

Cho dù bạn là nhà phát triển hay chỉ là người dùng Python thỉnh thoảng, thật khó để tưởng tượng một tập lệnh Python mà không có một loạt các báo cáo nhập (hoặc gói) khi bắt đầu mã của bạn.

Nhưng bạn đã bao giờ tự hỏi những gói này đến từ đâu?

Nhập báo cáo làm cho mô -đun Python và dễ sử dụng

Trong văn bản này, tôi sẽ hướng dẫn bạn cách tạo gói Python, với các chức năng tùy chỉnh của riêng bạn, mà bạn có thể nhập trong bất kỳ mã nào. Đây là cách nhanh nhất để chia sẻ mã sẵn sàng sử dụng bên trong các nhóm và cũng là một cách tuyệt vời để đóng góp cho cộng đồng Python, vì bất kỳ người dùng nào cũng có thể chỉ cần PIP cài đặt gói của bạn và nhập nó.

Vì vậy, hãy để bắt đầu!

Bước 1. Tạo các yếu tố gói

Tôi cho rằng bạn đã quen thuộc với Python, tuy nhiên việc tạo ra một gói đòi hỏi phải biết một vài chi tiết. Tôi đã cung cấp cho bạn một gói được công bố lại (có tên DIST_ALX) về cơ bản là một tệp/thư mụcThatContains tất cả các yếu tố cần thiết mà một gói trước khi xuất bản phải có. Chúng tôi sẽ sử dụng thư mục này làm hướng dẫn, vì tất cả các gói Python phải có cấu trúc tương tự này. Gói Dist_alx chính xác là gì, được giải thích ở đây.dist_alx ) which is basically a file/folderthatcontains all the necessary elements which a package before publishing must have. We will use this folder as a guideline, since all Python packages must have this same structure. What the dist_alx package exactly does, is explained here.

Để có được thư mục vào kho GitHub của tôi, hãy tải xuống dist_alx.zip trên máy của bạn và giải nén nó. Thư mục mẹ này Dist_alx chứa các tệp sau:

  • Setup.py Tệp -Contains Gói siêu dữ liệu
  • setup.cfg file -một định dạng tệp cấu hình được sử dụng để lưu trữ cài đặt
  • một bộ lọc phụ có cùng tên với thư mục cha (trong trường hợp này là dist_alx), trong đó mã python thực tế của gói của bạn được lưu trữ

Mỗi gói phải có ba yếu tố trên. Bên cạnh đó, một gói cũng nên có những điều sau:

  • Gói Python của bạn phải có một tên duy nhất. Không có hai gói Python hiện tại có thể chia sẻ cùng tên.
  • Thư mục cha và thư mục phụ phải có cùng tên, đó là tên của gói của bạn.
  • Bên trong tệp setup.py có tên và gói tham số. Họ cũng nên có cùng tên với gói của bạn.name and packages. They also should have the same name as your package.
  • Nhắc tham số phiên bản, trong trường hợp bạn thay đổi một cái gì đó trong gói của mình và tái bản nó, bạn cũng nên thay đổi phiên bảnversion parameter, in case you change something in your package and republish it, you should also change the version
  • Bên trong tệp setup.py có tham số Author_email. Nhập địa chỉ email của riêng bạn tại đâyauthor_email parameter. Type your own email address here

Bước 2. Viết mã

Bên trong bộ lọc phụ nằm ở mã Python thực tế của gói. Nếu bạn mở Sub Dist_alx SuberDeryou sẽ nhận thấy rằng nó chứa một tệp _init_.py. Theo mặc định, hạt nhân Python tìm tệp _init_.py làm điểm bắt đầu khi đọc mã. Tệp _init_.py được liên kết với tất cả các tập lệnh python khác trong trình duyệt phụ (ví dụ: trong tệp _init_.py của chúng tôi, liên kết này được thực hiện thông qua từ. Bạn nên làm mới kiến ​​thức của bạn về các lớp Python trước khi cố gắng viết mã gói.

Bước 3.Open một tài khoản PYPI Open a PyPI Account

Phần lớn các gói Python có sẵn công khai được lưu trữ trong kho Pypi. Khi bạn cài đặt gói trên máy của bạn (thường thông qua câu lệnh Cài đặt PIP), về cơ bản, bạn đang tải xuống gói từ kho PYPI và cài đặt nó trên máy của bạn. Khi xuất bản một gói mới, bạn đang tải nó lên máy chủ PYPI, để cộng đồng có thể sử dụng nó. Để có thể xuất bản trên PYPI, bạn cần mở tài khoản (miễn phí) trên PYPI. Đảm bảo sử dụng cùng một địa chỉ email bạn đã sử dụng cho tham số Author_email.author_email parameter.

Bước 4. Xuất bản gói của bạn Publish your Package

Việc xuất bản được thực hiện từ dấu nhắc/thiết bị đầu cuối lệnh và các lệnh giống hệt nhau trong Windows và Linux.

một. Điều hướng đến vị trí của thư mục cha mẹ của bạn Navigate to the location of your parent folder

b. Pip Cài đặt Setuptools và Twine pip install setuptools and twine

c. Loại: Python setup.py sdist Type: python setup.py sdist

Lưu ý rằng hai thư mục mới hiện được tạo bên trong thư mục gốc (tệp-info trứng và thư mục dist).

d. Loại: Tải lên Twine Dist/* Type: twine upload dist/*

Bạn sẽ cần cung cấp tên người dùng pypi (không phải email) và mật khẩu.

Và Voila! Gói của bạn hiện được lưu trữ trên máy chủ PYPI và sẵn sàng sử dụng!

e. Truy cập PYPI, nhấp vào tài khoản của bạn và truy cập các dự án của bạn. Nếu mọi thứ đều ổn, bạn sẽ thấy gói của bạn ở đó. Go to PyPI, click on your account and go to Your Projects. If everything is fine you should see your package there.

Lưu ý rằng PYPI chỉ hỗ trợ Dash (-) và không nhấn mạnh (_) trong đặt tên tệp. Do đó, dist_alx đã trở thành dist-alx. Tuy nhiên, khi nhập gói sau đó, chúng tôi sẽ nhập dist_alx bình thường.

Bước 5. Sử dụng gói của bạn Use your Package

Truy cập máy khách Python yêu thích của bạn (Terminal, Ipython, Jupyter) và PIP cài đặt gói hàng của bạn. Sau đó nhập gói của bạn và vui vẻ với nó!

Tóm tắt lại

Trong bài viết này, chúng tôi đã trải qua các bước sau đây để tạo gói Python:

  • Làm cho các yếu tố gói cần thiết và quan tâm đến việc đặt tên
  • Viết mã gói
  • Tạo tài khoản PYPI
  • Xuất bản gói trên PYPI
  • Cài đặt, nhập và chạy gói Pip

Ghi chú cuối cùng

#Mã bên trong gói Dist_alx được viết bởi Udacity, do đó tất cả các khoản tín dụng và nhận xét liên quan đến nó có thể được gửi đến chúng.

#Nói chung là một ý tưởng tốt để xuất bản gói của bạn trên máy chủ thử nghiệm PYPI, trước khi đặt nó lên máy chủ PYPI chính.

Bạn có thể đóng gói Python không?

Tạo một gói có thể cài đặt PIP bằng PIP là cách được hỗ trợ thông thường và được hỗ trợ tốt nhất để đóng gói ứng dụng Python để sử dụng lại.Chỉ cần lấy thư mục ứng dụng của bạn và trang trí nó bằng một tệp setup.py, biến nó thành gói pip -installable. Using pip is the most conventional and best-supported way to package a Python application for re-use. Just take your application directory and outfit it with a setup.py file, which turns it into a pip -installable package.

Các gói Python được tạo ra ở đâu?

PYPI là kho lưu trữ Python chính thức nơi lưu trữ tất cả các gói Python.Bạn có thể nghĩ về nó như là github cho các gói Python.Để cung cấp gói Python của bạn cho mọi người trên khắp thế giới, bạn sẽ cần có một tài khoản với PYPI.. You can think of it as the Github for Python Packages. To make your Python package available to people around the world, you'll need to have an account with PyPi.