The website for PrISUm Solar Car Team at Iowa State University
To contribute to this project, you may want to familiarize yourself with the following languages and technologies.
Languages
- CSS
- HTML5
- Javascript (Docs +JSX)
Libraries
Tools None
Languages
Libraries
Tools
- Git (or SourceTree)
- PyCharm (recommended)
Python 2 will be used to run the server. This allows us to use Jinja2 templates to reduce HTML duplication. Make sure you install Python 2, not Python 3. Python versions older than 2.7.9 do not include the package manager, pip. For those versions, you will need to manually install pip.
By default, pip will install all packages to your system Python installation. Virtual environments allow you to make new Python installations and install Python packages on a project-by-project basis. When you activate a virtual environment, you tell your system which executable and packages you want to use. A virtual environment is not technically required, but it is best practice.
These bash commands will install a virtual environment named "prisum".
pip install virtualenv
mkdir ~/.virtualenvs
cd ~/.virtualenvs
virtualenv prisum
This bash command will activate the virtual environment.
source ~/.virtualenvs/prisum/bin/activate
From the root project directory, run the command pip install -r requirements_dev.txt. Make sure your virtual environment is active first.
To start the server, run the command python run.py from the root project directory. As long as this server is running, you will be able to activate the website via localhost.
PyCharm is the recommended IDE for this project. JetBrains offers free full versions of all of their IDEs for students, including PyCharm, but the community edition will also work for this project.
With the project open in PyCharm, open the Settings dialog and navigate to the Project Interpreter page. Click on the gear icon in the top-right and select the "Add Local" option to select a Python interpreter executable. If you followed the installation instructions above, it is at ~/.virtualenvs/prisum/Scripts/python.exe (or ~/.virtualenvs/prisum/bin/python2.7 on OSX and Linux).
Having to activate a virtual environment, navigate to the project directory, and execute the python run.py command just to start the server is a bit annoying. Let's make the IDE do it for us! Open the Run Configurations dialog. Click on the green + icon in the top-left and select "Python" from the list of configuration types. Configure the "Script" and "Working directory" fields accordingly. Also make sure that the "Python interpreter" option points to your virtual environment directory.
The import system for Python projects is based on the host machine's operating system. Because of this, you will need to specify a "sources root" directory for PyCharm so that it knows where to import project files from. Simply right-click on the prisum directory (the second one) and choose "Mark Directory As > Sources Root".