obazl v2 migration: c apis

[mobileink]

The standard FFI included in the standard distribution: @ocaml//ffi

Some packages (e.g. ctypes) export both OCaml files and a C api (headers). The (tentative) naming convention is:

• @pkg//:pkg for the Ocaml target
• @pkg//:libpkg for the C api.

For multi-segment pkg names:

• @seg1//seg2/seg3
• @seg1//seg2/seg3:libseg1_seg2_seg3

For example: @ctypes//:ctypes and @ctypes//:libctypes. OCaml rules can depend on the former; cc_* rules on the latter.

• ctypes.stubs => @ctypes//stubs and @ctypes//stubs:libctypes_stubs

This may change. libctypes_stubs is a little clunky. Other options:

• @ctypes//stubs:hdrs
• @ctypes//stubs:c
• @ctypes//stubs:c-api
• @ctypes/stubs:csdk
• etc.

Or even:

• @ctypes//lib
• @ctypes//lib:stubs
• etc.

[tek]

outstanding!

[mobileink]

FYI I went ahead and implemented support for pseudo-packages. So for example we have both

• @threads//:threads (the pseudo-package)
• @ocaml//threads

Both targets are just aliases to @ocaml.threads//:threads.