Upgrade to 2.11 and use Buf (#13)

Author: Eric-Arellano

.github/workflows/pants.yaml

@@ -49,6 +49,6 @@ jobs:
         ./pants --version
     - name: Check BUILD files
       run: ./pants tailor --check update-build-files --check
-    - name: Test
+    - name: Lint and test
       run: |
-        ./pants test ::
+        ./pants lint test ::

README.md

@@ -4,11 +4,18 @@ An example repository to demonstrate codegen support in Pants.
 
 Refer to these docs for more information:
 
-* [Python Protobuf](https://www.pantsbuild.org/v2.10/docs/protobuf-python)
-* [Python Thrift](https://www.pantsbuild.org/v2.10/docs/thrift-python)
+* [Python Protobuf](https://www.pantsbuild.org/docs/protobuf-python)
+* [Python Thrift](https://www.pantsbuild.org/docs/thrift-python)
 
-Run `./pants export-codegen ::` to see the generated files. This isn't necessary for Pants to 
-use the generated files, but can be useful when debugging or to generate files for IDEs.
+Some commands you can try out:
+
+* `./pants export-codegen ::` - see the generated files.
+    * This isn't necessary for Pants to use the generated files, but can be useful when
+      debugging or to generate files for IDEs.
+* `./pants test ::` - run all tests
+* `./pants fmt ::` - format Protobuf with `buf`
+* `./pants lint ::` - lint Protobuf with `buf`
+* `./pants dependencies <path/to/file>` - see what depends on what
 
 Check out our other [example repositories](https://www.pantsbuild.org/docs/example-repos) to see 
-other features like running linters and formatters, and packaging binaries.
+other features like packaging binaries.

pants.toml

@@ -1,16 +1,12 @@
 [GLOBAL]
-pants_version = "2.10.0"
+pants_version = "2.11.0rc3"
 backend_packages = [
+  "pants.backend.codegen.protobuf.lint.buf",
   "pants.backend.codegen.protobuf.python",
   "pants.backend.codegen.thrift.apache.python",
   "pants.backend.python",
 ]
 
-# This will become the default in 2.11, and is only explicitly set to not break
-# backwards-compatibility for existing users. If you are setting up Pants for
-# the first time, set this to false.
-use_deprecated_python_macros = false
-
 [anonymous-telemetry]
 enabled = true
 repo_id = "205E301D-44A4-42FF-8495-C9D41871A431"

src/protobuf/simple_example/BUILD src/protobuf/simple_example/v1/BUILDsrc/protobuf/simple_example/BUILD renamed to src/protobuf/simple_example/v1/BUILD

@@ -1,10 +1,9 @@
 syntax = "proto3";
 
-package simple_example;
+package simple_example.v1;
 
 message Person {
   string name = 1;
   int32 id = 2;
   string email = 3;
 }
-

src/protobuf/simple_example/person.proto …/protobuf/simple_example/v1/person.protosrc/protobuf/simple_example/person.proto renamed to src/protobuf/simple_example/v1/person.proto src/protobuf/simple_example/person.proto renamed to src/protobuf/simple_example/v1/person.proto

@@ -1,4 +1,4 @@
-from simple_example.person_pb2 import Person
+from simple_example.v1.person_pb2 import Person
 
 def test_person() -> None:
   p = Person()