dynamic client connection class

[Antoine Martin]

Taking #1838 one step further: when the client disables a feature completely (ie: clipboard) or when the client is not a UI client (ie: #2348) then we can generate a custom client class without those base classes.

get_client_connection_class needs to be made dynamic.
We'll need a map from flags to mixins, ie:

 "clipboard" : ClipboardConnection,
 "webcam" : WebcamMixin,
etc..

[Antoine Martin]

Preparatory work in r23081.

[Antoine Martin]

This will be much easier to implement after dropping python2 support. (v4)

[Antoine Martin]

implementation - causes server hangs on control-c

[Antoine Martin]

No idea why, but re-doing the change step by step no longer crashes and so the code has been merged in r24907.
The only mixin we currently skip is the mmap mixin.

Still TODO:

• add the is_needed check to more mixins
• try to minimize module level imports so that the is_needed check does not cost too much
• in some cases, add a new flag so we can distinguish between something that is available but disabled from something that is not available (ie: av-sync could start turned off and be enabled via a control command, clipboard)

[Antoine Martin]

Much improved in r24910, see commit message for details. With minor updates in r24911 + r24912 + r24913 + r24914.
Minimal backport to help the server figure out what the client is capable of: r24915.
With a regular client and xpra top connected:

$ xpra info | grep ".modules"
client.1.modules=('Client', 'ClientInfo', 'Clipboard', 'Audio', 'Webcam', 'FilePrint', 'MMAP', 'Input', 'DBUS', 'NetworkState', 'ClientDisplay', 'Windows', 'Encodings', 'AVSync', 'Idle')
client.modules=('Client', 'ClientInfo', 'Webcam', 'Input', 'DBUS', 'NetworkState', 'ClientDisplay', 'Idle')

Apart from the stated goals of not loading code we don't need (reducing attack surface, reducing memory usage, etc), there are additional benefits: we are forced to remove cross-mixin dependencies and this reduces contention on shared resources. ie: a client which has disabled the clipboard will make it easier for other users.

Some caveats.

• av-sync: older clients will send "av-sync" properties even when disabled... so with those we enable the mixin even when not needed - could backport this trivial fix
• display mixin doesn't have any clear on-off properties
• input mixin needs disentangling
• webcam lacked a client capability attribute... so we should add a separate client flag to workaround that (ie: "webcam.mixin.caps")

Still TODO: test all possible combinations (one of the unit tests can do that - just disabled by default because it takes so long)

[Antoine Martin]

Unless needed skip those mixins:

• r25159 webcam
• r25160 input
• r25161 network-state (+r25166 fixup)
• r25163 idle
• r25164 dbus

This allows the "top" client to load only the bare minimum:

client.modules=('Client', 'ClientInfo', 'ClientDisplay')

This will do for v4.

[migration script]

this ticket has been moved to: ​https://github.com/Xpra-org/xpra/issues/2351