Hiểu tài liệu không gian tên

Question

Tôi đang cố gắng để hiểu cách doxygen hoạt động với các không gian tên trong Python. Không gian tên của tên "tên tệp" tức là temp.py, được tạo theo mặc định. Tôi cũng có thể khai báo các không gian tên mới bằng lệnh \package hoặc \namespace.

Tuy nhiên, điều tôi không hiểu là lý do lớp bên dưới (hoặc bất kỳ định nghĩa nào khác) luôn xuất hiện trong không gian tên temp?

Hãy giúp tôi hiểu cách lệnh không gian tên hoạt động trong doxygen.

Nếu bạn biết cách và tại sao/không gian tên lệnh pr/gói được sử dụng trong doxygen, bạn có thể bỏ qua ví dụ bên dưới và trả lời trực tiếp.

#filename = temp.py 
##\mainpage Main Page Title 
#\brief main page title comments \n 




## class class_demo1 \n 
# the class declared below \n 
class class_demo1: 
     pass 

from new_package import * 

Bây giờ, tôi đang bổ sung thêm một không gian tên mới bằng tên \ new_package, thêm vào tập tin temp.py

##\package new_package 
#new namespace comments \n 

Tôi cũng đã tạo ra một tập tin có tên \ new_package.py và bổ sung các dòng bên dưới trong đó:

def demo_fun: 
    pass 

class demo_class: 
    pass 

Trong tài liệu được tạo, tôi nhận \ class_demo1 dưới không gian tên \ temp. Tuy nhiên, không gian tên mới \ new_package.py không hiển thị lớp và def khai báo theo nó.

Answer 1

Để đưa Demo lớp thành new_package namespace nếu nó được định nghĩa trong mô-đun new_package.temp:

new_package/ 
├── __init__.py 
│ # from .temp import Demo 
└── temp.py 
    # class Demo: 
    #  pass 

Trong trường hợp này doxygen sẽ cần phải chỉ để phản ánh mối quan hệ đó là đã có trong mã.