buf generate does not appear to respect buf.yaml excludes rules about buf

[bufdev]

The problem is that you are including the files directly into your main module, in which case buf will generate stubs for them like any of your other files in api. You can't exclude these files - this is excluding them at the build stage, not the generate stage, and at the build stage you need all imported files present. To make this so, what you want is to add buf.build/googleapis/googleapis as a dependency in your buf.yaml:

version: v1
deps:
  - buf.build/googleapis/googleapis
breaking:
  use:
    - FILE
lint:
  use:
    - DEFAULT

Then, inside api, run buf mod update.

By default, buf generate won't generate code for imports, and you've already excluded rewriting the Go package for buf.build/googleapis/googleapis in your buf.gen.yaml, so you will get the correct google.golang.org imports.

I don't know where openapiv3 came from - where are these files from?

[bufdev]

Closing as this is a configuration issue - let us know if you have further issues.

[YvanJAquino]

@bufdev I'm a bit confused on managing dependencies.

• how does buf.build/googleapis/googleapis resolve into the right dependency set?
• How would I add dependencies from other libraries such as https://github.com/google/gnostic/blob/main/openapiv3/OpenAPIv3.proto?

Any guidance would be useful, I'm writing this one up for posterity.

[bufdev]

how does buf.build/googleapis/googleapis resolve into the right dependency set?

I'm not quite sure what you mean here, but buf mod update will pin to a specific commit. See https://buf.build/docs/bsr/module/dependency-management for more details.

How would I add dependencies from other libraries

You can make your own module with these files in them. See https://buf.build/docs/bsr/module/configure for more details.

[bufdev]

We'll also consider adding gnostic definitions as a module that we manage.

[YvanJAquino]

Just the fact you all would consider that is awesome. Thank you so much for this amazing tool!

[bufdev]

Apparently the author of gnostic already uploaded it: https://buf.build/gnostic/gnostic