Socialhome is missing features and needs a lot of polish on the UI side. If you are familiar with Django (or want to learn!) and are interested in getting involved, please don’t hesitate to get in touch!
For guidelines how to contribute, please first read the Contributing guide.
Instructions are for Ubuntu 16.04+ (+ simple Alpine 3.6 dependencies script). Please contribute via PR’s if you notice anything missing or want to contribute instructions for another platform.
Python 3.4, 3.5 and 3.6 are officially tested against. Ensure the following are installed:
- Python system dependencies
- NodeJS (version 6+)
- PostgreSQL server
requirements.apt contains other various dependencies. You can use the
install_ubuntu_dependencies.sh script to help installing these.
You can use the
install_alpine_dependencies.sh script to install required dependencies (including Python, NodeJS, PostgreSQL and Redis) on Alpine.
Install Python dependencies¶
pip-tools as the way to install Python dependencies. All the “base” dependencies, including production deployment dependencies are locked in
requirements.txt. The file
dev-requirements.txt includes both the base and the extra development/testing related dependencies.
pip-tools, first install it:
# Ensure pip and setuptools are up to date as well # We need a slightly older setuptools due to a bug in pip-tools pip install -U pip setuptools==30.4 pip-tools
Then install dependencies:
# Production environment pip-sync # Development environment pip-sync dev-requirements.txt
It is not mandatory to use
pip-tools for running a production installation. For development it is mandatory. All dependencies should be placed (unlocked) in either
requirements/requirements.in (base) or
requirements/requirements-dev.in (development extras). Then execute
./compile-requirements.sh to update the locked dependency files after each change to the
.in files. See pip-tools for more information.
Do NPM, Bower¶
npm install bower install sudo npm -g install grunt grunt dev
New Vue based frontend¶
The new Vue based frontend builds the bundles with Webpack. Execute the following to build the bundle.
npm run dev
To watch files and build bundles automatically, use this.
npm run watch
Configuration is done via environment variables. For the meaning of them, look them up under files in
config/settings. Values in
env.local will be used automatically.
cp env.example env.local
Edit any values necessary. By default the
SECRET_KEY is empty. You MUST set something to it. We don’t supply a default to force you to make it unique in your production app.
Create a database¶
If you changed the
DATABASE_URL in the settings file, make sure to change the values in these commands accordingly.
sudo su - postgres createuser -s -P socialhome # give password 'socialhome' createdb -O socialhome socialhome exit python manage.py migrate
Running the development server¶
Just use the standard command:
python manage.py runserver
runserver_plus cannot be used as it does not integrate with Django Channels.
Creating a user¶
To create an superuser account, use this command:
python manage.py createsuperuser
After this you need to log in once with the user via the user interface (which creates an email confirmation) and then run the following in the Django shell to confirm the email:
You should now be able to log in as the user
The search indexes must be initialized, otherwise there will be an error when trying to use search. Run this command once:
python manage.py rebuild_index
Any further changes to indexes objects will be maintained automatically from this point onwards. If you ever need to rebuild the index from scratch, use the same command.
This will launch a separate
runserver on port 8181 and execute the tests against that. The separate
runserver instance will be killed after the tests have been executed.
New Vue based frontend¶
npm run test
There is a dependency in the API route URL configurations with the new Vue based frontend tests. If you change or add new API routes during development, you must also do the following:
python manage.py collectstatic_js_reverse mv staticfiles/django_js_reverse/js/reverse.js socialhome/streams/app/tests/fixtures/Url.js
There is an
.eslintrc provided. We follow the Airbnb and Vue guidelines with some tweaks. It’s recommended to add this configuration to your editor directly. To run ESLint directly, use the following command. NOTE! This is only valid for the new Vue based frontend, not JS in
npm run lint
Building local documentation¶
cd docs make html
Doing a release¶
Bump version number in three places:
To generate a markdown version of the release changelog, first install
sudo apt install pandoc
Then execute the following and copy the markdown version for pasting to GitHub releases or a Socialhome post:
pandoc --from rst --to markdown_github docs/changelog.rst | less
After the release commit has been pushed and a release has been tagged, set a development version in the same above files. This is basically the next minor release postfixed by