Generate gRPC API using buf

.gitattributes

@@ -1,2 +1,4 @@
 *.py ident
 *.sh ident
+a3m/api/** linguist-generated
+docs/** linguist-documentation

.github/workflows/buf-pull-request.yml

@@ -0,0 +1,12 @@
+name: Buf (pull request)
+on: pull_request
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v2
+    - uses: bufbuild/buf-setup-action@v1
+    - uses: bufbuild/buf-lint-action@v1
+      with:
+        input: proto
+    # TODO: use buf-breaking-action when ready

.github/workflows/buf-push.yml

@@ -0,0 +1,19 @@
+name: Buf (push)
+on:
+  push:
+    branches:
+    - main
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v2
+    - uses: bufbuild/buf-setup-action@v1
+    - uses: bufbuild/buf-lint-action@v1
+      with:
+        input: proto
+    # TODO: use buf-breaking-action when ready
+    - uses: bufbuild/buf-push-action@v1
+      with:
+        input: proto
+        buf_token: ${{ secrets.BUF_TOKEN }}

.pre-commit-config.yaml

@@ -17,7 +17,7 @@ repos:
   - id: reorder-python-imports
     args: ["--application-directories=.:src", "--py37-plus"]
 - repo: https://github.com/jazzband/pip-tools
-  rev: 6.5.1
+  rev: 6.6.2
   hooks:
   - id: pip-compile
     files: |
@@ -27,7 +27,7 @@ repos:
       )$
     args: ["--output-file=requirements.txt"]
 - repo: https://github.com/jazzband/pip-tools
-  rev: 6.5.1
+  rev: 6.6.2
   hooks:
   - id: pip-compile
     files: |

Makefile

@@ -134,16 +134,13 @@ amflow:  ## Display the workflow in amflow.
 		artefactual/amflow:latest \
 			edit --file=/workflow.json
 
-.PHONY: protoc
-protoc:  ## Generate gRPC code.
-	$(call compose_run, \
-		--entrypoint python \
-		a3m \
-			-m grpc_tools.protoc -I=. --python_out=. --grpc_python_out=. a3m/server/rpc/proto/a3m.proto)
-	$(call compose_run, \
-		--entrypoint black \
-		a3m \
-			a3m/server/rpc/proto)
+.PHONY: buf
+buf:
+	docker run \
+		--volume "$(CURDIR)/proto:/workspace" \
+		--workdir /workspace \
+		bufbuild/buf:1.4.0 \
+			$(ARG)
 
 .PHONY: help
 help:  ## Print this help message.