wrong examples in documentation

[pat1]

https://arpa-simc.github.io/dballe/python/dballe_messages.html

class dballe.Message

    print("{m.report},{m.coords},{m.ident},{m.datetime},{m.type}".format(m=msg))
AttributeError: 'tuple' object has no attribute 'report'

suggested example:

importer = dballe.Importer("BUFR")
with dballe.File("temp.bufr") as f:
    for binmsg in f:
        msgs = importer.from_binary(binmsg)
        for msg in msgs:
            print("#{b.index}: {m.report},{m.coords},{m.ident},{m.datetime},{m.type}".format(b=binmsg, m=msg))

class dballe.Importer same problem as above

https://arpa-simc.github.io/dballe/python/dballe_db.html the example:

• do not use transaction
• B11101 do not exist
• db.insert_data do not have the last two parameters setted to True so running the example on some DB do not work
• lat e long are used as float; as native type is decimal I think that a better examble should use decimal

https://arpa-simc.github.io/dballe/python/dballe_messages.html

get_named(name: str) → Union[dballe.Var, None]
    Get a Var given its shortcut name; returns None if not found

set_named(name: str, value: Union[dballe.Var, int, str, double])
    Set a Var given its shortcut name

which 'shortcut name' I can use ?

     msg.set_named("report", dballe.var("B01194", "sound"))
KeyError: "Shortcut name 'report' not found"

[spanezz]

I have just documented the shortcuts (see #206)

[spanezz]

I have implemented a way to execute and test all code snippets in the documentation. It should be quite unlikely that documentation bits do not compile or work, or use deprecated functions now.