Bristol Hackspace website

The website is built using Flask and uses mosparo spam detection for forms.

A blog section is provided using content authored in a Django CMS that is available at this repository.

Prerequisites

To run this code locally it is assumed you have installed:

• git
• pyenv (to allow selection of virtual python environments)
• pip

Running Locally

Clone the repo

git clone https://github.com/bristolhackspace/website.git

cd website

Create example config file

This is a one-off config, if you already created the file you can skip this step.

mkdir instance
cd instance
cat << 'EOF' > config.toml
#Fake
MOSPARO_ENABLED = false
MOSPARO_HOST="localhost"
MOSPARO_PUBLIC_KEY="0x000"
MOSPARO_PRIVATE_KEY="0x001"
MOSPARO_UUID="12345"
SECRET_KEY='01234567890'
EOF

Verify the contents of the config.toml

cat config.toml

Set virtual environment

Ensure you are in the project root and create a virtual environment.

Select a Python 3.11 version, first check what versions are installed:

pyenv versions
  system
  3.10.13
* 3.11.8 (set by /Users/username/.pyenv/version)
  3.12.2

Install a Python 3.11 version if one is not listed:

pyenv local 3.11.8
python --version

create the virtual environment:

python -m venv .venv

# Activate it (macOS/Linux)
source .venv/bin/activate

# or on Windows PowerShell
# .venv\Scripts\Activate.ps1

# Update pip
pip install --upgrade pip

Install the project

From the project root:

pip install -r requirements.txt

Configure Flask environment variables

# On macOS/Linux (bash/zsh)
export FLASK_APP=hackspace_website:create_app
export FLASK_ENV=development

# On Windows PowerShell
# $env:FLASK_APP = "hackspace_website:create_app"
# $env:FLASK_ENV = "development"

Run the development server

Check you are in the root of the project.

flask run

 * Serving Flask app 'hackspace_website:create_app'
 * Debug mode: off
WARNING: This is a development server. Do not use it in a production deployment. Use a production WSGI server instead.
 * Running on http://127.0.0.1:5000

With the server running, in a browser navigate to: http://127.0.0.1:5000