This software is an extension for the Pagure forge that adds ForgeFed federation to Pagure instances.
This work has been made possible by the help of, and with the financial support from, NLNet and the NGI0 Discovery Fund.
re
module has replaced re._pattern_type
with re.Pattern
starting with Python 3.7)This plugin must be installed in a working instance of Pagure. See Installing Pagure for how to install it. The plugin reads most of the settings from the Pagure configuration file. Make sure that it is configured and that the instance is running correctly before installing the plugin.
Install the Python dependencies, either globally or in the Pagure virtual environment (if using any):
pip install -r requirements.txt
Now we need to configure Pagure to load the plugin. Pagure uses two configuration files: one is the main configuration for the app, the other one is for loading plugins. Start by setting the variable PAGURE_PLUGINS_CONFIG in the pagure main config file. Then edit the secondary config and import the forgefed plugin like this:
PLUGINS_PATH = "/path/to/plugins/folder"
if PLUGINS_PATH not in sys.path:
sys.path.append(PLUGINS_PATH)
import forgefed.app
PLUGINS = [ forgefed.app.APP ]
We need to register a signal listener for listening to Pagure events. Add this to the Pagure config file:
import blinker
def notify_forgefed(sender, topic, message):
import forgefed.tasks
forgefed.tasks.notification.handle_pagure_signal.delay(
topic, message, os.environ.get('FORGEFED_WORKER'))
if not blinker.signal('pagure').has_receivers_for(notify_forgefed):
blinker.signal('pagure').connect(notify_forgefed, weak=False)
Configure Celery imports in the Pagure main config file, such that all the tasks are found automatically at startup:
# Worker configuration
import sys
PLUGINS_PATH = "/home/git/pagure_local/plugins"
if PLUGINS_PATH not in sys.path: sys.path.append(PLUGINS_PATH)
CELERY_CONFIG = { 'imports': ('pagure.lib.tasks', 'forgefed.tasks') }
Pagure uses Celery with several queues for handling its tasks asynchronously (eg. for creating a new repo, sending emails, or mirroring a repo). We have to start a new Celery worker for handling the forgefed queue:
./start_forgefed_worker.sh
tests_forgefed
folder into the pagure directory
(the same where there is also the Pagure's own test
folder) and run
pytest tests_forgefed
. This is required because the test suite needs to load
Pagure and its modules.This is free software licensed as GNU General Public License, version 2. See the license files.
SPDX-FileCopyrightText: 2020-2021 zPlus zplus@peers.community SPDX-License-Identifier: GPL-2.0-only