I hijack this mail to coalesce answers to you both ..
Thank you both! This is important feedback. Let me give a reply now .. I try to address some of the points you raise rgd docs tomorrow.
"Stuff is scattered"
I just wrote a piece today:
in the hope this explains why this isn't 1 website / technology. In fact, what we are doing here is building an ecosystem.
Does that help?
Regarding asynchronous programming:
For Python, I tried to collect - what I think - useful pointers here:
I highly encourage checking out the links from the _first_ section. Probably I'm getting too involved later in this page again. Well.
But yes, if you've never done it, there will be a learning curve. I'm afraid I can't do much about that .. there are whole books that only talk about this.
And then Autobahn supports multiple languages. Take C++: this is heavy artillery .. and AutobahnCpp is using cutting edge features like C++11 and even newer. The fun thing is: once you got it, the know how translates. Granted, C++ will probably stay tricky;)
Regarding WebSocket programming with Python: have you looked at
It explains everything you need to know for probably >90% use cases (pure WebSocket programming).
This _single_ page took me >1d work/fiddling. It's the best I can do;( If this isn't sufficient, I'm afraid others need to jump in.
@Marcel: Yes, this text alternates between Twisted and asyncio - deliberately. I wanted to show how _similar_ both are. Also in the It's really mostly syntactical (the differences). You think this is bad?
@Tim: Regarding "how do all those pieces fit together":
Do you want to know how Crossbar works _inside_? Then yes, I can explain that.
If you are just interested in _using_ Crossbar, say from JS, then you only need to know AutobahnJS + CB config.
You don't need to know Twisted, asyncio, Python, whatever. Forget this. You can do WAMP programming with a browser, JS and Crossbar alone.
If you are interested in using CB from Python, then yes, you need AutobahnPython, plus either Twisted or asyncio.
I have mostly finished this page:
This page covers all you need to get started with Python writing WAMP components that run under CB.
Am 16.08.2014 19:48, schrieb Marcel Maré:
I appreciate the effort to improve the docs.
Though I really want to like autobahn/wamp/crossbar I'm having a hard
time to get up to speed. Of course, all this async stuff is very new as
well, and that doesn't help either..
The docs seems kind of scattered, on the autobahn site, the tavendo
blog, and the crossbar site.
What I'd like to see is a tutorial or series of examples that build from
the trivial to the more complex.
A minimal web socket example, python server and client.
Maybe a more expanded ws example.
Then indicate how to move to production.
Then explain what WAMP adds to the mix.
Then explain why one would use crossbar.
Expand the examples to include crossbar
Then indicate how to move this to production.
In all this reduce the degrees of freedom. Stick to 1 async solution (eg
asyncio) or create fully parallel tutorials/examples, but do not
interleave say twisted and asyncio examples.
Hope this helps a tiny bit...
You received this message because you are subscribed to the Google
Groups "Autobahn" group.
To unsubscribe from this group and stop receiving emails from it, send
an email to autobahnws+...@googlegroups.com
To post to this group, send email to autob...@googlegroups.com
To view this discussion on the web visit
For more options, visit https://groups.google.com/d/optout.