Pagure
======

:Author: Pierre-Yves Chibon <pingou@pingoured.fr>


Pagure is a light-weight git-centered forge based on pygit2.

Currently, Pagure offers a decent web-interface for git repositories, a
simplistic ticket system (that needs improvements) and possibilities to create
new projects, fork existing ones and create/merge pull-requests across or
within projects.


Homepage: https://github.com/pypingou/pagure

Dev instance: http://209.132.184.222/ (/!\\ May change unexpectedly, it's a dev instance ;-))


Get it running
==============

* Retrieve the sources::

    git clone git://github.com/pypingou/pagure


* Create the folder that will receive the projects, forks, docs and tickets'
  git repo::

    mkdir {repos,docs,forks,tickets}


* Create the inital database scheme::

    python createdb.py


* Run it::

    ./runserver.py


* To get some profiling information you can also run it as::

    ./runserver.py --profile



This will launch the application at http://127.0.0.1:5000

UI overview
-----------

.. image:: screenshots/overview_home.png
   :scale: 50 %
   :alt: Pagure's home page overview
   :align: center
   :target: https://github.com/pypingou/pagure/raw/master/screenshots/overview_home.png

.. image:: screenshots/overview_main.png
   :scale: 50 %
   :alt: Pagure's project page overview
   :align: center
   :target: https://github.com/pypingou/pagure/raw/master/screenshots/overview_main.png

.. image:: screenshots/overview_commit.png
   :scale: 50 %
   :alt: Pagure's commit overview
   :align: center
   :target: https://github.com/pypingou/pagure/raw/master/screenshots/overview_commit.png

.. image:: screenshots/overview_request_pull.png
   :scale: 50 %
   :alt: Pagure's pull-request overview
   :align: center
   :target: https://github.com/pypingou/pagure/raw/master/screenshots/overview_request_pull.png

.. image:: screenshots/overview_issues_list.png
   :scale: 50 %
   :alt: Pagure's issues list overview
   :align: center
   :target: https://github.com/pypingou/pagure/raw/master/screenshots/overview_issues_list.png

.. image:: screenshots/overview_issue.png
   :scale: 50 %
   :alt: Pagure's issue overview
   :align: center
   :target: https://github.com/pypingou/pagure/raw/master/screenshots/overview_issue.png

.. image:: screenshots/overview_users.png
   :scale: 50 %
   :alt: Pagure's users overview
   :align: center
   :target: https://github.com/pypingou/pagure/raw/master/screenshots/overview_users.png