[Python] reStructuredText GitHub Gist directive.

gist.py

class GitHubGist(Directive):
    """ Embed GitHub Gist.

        Usage:
          .. gist:: GIST_ID
    
    """

    required_arguments = 1
    optional_arguments = 1
    option_spec = {'file': directives.unchanged}
    final_argument_whitespace = True
    has_content = False

    def get_raw_gist_with_filename(self, gistID, filename):
        url = "https://raw.github.com/gist/%s/%s" % (gistID, filename)
        return urlopen(url).read()

    def get_raw_gist(self, gistID):
        url = "https://raw.github.com/gist/%s/" % (gistID)
        return urlopen(url).read()
       
    def run(self):
        gistID = self.arguments[0].strip()
        embedHTML = ""
        rawGist = ""

        if 'file' in self.options:
            filename = self.options['file']
            rawGist = (self.get_raw_gist_with_filename(gistID, filename))
            embedHTML = '<script src="https://gist.github.com/%s.js?file=%s"></script>' % \
                (gistID, filename)
        else:
            rawGist = (self.get_raw_gist(gistID))
            embedHTML = '<script src="https://gist.github.com/%s.js"></script>' % gistID
               
        return [nodes.raw('', embedHTML, format='html'), 
                nodes.raw('', '<noscript>', format='html'), 
                nodes.literal_block('', rawGist), 
                nodes.raw('', '</noscript>', format='html')]

directives.register_directive('gist', GitHubGist)