Re: [SR-Users] Kamailio KEMI Framework Tutorial

Hi again, Regarding RPC list: I do not think it is implemented for python?

I checked the source and couldn't find anything that would handle the RPC call: kamctl rpc app_python.api_list Regarding the documentation: I didn't mean to document in the source code, sorry for not expressing myself clearly,

 I ment to generate the Kemi function list documentation from the source code automatically via a script instead of updating it manually (so the documentation doesn't become stale). One example could be to run the RPC api_list and take that list to generate a documentation file that shows all available functions. I tried to check that out now but couldn't get it working for python because I think the command is missing (v5.0.4). So to condense my proposal on how we could structure the KEMI docs I would suggest: - General documentation about how KEMI works: As it is now, great - Document special functions that are only implemented in KEMI /or differs from the original module implementation: As it is now, great - Not have sections for each and every module, just one section with a long list of exported KEMI functions with a link to the original documentation I'm happy to take a shot at generating a script for this but would need help to understand how I can export the python API list.

// Samuel ------------------------------------------------------------------------ *From:* Daniel-Constantin Mierla &lt;miconda(a)gmail.com&gt; <mailto:miconda@gmail.com> *Sent:* Tuesday, November 21, 2017 3:20:21 PM *To:* Samuel F.; Kamailio (SER) - Users Mailing List *Subject:* Re: [SR-Users] Kamailio KEMI Framework Tutorial   Hello, On 21.11.17 10:20, Samuel F. wrote: thanks for the feedback, really appreciated! It is good to know that KEMI is being used in production and also it shows its potential for various needs. There is an RPC command that lists the exported KEMI functions for a running Kamailio. It reflects exactly what functions are available from the kemi framework internal structure. This is like an auto discovery, it is done automatically. Addition docs can be added in the code using doxygen, however, while that is good for short descriptions, I don't find it good to add extensive docs and especially usage examples in the code. Also, from past experiences, non-developer users tend not to look at the code, therefore the improvements to docs in code from general users are very low. Anyhow, this tutorial was started with the initial goal of covering the KEMI framework in general, and the special functions. For the functions exported by modules I added only the acc as an example (which is also a skeleton at this moment). As I said, I am open for suggestions on how to do the docs for kemi functions from modules. Your proposal with using somehow the code is not like being dismissed, I just expressed my opinions based. Contributions to parse the code and extract prototypes are of course welcome. Cheers, Daniel -- Daniel-Constantin Mierla www.twitter.com/miconda <https://eur02.safelinks.protection.outlook.com/?url=http%3A%2F%2Fwww.twitter.com%2Fmiconda&data=02%7C01%7Csamuel_is_kewl%40hotmail.com%7Cb0ef8c659a014ebc3bbc08d530eb0520%7C84df9e7fe9f640afb435aaaaaaaaaaaa%7C1%7C0%7C636468708318318423&sdata=%2B6XNLL0f7NWcJWExn7P%2FBQSdjfry6ku79GWr1C9HFyA%3D&reserved=0> -- www.linkedin.com/in/miconda <https://eur02.safelinks.protection.outlook.com/?url=http%3A%2F%2Fwww.linkedin.com%2Fin%2Fmiconda&data=02%7C01%7Csamuel_is_kewl%40hotmail.com%7Cb0ef8c659a014ebc3bbc08d530eb0520%7C84df9e7fe9f640afb435aaaaaaaaaaaa%7C1%7C0%7C636468708318318423&sdata=gctVv3a%2Fyt6K%2F5u8cdxDPOVCXpjAFtWYWdi0edqlQaE%3D&reserved=0> Kamailio Advanced Training - www.asipto.com <https://eur02.safelinks.protection.outlook.com/?url=http%3A%2F%2Fwww.asipto.com&data=02%7C01%7Csamuel_is_kewl%40hotmail.com%7Cb0ef8c659a014ebc3bbc08d530eb0520%7C84df9e7fe9f640afb435aaaaaaaaaaaa%7C1%7C0%7C636468708318318423&sdata=PUjvVlxZ6%2B6i%2BVX1uyHDP7EHF4dbYgozNjlFRJMJICg%3D&reserved=0> Kamailio World Conference - May 14-16, 2018 - www.kamailioworld.com <https://eur02.safelinks.protection.outlook.com/?url=http%3A%2F%2Fwww.kamailioworld.com&data=02%7C01%7Csamuel_is_kewl%40hotmail.com%7Cb0ef8c659a014ebc3bbc08d530eb0520%7C84df9e7fe9f640afb435aaaaaaaaaaaa%7C1%7C0%7C636468708318318423&sdata=n7wEMwvt38VIugGTLcT9mBZMNLCCaeWgYKDWtapcnVc%3D&reserved=0>