Blame README.rst

Pierre-Yves Chibon fe5017
Pagure
Pierre-Yves Chibon 2088eb
======
Pierre-Yves Chibon 2088eb
Pierre-Yves Chibon 2088eb
:Author: Pierre-Yves Chibon <pingou@pingoured.fr></pingou@pingoured.fr>
Pierre-Yves Chibon 2088eb
Pierre-Yves Chibon 2088eb
Pierre-Yves Chibon fe5017
Pagure is a light-weight git-centered forge based on pygit2.
Pierre-Yves Chibon 78e123
Pierre-Yves Chibon fe5017
Currently, Pagure offers a decent web-interface for git repositories, a
Pierre-Yves Chibon 78e123
simplistic ticket system (that needs improvements) and possibilities to create
Pierre-Yves Chibon 78e123
new projects, fork existing ones and create/merge pull-requests across or
Pierre-Yves Chibon 78e123
within projects.
Pierre-Yves Chibon 2088eb
Pierre-Yves Chibon 2088eb
Rahul Bajaj 29b73b
Homepage: https://pagure.io/pagure
Stanislav Ochotnicky 6739d2
Pierre-Yves Chibon 4951c5
See it at work: https://pagure.io
Pierre-Yves Chibon 4951c5
Pierre-Yves Chibon 4951c5
Playground version: https://stg.pagure.io
Pierre-Yves Chibon 4951c5
Pierre-Yves Chibon 22c46f
Pierre-Yves Chibon bfbc7c
Pierre-Yves Chibon 2088eb
Get it running
Pierre-Yves Chibon 2088eb
==============
Pierre-Yves Chibon 2088eb
Pierre-Yves Chibon 2088eb
* Retrieve the sources::
Pierre-Yves Chibon 2088eb
Rahul Bajaj 29b73b
    git clone https://pagure.io/pagure.git
Daniel Mach d27126
    cd pagure
Daniel Mach d27126
Daniel Mach d27126
Daniel Mach d27126
* Install dependencies
Daniel Mach d27126
Daniel Mach d27126
  * development virtualenv::
Daniel Mach d27126
Daniel Mach d27126
      dnf install libgit2-devel
Daniel Mach d27126
      virtualenv devel
Daniel Mach d27126
      devel/bin/pip install -r requirements.txt
Daniel Mach d27126
Daniel Mach d27126
  * Fedora RPMs::
Daniel Mach d27126
Daniel Mach d27126
      dnf install $(cat requirements-fedora.txt)
Pierre-Yves Chibon 2088eb
Pierre-Yves Chibon 2088eb
Pierre-Yves Chibon d136d5
* Create the folder that will receive the projects, forks, docs and tickets'
Pierre-Yves Chibon d136d5
  git repo::
Pierre-Yves Chibon 2088eb
Pierre-Yves Chibon d136d5
    mkdir {repos,docs,forks,tickets}
Pierre-Yves Chibon 2088eb
Pierre-Yves Chibon 2088eb
Sayan Chowdhury 367479
* Create the inital database scheme::
Sayan Chowdhury 367479
Daniel Mach d27126
    # development virtualenv only
Daniel Mach d27126
    source devel/bin/activate
Daniel Mach d27126
Sayan Chowdhury 367479
    python createdb.py
Sayan Chowdhury 367479
Sayan Chowdhury 367479
Pierre-Yves Chibon 2088eb
* Run it::
Pierre-Yves Chibon 2088eb
Daniel Mach d27126
    # development virtualenv only
Daniel Mach d27126
    source devel/bin/activate
Daniel Mach d27126
Pierre-Yves Chibon 40cf0a
    ./runserver.py
Pierre-Yves Chibon 2088eb
Pierre-Yves Chibon 2088eb
Pierre-Yves Chibon b42030
* To get some profiling information you can also run it as::
Pierre-Yves Chibon b42030
Daniel Mach d27126
    # development virtualenv only
Daniel Mach d27126
    source devel/bin/activate
Pierre-Yves Chibon b42030
Daniel Mach d27126
    ./runserver.py --profile
Pierre-Yves Chibon b42030
Pierre-Yves Chibon b42030
Pierre-Yves Chibon 2088eb
This will launch the application at http://127.0.0.1:5000