microservices header missing

[geiseri]

Observed behavior

The header micro_args.h is missing from the install files.

Expected behavior

It is added to the install section of src/CMakeLists.txt

Server and client version

release 3.7.0

Host environment

No response

Steps to reproduce

No response

[geiseri]

Noted by the header contents that it is incomplete maybe this is blocking based on completion so feel free to close.

[kozlovic]

@geiseri Since v3.7.0, the service framework was released, so I think this header should have been included indeed, even if there are still TODOs. Will create a PR to address that.

[kozlovic]

@geiseri Actually, having second thoughts. This is used only for the examples, and not sure that it was intended to be library-level APIs. Asking @levb what we should be doing with that header file.

[geiseri]

@kozlovic looking at the internals maybe it should be in the examples directory. The "args format" looks like is specific to the example as it wouldn't have enough of a schema for interop.

[levb]

micro-args was kind of a stop-gap TBH, for examples only. I will move it there.

[levb]

Moving micro_args.* to ./examples would be rather involved since the CMakeLists.txt builds an executable for every .c file.

Moving micro_args.h only, and leaving micro_args.c in ./src can be confusing.

0/5 we should just leave the files where they are, and perhaps replace the use of micro_args in the examples with another, OSS serialization package? Initially I didn't want to pull in the dependencies even for the examples, but using JSON or some other common format would probably be preferred?

@geiseri @kozlovic ?

[kozlovic]

@levb Maybe the "mistake" was to make this example program a bit too configurable ;-). The parameters could have been hard coded, in that the value of the examples was to show how to use the service APIs, not really to be able to run actual fibonnaci or factorial computations :-)

But I would not want to pull a JSON dependency just for that. As you said, we have tried hard to limit the dependencies, so it would be a shame to add one just for the examples. Note that most of the build issues reported by users are around the protobuf (to compile the NATS Streaming client).

[levb]

I agree. For now, I am proposing a PR that moves all this serialization business into a single .h file under examples. Will make Help wanted tickets for more, simpler examples.

[geiseri]

@levb did you make that ticket? I have some ideas on that.