Add database Dial example

[ernestas-poskus]

#31

@dennwc @theduke

Adding Dial example

[dennwc]

1. Import path should be gopkg.in/istreamdata/orientgo.v2/obinary.

2. I think we can make a Dial example much shorter for README - only the necessary lines. Everything else will be visible via godoc.

3. Examples can be built into test files. They will be tested for compilation automatically and will appear in godoc in a natural way. So please change everything accordingly to "Large examples" section of documentation.

[ernestas-poskus]

I think we can make a Dial example much shorter for README - only the necessary lines. Everything else will be visible via godoc.

made it a little shorter

3. Examples can be built into test files. They will be tested for compilation automatically and will appear in godoc in a natural way. So please change everything accordingly to "Large examples" section of documentation.

then example will be non-copy-able, I mean user will have to figure out import paths.

How about I will add just a link to examples folder ?

[dennwc]

I still think it's too large for README. Example code is good itself, but not for the project main page. Would you mind leaving something like Dial-Open-SQLQuery for README without any details at all? You can even drop error handling there.

then example will be non-copy-able, I mean user will have to figure out import paths.

You can use full import paths in example by naming it package orient_test. Please check this example. It's a copy-able code with full godoc support. You can't underestimate how useful such examples could be - anyone can see it right after function documentation :)

Also, please remove HandleError wrapper. Panics are ok for examples.

[ernestas-poskus]

Updated README with file reference, added example to root of the package.

[dennwc]

Looks great! Thank you for you work :)