Số phiên bản và lịch sử

Phát triển gói Python

James Fulton

Climate informatics researcher

Tệp cuối cùng

  • CONTRIBUTING.md
  • HISTORY.md
mysklearn/
|-- mysklearn/
|   |-- __init__.py
|   `-- mysklearn.py
|-- tests/
|   |-- __init__.py
|   `-- test_mysklearn.py
|-- MANIFEST.in
|-- README.md
|-- requirements_dev.txt
|-- setup.cfg
|-- setup.py
|-- tox.ini
|-- AUTHORS.md
|-- CONTRIBUTING.md  <-- tệp mới
|-- HISTORY.md       <--
`-- Makefile
Phát triển gói Python

CONTRIBUTING.md

  • Dạng markdown hoặc reStructured-Text
  • Mời nhà phát triển khác đóng góp vào gói của bạn
  • Hướng dẫn cách bắt đầu
Phát triển gói Python

HISTORY.md

ví dụ: Ghi chú phát hành NumPy

  • Còn gọi là lịch sử, changelog hoặc ghi chú phát hành
  • Cho biết người dùng những gì đã thay đổi giữa các phiên bản
Phát triển gói Python

HISTORY.md

  • Mục cho mỗi phiên bản đã phát hành
  • Gạch đầu dòng các thay đổi quan trọng
  • Các tiểu mục cho
# Lịch sử

## 0.3.0 ## 0.2.1 ## 0.2.0
Phát triển gói Python

HISTORY.md

  • Mục cho mỗi phiên bản đã phát hành
  • Gạch đầu dòng các thay đổi quan trọng
  • Các tiểu mục cho
    • Cải tiến chức năng hiện có
# Lịch sử

## 0.3.0
### Thay đổi
- Tăng tốc khớp hồi quy bằng phép toán NumPy.




## 0.2.1



## 0.2.0











Phát triển gói Python

HISTORY.md

  • Mục cho mỗi phiên bản đã phát hành
  • Gạch đầu dòng các thay đổi quan trọng
  • Các tiểu mục cho
    • Cải tiến chức năng hiện có
    • Bổ sung mới
# Lịch sử

## 0.3.0
### Thay đổi
- Tăng tốc khớp hồi quy bằng phép toán NumPy.




## 0.2.1



## 0.2.0
### Đã thêm
- Hồi quy tuyến tính bội hiện có trong mô-đun mới 
  `regression.multiple_regression`.








Phát triển gói Python

HISTORY.md

  • Mục cho mỗi phiên bản đã phát hành
  • Gạch đầu dòng các thay đổi quan trọng
  • Các tiểu mục cho
    • Cải tiến chức năng hiện có
    • Bổ sung mới
    • Lỗi đã được sửa
# Lịch sử

## 0.3.0
### Thay đổi
- Tăng tốc khớp hồi quy bằng phép toán NumPy.




## 0.2.1
### Đã sửa
- Sửa lỗi khiến hệ số chặn bằng 0.

## 0.2.0
### Đã thêm
- Hồi quy tuyến tính bội hiện có trong mô-đun mới 
  `regression.multiple_regression`.








Phát triển gói Python

HISTORY.md

  • Mục cho mỗi phiên bản đã phát hành
  • Gạch đầu dòng các thay đổi quan trọng
  • Các tiểu mục cho
    • Cải tiến chức năng hiện có
    • Bổ sung mới
    • Lỗi đã được sửa
    • Tính năng ngừng hỗ trợ
# Lịch sử

## 0.3.0
### Thay đổi
- Tăng tốc khớp hồi quy bằng phép toán NumPy.
### Ngừng hỗ trợ
- Kết thúc hỗ trợ Python 3.5.
- Mô-đun `regression.regression` đã bị loại bỏ.

## 0.2.1
### Đã sửa
- Sửa lỗi khiến hệ số chặn bằng 0.

## 0.2.0
### Đã thêm
- Hồi quy tuyến tính bội hiện có trong mô-đun mới 
  `regression.multiple_regression`.
### Ngừng hỗ trợ
- 0.2.x sẽ là phiên bản cuối cùng hỗ trợ Python 3.5.
- Mô-đun `regression.regression` được đổi tên thành 
  `regression.single_regression`. `regression.regression` sẽ bị 
  loại bỏ ở bản phát hành phụ tiếp theo.


Phát triển gói Python

Lịch sử

0.3.0

Thay đổi
  • Tăng tốc khớp hồi quy bằng phép toán NumPy.
Ngừng hỗ trợ
  • Kết thúc hỗ trợ Python 3.5.
  • Mô-đun regression.regression đã bị loại bỏ.

0.2.1

Đã sửa
  • Sửa lỗi khiến hệ số chặn bằng 0.

0.2.0

Đã thêm
  • Hồi quy tuyến tính bội hiện có trong mô-đun mới regression.multiple_regression.
Ngừng hỗ trợ
  • 0.2.x sẽ là phiên bản cuối cùng hỗ trợ Python 3.5.
  • Mô-đun regression.regression được đổi tên thành regression.single_regression. regression.regression sẽ bị loại bỏ ở bản phát hành phụ tiếp theo.
Phát triển gói Python

Số phiên bản

  • Tăng số phiên bản khi sẵn sàng phát hành mới
  • Không thể tải lên PyPI nếu không đổi số phiên bản
mysklearn/
|-- mysklearn/
|   |-- __init__.py         <---
|   `-- mysklearn.py
|-- setup.py                <---
...
Phát triển gói Python

Số phiên bản của gói

setup.py

# Import required functions
from setuptools import setup, find_packages

# Call setup function
setup(
    ...
    version='0.1.0',  <---
    ...

)

__init__.py cấp cao nhất

"""
Hồi quy tuyến tính cho Python
=============================

mysklearn là gói đầy đủ để triển khai
hồi quy tuyến tính trong python. 
"""

__version__ = '0.1.0'  <---
print(mysklearn.__version__)
0.1.0
Phát triển gói Python

bumpversion

  • Công cụ tiện lợi để cập nhật mọi số phiên bản trong gói
bumpversion major
bumpversion minor
bumpversion patch
mysklearn/    <--   điều hướng đến đây
|-- mysklearn/
|   |-- __init__.py
|   `-- mysklearn.py
|-- setup.py
...
Phát triển gói Python

Ayo berlatih!

Phát triển gói Python

Preparing Video For Download...