101 lines
2.5 KiB
Python
101 lines
2.5 KiB
Python
# -*- coding: utf-8 -*-
|
|
|
|
"""
|
|
(c) 2016 - Copyright Red Hat Inc
|
|
|
|
Authors:
|
|
Pierre-Yves Chibon <pingou@pingoured.fr>
|
|
|
|
"""
|
|
|
|
import flask_wtf as wtf
|
|
import sqlalchemy as sa
|
|
import wtforms
|
|
from sqlalchemy.orm import relation
|
|
from sqlalchemy.orm import backref
|
|
|
|
from pagure.hooks import BaseHook, RequiredIf
|
|
from pagure.lib.model import BASE, Project
|
|
from pagure import get_repo_path
|
|
|
|
|
|
class RtdTable(BASE):
|
|
""" Stores information about the pagure hook deployed on a project.
|
|
|
|
Table -- hook_rtd
|
|
"""
|
|
|
|
__tablename__ = 'hook_rtd'
|
|
|
|
id = sa.Column(sa.Integer, primary_key=True)
|
|
project_id = sa.Column(
|
|
sa.Integer,
|
|
sa.ForeignKey(
|
|
'projects.id', onupdate='CASCADE', ondelete='CASCADE'),
|
|
nullable=False,
|
|
unique=True,
|
|
index=True)
|
|
|
|
active = sa.Column(sa.Boolean, nullable=False, default=False)
|
|
|
|
project_name = sa.Column(sa.Text, nullable=False)
|
|
branches = sa.Column(sa.Text, nullable=True)
|
|
|
|
project = relation(
|
|
'Project', remote_side=[Project.id],
|
|
backref=backref(
|
|
'rtd_hook', cascade="delete, delete-orphan",
|
|
single_parent=True, uselist=False)
|
|
)
|
|
|
|
|
|
class RtdForm(wtf.Form):
|
|
''' Form to configure the pagure hook. '''
|
|
project_name = wtforms.TextField(
|
|
'Project name on readthedoc.org',
|
|
[RequiredIf('active')]
|
|
)
|
|
branches = wtforms.TextField(
|
|
'Restrict build to these branches only (comma separated)',
|
|
[wtforms.validators.Optional()]
|
|
)
|
|
|
|
active = wtforms.BooleanField(
|
|
'Active',
|
|
[wtforms.validators.Optional()]
|
|
)
|
|
|
|
|
|
class RtdHook(BaseHook):
|
|
''' Read The Doc hook. '''
|
|
|
|
name = 'Read the Doc'
|
|
description = 'Kick off a build of the documentation on readthedocs.org.'
|
|
form = RtdForm
|
|
db_object = RtdTable
|
|
backref = 'rtd_hook'
|
|
form_fields = ['active', 'project_name', 'branches']
|
|
|
|
@classmethod
|
|
def install(cls, project, dbobj):
|
|
''' Method called to install the hook for a project.
|
|
|
|
:arg project: a ``pagure.model.Project`` object to which the hook
|
|
should be installed
|
|
|
|
'''
|
|
repopaths = [get_repo_path(project)]
|
|
|
|
cls.base_install(repopaths, dbobj, 'rtd', 'rtd_hook.py')
|
|
|
|
@classmethod
|
|
def remove(cls, project):
|
|
''' Method called to remove the hook of a project.
|
|
|
|
:arg project: a ``pagure.model.Project`` object to which the hook
|
|
should be installed
|
|
|
|
'''
|
|
repopaths = [get_repo_path(project)]
|
|
|
|
cls.base_remove(repopaths, 'rtd')
|