Skip to content

Latest commit

 

History

History
86 lines (68 loc) · 2.47 KB

README.md

File metadata and controls

86 lines (68 loc) · 2.47 KB

Pycon Nigeria 2018

This is the official website for Python Nigeria Conference

Setting Up the repo for development

The project uses python3 specifically python3.6

  1. Before cloning the repo, create a parent folder

  2. clone the repo inside this folder just created

    $ git clone https://github.com/pyung/pyconng.git pycon
    # ensure you switch to the develop branch
    $ git checkout develop
    
  3. Create a virtual environment and activate it

    $ python -m venv venv
    $ source venv\bin\activate
    # ensure the version of pip is 18.1
    $ pip install pip==18.1
    $ cd pycon
    
    # for window users
    > venv\Scripts\activate
    
  4. Install all the dependencies for the project

    (venv)$ pip install -r requirements/local.txt  
    
  5. Ensure you have Postgres database installed on your system. visit Postgres Download Section to download postgres for your respective OS

  6. Create a database using the default postgres user and create a db named pyconng

    $ createdb pyconng
    
    

    __This step isn't compulsory if you already have a database that you want to use or you are using pgadmin3 to create the database.

  7. Setup an environmental variable to map the database configuration

    export DATABASE_URL=postgres://<dbuser>:<dbpassword>@<dbhost>:<dbport>/pyconng
    # remember to set this environment variable
    export DJANGO_SETTINGS_MODULE=config.settings.local
    
  8. Run migrations

    python manage.py migrate
    
  9. Run fixtures (one time only)

    $ python manage.py loaddata fixtures/*
  10. If everything above was successful, you can go ahead and start the server

    $ python manage.py runserver_plus 
    
    #there  is a chance you might run into segfault with runsrver
    
    # if running on cloud9
    python manage.py runserver $IP:$PORT

Extras. Useful for frontend developers and designers

This is important to those who would be working on converting the mockups to actual html/css

$ cd design
$ npm install -g parcel-bundler
$ npm install  #or yarn install if yarn is used
$ yarn start

Issue Reporting

If you have found a bug or if you have a feature request, please report them at this repository issues section.

License

This project is licensed under the MIT license. See the LICENSE file for more info.