Skip to content

wilmerm/django-survey

Repository files navigation

django-survey

The django-survey project is an application for Django that makes it easy to create and manage surveys on websites. This application provides functionalities to create surveys, define questions and response options, manage active and inactive surveys, collect user responses, and generate statistical reports on survey results. With this tool, developers can easily integrate surveys into their Django websites to collect user data and feedback.

image

Installation

pip install django-surveyplus

Usage

Add to installed applications

# settings.py

INSTALLED_APPS = [
    # ...
    'survey',
    # ...
]

Add the URLs

urlpatterns = [
    # ...
    path('survey/', include('survey.urls')),
    # ...
]

Run the migrations

python manage.py migrate

Creating a Survey

from survey.models import Survey, SurveyOption

survey = Survey.objects.create(
    title='Test Survey',
    description='Survey Description',
)

for i in range(1, 5):
    SurveyOption.objects.create(
        survey=survey,
        title=f'Option {i}',
        description=f'Option {i} Description',
    )

Displaying the Survey

{% load survey %}
<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Survey</title>
</head>
<body>
    <!-- Assuming you have a survey object -->
    {% survey_detail survey %}
</body>
</html>

Developer Instructions

Setting Up the Development Environment

  1. Clone the repository:

    git clone https://github.com/wilmerm/django-survey.git
    cd django-survey
  2. Create and activate a virtual environment:

    python -m venv env
    source env/bin/activate  # On Windows use `env\Scripts\activate`
  3. Install the dependencies:

    pip install -r requirements.txt
    pip install -r requirements-dev.txt
  4. Build and install the survey application:

    python -m build
    pip uninstall django-surveyplus
    pip install dist/*tar.gz
  5. Run the development server:

    python manage.py runserver

Running Tests

To run the tests, use the following command:

python manage.py test

Building and Publishing the Library

To compile and upload the library to PyPI, follow these steps:

  1. Ensure you have the necessary dependencies:

    pip install build twine
  2. Build the package:

    python -m build
  3. (Optional) Verify the package:

    twine check dist/*
  4. Upload the package to PyPI:

    python -m twine upload dist/*

License

This project is licensed under the MIT License. See LICENSE file for details.

Project Status

This project is in Production/Stable ✔


Contribution 💗

If you find value in this project and would like to show your support, please consider making a donation via PayPal:

Donate on PayPal

Your generosity helps us to continue improving and maintaining this project. We appreciate every contribution, however small. Thanks for being part of our community!