Vietnamese (machine translation)

Lưu ý

Mục đích của file này là để độc giả tiếng Việt có thể đọc và hiểu tài liệu nhân kernel dễ dàng hơn, không phải để tạo ra một nhánh tài liệu riêng. Nếu bạn có bất kỳ nhận xét hoặc cập nhật nào cho file này, vui lòng thử cập nhật file tiếng Anh gốc trước. Nếu bạn thấy có sự khác biệt giữa bản dịch và bản gốc, hoặc có vấn đề về bản dịch, vui lòng gửi góp ý hoặc patch cho người dịch của file này, hoặc nhờ người bảo trì và người review tài liệu tiếng Việt giúp đỡ.

Bản gốc:

Python unittest

Người dịch:

Google Translate (machine translation)

Phiên bản gốc:

8541d8f725c6

Cảnh báo

Tài liệu này được dịch tự động bằng máy và chưa được review bởi người dịch. Nội dung có thể không chính xác hoặc khó hiểu ở một số chỗ. Khi có sự khác biệt với bản gốc, bản gốc luôn là chuẩn. Bản dịch chất lượng cao (được review) được đặt trong thư mục vi_VN/.

Python kém nhất

Kiểm tra tính nhất quán của các mô-đun python có thể phức tạp. Đôi khi, nó là hữu ích để xác định một tập hợp các bài kiểm tra đơn vị nhằm giúp kiểm tra chúng.

Mặc dù việc triển khai thử nghiệm thực tế phụ thuộc vào từng trường hợp sử dụng nhưng Python đã cung cấp một cách tiêu chuẩn để thêm các bài kiểm tra đơn vị bằng cách sử dụng ZZ0000ZZ.

Sử dụng lớp như vậy, yêu cầu thiết lập một bộ thử nghiệm. Ngoài ra, định dạng mặc định có một chút khó chịu. Để cải thiện nó và cung cấp một cách thống nhất hơn để báo cáo lỗi, một số lớp và hàm nhỏ nhất được xác định.

Mô-đun trợ giúp đơn giản nhất

Provides helper functions and classes execute python unit tests.

Those help functions provide a nice colored output summary of each executed test and, when a test fails, it shows the different in diff format when running in verbose mode, like:

$ tools/unittests/nested_match.py -v
...
Traceback (most recent call last):
File "/new_devel/docs/tools/unittests/nested_match.py", line 69, in test_count_limit
    self.assertEqual(replaced, "bar(a); bar(b); foo(c)")
    ~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
AssertionError: 'bar(a) foo(b); foo(c)' != 'bar(a); bar(b); foo(c)'
- bar(a) foo(b); foo(c)
?       ^^^^
+ bar(a); bar(b); foo(c)
?       ^^^^^
...

It also allows filtering what tests will be executed via -k parameter.

Typical usage is to do:

from unittest_helper import run_unittest
...

if __name__ == "__main__":
    run_unittest(__file__)

If passing arguments is needed, on a more complex scenario, it can be used like on this example:

from unittest_helper import TestUnits, run_unittest
...
env = {'sudo': ""}
...
if __name__ == "__main__":
    runner = TestUnits()
    base_parser = runner.parse_args()
    base_parser.add_argument('--sudo', action='store_true',
                            help='Enable tests requiring sudo privileges')

    args = base_parser.parse_args()

    # Update module-level flag
    if args.sudo:
        env['sudo'] = "1"

    # Run tests with customized arguments
    runner.run(__file__, parser=base_parser, args=args, env=env)
class lib.python.unittest_helper.Summary(*args, **kwargs)

Bases: TestResult

Overrides unittest.TestResult class to provide a nice colored summary. When in verbose mode, displays actual/expected difference in unified diff format.

addError(test, err)

Called when an error has occurred. ‘err’ is a tuple of values as returned by sys.exc_info().

addFailure(test, err)

Called when an error has occurred. ‘err’ is a tuple of values as returned by sys.exc_info().

addSkip(test, reason)

Called when a test is skipped.

addSuccess(test)

Called when a test has completed successfully

max_name_length

max length of the test names.

printResults(verbose)

Print results using colors if tty.

startTest(test)

Called when the given test is about to be run

test_results

Dictionary to store organized test results.

class lib.python.unittest_helper.TestUnits

Bases: object

Helper class to set verbosity level.

This class discover test files, import its unittest classes and executes the test on it.

parse_args()

Returns a parser for command line arguments.

run(caller_file=None, pattern=None, suite=None, parser=None, args=None, env=None)

Execute all tests from the unity test file.

It contains several optional parameters:

caller_file:

  • name of the file that contains test.

    typical usage is to place __file__ at the caller test, e.g.:

    if __name__ == "__main__":
    TestUnits().run(__file__)
pattern:

  • optional pattern to match multiple file names. Defaults to basename of caller_file.

suite:

  • an unittest suite initialized by the caller using unittest.TestLoader().discover().

parser:

  • an argparse parser. If not defined, this helper will create one.

args:

  • an argparse.Namespace data filled by the caller.

env:

  • environment variables that will be passed to the test suite

At least caller_file or suite must be used, otherwise a TypeError will be raised.

lib.python.unittest_helper.flatten_suite(suite)

Flatten test suite hierarchy.

lib.python.unittest_helper.run_unittest(fname)

Basic usage of TestUnits class.

Use it when there’s no need to pass any extra argument to the tests with. The recommended way is to place this at the end of each unittest module:

if __name__ == "__main__":
    run_unittest(__file__)