Merge pull request #97 from arimakaori/master

add chinese comments

Author: wh0am1i

zoomeye/core.py

@@ -16,7 +16,8 @@
 zoomeye_dir = os.path.expanduser(config.ZOOMEYE_CONFIG_PATH)
 
 
-def init_key(key):
+def init_key(key): #初始化API密钥并将其保存在本地配置文件中
+
     """
     initialize through the api key, write the api key to the local configuration file,
     theoretically it will never expire unless you remake the api key
@@ -43,7 +44,7 @@ def init_key(key):
     os.chmod(key_file, 0o600)
 
 
-def init(args):
+def init(args):#根据用户输入的参数来选择初始化方法，可以通过API密钥来进行初始化
     """
     the initialization processing function will select the initialization method according to the user's input.
     :param args:
@@ -59,7 +60,7 @@ def init(args):
     show.printf("please run <zoomeye init -h> for help.", color="red")
 
 
-def search(args):
+def search(args):#进行搜索操作，根据用户输入的搜索条件进行搜索
     dork = args.dork
     num = int(args.num)
     facet = args.facet
@@ -93,7 +94,7 @@ def search(args):
     show.printf("please run <zoomeye search -h> for help.")
 
 
-def info(args):
+def info(args):#打印当前用户的身份和本月剩余的数据配额
     """
     used to print the current identity of the user and the remaining data quota for the month
     :param args:
@@ -111,7 +112,7 @@ def info(args):
         show.printf("quota_info: {}".format(user_data["quota_info"]))
 
 
-def ip_history(args):
+def ip_history(args):#查询设备的历史信息
     """
     query device history
     please see: https://www.zoomeye.org/doc#history-ip-search
@@ -141,7 +142,7 @@ def ip_history(args):
     zm.show_fields()
 
 
-def clear_file(args):
+def clear_file(args):#清除用户设置和ZoomEye缓存数据
     """
     clear user setting and zoomeye cache data
     """
@@ -165,7 +166,7 @@ def clear_file(args):
     show.printf("clear complete!", color='green')
 
 
-def information_ip(args):
+def information_ip(args):#获取特定IP的信息
     ip = args.ip
     filters = args.filter
     # determine whether the input is an IP address by regular
@@ -185,7 +186,7 @@ def information_ip(args):
     infor.show_information()
 
 
-def associated_domain_query(args):
+def associated_domain_query(args):#关联域名查询
     q = args.q
     resource = args.type
     page = args.page

zoomeye/data.py

@@ -259,7 +259,7 @@ def process_filter(fields, data, tables):
     return result_data, has_equal, not_equal
 
 
-class Cache:
+class Cache:#用于缓存从API获取的数据或从本地文件中读取数据
     """
     used to cache the data obtained from the api to the local,
     or directly clip the file from the local.
@@ -333,7 +333,7 @@ def update(self):
         pass
 
 
-class CliZoomEye:
+class CliZoomEye:#处理与ZoomEye搜索相关的功能，如默认显示、过滤、统计等
 
     def __init__(self, dork, num, resource, facet=None, force=False):
         self.dork = dork
@@ -586,7 +586,7 @@ def count(self):
         show.printf(self.total)
 
 
-class HistoryDevice:
+class HistoryDevice:#处理获取主机历史数据的功能
     """
     obtain the user's identity information and determine whether to use the IP history search function
     """
@@ -704,7 +704,7 @@ def filter_fields(self, fields):
         show.print_filter_history(not_equal, result_data[:self.num], has_equal)
 
 
-class IPInformation:
+class IPInformation:#用于查询特定IP地址的信息
     """
     query IP information
     """
@@ -746,7 +746,7 @@ def filter_information(self, filters):
         show.print_info_filter(not_equal, result_data, has_equal)
 
 
-class DomainSearch:
+class DomainSearch:#用于查询相关域名或子域名
     """
     query relation domain or sub domain
     """