Enable gitsubmodule for milvus-proto in pymilvus (milvus-io#975)

See also: milvus-io/milvus#15653, milvus-io#909

Signed-off-by: XuanYang-cn <[email protected]>

.gitmodules

@@ -0,0 +1,3 @@
+[submodule "pymilvus/grpc_gen/milvus-proto"]
+	path = pymilvus/grpc_gen/milvus-proto
+	url = https://github.com/milvus-io/milvus-proto.git

CONTRIBUTING.md

@@ -69,4 +69,4 @@ Note: the problems, features, and questions mentioned here are not limited to Py
 
 ## Congratulations! You are now the contributor to the Milvus community!
 
-Apart from dealing with codes and machines, you are always welcome to communicate with any member from the Milvus community. New faces join us every day, and they may as well encounter the same challenges as you faced beore. Feel free to help them. You can pass on the collaborative spirit from the assistance you acquired when you first joined the community. Let us build a collaborative, open-source, exuberant, and tolerant community together!
+Apart from dealing with codes and machines, you are always welcome to communicate with any member from the Milvus community. New faces join us every day, and they may as well encounter the same challenges as you faced beore. Feel free to help them. You can pass on the collaborative spirit from the assistance you acquired when you first joined the community. Let us build a collaborative, open-source, exuberant, and tolerant community together!

Makefile

@@ -16,5 +16,8 @@ example_index:
 package:
 	python3 -m build --sdist --wheel --outdir dist/ .
 
-gen_proto:
-	cd pymilvus/grpc_gen/proto && ./python_gen.sh
+get_proto:
+	git submodule update --init
+
+gen_proto: get_proto
+	cd pymilvus/grpc_gen && ./python_gen.sh

README.md

@@ -42,6 +42,29 @@ You can upgrade PyMilvus to the latest version by:
 $ pip3 install --upgrade pymilvus
 ```
 
+## FAQ
+Q1. How to get submodules?
+
+A1. The following command will only get the latest protos , for protos of certain version, see
+[milvus-proto](https://github.com/milvus-io/milvus-proto#usage) for details.
+```shell
+$ git sumodule update --init
+```
+
+Q2. How to generate python files from milvus-proto?
+
+A2.
+```shell
+$ make gen_proto
+```
+
+Q3. How to use the local PyMilvus repository for Milvus server?
+
+A3.
+```shell
+$ python setup.py install
+```
+
 
 ## Documentation
 

pymilvus/grpc_gen/milvus_pb2_grpc.py

@@ -225,6 +225,11 @@ def __init__(self, channel):
                 request_serializer=milvus__pb2.GetImportStateRequest.SerializeToString,
                 response_deserializer=milvus__pb2.GetImportStateResponse.FromString,
                 )
+        self.ListImportTasks = channel.unary_unary(
+                '/milvus.proto.milvus.MilvusService/ListImportTasks',
+                request_serializer=milvus__pb2.ListImportTasksRequest.SerializeToString,
+                response_deserializer=milvus__pb2.ListImportTasksResponse.FromString,
+                )
         self.CreateCredential = channel.unary_unary(
                 '/milvus.proto.milvus.MilvusService/CreateCredential',
                 request_serializer=milvus__pb2.CreateCredentialRequest.SerializeToString,
@@ -505,6 +510,12 @@ def GetImportState(self, request, context):
         context.set_details('Method not implemented!')
         raise NotImplementedError('Method not implemented!')
 
+    def ListImportTasks(self, request, context):
+        """Missing associated documentation comment in .proto file."""
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details('Method not implemented!')
+        raise NotImplementedError('Method not implemented!')
+
     def CreateCredential(self, request, context):
         """https://wiki.lfaidata.foundation/display/MIL/MEP+27+--+Support+Basic+Authentication
         """
@@ -743,6 +754,11 @@ def add_MilvusServiceServicer_to_server(servicer, server):
                     request_deserializer=milvus__pb2.GetImportStateRequest.FromString,
                     response_serializer=milvus__pb2.GetImportStateResponse.SerializeToString,
             ),
+            'ListImportTasks': grpc.unary_unary_rpc_method_handler(
+                    servicer.ListImportTasks,
+                    request_deserializer=milvus__pb2.ListImportTasksRequest.FromString,
+                    response_serializer=milvus__pb2.ListImportTasksResponse.SerializeToString,
+            ),
             'CreateCredential': grpc.unary_unary_rpc_method_handler(
                     servicer.CreateCredential,
                     request_deserializer=milvus__pb2.CreateCredentialRequest.FromString,
@@ -1487,6 +1503,23 @@ def GetImportState(request,
             options, channel_credentials,
             insecure, call_credentials, compression, wait_for_ready, timeout, metadata)
 
+    @staticmethod
+    def ListImportTasks(request,
+            target,
+            options=(),
+            channel_credentials=None,
+            call_credentials=None,
+            insecure=False,
+            compression=None,
+            wait_for_ready=None,
+            timeout=None,
+            metadata=None):
+        return grpc.experimental.unary_unary(request, target, '/milvus.proto.milvus.MilvusService/ListImportTasks',
+            milvus__pb2.ListImportTasksRequest.SerializeToString,
+            milvus__pb2.ListImportTasksResponse.FromString,
+            options, channel_credentials,
+            insecure, call_credentials, compression, wait_for_ready, timeout, metadata)
+
     @staticmethod
     def CreateCredential(request,
             target,