KDWSDL2CPP(1)

💅 NAME 💅

okay so bestie, meet kdwsdl2cpp — it's KDAB's WSDL to C++ compiler. yes literally that. it takes your WSDL and hands you back C++ like it's nothing. iconic behavior honestly.

✨ USAGE ✨

the way this works is you pick your vibe: header only, impl only, or both. here's the exact tea, three ways:

Header file:

kdwsdl2cpp [options] -o <headerfile> <wsdlfile>

Impl. file:

kdwsdl2cpp [options] -o <cppfile> -impl <headerfile> <wsdlfile>

Both files:

kdwsdl2cpp [options] -both <basefile> <wsdlfile>

🎀 OPTIONS 🎀

okay so this is the part where i need you to lock in, because every single one of these matters and i'm not letting you skim 🫶

• -h, -help — display this help and exit. a little "hey bestie here's what i can do" moment.
• -v, -version — display version. just the number, no drama.
• -s, -service — name of the service to generate. like, which one. be specific.
• -o <file> — output the generated file into <file>. that's where the magic lands, bestie.
• -impl <headerfile> — generate the implementation(.cpp) file, and #include <headerfile>. so it knows who its header bestie is.
• -both <basefilename> — generate both the header(.h) and the implementation(.cpp) file. two for one, we love a bundle ✨
• -server — generate server-side base class, instead of client service. pick your side of the conversation.
• -exportMacro <macroname> — set the export declaration to use for generated classes.
• -namespace <ns> — put all generated classes into the given C++ namespace. they all move into the same apartment 🏠
• -namespaceMapping <mapping> — add the uri=code mapping. if <mapping> begins with '@', read from file instead, one entry per line. (this one affects the generated class names, so heads up 👀)
• -optional-element-type <type> — use <type> as the getter return value for optional elements. <type> can be either raw-pointer, boost-optional or std-optional. three options, no in-between.
• -keep-unused-types — keep the wsdl unused types to the cpp generation step. yeah, even the ones nobody's using. we're not ghosting them 💀
• -import-path <importpath> — search for files first in this path before downloading them. may be specified multiple times. the file needs to be located at: <importpath>/<url-host>/<url-path>. write that path down fr fr.
• -use-local-files-only — only use local files instead of downloading them automatically. this can be used to force the correct use of the import-path option. no internet, only vibes 🦋
• -help-on-missing — When groups or basic types could not be found, display available types (helps with wrong namespaces). it's giving "here's what i do have" energy, and honestly it's so helpful when your namespace is a mess.
• -pkcs12file — Load a certificate from a PKCS12 file. You can use this option if the WSDL file (or files refering to it) is served from a location which require certificate based authentication. fancy locked-door situation 🔐
• -pkcs12password — Pass the password for the certificate file if required.

⚠️ okay this next part is serious, no jokes: this option is not secure and should be used with caution if other users of the machine are capable to see the running processes ran by the current user. like, they can literally read it off the process list. protect yourself bestie 😭

👑 AUTHORS 👑

kdwsdl2cpp was written by Tobias Koenig <tokoe@kde.org>.

This manual page was written by Thomas Pierson <contact@thomaspierson.fr> for the Debian system (and may be used by others). Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License, Version 3 any later version published by the Free Software Foundation.

okay and that's the whole page, you ate that 🌸 this was KDAB's WSDL to C++ compiler, version 2.1, from October 2020 — go compile something cute, mwah 💖🧚‍♀️