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 10 months ago
clientlib [svn] added license informations to lodgeit pastebin and finished open sourceing the package 14 years ago
editors/vim vim plugin: add vim plugin that targets openstack 5 years ago
lodgeit Upload container images 10 months ago
scripts Merge "Fix sort comparison function" 10 months ago
tests Fix python3 compatibility issue 10 months ago
.gitignore Ignore the virtualenv folder and Eclipse's settings files. 5 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 10 months ago
Dockerfile Be explicit about python base image version 10 months ago
Makefile added missing files 12 years ago
README Update URLs from openstack.org to opendev.org 10 months ago
TODO Fix misspellings in lodgeit 7 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 10 months ago
lodgeit.wsgi Import make_app from lodgeit.application instead of lodgeit 5 years ago
manage.py Fix PEP-8 errors 3 years ago
requirements.txt Add libc6-dev to bindep and pin Pygments for 2.7 10 months ago
setup.cfg Upload container images 10 months ago
setup.py Upload container images 10 months ago
test-requirements.txt Fix up the tests and add tox configuration to run them 5 years ago
tox.ini Fix python3 compatibility issue 10 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!