Statement rgd API and feature stability for 1.0

[oberstet]

We need to have a clear statement regarding what's the public API and featureset that we strive to support long-term (after 1.0).

[oberstet]

We probably should follow http://semver.org/ at least after 1.0

[oberstet]

I think we should do semver. This requires a definition of "public API" first.

In a way, we have that already:

• https://github.com/tavendo/AutobahnPython/blob/master/autobahn/autobahn/websocket/interfaces.py
• https://github.com/tavendo/AutobahnPython/blob/master/autobahn/autobahn/wamp/interfaces.py

But this doesn't cover

• actual concrete classes implementing these interfaces and constructors thereof
• smallish "value transfer" classes used as parameters like autobahn.wamp.types.ComponentConfig and such

[oberstet]

We should look at these issues at least:

• ApplicationRunner
• auto-reconnect
• WAMP call timeouts
• naming inconsistency
• naming not PEP8

[oberstet]

We don't have a consolidated list of API which is supposed to be "public and supported".

Well, we do have:

• https://github.com/tavendo/AutobahnPython/blob/master/autobahn/websocket/interfaces.py
• https://github.com/tavendo/AutobahnPython/blob/master/autobahn/wamp/interfaces.py

but this isn't exhaustive.

[oberstet]

another thing I am unhappy with is https://github.com/tavendo/AutobahnPython/blob/master/autobahn/websocket/protocol.py#L3557 and even https://github.com/tavendo/AutobahnPython/blob/master/autobahn/websocket/protocol.py#L1097

[oberstet]

https://github.com/tavendo/AutobahnPython/blob/master/autobahn/websocket/interfaces.py#L107 is limiting: it should have been def on_message(msg) where msg is a struct like thing.

[oberstet]

Also, the logging should be sanitized, and more importantly, parameters like debug_wamp=False should go away.

[oberstet]

subseded/fixed in https://github.com/crossbario/autobahn-python/issues/964