LogdeIt, a Pastebin service
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 
Monty Taylor d66b0e82fb Be explicit about python base image version 6 months ago
clientlib [svn] added license informations to lodgeit pastebin and finished open sourceing the package 13 years ago
editors/vim vim plugin: add vim plugin that targets openstack 4 years ago
lodgeit Upload container images 6 months ago
scripts Merge "Fix sort comparison function" 6 months ago
tests Fix python3 compatibility issue 6 months ago
.gitignore Ignore the virtualenv folder and Eclipse's settings files. 4 years ago
.gitreview OpenDev Migration Patch 1 year ago
.mailmap Add a .mailmap file 4 years ago
.zuul.yaml Be explicit about python base image version 6 months ago
Dockerfile Be explicit about python base image version 6 months ago
Makefile added missing files 12 years ago
README Update URLs from openstack.org to opendev.org 6 months ago
TODO Fix misspellings in lodgeit 6 years ago
babel.ini Added javascript support in babel 12 years ago
bindep.txt Add libc6-dev to bindep and pin Pygments for 2.7 6 months ago
lodgeit.wsgi Import make_app from lodgeit.application instead of lodgeit 4 years ago
manage.py Fix PEP-8 errors 3 years ago
requirements.txt Add libc6-dev to bindep and pin Pygments for 2.7 6 months ago
setup.cfg Upload container images 6 months ago
setup.py Upload container images 6 months ago
test-requirements.txt Fix up the tests and add tox configuration to run them 4 years ago
tox.ini Fix python3 compatibility issue 6 months ago

README

==============
LodgeIt Readme
==============

Lodgeit implements a pastebin and some scripts to paste the service.


Installation
~~~~~~~~~~~~

LodgeIt requires at least Python 2.5 to work correctly. Next to this LodgeIt has
quite a few of dependencies as well as a nice bootstrap process. This is documented
on the following slides.

Dependencies and virtual environment
====================================

To get LodgeIt work properly we need those dependencies: Python (at least 2.5),
python-setuptools and git.

For Ubuntu (or any Debian based distribution) use ``aptitude`` to install::

aptitude install python-dev python-setuptools python-virtualenv git

Now we can install LodgeIt. But first we need to clone LodgeIt from the
git repository. To do that you create a new folder ``lodgeit-dev`` in your
projects directory and change into it. There we initialize the virtual
environment and clone LodgeIt::

git clone https://opendev.org/opendev/lodgeit

Right before we can initialize the virtual environment we need to install some
development packages to compile the python imaging library.

For Ubuntu again ``aptitude`` (as root)::

sudo aptitude install build-essential
apt-get build-dep python-imaging

Now it's possible to install the virtual environment. This is done with a simple
Python command::

# assumed that you are located in lodgeit-dev/lodgeit
python scripts/make-bootstrap.py > ../bootstrap.py
cd ..
# make sure that the virtualenv is not activated. If yes, execute `deactivate`
python bootstrap.py .

You are ready to run now.

Database and other things
=========================

We are now ready to enter the virtual environment (assumed you are located in
``lodgeit-dev/lodgeit``)::

. ../bin/activate

LodgeIt initializes it's database per default on /tmp/lodgeit.db, you can change
that path in the manage.py by modifying ``dburi``.

Now start the development server::

python manage.py runserver

Enjoy!