programming python

Làm thế nào để bạn tạo một chuỗi tài liệu trong python?

Nếu bạn đổi tên một tham số của hàm, PyCharm sẽ cập nhật thẻ tương ứng trong nhận xét tài liệu

Để tạo nhận xét tài liệu cho hàm Python bằng cách sử dụng hành động ý định

Đặt dấu mũ ở đâu đó trong chức năng bạn muốn ghi lại
Nhấn Alt+Enter để hiển thị các hành động ý định có sẵn
Chọn Chèn sơ khai chuỗi tài liệu .
PyCharm tạo sơ khai nhận xét tài liệu theo định dạng chuỗi tài liệu, được chọn trong trang Công cụ tích hợp Python

Ví dụ về nhận xét tài liệu Python

Xét hàm sau

xử lý def [bản thân, myParam1, myParam2]

Mở cài đặt Ctrl+Alt+S và điều hướng đến Công cụ. Công cụ tích hợp Python .

Trong Định dạng chuỗi tài liệu thả xuống, chọn Epytext .

Sau đó nhập ba dấu ngoặc kép mở đầu và nhấn Enter hoặc Space. PyCharm tạo sơ khai nhận xét tài liệu ở định dạng Epytext .

""" @param tự. @param myParam1. @param myParam2. @trở lại. """

Quay lại trang Công cụ tích hợp Python trong cài đặt [Ctrl+Alt+S] và chuyển Docstring format to reStructuredText. Then type the opening triple double-quotes and press Enter or Space. PyCharm generates a documentation comment stub in reStructuredText .

""". thông số tự. . thông số myParam1. . tham số myParam2. . trở lại. """

Bạn có thể sử dụng đánh dấu để định dạng văn bản, cũng như thay thế, danh sách dấu đầu dòng, liên kết, khối mã và bảng

Mô tả dự án

Tự động tạo chuỗi tài liệu từ gợi ý loại

Làm thế nào để sử dụng nó

gendocs file.py

gendocs mydir/

Tùy chọn

Phong cách

--style
Kiểu chuỗi tài liệu [numpy, rest]. [vỡ nợ. numpy]

lớp bỏ qua

--ignore-classes
khi được sử dụng thì sẽ không có lớp nào bị sửa đổi

chức năng bỏ qua

--ignore-functions
khi sử dụng rồi sẽ không có chức năng nào được sửa đổi này
các phương thức lớp quan trọng không có chức năng trong ngữ cảnh này

Thêm thông tin bổ sung trước khi chạy `gendocs`

khi thêm $ vào chuỗi tài liệu của bạn, những thứ này sau đó sẽ được thay thế bằng tham số tại chỉ mục này
Thí dụ

from typing import List


def foo[val_a: int, val_b: List[int]]:
    """
    Lorem ipsum dolor sit amet, consetetur sadipscing elitr,
    sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam

    $1 Lorem ipsum dolor sit amet
    $2 nonumy eirmod tempor invidun
    """

sẽ trở thành [ở đây với phong cách gọn gàng]

from typing import List


def foo[val_a: int, val_b: List[int]]:
    """
    Lorem ipsum dolor sit amet, consetetur sadipscing elitr,
    sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam
    
    Parameters
    ----------
    val_a : argument of type int
        Lorem ipsum dolor sit amet
    val_b : argument of type List[int]
        nonumy eirmod tempor invidun

    """

ví dụ

Một ví dụ có thể được tìm thấy dưới các ví dụ

cài đặt

pip cài đặt trình tạo chuỗi tài liệu

lập phiên bản

Đối với các phiên bản có sẵn, hãy xem các thẻ trên kho lưu trữ này

tác giả

Giấy phép

Dự án này được cấp phép theo Giấy phép MIT - xem GIẤY PHÉP. tập tin md để biết chi tiết

Ghi lại mã của bạn là một kỹ năng quan trọng đối với bất kỳ nhà khoa học dữ liệu hoặc kỹ sư phần mềm nào. Tìm hiểu làm thế nào để làm điều đó bằng cách sử dụng docstrings

Tại sao tài liệu trong Python lại quan trọng?

Điều này cho chúng ta biết rằng "Khả năng đọc được tính" và "Rõ ràng tốt hơn ẩn. " Đây là những đặc điểm cần thiết của Python. Khi chúng tôi viết mã, chúng tôi làm điều đó cho người dùng cuối, nhà phát triển và chính chúng tôi

Hãy nhớ rằng chúng ta cũng là người dùng cuối khi chúng ta đọc tài liệu

6 hoặc tài liệu

7. Hai gói này có tài liệu tuyệt vời và người dùng thường không gặp khó khăn gì khi sử dụng chúng vì chúng chứa rất nhiều ví dụ và hướng dẫn. Họ cũng có tài liệu tích hợp mà chúng tôi có thể truy cập trực tiếp vào IDE ưa thích của bạn

Bây giờ hãy tưởng tượng sử dụng các gói này mà không có bất kỳ tài liệu tham khảo nào. Chúng tôi sẽ cần tìm hiểu mã của họ để hiểu nó làm gì và cách chúng tôi có thể sử dụng nó. Có một số gói hoàn toàn không có tài liệu hướng dẫn và thường mất nhiều thời gian hơn để hiểu những gì bên trong chúng và cách chúng ta có thể sử dụng chúng. Khối lượng công việc này tăng gấp đôi hoặc gấp ba nếu gói lớn, với các chức năng trải rộng trên nhiều tệp

Bây giờ rõ ràng hơn tại sao tài liệu tốt lại được tính

Tiếp theo, các nhà phát triển khác có thể muốn đóng góp cho các dự án của chúng tôi. Họ có thể làm điều đó nhanh hơn và hiệu quả hơn nhiều nếu mã của chúng tôi được ghi chép đầy đủ. Bạn có muốn đóng góp cho một dự án trong thời gian rảnh nếu bạn phải dành hàng giờ để tìm hiểu những phần khác nhau của nó làm gì không?

Cuối cùng, ngay cả khi đó chỉ là dự án riêng của chúng tôi hoặc một tập lệnh nhỏ, chúng tôi vẫn cần tài liệu. Chúng tôi không bao giờ biết khi nào chúng tôi sẽ quay lại một trong những dự án cũ của mình để sửa đổi hoặc cải thiện nó. Thật thú vị và dễ làm việc với nó nếu nó cho chúng ta biết rõ ràng nó dùng để làm gì và các chức năng, dòng mã và mô-đun của nó làm gì. Chúng ta có xu hướng nhanh chóng quên đi những gì mình đang nghĩ trong quá trình viết mã, vì vậy dành thời gian giải thích lý do tại sao chúng ta đang làm điều gì đó luôn giúp tiết kiệm nhiều thời gian hơn khi quay lại mã [ngay cả khi nó mới được viết một ngày trước]. Vì vậy, hãy đầu tư một chút thời gian vào tài liệu và nó sẽ đền đáp cho bạn sau này

Ví dụ về tài liệu Python

Hãy xem qua một số ví dụ về chuỗi tài liệu trong Python. Ví dụ: một hàm tầm thường bên dưới nhận hai biến và trả về tổng của chúng [theo mặc định] hoặc hiệu giữa chúng

def sum_subtract[a, b, operation="sum"]:
    if operation == "sum":
        return a + b
    elif operation == "subtract":
        return a - b
    else:
        print["Incorrect operation."]

print[sum_subtract[1, 2, operation="sum"]]

Chức năng này khá đơn giản, nhưng để chứng minh sức mạnh của chuỗi tài liệu Python, hãy viết một số tài liệu

________số 8_______

Chuỗi tài liệu Python của hàm này được đặt giữa ba dấu ngoặc kép từ cả hai phía. Như bạn có thể thấy, chuỗi này giải thích chức năng này làm gì và cho biết cách chúng ta có thể thay đổi chức năng của nó — và điều gì xảy ra nếu nó không hỗ trợ hành động mà chúng ta muốn nó thực hiện. Đó là một ví dụ đơn giản và bạn có thể lập luận rằng chức năng này quá rõ ràng để yêu cầu bất kỳ lời giải thích nào, nhưng một khi các chức năng trở nên phức tạp và số lượng của chúng tăng lên, bạn sẽ cần ít nhất một số tài liệu để tránh bị lạc trong mã của chính mình

Điều gì đang xảy ra dưới mui xe? . Tất cả các gói tài liệu tốt đều có chuỗi tài liệu cho [gần như] tất cả các chức năng của chúng. Ví dụ: hãy xem DataFrame trong pandas

import pandas as pd

help[pd.DataFrame]

# Help on class DataFrame in module pandas.core.frame:

# class DataFrame[pandas.core.generic.NDFrame, pandas.core.arraylike.OpsMixin]
#  |  DataFrame[data=None, index: 'Axes | None' = None, columns: 'Axes | None' = None, dtype: 'Dtype | None' = None, copy: 'bool | None' = None]
#  |
#  |  Two-dimensional, size-mutable, potentially heterogeneous tabular data.
#  |
#  |  Data structure also contains labeled axes [rows and columns].
#  |  Arithmetic operations align on both row and column labels. Can be
#  |  thought of as a dict-like container for Series objects. The primary
#  |  pandas data structure.
#  |
#  |  Parameters
#  |  ----------
#  |  data : ndarray [structured or homogeneous], Iterable, dict, or DataFrame
#  |      Dict can contain Series, arrays, constants, dataclass or list-like objects. If
#  |      data is a dict, column order follows insertion-order. If a dict contains Series
#  |      which have an index defined, it is aligned by its index.
#  |
#  |      . versionchanged:: 0.25.0
#  |         If data is a list of dicts, column order follows insertion-order.
#  |
#  |  index : Index or array-like
#  |      Index to use for resulting frame. Will default to RangeIndex if
#  |      no indexing information part of input data and no index provided.
#  |  columns : Index or array-like
#  |      Column labels to use for resulting frame when data does not have them,
#  |      defaulting to RangeIndex[0, 1, 2, ..., n]. If data contains column labels,
#  |      will perform column selection instead.
#  |  dtype : dtype, default None
#  |      Data type to force. Only a single dtype is allowed. If None, infer.
#  |  copy : bool or None, default None
#  |      Copy data from inputs.
#  |      For dict data, the default of None behaves like ``copy=True``.  For DataFrame
#  |      or 2d ndarray input, the default of None behaves like ``copy=False``.
#  |
#  |      . versionchanged:: 1.3.0

# Docstring continues...

Bây giờ, nếu chúng ta xem mã nguồn

6, chúng ta sẽ thấy rằng

def sum_subtract[a, b, operation="sum"]:
    """
    Return sum or difference between the numbers 'a' and 'b'.
    The type of operation is defined by the 'operation' argument.
    If the operation is not supported, print 'Incorrect operation.'
    """
    if operation == "sum":
        return a + b
    elif operation == "subtract":
        return a - b
    else:
        print["Incorrect operation."]

1 hiển thị cho chúng ta chuỗi tài liệu của lớp

def sum_subtract[a, b, operation="sum"]:
    """
    Return sum or difference between the numbers 'a' and 'b'.
    The type of operation is defined by the 'operation' argument.
    If the operation is not supported, print 'Incorrect operation.'
    """
    if operation == "sum":
        return a + b
    elif operation == "subtract":
        return a - b
    else:
        print["Incorrect operation."]

2 [tìm kiếm

def sum_subtract[a, b, operation="sum"]:
    """
    Return sum or difference between the numbers 'a' and 'b'.
    The type of operation is defined by the 'operation' argument.
    If the operation is not supported, print 'Incorrect operation.'
    """
    if operation == "sum":
        return a + b
    elif operation == "subtract":
        return a - b
    else:
        print["Incorrect operation."]

Về mặt kỹ thuật, chuỗi tài liệu được gán cho một thuộc tính được tạo tự động của đối tượng này có tên là

def sum_subtract[a, b, operation="sum"]:
    """
    Return sum or difference between the numbers 'a' and 'b'.
    The type of operation is defined by the 'operation' argument.
    If the operation is not supported, print 'Incorrect operation.'
    """
    if operation == "sum":
        return a + b
    elif operation == "subtract":
        return a - b
    else:
        print["Incorrect operation."]

4. Chúng ta cũng có thể in thuộc tính này ra và thấy rằng nó hoàn toàn giống như trước đây

print[pd.DataFrame.__doc__[:1570]]  # Truncated

    Two-dimensional, size-mutable, potentially heterogeneous tabular data.

    Data structure also contains labeled axes [rows and columns].
    Arithmetic operations align on both row and column labels. Can be
    thought of as a dict-like container for Series objects. The primary
    pandas data structure.

    Parameters
    ----------
    data : ndarray [structured or homogeneous], Iterable, dict, or DataFrame
        Dict can contain Series, arrays, constants, dataclass or list-like objects. If
        data is a dict, column order follows insertion-order. If a dict contains Series
        which have an index defined, it is aligned by its index.

        . versionchanged:: 0.25.0
           If data is a list of dicts, column order follows insertion-order.

    index : Index or array-like
        Index to use for resulting frame. Will default to RangeIndex if
        no indexing information part of input data and no index provided.
    columns : Index or array-like
        Column labels to use for resulting frame when data does not have them,
        defaulting to RangeIndex[0, 1, 2, ..., n]. If data contains column labels,
        will perform column selection instead.
    dtype : dtype, default None
        Data type to force. Only a single dtype is allowed. If None, infer.
    copy : bool or None, default None
        Copy data from inputs.
        For dict data, the default of None behaves like `copy=True`.  For DataFrame
        or 2d ndarray input, the default of None behaves like `copy=False`.

        . versionchanged:: 1.3.0

Sự khác biệt giữa Tài liệu và Nhận xét Mã

Sau khi chúng tôi đã thấy các chuỗi tài liệu trông như thế nào, đã đến lúc tìm hiểu lý do và cách chúng khác với các nhận xét mã thông thường. Ý tưởng chính là chúng [thường] phục vụ các mục đích khác nhau

Các tài liệu giải thích chức năng/lớp cần thiết để làm gì [i. e. , mô tả, đối số và đầu ra của nó — và bất kỳ thông tin hữu ích nào khác] trong khi nhận xét giải thích chức năng của các chuỗi mã cụ thể. Nói cách khác, nhận xét mã dành cho những người muốn sửa đổi mã và chuỗi tài liệu dành cho những người muốn sử dụng mã

Ngoài ra, nhận xét mã có thể hữu ích khi lập kế hoạch mã [ví dụ: bằng cách triển khai mã giả hoặc để lại nhận xét tạm thời về ý tưởng hoặc suy nghĩ của bạn không dành cho người dùng cuối]

Định dạng chuỗi tài liệu

Hãy xem xét các loại docstrings khác nhau. Đầu tiên, bạn nên duyệt qua các trang PEP của Python. Chúng ta có thể tìm thấy PEP 257, tóm tắt các tài liệu Python. Tôi thực sự khuyên bạn nên đọc tất cả mặc dù bạn có thể không hiểu tất cả. Các điểm thiết yếu như sau

Sử dụng ba dấu ngoặc kép để đính kèm các tài liệu
Chuỗi tài liệu kết thúc bằng dấu chấm
Nó sẽ mô tả lệnh của chức năng [i. e. , chức năng này làm gì, vì vậy chúng ta thường bắt đầu cụm từ bằng "Return…"]
Nếu chúng ta cần thêm nhiều thông tin hơn [ví dụ, về các đối số], thì chúng ta nên để một dòng trống giữa phần tóm tắt hàm/lớp và phần mô tả chi tiết hơn [sẽ nói thêm về điều này sau trong phần hướng dẫn]
Các tài liệu nhiều dòng vẫn ổn nếu chúng tăng khả năng đọc
Cần có một mô tả về các đối số, đầu ra, ngoại lệ, v.v.

Lưu ý rằng đây chỉ là những khuyến nghị và không phải là quy tắc nghiêm ngặt. Ví dụ: tôi nghi ngờ rằng chúng ta sẽ cần bổ sung thêm thông tin về các đối số hoặc đầu ra cho hàm

9 vì bản tóm tắt đã đủ mô tả

Có bốn loại tài liệu chính, tất cả đều tuân theo các khuyến nghị trên

Tài liệu NumPy/SciPy
cấu trúc lại văn bản
văn bản

Bạn có thể xem tất cả chúng và quyết định cái nào bạn thích nhất. Các chuỗi tài liệu NumPy/SciPy và Google sẽ xuất hiện thường xuyên hơn mặc dù reStructuredText là kiểu tài liệu chính thức của Python

Hãy xem xét một tập dữ liệu trong thế giới thực và viết một hàm để áp dụng cho một trong các cột của nó

Bộ dữ liệu này chứa các trò chơi điện tử hàng đầu trên Metacritic trong giai đoạn 1995-2021

from datetime import datetime
import pandas as pd

all_games = pd.read_csv["all_games.csv"]
print[all_games.head[]]

                                   name        platform        release_date  \
0  The Legend of Zelda: Ocarina of Time     Nintendo 64   November 23, 1998   
1              Tony Hawk's Pro Skater 2     PlayStation  September 20, 2000   
2                   Grand Theft Auto IV   PlayStation 3      April 29, 2008   
3                           SoulCalibur       Dreamcast   September 8, 1999   
4                   Grand Theft Auto IV        Xbox 360      April 29, 2008   

                                             summary  meta_score user_review  
0  As a young boy, Link is tricked by Ganondorf, ..          99         9.1  
1  As most major publishers' development efforts ..          98         7.4  
2  [Metacritic's 2008 PS3 Game of the Year; Also ..          98         7.7  
3  This is a tale of souls and swords, transcendi..          98         8.4  
4  [Metacritic's 2008 Xbox 360 Game of the Year; ..          98         7.9

Ví dụ: chúng tôi có thể quan tâm đến việc tạo một cột tính toán số ngày trước một trò chơi đã được phát hành. Với mục đích này, chúng tôi cũng sẽ sử dụng gói

def sum_subtract[a, b, operation="sum"]:
    """
    Return sum or difference between the numbers 'a' and 'b'.
    The type of operation is defined by the 'operation' argument.
    If the operation is not supported, print 'Incorrect operation.'
    """
    if operation == "sum":
        return a + b
    elif operation == "subtract":
        return a - b
    else:
        print["Incorrect operation."]

6 [hướng dẫn một, hướng dẫn hai]

Đầu tiên, hãy viết chức năng này và kiểm tra nó

def days_release[date]:
    current_date = datetime.now[]
    release_date_dt = datetime.strptime[date, "%B %d, %Y"] # Convert date string into datetime object
    return [current_date - release_date_dt].days

print[all_games["release_date"].apply[days_release]]

Chức năng này hoạt động như dự định, nhưng tốt hơn là bổ sung cho nó bằng các chuỗi tài liệu. Trước hết, hãy sử dụng định dạng SciPy/NumPy

Ở trên trong phần

def sum_subtract[a, b, operation="sum"]:
    """
    Return sum or difference between the numbers 'a' and 'b'.
    The type of operation is defined by the 'operation' argument.
    If the operation is not supported, print 'Incorrect operation.'
    """
    if operation == "sum":
        return a + b
    elif operation == "subtract":
        return a - b
    else:
        print["Incorrect operation."]

7, tôi không lặp lại [hầu hết] những gì đã có trong phần tóm tắt

Tiếp theo, một ví dụ về tài liệu của Google

Một ví dụ về cấu trúc lại văn bản

Cuối cùng, một ví dụ Epytext

Hầu hết các chuỗi tài liệu chức năng phải có ít nhất một bản tóm tắt về chức năng, mô tả đầu vào và đầu ra của chúng. Hơn nữa, nếu chúng phức tạp hơn, chúng có thể bao gồm các ví dụ, ghi chú, ngoại lệ, v.v.

Cuối cùng, tôi không nói nhiều về các lớp vì chúng không thường xuyên xuất hiện trong khoa học dữ liệu, nhưng ngoài các phương thức [chức năng] của chúng bao gồm những gì, chúng cũng nên có những điều sau

mô tả thuộc tính
Danh sách các phương thức và tóm tắt chức năng của chúng
Giá trị mặc định của thuộc tính

Tài liệu kịch bản

Các tài liệu Python cũng mô tả chức năng và nguyên tắc sử dụng của các tập lệnh nhỏ, có thể phù hợp để tự động hóa một số tác vụ hàng ngày của chúng ta. Ví dụ: tôi thường xuyên cần đổi kroner Đan Mạch sang euro. Tôi có thể nhập một truy vấn trên Google mỗi lần hoặc tôi có thể tải xuống một ứng dụng có thể thực hiện điều đó cho tôi, nhưng tất cả dường như quá phức tạp và dư thừa. Tôi biết rằng một euro là khoảng 7. 45 krone Đan Mạch và vì tôi hầu như luôn làm việc trong thiết bị đầu cuối Linux, nên tôi quyết định viết một chương trình CLI nhỏ để chuyển đổi loại tiền này sang loại tiền khác

Tập lệnh phải được ghi lại đầy đủ để cho phép người dùng áp dụng nó. Ở đầu tệp, một chuỗi tài liệu sẽ mô tả mục đích chính của tập lệnh, hướng dẫn ngắn gọn và các hàm hoặc lớp chứa trong đó. Ngoài ra, nếu bất kỳ gói của bên thứ ba nào được sử dụng, gói đó phải được nêu trong tài liệu để người dùng cài đặt gói đó trước khi sử dụng tập lệnh

Nếu bạn sử dụng mô-đun

def sum_subtract[a, b, operation="sum"]:
    """
    Return sum or difference between the numbers 'a' and 'b'.
    The type of operation is defined by the 'operation' argument.
    If the operation is not supported, print 'Incorrect operation.'
    """
    if operation == "sum":
        return a + b
    elif operation == "subtract":
        return a - b
    else:
        print["Incorrect operation."]

8 để tạo các ứng dụng CLI, thì mỗi đối số của nó phải được mô tả trong menu

def sum_subtract[a, b, operation="sum"]:
    """
    Return sum or difference between the numbers 'a' and 'b'.
    The type of operation is defined by the 'operation' argument.
    If the operation is not supported, print 'Incorrect operation.'
    """
    if operation == "sum":
        return a + b
    elif operation == "subtract":
        return a - b
    else:
        print["Incorrect operation."]

1 để người dùng cuối có thể chọn tùy chọn

import pandas as pd

0 và xác định đầu vào. Hơn nữa, tham số

import pandas as pd

1 phải được điền vào trong đối tượng

import pandas as pd

Cuối cùng, tất cả các chức năng phải được ghi lại đúng cách như đã mô tả trước đây. Ở đây, tôi đã bỏ qua các bộ mô tả "Đối số" và "Trả về" bởi vì, theo quan điểm của tôi, chúng không cần thiết

Ngoài ra, hãy lưu ý cách tôi sử dụng nhận xét mã và cách chúng khác với chuỗi tài liệu. Nếu bạn có một kịch bản bạn đã viết, hãy thêm vào đó một số tài liệu để thực hành

Lời khuyên chung về cách viết tài liệu và tài liệu Python

Khá rõ ràng tại sao tài liệu lại quan trọng và tại sao chuỗi tài liệu là một phần thiết yếu của tài liệu Python. Để kết thúc, hãy để tôi cung cấp cho bạn một số lời khuyên chung về tài liệu và chuỗi tài liệu Python

Viết tài liệu cho con người, không phải máy tính. Nó nên được mô tả nhưng ngắn gọn và đơn giản
Đừng lạm dụng docstrings. Đôi khi chúng không cần thiết và một chú thích mã nhỏ có thể đủ [hoặc thậm chí không có chú thích nào cả]. Giả sử rằng nhà phát triển có một số kiến thức cơ bản về Python
Các tài liệu không nên giải thích cách thức hoạt động của hàm ẩn mà thay vào đó, cách sử dụng nó. Đôi khi, có thể cần phải giải thích cơ chế bên trong của một đoạn mã, vì vậy hãy sử dụng chú thích mã cho điều đó
Không sử dụng chuỗi tài liệu thay cho nhận xét và nhận xét thay cho mã

Tóm lược

Đây là những gì chúng ta đã học được trong hướng dẫn này

Tài liệu là một phần thiết yếu của dự án Python — nó quan trọng đối với người dùng cuối, nhà phát triển và bạn
Tài liệu là để sử dụng mã và nhận xét là để sửa đổi mã
PEP 257 tóm tắt các tài liệu Python
Có bốn định dạng chuỗi tài liệu chính. Các chuỗi tài liệu NumPy/SciPy, , reStructuredText và Epytext. Hai cái đầu tiên là phổ biến nhất
Một chuỗi tài liệu tập lệnh phải mô tả chức năng của tập lệnh, cách sử dụng và các chức năng có trong đó

Tôi hy vọng rằng bạn đã học được một cái gì đó mới ngày hôm nay. Vui lòng kết nối với tôi trên LinkedIn hoặc GitHub. Mã hóa vui vẻ

Khoa học dữ liệu hướng dẫn Python

Thông tin về các Tác giả

Artur Sannikov

Tôi là sinh viên Sinh học phân tử tại Đại học Padua, Ý quan tâm đến tin sinh học và phân tích dữ liệu

docstrings trong Python là gì đưa ra một ví dụ?

Như đã đề cập ở trên, chuỗi tài liệu Python là chuỗi được sử dụng ngay sau định nghĩa của hàm, phương thức, lớp hoặc mô-đun [như trong Ví dụ 1]. Chúng được sử dụng để ghi lại mã của chúng tôi. Chúng ta có thể truy cập các chuỗi tài liệu này bằng thuộc tính __doc__

Làm cách nào để định dạng chuỗi tài liệu Python?

Định dạng chuỗi tài liệu .

Sử dụng ba dấu ngoặc kép để đính kèm các tài liệu

Chuỗi tài liệu kết thúc bằng dấu chấm

Nó sẽ mô tả lệnh của chức năng [i. e. , chức năng này làm gì, vì vậy chúng ta thường bắt đầu cụm từ bằng "Return…"]