90 lines
2.2 KiB
ReStructuredText
90 lines
2.2 KiB
ReStructuredText
Dynamicweb
|
|
----------
|
|
Installation for dynamicweb
|
|
=======
|
|
|
|
|
|
Requirements
|
|
============
|
|
* Python 3.5+
|
|
|
|
Install
|
|
=======
|
|
|
|
.. note::
|
|
lxml that is one of the dependency of dynamicweb couldn't
|
|
get build on Python 3.7 so, please use Python 3.5.
|
|
|
|
|
|
First install packages from requirements.archlinux.txt or
|
|
requirements.debian.txt based on your distribution.
|
|
|
|
|
|
The quick way:
|
|
``pip install -r requirements.txt``
|
|
|
|
Next find the dump.db file on stagging server. Path for the file is under the base application folder.
|
|
|
|
or you can create one for yourself by running the following commands on dynamicweb server
|
|
|
|
.. code:: sh
|
|
|
|
sudo su - postgres
|
|
pg_dump app > /tmp/postgres_db.bak
|
|
exit
|
|
cp /tmp/postgres_db.bak /root/postgres_db.bak
|
|
|
|
Now, you can download this using sftp.
|
|
|
|
|
|
Install the postgresql server and import the database::
|
|
``psql -d app -U root < dump.db``
|
|
|
|
**No migration is needed after a clean install, and You are ready to start developing.**
|
|
|
|
Development
|
|
===========
|
|
Project is separated in master branch and development branch, and feature branches.
|
|
Master branch is currently used on `Digital Glarus <https://digitalglarus.ungleich.ch/en-us/digitalglarus/>`_ and `Ungleich blog <https://digitalglarus.ungleich.ch/en-us/blog/>`_.
|
|
|
|
If You are starting to create a new feature fork the github `repo <https://github.com/ungleich/dynamicweb>`_ and branch the development branch.
|
|
|
|
After You have completed the task, create a pull request and ask someone to review the code from other developers.
|
|
|
|
**Cheat sheet for branching and forking**:
|
|
|
|
*branching*
|
|
|
|
``git branch feature_name && git checkout feature_name``
|
|
|
|
|
|
*fetching upstream(should be done everytime before development is started)*
|
|
|
|
``git fetch upstream && git merge upstream/feature_name``
|
|
|
|
|
|
`read more about getting code from upstream here <https://help.github.com/articles/syncing-a-fork/>`_
|
|
|
|
*merging your branch*
|
|
(**IMPORTANT**)
|
|
|
|
Before You make a pull request from Your forked branch to the ungleich make sure You did merge and resolve any conflicts You may find and that the application is running bug free.
|
|
Also You can run
|
|
|
|
``./manage test``
|
|
|
|
|
|
To merge upstream branch run this git commands.
|
|
|
|
``git fetch upstream``
|
|
|
|
``git checkout your_feature_branch``
|
|
|
|
``git merge remotes/upstream/develop``
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|