LogdeIt, a Pastebin service
Go to file
Jeremy Stanley 1cee24ce0b Support Pillow v10
Pillow 9.5 deprecated the getsize method for fonts in favor of its
new getbbox, and then getsize was removed in Pillow 10.. Adjust the
call we use for captcha generation so it will continue working, and
declare a requirement for the earliest forward-compatible release.

Change-Id: Ib35eea077d7f8c428493ef8e4cfe00e05e580a6f
2024-02-20 21:49:07 +00:00
clientlib [svn] added license informations to lodgeit pastebin and finished open sourceing the package 2006-12-15 22:37:06 +01:00
editors/vim vim plugin: add vim plugin that targets openstack 2015-12-02 17:15:08 +01:00
lodgeit Support Pillow v10 2024-02-20 21:49:07 +00:00
scripts Merge "Fix sort comparison function" 2020-03-17 23:20:12 +00:00
tests Modernize test suite 2022-11-10 10:30:15 -08:00
.gitignore Modernize test suite 2022-11-10 10:30:15 -08:00
.gitreview OpenDev Migration Patch 2019-04-19 19:25:38 +00:00
.mailmap Add a .mailmap file 2016-02-26 15:23:37 +09:00
.stestr.conf Modernize test suite 2022-11-10 10:30:15 -08:00
.zuul.yaml Update lodgeit container image to Python3.11 on Bookworm 2023-10-09 13:40:43 -07:00
babel.ini Added javascript support in babel 2008-09-14 13:44:48 +02:00
bindep.txt Add libc6-dev to bindep and pin Pygments for 2.7 2020-03-26 10:10:08 -05:00
Dockerfile Update lodgeit container image to Python3.11 on Bookworm 2023-10-09 13:40:43 -07:00
lodgeit.wsgi Import make_app from lodgeit.application instead of lodgeit 2015-11-27 07:31:39 +00:00
Makefile added missing files 2008-07-08 11:20:20 +02:00
manage.py Fix PEP-8 errors 2017-02-25 13:47:11 +09:00
README Allow for overriding title 2021-06-29 19:24:27 +10:00
requirements.txt Support Pillow v10 2024-02-20 21:49:07 +00:00
setup.cfg Update lodgeit container image to Python3.11 on Bookworm 2023-10-09 13:40:43 -07:00
setup.py Upload container images 2020-03-09 08:19:55 -04:00
test-requirements.txt Modernize test suite 2022-11-10 10:30:15 -08:00
TODO Fix misspellings in lodgeit 2014-02-08 10:39:12 +08:00
tox.ini Update lodgeit container image to Python3.11 on Bookworm 2023-10-09 13:40:43 -07:00

==============
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!

Environment Settings
====================

LODGEIT_TITLE_OVERRIDE : <string>
  Arbitrary string to override the main heading for site customisation