Updated release process

This commit is contained in:
reverend 2020-09-10 23:07:51 +02:00
parent 654cd87006
commit 98c5ddad65
5 changed files with 15 additions and 205 deletions

5
.gitignore vendored
View File

@ -94,4 +94,7 @@ env.bak/
venv.bak/
# Editors
.vscode
.vscode
# twine / pypi
.pypirc

View File

@ -1,5 +1,5 @@
include LICENSE
include README.rst
include Readme.rst
include Pipfile
recursive-include lostplaces_app/static *
recursive-include lostplaces_app/templates *

View File

@ -9,6 +9,8 @@ coverage = "*"
autopep8 = "*"
pipenv = "*"
wheel = "*"
twine = "*"
pandoc ="*"
[packages]
django = "*"

View File

@ -1,199 +0,0 @@
lostplaces-backend
==================
lostplaces-backend is a django (3.x) based webproject. It once wants to
become a software which allows a group of urban explorers to manage,
document and share the locations of lost places while not exposing too
much / any information to the public.
The software is currently in early development status, neither scope,
datalmodel(s) nor features are finalized yet. Therefore we would not
recommend to download or install this piece of software anywhere -
except your local django dev server.
Features
--------
- manage lost places with lots of usefull information
- sensitive information is not accesiable for anonymous (not logged in)
users
- user self registration using a voucher system, only people you invite
can join your instance
- collaboration, every user can add informations like tags, photos and
external links to your place
Dependencies
------------
Right now it depends on the following non-core Python 3 libraries. These
can be installed using the package manager of your distribution or into
the venv locally.
- `django <https://www.djangoproject.com/>`__ django is a high-level
Python Web framework that encourages rapid development and clean,
pragmatic design.
- `easy-thumbnails <https://github.com/SmileyChris/easy-thumbnails>`__
A powerful, yet easy to implement thumbnailing application for Django
1.11+
- `image <https://github.com/francescortiz/image>`__ Image cropping for
django
- `django-widget-tweaks <https://github.com/jazzband/django-widget-tweaks>`__
Tweak the form field rendering in templates, not in python-level form
definitions.
- `django-taggit <https://github.com/jazzband/django-taggit>`__ A
simpler approach to tagging with Django.
Installing a development instance
=================================
Clone the repository
--------------------
``git clone https://git.mowoe.com/reverend/lostplaces-backend.git`` ##
Setting up a (pipenv) virtual environment for development
After having obtained the repository contents (either via .zip download
or git clone), you can easily setup a
`pipenv <https://docs.pipenv.org/>`__ virtual environment. The repo
provides a Pipfile for easy dependency management that does not mess
with your system.
.. code:: shell
$ cd lostplaces-backend
$ pipenv install
$ pipenv shell
(lostplaces-backend) $ lostplaces/manage.py makemigrations
(lostplaces-backend) $ lostplaces/manage.py migrate
(lostplaces-backend) $ lostplaces/manage.py createsuperuser
(lostplaces-backend) $ lostplaces/manage.py runserver --ipv6
Returning to the venv
---------------------
.. code:: shell
$ cd lostplaces-backend
$ pipenv shell
(lostplaces-backend) $ pipenv update # If dependencies changed, or updates available
(lostplaces-backend) $ lostplaces/manage.py makemigrations # If datamodels changed
(lostplaces-backend) $ lostplaces/manage.py migrate # If datamodels changed
(lostplaces-backend) $ lostplaces/manage.py runserver --ipv6
Visit: `admin <http://localhost:8000/admin>`__ for administrative
backend or `frontend <http://localhost:8000/>`__
Installing a productive instance
================================
Currently there are two ways to deploy the lostplaces project: 1.
Cloning this repository, including the configured django instance 2.
Install the package and setup the django instance your self
Cloning the repository
----------------------
Essently, this is the same as installing an development instance, but
without the development server (manage.py runserver) and something
powerfull (Apache, NGINX) instead. You have to configure the webserve to
work with the \*SGI Api respectivly, reference `django's guide for
deployment <https://docs.djangoproject.com/en/3.1/howto/deployment/>`__
for further information.
You also should setup an dedicated database server, the build in SQLite
file is not recommened for production use. Reference `django's guide for
databases <https://docs.djangoproject.com/en/3.1/ref/databases/>`__ for
further information.
Before making the django instance public, you should tweak the config
``settings.py``: 1. Change the secret key, the one found in the config
is already public. Choose something secure (i.e.
`this <https://duckduckgo.com/?q=password+generator+64>`__) 2. Turn off
debug mode by setting ``DEBUG = False`` 3. Tune the localization
settings, see `django's
documentation <https://docs.djangoproject.com/en/3.1/topics/i18n/>`__
Run ``lostplaces/managy.py collectstatic`` you should be ready to go.
Installing the lostplaces\_app to an existing django instance
-------------------------------------------------------------
Installing django and the lostplaces app
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
If you haven't already setup an django instance, see `django's
documentation <https://docs.djangoproject.com/en/3.1/topics/install/>`__.
After that, download the desired release (probably the latest one) `from
the realeases
page <https://git.mowoe.com/reverend/lostplaces-backend/releases>`__ and
install it using ``pip install --user name-of-the-file.tar.gz``.
*Note: You can run pip install without the --user flag, which will
require root privileges and introduces potential security issues*
Configuring the django instance
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Now configure your ``settings.py`` as follows: 1. Add the following apps
to the django project
.. code:: python
INSTALLED_APPS = [
...
'lostplaces_app',
'easy_thumbnails',
'widget_tweaks',
'django_taggit'
]
2. Set the URL's and Root-directories for file handling, for example
.. code:: python
STATIC_URL = '/static/'
STATIC_ROOT = os.path.join(BASE_DIR, 'static_files')
MEDIA_URL = '/uploads/'
MEDIA_ROOT = os.path.join(BASE_DIR, 'uploads')
3. Set the user model (this will be changed in the next release)
.. code:: python
AUTH_USER_MODEL = 'lostplaces_app.Explorer'
4. Set the URL's for login, for example
.. code:: python
LOGIN_URL = reverse_lazy('login')
LOGIN_REDIRECT_URL = reverse_lazy('lostplaces_home')
LOGOUT_REDIRECT_URL = reverse_lazy('lostplaces_home')
Configuring the URL's
~~~~~~~~~~~~~~~~~~~~~
In the ``urls.py`` configure the ``urlpatter`` like this
.. code:: python
urlpatterns = [
path('admin/', admin.site.urls),
path('signup/', SignUpView.as_view(), name='signup'), # If you want to use lostplaces sign up view
path('explorers/', include('django.contrib.auth.urls')), # You can change the 'explorers/' to whatever you desire
path('', include('lostplaces_app.urls')), # In this configuration lostplaces will be at the top level of you website, change '' to 'lostplaces/', if you don't want this
] + static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT) # So django can deliver user uploaded files
Before making the django instance public, you should tweak the config
``settings.py``: 1. Change the secret key, the one found in the config
is already public. Choose something secure (i.e.
`this <https://duckduckgo.com/?q=password+generator+64>`__) 2. Turn off
debug mode by setting ``DEBUG = False`` 3. Tune the localization
settings, see `django's
documentation <https://docs.djangoproject.com/en/3.1/topics/i18n/>`__
Run ``lostplaces/managy.py collectstatic`` you should be ready to go.
Happy developing ;-)

View File

@ -1,17 +1,21 @@
from setuptools import setup, find_packages
with open('Readme.md') as f:
readme = f.read()
setup(
name='django-lostplaces',
version='0.1.a2',
version='0.1.a5',
description='A django app to manage lost places',
author='Reverend :: Commander1024',
author_email='reverend@reverend2048.de :: commander@commander1024.de',
author='Reverend',
author_email='reverend@reverend2048.de',
url='https://git.mowoe.com/reverend/lostplaces-backend',
packages=find_packages(exclude=['lostplaces']),
long_description=readme,
long_description_content_type='text/markdown',
classifiers=[
'Development Status :: 3 - Alpha',
'Environment :: Web Environment',
'Intended Audience :: Explorer :: Photographers :: Proper People',
'License :: OSI Approved :: MIT License',
'Operating System :: OS Independent',
'Programming Language :: Python :: 3.7'