I am plan­ning to do a ma­jor re­lease (ver­sion 6!) of Niko­la my stat­ic blog and site gen­er­a­tor the next week­end. It's a ma­jor ver­sion be­cause there has been a ton of fea­ture work done. So, I will do a quick se­ries high­light­ing some of those im­prove­ments this week.

I am plan­ning to do a ma­jor re­lease (ver­sion 6!) of Niko­la my stat­ic blog and site gen­er­a­tor the next week­end. It's a ma­jor ver­sion be­cause there has been a ton of fea­ture work done. So, I will do a quick se­ries high­light­ing some of those im­prove­ments this week.

It all start­ed qui­et­ly with an Is­sue in the Niko­la bug track­er:

gustavodiazjaimes opened this issue 3 hours ago

oembed by micawber - feature sugestion

instead of using specific code for embed object (Youtube, Vimeo, Soundcloud) use a generic solution like https://github.com/coleifer/micawber

So, I looked at mi­caw­ber. And it's awe­some and I had nev­er heard of it be­fore. What it does is, it looks at a URL, and if it knows the site where it's point­ed at, it will then gath­er in­for­ma­tion from it. And us­ing that in­for­ma­tion it will cre­ate for you a HTML frag­ment so you can em­bed it in your own HTML page.

And how hard is it to turn that in­to a re­Struc­tured­Text di­rec­tive? NOT HARD AT ALL.

import micawber

class Media(Directive):
    """ Restructured text extension for inserting any sort of media using micawber."""
    has_content = False
    required_arguments = 1

    def run(self):
        providers = micawber.bootstrap_basic()
        return [nodes.raw('', micawber.parse_text(self.arguments[0], providers), format='html')]

So now, in Niko­la's github mas­ter you can do this:

Read more…