proto-lens-setup

Cabal support for codegen with proto-lens. https://github.com/google/proto-lens#readme

Version on this page:0.4.0.1
Stackage Nightly 2018-12-15:0.4.0.1
Latest on Hackage:0.4.0.1

See all snapshots proto-lens-setup appears in

BSD3 licensed by Judah Jacobson
Maintained by proto-lens@googlegroups.com

Module documentation for 0.4.0.1

There are no documented modules for this package.

This package provides Cabal support for the proto-lens package. It automatically generates Haskell source files from protocol buffer files (.proto).

To generate Haskell modules for a Cabal package, import Data.ProtoLens.Setup from the Setup.hs file. For example:

import Data.ProtoLens.Setup
-- Here, "src" is the directory where .proto source files may be found
main = defaultMainGeneratingProtos "src"

Then, edit the .cabal file of your project to:

  • Specify build-type: Custom, and add a custom-setup clause that depends on proto-lens-setup.

  • List the .proto files in extra-source-files. Note that the field belongs at the top level of the .cabal file, rather than once per library/executable/etc.

  • List the generated modules (e.g. Proto.Foo.Bar) in exposed-modules or other-modules of the rule(s) that use them (e.g. the library or executables). Additionally, add proto-lens-runtime to the build-depends of those rules.

For example, in foo-bar-proto.cabal:

build-type: Custom
extra-source-files: src/foo/bar.proto
...
custom-setup
  setup-depends: base, Cabal, proto-lens-setup
library
    exposed-modules: Proto.Foo.Bar, Proto.Foo.Bar_Fields
    autogen-modules: Proto.Foo.Bar, Proto.Foo.Bar_Fields
    build-depends: proto-lens-runtime, ...

Changes

Changelog for proto-lens-setup

v0.4.0.1

  • Bump the lower bound on base and containers to support ghc-8.6.1.
  • Support Cabal-2.4.*.

v0.4.0.0

  • Split out from proto-lens-protoc.

Older

See Changelog.md for proto-lens-protoc.

comments powered byDisqus