Updated release process
This commit is contained in:
parent
654cd87006
commit
98c5ddad65
5
.gitignore
vendored
5
.gitignore
vendored
@ -94,4 +94,7 @@ env.bak/
|
|||||||
venv.bak/
|
venv.bak/
|
||||||
|
|
||||||
# Editors
|
# Editors
|
||||||
.vscode
|
.vscode
|
||||||
|
|
||||||
|
# twine / pypi
|
||||||
|
.pypirc
|
||||||
@ -1,5 +1,5 @@
|
|||||||
include LICENSE
|
include LICENSE
|
||||||
include README.rst
|
include Readme.rst
|
||||||
include Pipfile
|
include Pipfile
|
||||||
recursive-include lostplaces_app/static *
|
recursive-include lostplaces_app/static *
|
||||||
recursive-include lostplaces_app/templates *
|
recursive-include lostplaces_app/templates *
|
||||||
2
Pipfile
2
Pipfile
@ -9,6 +9,8 @@ coverage = "*"
|
|||||||
autopep8 = "*"
|
autopep8 = "*"
|
||||||
pipenv = "*"
|
pipenv = "*"
|
||||||
wheel = "*"
|
wheel = "*"
|
||||||
|
twine = "*"
|
||||||
|
pandoc ="*"
|
||||||
|
|
||||||
[packages]
|
[packages]
|
||||||
django = "*"
|
django = "*"
|
||||||
|
|||||||
199
Readme.rst
199
Readme.rst
@ -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 ;-)
|
|
||||||
12
setup.py
12
setup.py
@ -1,17 +1,21 @@
|
|||||||
from setuptools import setup, find_packages
|
from setuptools import setup, find_packages
|
||||||
|
|
||||||
|
with open('Readme.md') as f:
|
||||||
|
readme = f.read()
|
||||||
|
|
||||||
setup(
|
setup(
|
||||||
name='django-lostplaces',
|
name='django-lostplaces',
|
||||||
version='0.1.a2',
|
version='0.1.a5',
|
||||||
description='A django app to manage lost places',
|
description='A django app to manage lost places',
|
||||||
author='Reverend :: Commander1024',
|
author='Reverend',
|
||||||
author_email='reverend@reverend2048.de :: commander@commander1024.de',
|
author_email='reverend@reverend2048.de',
|
||||||
url='https://git.mowoe.com/reverend/lostplaces-backend',
|
url='https://git.mowoe.com/reverend/lostplaces-backend',
|
||||||
packages=find_packages(exclude=['lostplaces']),
|
packages=find_packages(exclude=['lostplaces']),
|
||||||
|
long_description=readme,
|
||||||
|
long_description_content_type='text/markdown',
|
||||||
classifiers=[
|
classifiers=[
|
||||||
'Development Status :: 3 - Alpha',
|
'Development Status :: 3 - Alpha',
|
||||||
'Environment :: Web Environment',
|
'Environment :: Web Environment',
|
||||||
'Intended Audience :: Explorer :: Photographers :: Proper People',
|
|
||||||
'License :: OSI Approved :: MIT License',
|
'License :: OSI Approved :: MIT License',
|
||||||
'Operating System :: OS Independent',
|
'Operating System :: OS Independent',
|
||||||
'Programming Language :: Python :: 3.7'
|
'Programming Language :: Python :: 3.7'
|
||||||
|
|||||||
Loading…
Reference in New Issue
Block a user