BlankProjectTemplate/Doc_Revision1/ProblemStatement/ProblemStatement.tex

+\documentclass{article}
+
+\usepackage{tabularx}
+\usepackage{booktabs}
+
+\title{SE 3XA3: Problem Statement\\ \textbf{Snake Game}}
+
+\author{Team \#30, VUA30
+		\\ Usman Irfan - irfanm7
+		\\ Andy Hameed - hameea1
+		\\ Vaibhav Chadha - chadhav
+}
+
+\date{2018-09-21}
+
+\usepackage[left=2cm, right=5cm, top=2cm]{geometry}
+
+\begin{document}
+
+\begin{table}[hp]
+\caption{Revision History} \label{TblRevisionHistory}
+\begin{tabularx}{\textwidth}{llX}
+\toprule
+\textbf{Date} & \textbf{Developer(s)} & \textbf{Change}\\
+\midrule
+2018-09-20 & Vaibhav & Made the LaTeX file and wrote the section with what the Problem is\\
+2018-09-20 & Usman & Added the Importance of Problem section while formatting the LaTeX\\
+2018-09-21 & Andy Hameed & Formatted LaTeX file and added Context section, giving the final editing to the document\\
+2018-10-09 & Andy Hameed & Edited doc to reflect web app to desktop app decision change\\
+\bottomrule
+\end{tabularx}
+\end{table}
+
+\newpage
+
+\maketitle
+
+\subsection*{The Problem}
+
+Almost everyone nowadays relies on a computer as a multipurpose tool for research, video streaming, gaming and many other tasks. With the emergence of fast computing, gaming has become a popular pastime activity and a source of entertainment for many. However, not everyone has a device powerful enough to support extensive game applications. A simple, memory effecient application of the Snake game allows it to be accessible for gamers without the need for extensive hardware or a high-performance computer. Our team, VUA30, will be creating a desktop application for the well-known Snake game with new enhancements and features. This competitive and addictive game can allow the user to play at their own pace and challenge their own high score. 
+
+\subsection*{Importance of the Problem}
+
+Buying a computing device with high storage and faster performance can be out of budget. Complicated software covers up all the storage and the user is bound to use these applications as opposed to downloading other software. The importance of the redevelopment of The Snake is to save computing devices' personal storage and allow the user to play a game 24/7 with strong performance, even offline. Creating a desktop version of the snake game can fit into the category of downloadable calssical games such as the solitaire suite. The recreation of this game will allow the user to enjoy the classical game anytime and anywhere as long as they have installed the application. Improving aspects such as graphics and custom speed will also make the game more interesting. We would like to add more features to the game to make it more customizable and help people enjoy the classical game in an exciting and new way.
+
+
+\subsection*{Context}
+The stakeholders are mainly the gaming audience, the older generation of game enthusiasts, youth and teens. Some other stakeholders that Although the game can be played by anyone, it is targeted towards the audience mentioned above who are most invested in the game. The environment is native app development using Python. This provides provides less flexibility than web API's but there still exists many useful libraries which can be used such as Pygame for example.
+
+\end{document}
+

BlankProjectTemplate/Doc/DevelopmentPlan/README.md → BlankProjectTemplate/Doc_Revision1/ProblemStatement/README.md

-# Development Plan
+# Problem Statement
 
 The folders and files for this folder are as follows:
 

BlankProjectTemplate/Doc_Revision1/SRS/README.md

+# Software Requirements Specification
+
+The folders and files for this folder are as follows:
+
+Describe ...

BlankProjectTemplate/Doc_Revision1/SRS/SRS.tex

+\documentclass[12pt, titlepage]{article}
+
+\usepackage{booktabs}
+\usepackage{tabularx}
+\usepackage{hyperref}
+\hypersetup{
+    colorlinks,
+    citecolor=black,
+    filecolor=black,
+    linkcolor=black,
+    urlcolor=blue
+}
+\usepackage[round]{natbib}
+
+\title{SE 3XA3: Software Requirements Specification\\Title of Project}
+
+\author{Team 30, VUA
+		\\ Andy Hameed and hameea1
+		\\ Usman Irfan and irfanm7
+		\\ Vaibhav Chadah and chadhav
+}
+
+\date{\today}
+
+
+\begin{document}
+
+\maketitle
+
+\pagenumbering{roman}
+\tableofcontents
+\listoftables
+\listoffigures
+
+\begin{table}[bp]
+\caption{\bf Revision History}
+\begin{tabularx}{\textwidth}{p{3cm}p{2cm}X}
+\toprule {\bf Date} & {\bf Version} & {\bf Notes}\\
+\midrule
+Oct 5, 2018 & 1.0 & Andy worked on Project Drivers and Project Issues. Usman worked on Functional requirements. Vaibhav worked on Non-Functional Requirements\\
+Date 2 & 1.1 & Notes\\
+\bottomrule
+\end{tabularx}
+\end{table}
+
+\newpage
+
+\pagenumbering{arabic}
+
+This document describes the requirements for ....  The template for the Software
+Requirements Specification (SRS) is a subset of the Volere
+template~\citep{RobertsonAndRobertson2012}.  If you make further modifications
+to the template, you should explicity state what modifications were made.
+
+\section{Project Drivers}
+
+\subsection{The Purpose of the Project}
+
+Almost everyone nowadays relies on a computer as a multipurpose tool for research, video streaming, gaming and many other tasks. With the emergence of fast computing, gaming has become a popular pastime activity and a source of entertainment for many. However, not everyone has a device powerful enough to support extensive game applications. A simple, memory-effecient application of the Snake game allows it to be accessible for gamers without the need for extensive hardware or a high-performance computer. Our team, VUA30, will be creating a desktop application for the well-known “Snake” game with new enhancements and features. This competitive and addictive game can allow the user to play at their own pace and challenge their own high score. 
+
+Buying a computing device with high storage and faster performance can be out of budget. Complicated software covers up all the storage and the user is bound to use these applications as opposed to downloading other software. The importance of the redevelopment of “The Snake” is to save computing device’s personal storage and allow the user to play a game 24/7 with strong performance, even offline. Creating a desktop version of the snake game can fit into the category of downloadable calssical games such as the solitaire suite. The recreation of this game will allow the user to enjoy the classical game anytime and anywhere as long as they have installed the application. Improving aspects such as graphics and custom speed will also make the game more interesting. We would like to add more features to the game to make it more customizable and help people enjoy the classical game in an exciting and new way. 
+
+\subsection{The Stakeholders}
+
+Stakeholders involved will be contained within the gaming community, more specifically the desktop gaming community and casual PC owners who are 
+looking for a fun reliever for boredom or quick game to play.This also includes members invested in the project which are mentioned in the subsesctions below.
+
+\subsubsection{The Client}
+
+Since this game is a separate entity, the clients are the designers in this project team. In further developments and upon increase in game popularity, the clients 
+could be a desktop gaming distribution service such as steam, google play or apple store. Otherwise, the main client would be Dr. Bokhari who has assigned the project.
+
+\subsubsection{The Customers}
+
+The main users or customers  are desktop gamers, older generation of game enthusiasts, youth and teens. However, the client can be anyone with a PC and an interest in classical gaming or a sudden craving for playing the classical Snake game. Often times, these games are a quick fix to boredom for those who are casually browing their PC's, so the game will be designed to provide enough stimulus and excitmement for regular computer users, similar to the solitaire suite.
+
+\subsubsection{Other Stakeholders}
+
+Aside from the clients and customers, other stakeholder include 3rd party Desktop game distribution stores and open source project banks which may make use of this project for development purposes:
+
+\begin{itemize}
+\item 3rd party desktop game distribution stores.
+\item Game Testers.
+\item Technology Experts [Part of Project Team].
+\item Usability experts.
+\item Dr. Bokhari.
+\item Project Development Experts: This can include teaching assistants, the professor, experienced peers and so on.
+\end{itemize}
+
+
+\subsection{Mandated Constraints}
+
+Some constraints that apply to the project include the following:
+
+\begin{itemize}
+\item No project budget provided; Project cannot use costly API memberships or resources.
+\item Application should take less than 400MB of storage space to meet requirements.
+\item The project must be completed within a 4-month period.
+\item Limited resources in terms of domain experts, specifically in graphic design.
+\item Application will be developed for one OS due to time constraint.
+\item open source project must be translated to Python due to development language and scope.
+\end{itemize}
+
+\subsection{Naming Conventions and Terminology}
+
+The naming conventions listed below will be used to clearly define words and termiology that will come up in the project development process. Below is a list
+of naming conventions, terms, and special vocabularly and their meaning. Since the desktop application is straighforward, there is not much terminology being
+used as of now:
+
+\begin{itemize}
+\item DDS: Digital Distribution Service such as play store, microsoft play, etc.
+\item OS: Operating System.
+\item Python: The programming language used for application development.
+\item Pygame: Computer graphics Python library.
+\item Snake 2.o: The desktop application being developed in Python.
+\item The interface: The graphics developed using Pygame.
+\item The source game: The open source original Python snake game being used for this project.
+\end{itemize}
+
+\subsection{Relevant Facts and Assumptions}
+
+Some factors that might affect the outcome of the product are listed as follows:
+\begin{itemize}
+\item DDS contribution will be necessary for the public release of the game.
+\item Contribution of  the development team will affect the outcome of the product.
+\item Feedback from game testers.
+\item Availability of resources from pygame library to replicate front-end design in HTML,CSS and JS.
+\item Time remaining once initial objectives and goals are met. This could affect which additional functionality is added.
+\end{itemize}
+
+ There are also assumptions that pertain to the intended operational environment and anything affecting the product:
+\begin{itemize}
+\item Pygame library offers enough functionality to recreate the web app graphics in Python.
+\item The user is using Windows for game execution otherwise they must compile the source code to run the application.
+\item The application will not be an exact replica of the source game. Added functionality and a change of graphics is expected.
+\item The game application will prioritize the completion of the snake game as the central attraction.
+\end{itemize}
+
+Some user characteristics will affect the final deisgn and written requirements:
+\begin{itemize}
+\item Users expect the game to be responsive and timely due to the nature of wanting quick stimulus .
+\item The game should have an attractive user inteface due to the nature of the users expectations. It is mainly used for entertainment and should
+have a smooth user-interface.
+\end{itemize}
+
+\section{Functional Requirements}
+
+\subsection{The Scope of the Work and the Product}
+% Summarize Gantt Chart
+
+\subsubsection{The Context of the Work}
+%
+The scope of the project is deliver a Product that has the requirement documentation, and a desktop application that can be installed on a user's system.\\
+\\To achieve the goals of the Product, the following are decided to be the deadlines of the goal to be on the track:\\
+$\bullet$ Development Plan \date{28/09/18}\\
+\\$\bullet$ Requirements Document Revision \date{05/10/18}\\
+\\$\bullet$ Proof of Concept Demonstration \date{16/10/18}\\
+\\$\bullet$ Test Plan Revision \date{26/10/19}\\
+\\$\bullet$ Design \& Document Revision \date{09/11/18}\\
+\\$\bullet$ Revise all the Documentation \date{13/11/18}\\
+\\$\bullet$ Final Documentation \date{06/12/18}\\
+
+\subsubsection{Work Partitioning}
+%breakdown your task into sub-task e.g. break logic and user interface
+The desktop application involves different processes to successfully run: making a user-interface so the user can interact with the application, the logic behind the user-interface that can handle all the inputs given by the user and outputs the result according to the requirements.
+These tasks can be divided into sub-task. For example, the system uses the microphone as an input, so whenever the sake completes a functional requirement (the requirements are described below) it will output an audio to make the game much more interesting.  Another example would be, the movement of the snake and it get larger would be done by the logic at the back-end and its output will be displayed on the screen so the user can continue playing. 
+Tasks such as displaying the food, making snake appear at random locations in the beginning, etc. should all be divided and can be worked individually as this would more efficient to complete and the developer would know how to test these functions.
+\subsubsection{Individual Product Use Cases}
+%
+The user can use the system-to-be (the desktop application) to entertain themselves when they are bored. They can use the system to improve their response time, with playing the game in difficulty modes it can be more challenging and the user has to be fast. In addition, the desktop application would be a fun means of entertainment between friends as they can play turn-by-turn and challenge each other.
+\subsection{Functional Requirements}
+
+
+$\bullet$ Requirement number: FR(Functional Requirement)1\\
+When the user sees the interface it can start the game by pressing any button key.\\
+Rationale: If the user presses any button and the game does not work as it is expected to be.\\
+
+$\bullet$ Requirement number: FR2 \\
+User's can press F11 key to play the desktop application in Full screen mode.\\
+
+$\bullet$ Requirement number: FR3\\
+The user can press the UP key to move the snake's direction in the upwards direction.\\
+
+$\bullet$ Requirement number: FR4\\
+The user can press the DOWN key to move the snake's direction in the downwards direction.\\
+
+$\bullet$ Requirement number: FR5\\
+The user can press the LEFT key to move the snake's direction in the left direction.\\
+
+$\bullet$ Requirement number: FR6\\
+The user can press the LEFT key to move the snake's direction in the right direction.\\
+
+$\bullet$ Requirement number: FR7\\
+The game should display the user's highest score.\\
+
+$\bullet$ Requirement number: FR8\\
+The initial location of the snake should be random whenever the user starts the game or when it restarts.\\
+
+$\bullet$ Requirement number: FR9\\
+The user has the option to play in three different modes: easy, medium and hard.\\
+
+$\bullet$ Requirement number: FR10\\
+The game should display the user's highest score.\\
+
+$\bullet$ Requirement number: FR11\\
+The desktop application provides a facility to toggle in different themes, e.g. Dark to Light.\\
+
+$\bullet$ Requirement number: FR12\\
+The desktop application provides a facility to toggle in different themes, e.g. Dark to Light.\\
+
+$\bullet$ Requirement number: FR13\\
+When the snake eats its food its length should be increased by 5 units. For instance, when the game is started and the snake's length is only 1 unit, but after eating a block of food its new length should be 6 units.\\
+
+$\bullet$ Requirement number: FR14\\
+By pressing the spacebar key the game should be paused.\\
+
+$\bullet$ Requirement number: FR15\\
+By pressing the spacebar key the game should be resumed, only if the game was paused initially.\\
+
+$\bullet$ Requirement number: FR16\\
+Snake's food should be randomly placed on the screen in the beginning of the game, once the snake eats its food, the food should reappear on the screen.\\
+
+$\bullet$ Requirement number: FR17\\
+The snake is allowed to move around in a certain space, if the snake crosses that space it should die and a message should prompt on the screen to restart the game.\\
+
+$\bullet$ Requirement number: FR18\\
+If the snake bites itself, the game should be over and a message should prompt on the screen to restart the game.\\
+
+$\bullet$ Requirement number: FR19\\
+If the user is successful in making the snake eat 10 food units consecutively, a food unit with more value should be displayed on the screen that would give the snake more points but will increase its length with the same amount, as previously stated.\\
+
+$\bullet$ Requirement number: FR20\\
+The snake should change its colour when it dies.\\
+
+\section{Non-functional Requirements}
+
+\subsection{Look and Feel Requirements}
+
+\subsubsection{Appearance Requirements}
+
+The final product shall be a desktop application which will contain a playground with a snake in it. It shall have different theme options and buttons to customize the speed of the snake. Also, it shall show the highest score made on the specific device.
+
+\subsubsection{Style Requirements}
+
+The product should be given a modern style by adding a nice background to it with a user-friendly interface.
+
+\subsection{Usability and Humanity Requirements}
+
+The application must be simple for a person aged 10 or above. It should be understandable by any person within the age group who is familiar to the technology. No feature should restrict the player to a non-knowledgeable outcome.
+
+\subsection{Performance Requirements}
+
+\subsubsection{Speed Requirements}
+
+\begin{description}
+	
+	\item[$\bullet$] All valid interaction should have a maximum response time of half a second.
+	
+	\item[$\bullet$] The speed for snake should be customizable by the user and should not increase or decrease by itself.
+	
+	
+\end{description}
+
+\subsubsection{Safety Critical requirements}
+
+The game shall not consume any private data from the user's device. 
+
+\subsubsection{Precision Requirements}
+\begin{description}
+	\item[$\bullet$] The speed of the snake should be consumed through integer values.
+	
+	\item[$\bullet$] The turn for snake should match with the users key and should be done as precisely as possible.
+\end{description}
+
+\subsubsection{Reliability and Availability Requirements}
+
+The game should be available 24 hours, 365 days per year to the user.
+
+\subsubsection{Capacity Requirements}
+
+The game shall not overload the clients device's memory. 
+
+\subsection{Operational and Environmental Requirements}
+
+\subsubsection{Expected Physcial environment}
+
+The application is intended to be used anywhere, at any desktop device. It can be used in any climatic condition from harsh summers to chilly winter( given that the device is working as well).
+
+\subsubsection{Expected Technological environment}
+
+This application should work on any desktop device as long as the device is working.
+
+\subsection{Maintainability and Support Requirements}
+
+\subsubsection{Maintainability}
+
+The application shall require minimum maintenance. Also, the application shall be revised every year.
+
+\subsubsection{Portability}
+
+The application is expected to run on Windows, Mac OS and Linux environment.
+
+\subsection{Security Requirements}
+
+This is an open-ended application. However, the application must not break the privacy policy by interfering with files stored on the desktop. Authors credits must be given when used by another party for any kind of development.
+
+\subsection{Cultural Requirements}
+
+The application will not use any kind of communicating data that will offend any religion, country or user in any way. The product will give a detailed explanation in case of use of any cultural or political symbol.
+
+\subsection{Legal Requirements}
+
+The application shall comply with all national and federal laws. In addition, the application must agree to the MIT Open License.
+
+\subsection{Health and Safety Requirements}
+
+This section is not in the original Volere template, but health and safety are
+issues that should be considered for every engineering project.
+
+\section{Project Issues}
+
+\subsection{Open Issues}
+Below is a list of open issues pertaining to the project scope:
+\begin{itemize}
+\item Investigating and understanding the capabilities of the Pygame library is yet to be completed.
+\item Integrating additional features is not decided on as of yet. It is dependant on time constraints.
+\item snake-game multiplayer mode is an open issue on the open source project which we may or may not choose to implement as time permits.
+\end{itemize}
+\subsection{Off-the-Shelf Solutions}
+
+Although there are available solutions on developing such a game, the project team is aiming to enhance the game by producing a desktop version with 
+added functionality.
+
+Ready-made simple implementations of the projects are available and can be used as reference but otherwise, enhanced features will have to be created from scratch (light/ dark theme, custom player settings, high scores and so on).
+
+\subsection{New Problems}
+
+\subsubsection{Effects on the Current Environment}
+
+The Microsoft Store contains the "250k snake" app for windows, an implementation of the old-school snake game. Aside from this application, other applications that appear when searching "snake" or "snake game" do not reflect the classical snake game. By developing the snake game as a desktop app, we will be able to provide game shoppers with more options to pick from. 
+
+\subsubsection{Effects on the Installed Systems}
+
+The existance of the 250k snake will make it difficult to push the project team's implementation of the game, Snake 2.o, into the microsoft store market successfully. However, the new snake game will fill a niche for cutsomizability by allowing users to pick from many different settings. 
+
+\subsection{Tasks}
+
+An article on linkedIn by Sumit Jain summarizes the steps involved in the game development process [ ~\cite{devArticle} ]. In his article, he outlines 6 main steps to the game development cycle: Idea \& Story, Conceptualize \& Design, Technical Analysis, Development, Testing, Deployment. Considering the project scope and the redevelopment of the snake game, the main three steps involved in the developement cycle are the following:
+\begin{itemize}
+\item Technical Analysis: Use reverse engineering to understand how the game was originally built and analyze the main modules/ framework used to develop the game.
+\item Development: Using Python and Pygame to develop the source code for the game; Analysis from the previous step will be necessary to break down the developement process.
+\item Testing: Test using unittest in python and principles of white box and black box testing. In further developments, this would also include intergation testing with the user interface and the collection of modules created for the application. 
+\end{itemize}
+
+Project members should expect the development cycle to resemble the previously mentioned framework. Once the cycle has been iterated until completion of Snake 2.o, the team will move on to the deployment stage, considering options for making the game available on a DDS such as the Microsoft Store.   
+
+\subsection{Migration to the New Product}
+
+Snake 2.o will be require the following conversion tasks:
+\begin{itemize}
+\item Converting JS,HTML and CSS graphics and animations to Pygame graphics.
+\item Comverting the source project into modularized step-based tasks.
+\item Converting from JS,HTML and CSS source code to Python source code.
+\end{itemize}
+
+The source project will be run with Snake 2.o for performance comparison and visual feedback on the accuracy of the redevelopment as well as the enhance features that were added to snake 2.o. 
+
+\subsection{Risks}
+
+Snake 2.o will be a classical desktop application and therefore does not present many risks to the user or any stakeholders involved. In terms of taking risk to advance the project, there is risk in striving for the completion of a multiplayer mode for the game since it may take substantial time and effort. However, this risk is low since the project requirements have already been met and other features of the game have been enhanced, aside from the addition of a multiplayer mode. 
+
+In the case that more risks are perceived in the future, the project team will take the following course of action to come up with early warnings:
+\begin{itemize}
+\item If the development is taking place 1 week prior to the project deadline, an early warning will be issued and the group must decide to continue or dismiss the development.
+\item If the development is currently taking place with 2 weeks left until the project deadline and less than 50\% of the development is in place, it will be dismissed.
+\item If the main project is missing any component (testing, code modularization, documentation, commenting, etc.) no development will proceed until the main requirements (minimum requirements) are met.
+\item If any of the main project components are deemed to have lower quality, a warning is issued and the team members must discuss whether to continue with further development or improving the existing product.
+\end{itemize}
+
+\subsection{Costs}
+As mentioned in the development plan document, team members will be dedicating 2 hours outside of lab time for team meetings and discussions along with 5 hours of individual work on the project itself. Since the project is open source and uses open libraries such as Pygame, the monetary cost is \$0. However, there may be additional costs to publishing Snake 2.o with a DDS.
+
+\subsection{User Documentation and Training}
+
+The user will be provided with the following documentation and training:
+\begin{itemize}
+\item Snake 2.o User Manual: The document will explain the basic permisses of the game, user settings, graphic themes, menu headings, and any other information necessary for the user to understand the features of the game.
+\item Snake 2.o Installation Manual: Provided that the user will not be using Windows or the native OS that is decided on, this document will provide simple installation instructions for compiling the code on different OS's.
+\end{itemize}
+
+\subsection{Waiting Room}
+In future releases of the project, the following requirements might be included in the revised requirements document:
+\begin{itemize}
+\item Snake 2.o User Manual - Multiplayer Mode: A section explaining how to connect and play the snake game with friends
+\item additional 'multiplayer mode' module: A separate module to encapsulate the multiplayer mode
+\item additional 'themes' module - a module encapsulating the different graphic themes available for the game
+\end{itemize}
+
+
+\subsection{Ideas for Solutions}
+
+Some rudimentary ideas for project modules and solutions have been mentioned down below:
+\begin{itemize}
+\item Classes/modules for individual objects like the snake, food block, the frame, the menu bar, the settings bar and so on.
+\item import graphics developed in adobe illustrator into the game as characters, props and so on.
+\item the snake class can have method that correspond to the snakes functionality such as moveLeft, moveRight, moveUp, moveDown, and Lengthen.
+\item the food item can have a randomPlacement method for when being placed at random around the window.
+\item UI: a custom header section can contain the entry fields for custom speed and other important parameters.
+\end{itemize}
+
+\bibliographystyle{plainnat}
+
+\bibliography{SRS}
+
+\newpage
+
+\section{Appendix}
+
+This section has been added to the Volere template.  This is where you can place
+additional information.
+
+\subsection{Symbolic Parameters}
+
+The definition of the requirements will likely call for SYMBOLIC\_CONSTANTS.
+Their values are defined in this section for easy maintenance.
+
+
+\end{document}
\ No newline at end of file

BlankProjectTemplate/POC_Demo/Snake_2.o_Demo.py

+#standard set up
+import pygame
+from random import randint
+pygame.init()
+
+#setting width and height of window
+
+screen_x = 500
+screen_y = 500
+win = pygame.display.set_mode((screen_x,screen_y))
+
+pygame.display.set_caption("My Game")
+
+white = (255,255,255)
+black = (0,0,0)
+
+x = randint(40,400)
+y = randint(40,400)
+width = 20
+height = 20
+vel = 10
+
+speed = 40
+# 0 - (- direction) , 1 - (+ direction)
+direction = 0
+# 0 - x-axis , 1 - y-axis
+axis = 0
+
+run = True
+
+while run:
+    pygame.time.delay(speed) #create a delay to prevent any unwanted behaviour
+
+    #events are anything that happens from the user
+    #we loop through the list of events that happen by the user's actions
+    for event in pygame.event.get():
+
+        if event.type == pygame.QUIT:
+            run = False
+
+        #Each event type has an integer assigned to it. KEYDOWN has the code 2
+        if event.type == pygame.KEYDOWN:
+            if (event.key == pygame.K_LEFT):
+                    axis = 0;direction=-1
+            if (event.key == pygame.K_RIGHT):
+                    axis = 0;direction=1
+            if (event.key == pygame.K_UP):
+                    axis = 1;direction=-1
+            if (event.key == pygame.K_DOWN):
+                    axis = 1;direction=1
+
+    #Snake moving depending on axis and direction
+    if (axis):
+        y += vel*direction
+    else:
+        x += vel*direction
+
+
+    if x < 0:
+        #x = 0
+        x = screen_x - height
+
+    if y < 0:
+        #y = 0
+        y = screen_y - width
+
+    if y > screen_y - width:
+        #y = 500 - width
+        y = 0
+    if x > screen_x - height:
+        #x = 500 - height
+        x = 0
+
+    win.fill(white)
+    #all colors are defined in RGB with Pygame
+    pygame.draw.rect(win,(255,0,0), (x,y,width, height))
+    #we have to update the display to see the drawing of our object. Since it does
+    #not automatically update
+    pygame.display.update()
+
+#Quit the game
+pygame.quit()

BlankProjectTemplate/POC_Demo/Snake_Game.py

+#importing necessary libraries
+import pygame, sys
+
+#a function made to execute other files from the system
+def runfile(runfilename):
+  with open(runfilename,"r") as rnf:
+    exec(rnf.read())
+
+pygame.init()
+
+#while loop required to always refresh the page
+while True:
+    game = pygame.display.set_mode((800, 610))
+    game.fill([213, 219, 219])
+    mousepos = pygame.mouse.get_pos() #checking mouse position
+    mouseclick = pygame.mouse.get_pressed()#checking mouse pressed
+    pygame.display.set_caption("Lets Play")
+    title_font = pygame.font.SysFont("monospace", 80)
+
+    #Adding the title
+    gamename = title_font.render('SNAKE GAME', True, (255, 0, 0))
+    game.blit(gamename,(150,80))
+    
+    #Adding the play game button
+    if (270 <= mousepos[0] <= 270+250 and 505 <= mousepos[1] <= 555 ):
+      #checks if the mouse is hovering over the button
+        pygame.draw.rect(game,[100,100,100], [270,505,250,50], 0)
+        #checking if the button is clicked
+        if mouseclick[0] == 1:
+            runfile('Snake_2.o_Demo.py')
+            
+    else:
+        pygame.draw.rect(game,[180,180,180], [270,505,250,50], 0)
+
+    playgame_font = pygame.font.SysFont("comicsansms", 40)
+    gamebutton = playgame_font.render('GAME TIME', True, (0, 0, 200))
+    game.blit(gamebutton,(275,500))
+
+    #Taking user name
+    UserName = playgame_font.render('NAME:', True, (0, 250, 0))
+    game.blit(UserName,(50,200))
+
+    #Asking user for theme
+    ThemeOption = playgame_font.render('THEMES:', True, (0, 200, 0))
+    game.blit(ThemeOption,(50,300))
+
+    #Asking user for speed 
+    SpeedOption = playgame_font.render('SPEED:', True, (0, 150, 0))
+    game.blit(SpeedOption,(50,400))
+
+    #If user wants to quit
+    pygame.draw.rect(game,[180,180,180], [650,550,130,55], 0)
+    Quit = playgame_font.render('QUIT', True, (0, 0, 0))
+    game.blit(Quit,(650,550))
+    if ( 650 <= mousepos[0] <= 650+130 and 550 <= mousepos[1] <= 550 +55):
+      #checks if the mouse is hovering over the button
+        #checking if the button is clicked
+        if mouseclick[0] == 1:
+          #print ("quiting")
+          #pygame.display.quit()
+          pygame.quit()
+          sys.exit()
+    
+    pygame.display.update()
+
+
+
+

BlankProjectTemplate/ProjectSchedule/Team_Gantt.gan

+<?xml version="1.0" encoding="UTF-8"?><project name="3XA3: Team Project" company="" webLink="http://" view-date="2018-10-25" view-index="0" gantt-divider-location="300" resource-divider-location="300" version="2.8.9" locale="en_IN">
+    <description><![CDATA[Developing the clasical Snake game using python and front-end development languages.]]></description>
+    <view zooming-state="default:2" id="gantt-chart">
+        <field id="tpd3" name="Name" width="167" order="0"/>
+        <field id="tpd4" name="Begin date" width="65" order="1"/>
+        <field id="tpd5" name="End date" width="64" order="2"/>
+    </view>
+    <view id="resource-table">
+        <field id="0" name="Name" width="210" order="0"/>
+        <field id="1" name="Default role" width="86" order="1"/>
+    </view>
+    <!-- -->
+    <calendars>
+        <day-types>
+            <day-type id="0"/>
+            <day-type id="1"/>
+            <default-week id="1" name="default" sun="1" mon="0" tue="0" wed="0" thu="0" fri="0" sat="1"/>
+            <only-show-weekends value="false"/>
+            <overriden-day-types/>
+            <days/>
+        </day-types>
+    </calendars>
+    <tasks empty-milestones="true">
+        <taskproperties>
+            <taskproperty id="tpd0" name="type" type="default" valuetype="icon"/>
+            <taskproperty id="tpd1" name="priority" type="default" valuetype="icon"/>
+            <taskproperty id="tpd2" name="info" type="default" valuetype="icon"/>
+            <taskproperty id="tpd3" name="name" type="default" valuetype="text"/>
+            <taskproperty id="tpd4" name="begindate" type="default" valuetype="date"/>
+            <taskproperty id="tpd5" name="enddate" type="default" valuetype="date"/>
+            <taskproperty id="tpd6" name="duration" type="default" valuetype="int"/>
+            <taskproperty id="tpd7" name="completion" type="default" valuetype="int"/>
+            <taskproperty id="tpd8" name="coordinator" type="default" valuetype="text"/>
+            <taskproperty id="tpd9" name="predecessorsr" type="default" valuetype="text"/>
+        </taskproperties>
+        <task id="0" name="Development Plan" color="#8cb6ce" meeting="false" start="2018-09-25" duration="4" complete="0" thirdDate="2018-09-27" thirdDate-constraint="0" expand="false">
+            <task id="19" name="Team Meeting Plan" color="#8cb6ce" meeting="false" start="2018-09-25" duration="1" complete="0" thirdDate="2018-09-19" thirdDate-constraint="0" expand="true"/>
+            <task id="20" name="Team Communication Plan" color="#8cb6ce" meeting="false" start="2018-09-25" duration="1" complete="0" thirdDate="2018-09-13" thirdDate-constraint="0" expand="true"/>
+            <task id="29" name="Copy_Team Communication Plan" color="#8cb6ce" meeting="false" start="2018-09-25" duration="1" complete="0" thirdDate="2018-09-13" thirdDate-constraint="0" expand="true"/>
+            <task id="21" name="Team Member Roles" color="#8cb6ce" meeting="false" start="2018-09-25" duration="1" complete="0" thirdDate="2018-09-13" thirdDate-constraint="0" expand="true"/>
+            <task id="22" name="Git workflow plan" color="#8cb6ce" meeting="false" start="2018-09-25" duration="1" complete="0" thirdDate="2018-09-13" thirdDate-constraint="0" expand="true"/>
+            <task id="23" name="Proof of Concept" color="#8cb6ce" meeting="false" start="2018-09-26" duration="1" complete="0" thirdDate="2018-09-13" thirdDate-constraint="0" expand="true"/>
+            <task id="24" name="Technology" color="#8cb6ce" meeting="false" start="2018-09-26" duration="1" complete="0" thirdDate="2018-09-13" thirdDate-constraint="0" expand="true"/>
+            <task id="25" name="Coding Style" color="#8cb6ce" meeting="false" start="2018-09-27" duration="1" complete="0" thirdDate="2018-09-13" thirdDate-constraint="0" expand="true"/>
+            <task id="26" name="Project Schedule" color="#8cb6ce" meeting="false" start="2018-09-27" duration="1" complete="0" thirdDate="2018-09-13" thirdDate-constraint="0" expand="true"/>
+            <task id="27" name="Project review" color="#8cb6ce" meeting="false" start="2018-09-28" duration="1" complete="0" thirdDate="2018-09-13" thirdDate-constraint="0" expand="true"/>
+        </task>
+        <task id="8" name="Requirements Document Revision" color="#8cb6ce" meeting="false" start="2018-10-01" duration="5" complete="0" thirdDate="2018-09-27" thirdDate-constraint="0" expand="false">
+            <task id="31" name="Project Drivers" color="#8cb6ce" meeting="false" start="2018-10-01" duration="2" complete="0" thirdDate="2018-09-17" thirdDate-constraint="0" expand="true"/>
+            <task id="49" name="Functional Requirements" color="#8cb6ce" meeting="false" start="2018-10-02" duration="2" complete="0" thirdDate="2018-09-12" thirdDate-constraint="0" expand="true"/>
+            <task id="42" name="Non-Functional Requirements" color="#8cb6ce" meeting="false" start="2018-10-03" duration="2" complete="0" thirdDate="2018-09-12" thirdDate-constraint="0" expand="true"/>
+            <task id="44" name="Project Issues" color="#8cb6ce" meeting="false" start="2018-10-03" duration="2" complete="0" thirdDate="2018-09-12" thirdDate-constraint="0" expand="true">
+                <depend id="52" type="2" difference="0" hardness="Strong"/>
+            </task>
+            <task id="52" name="Push &amp; Tag Document" color="#8cb6ce" meeting="false" start="2018-10-05" duration="1" complete="0" thirdDate="2018-09-17" thirdDate-constraint="0" expand="true"/>
+            <task id="55" name="SpellCheck" color="#8cb6ce" meeting="false" start="2018-10-04" duration="1" complete="0" thirdDate="2018-09-18" thirdDate-constraint="0" expand="true">
+                <depend id="52" type="2" difference="0" hardness="Strong"/>
+            </task>
+        </task>
+        <task id="9" name="Proof of Concept Demonstration" color="#8cb6ce" meeting="false" start="2018-10-10" duration="4" complete="0" thirdDate="2018-09-27" thirdDate-constraint="0" expand="false">
+            <task id="59" name="Snake Body &amp; Movement" color="#8cb6ce" meeting="false" start="2018-10-10" duration="2" complete="0" thirdDate="2018-09-17" thirdDate-constraint="0" expand="true"/>
+            <task id="61" name="Home Page GUI" color="#8cb6ce" meeting="false" start="2018-10-11" duration="2" complete="0" thirdDate="2018-09-17" thirdDate-constraint="0" expand="true"/>
+            <task id="63" name="Border Boundaries" color="#8cb6ce" meeting="false" start="2018-10-15" duration="1" complete="0" thirdDate="2018-09-17" thirdDate-constraint="0" expand="true"/>
+        </task>
+        <task id="12" name="Test Plan Revision" color="#8cb6ce" meeting="false" start="2018-10-19" duration="5" complete="0" thirdDate="2018-09-27" thirdDate-constraint="0" expand="false">
+            <task id="64" name="General Information" color="#8cb6ce" meeting="false" start="2018-10-19" duration="2" complete="0" thirdDate="2018-10-08" thirdDate-constraint="0" expand="true"/>
+            <task id="65" name="Plan" color="#8cb6ce" meeting="false" start="2018-10-19" duration="2" complete="0" thirdDate="2018-10-08" thirdDate-constraint="0" expand="true"/>
+            <task id="66" name="System Test Description" color="#8cb6ce" meeting="false" start="2018-10-22" duration="2" complete="0" thirdDate="2018-10-08" thirdDate-constraint="0" expand="true"/>
+            <task id="67" name="Tests for Proof of Concept" color="#8cb6ce" meeting="false" start="2018-10-23" duration="3" complete="0" thirdDate="2018-10-08" thirdDate-constraint="0" expand="true">
+                <task id="82" name="Tests for Functional Req." color="#8cb6ce" meeting="false" start="2018-10-23" duration="3" complete="0" thirdDate="2018-10-15" thirdDate-constraint="0" expand="true"/>
+                <task id="83" name="Tests for Non-Functional Req." color="#8cb6ce" meeting="false" start="2018-10-23" duration="2" complete="0" thirdDate="2018-10-15" thirdDate-constraint="0" expand="true"/>
+            </task>
+            <task id="68" name="Comparison to Existing Implementation" color="#8cb6ce" meeting="false" start="2018-10-24" duration="2" complete="0" thirdDate="2018-10-08" thirdDate-constraint="0" expand="true"/>
+            <task id="69" name="Unit Test Plan" color="#8cb6ce" meeting="false" start="2018-10-24" duration="2" complete="0" thirdDate="2018-10-08" thirdDate-constraint="0" expand="true"/>
+        </task>
+        <task id="13" name="Design &amp;Document Revision" color="#8cb6ce" meeting="false" start="2018-10-31" duration="4" complete="89" thirdDate="2018-09-27" thirdDate-constraint="0" expand="false">
+            <task id="85" name="Anticipated and Unlikely Changes" color="#8cb6ce" meeting="false" start="2018-11-05" duration="1" complete="100" thirdDate="2018-10-18" thirdDate-constraint="0" expand="true"/>
+            <task id="103" name="Introduction" color="#8cb6ce" meeting="false" start="2018-10-31" duration="1" complete="100" thirdDate="2018-10-31" thirdDate-constraint="0" expand="true"/>
+            <task id="86" name="Module Hierarchy" color="#8cb6ce" meeting="false" start="2018-11-01" duration="2" complete="100" thirdDate="2018-10-18" thirdDate-constraint="0" expand="true"/>
+            <task id="91" name="Conncection between Requirements and Design" color="#8cb6ce" meeting="false" start="2018-10-31" duration="3" complete="100" thirdDate="2018-10-18" thirdDate-constraint="0" expand="true"/>
+            <task id="93" name="Module Decomposition" color="#8cb6ce" meeting="false" start="2018-10-31" duration="4" complete="100" thirdDate="2018-10-18" thirdDate-constraint="0" expand="true" cost-manual-value="33.0" cost-calculated="false"/>
+            <task id="96" name="Traceability Matrix" color="#8cb6ce" meeting="false" start="2018-10-31" duration="4" complete="100" thirdDate="2018-10-18" thirdDate-constraint="0" expand="true"/>
+            <task id="98" name="Use Heirarchy between modules" color="#8cb6ce" meeting="false" start="2018-11-02" duration="2" complete="100" thirdDate="2018-10-18" thirdDate-constraint="0" expand="true"/>
+            <task id="99" name="MIS" meeting="false" start="2018-11-02" duration="2" complete="0" expand="false">
+                <task id="100" name="Interface - Doxygen" color="#8cb6ce" meeting="false" start="2018-11-02" duration="2" complete="0" thirdDate="2018-10-29" thirdDate-constraint="0" expand="true"/>
+                <task id="101" name="Food &amp; barriers - Doxygen" color="#8cb6ce" meeting="false" start="2018-11-02" duration="2" complete="0" thirdDate="2018-10-29" thirdDate-constraint="0" expand="true"/>
+                <task id="102" name="Snake body &amp; movement - doxygen" color="#8cb6ce" meeting="false" start="2018-11-02" duration="2" complete="0" thirdDate="2018-10-29" thirdDate-constraint="0" expand="true"/>
+            </task>
+        </task>
+        <task id="113" name="Implementation" meeting="false" start="2018-11-06" duration="8" complete="0" expand="false">
+            <task id="114" name="highscore" color="#8cb6ce" meeting="false" start="2018-11-12" duration="2" complete="0" thirdDate="2018-10-22" thirdDate-constraint="0" expand="true"/>
+            <task id="117" name="Gameplay" color="#8cb6ce" meeting="false" start="2018-11-06" duration="8" complete="0" thirdDate="2018-10-22" thirdDate-constraint="0" expand="true"/>
+            <task id="119" name="init" color="#8cb6ce" meeting="false" start="2018-11-06" duration="2" complete="0" thirdDate="2018-10-22" thirdDate-constraint="0" expand="true"/>
+            <task id="121" name="Interface" color="#8cb6ce" meeting="false" start="2018-11-06" duration="8" complete="0" thirdDate="2018-10-22" thirdDate-constraint="0" expand="true"/>
+            <task id="123" name="Food" color="#8cb6ce" meeting="false" start="2018-11-08" duration="1" complete="0" thirdDate="2018-10-22" thirdDate-constraint="0" expand="true"/>
+            <task id="125" name="Themes" color="#8cb6ce" meeting="false" start="2018-11-13" duration="3" complete="0" thirdDate="2018-10-22" thirdDate-constraint="0" expand="true"/>
+        </task>
+        <task id="309" name="Testing" meeting="false" start="2018-11-13" duration="3" complete="0" expand="false">
+            <task id="310" name="System/Integration testing" color="#8cb6ce" meeting="false" start="2018-11-13" duration="1" complete="0" thirdDate="2018-10-12" thirdDate-constraint="0" expand="true">
+                <notes><![CDATA[Will be done throughout the development process to check if everything works together correctly. Closer to the final date, peers will be asked to try the game as part of system testing.]]></notes>
+            </task>
+            <task id="355" name="Gameplay - white box testing" color="#8cb6ce" meeting="false" start="2018-11-14" duration="2" complete="0" thirdDate="2018-10-22" thirdDate-constraint="0" expand="true"/>
+            <task id="357" name="Interface - white box testin" color="#8cb6ce" meeting="false" start="2018-11-14" duration="2" complete="0" thirdDate="2018-10-22" thirdDate-constraint="0" expand="true"/>
+            <task id="358" name="highscore - whitebox testing" color="#8cb6ce" meeting="false" start="2018-11-14" duration="2" complete="0" thirdDate="2018-10-22" thirdDate-constraint="0" expand="true"/>
+            <task id="359" name="Themes - white box" color="#8cb6ce" meeting="false" start="2018-11-14" duration="2" complete="0" thirdDate="2018-10-22" thirdDate-constraint="0" expand="true"/>
+        </task>
+        <task id="14" name="Revision 0 Demonstration" color="#8cb6ce" meeting="false" start="2018-11-12" duration="2" complete="0" thirdDate="2018-09-27" thirdDate-constraint="0" expand="true"/>
+        <task id="15" name="Final Demonstration" color="#8cb6ce" meeting="false" start="2018-11-19" duration="7" complete="0" thirdDate="2018-09-27" thirdDate-constraint="0" expand="true"/>
+        <task id="17" name="Peer Evaluation - Final Demo" color="#8cb6ce" meeting="false" start="2018-11-27" duration="4" complete="0" thirdDate="2018-09-27" thirdDate-constraint="0" expand="true"/>
+        <task id="18" name="Final Documentation" color="#8cb6ce" meeting="false" start="2018-12-06" duration="1" complete="0" thirdDate="2018-09-27" thirdDate-constraint="0" expand="true">
+            <notes><![CDATA[Problem Statement
+Development Plan
+Requirements Document
+Design Document
+Test Plan
+Test Report
+Users Guide (optional)
+Source Code]]></notes>
+        </task>
+    </tasks>
+    <resources>
+        <resource id="3" name="Andy" function="4" contacts="hameea1@mcmaster.ca" phone="6479276093"/>
+        <resource id="4" name="Usman" function="4" contacts="irfanm7@mcmaster.ca" phone="4168787844">
+            <rate name="standard" value="99"/>
+        </resource>
+        <resource id="5" name="Vaibhav" function="8" contacts="chadhav@mcmaster.ca" phone="6474545182">
+            <rate name="standard" value="100"/>
+        </resource>
+        <resource id="6" name="Varun Hooda" function="2" contacts="hoodav@mcmaster.ca" phone=""/>
+        <resource id="7" name="Dr. Bokhari" function="3" contacts="bokhari@mcmaster.ca" phone=""/>
+    </resources>
+    <allocations>
+        <allocation task-id="31" resource-id="3" function="1" responsible="true" load="100.0"/>
+        <allocation task-id="8" resource-id="3" function="1" responsible="true" load="33.333332"/>
+        <allocation task-id="44" resource-id="3" function="1" responsible="true" load="100.0"/>
+        <allocation task-id="55" resource-id="3" function="1" responsible="true" load="100.0"/>
+        <allocation task-id="59" resource-id="3" function="1" responsible="true" load="100.0"/>
+        <allocation task-id="67" resource-id="3" function="1" responsible="true" load="100.0"/>
+        <allocation task-id="66" resource-id="3" function="1" responsible="true" load="20.0"/>
+        <allocation task-id="64" resource-id="3" function="1" responsible="true" load="100.0"/>
+        <allocation task-id="93" resource-id="3" function="1" responsible="true" load="33.0"/>
+        <allocation task-id="102" resource-id="3" function="1" responsible="true" load="100.0"/>
+        <allocation task-id="98" resource-id="3" function="1" responsible="true" load="100.0"/>
+        <allocation task-id="103" resource-id="3" function="1" responsible="true" load="100.0"/>
+        <allocation task-id="117" resource-id="3" function="1" responsible="true" load="50.0"/>
+        <allocation task-id="119" resource-id="3" function="1" responsible="true" load="100.0"/>
+        <allocation task-id="125" resource-id="3" function="1" responsible="false" load="20.0"/>
+        <allocation task-id="355" resource-id="3" function="1" responsible="false" load="50.0"/>
+        <allocation task-id="359" resource-id="3" function="1" responsible="true" load="20.0"/>
+        <allocation task-id="8" resource-id="4" function="4" responsible="false" load="33.333332"/>
+        <allocation task-id="49" resource-id="4" function="4" responsible="true" load="100.0"/>
+        <allocation task-id="65" resource-id="4" function="4" responsible="true" load="100.0"/>
+        <allocation task-id="66" resource-id="4" function="4" responsible="false" load="40.0"/>
+        <allocation task-id="101" resource-id="4" function="4" responsible="true" load="100.0"/>
+        <allocation task-id="91" resource-id="4" function="4" responsible="true" load="100.0"/>
+        <allocation task-id="93" resource-id="4" function="4" responsible="false" load="33.0"/>
+        <allocation task-id="96" resource-id="4" function="4" responsible="false" load="100.0"/>
+        <allocation task-id="117" resource-id="4" function="4" responsible="false" load="50.0"/>
+        <allocation task-id="123" resource-id="4" function="4" responsible="true" load="100.0"/>
+        <allocation task-id="125" resource-id="4" function="4" responsible="false" load="20.0"/>
+        <allocation task-id="355" resource-id="4" function="4" responsible="true" load="50.0"/>
+        <allocation task-id="359" resource-id="4" function="4" responsible="false" load="20.0"/>
+        <allocation task-id="8" resource-id="5" function="8" responsible="false" load="33.333332"/>
+        <allocation task-id="42" resource-id="5" function="8" responsible="true" load="100.0"/>
+        <allocation task-id="52" resource-id="5" function="8" responsible="true" load="100.0"/>
+        <allocation task-id="61" resource-id="5" function="8" responsible="true" load="100.0"/>
+        <allocation task-id="68" resource-id="5" function="8" responsible="true" load="100.0"/>
+        <allocation task-id="69" resource-id="5" function="8" responsible="true" load="100.0"/>
+        <allocation task-id="66" resource-id="5" function="8" responsible="false" load="40.0"/>
+        <allocation task-id="100" resource-id="5" function="8" responsible="true" load="100.0"/>
+        <allocation task-id="85" resource-id="5" function="8" responsible="true" load="100.0"/>
+        <allocation task-id="86" resource-id="5" function="8" responsible="true" load="100.0"/>
+        <allocation task-id="93" resource-id="5" function="8" responsible="false" load="34.0"/>
+        <allocation task-id="114" resource-id="5" function="8" responsible="true" load="100.0"/>
+        <allocation task-id="121" resource-id="5" function="8" responsible="true" load="100.0"/>
+        <allocation task-id="125" resource-id="5" function="8" responsible="true" load="60.0"/>
+        <allocation task-id="357" resource-id="5" function="8" responsible="true" load="100.0"/>
+        <allocation task-id="358" resource-id="5" function="8" responsible="true" load="100.0"/>
+        <allocation task-id="359" resource-id="5" function="8" responsible="false" load="60.0"/>
+    </allocations>
+    <vacations/>
+    <previous/>
+    <roles roleset-name="Default"/>
+    <roles>
+        <role id="1" name="UI Deisgner | Project Schedule Administrator"/>
+        <role id="2" name="TA"/>
+        <role id="3" name="Course Professor"/>
+        <role id="4" name="Main Programmer | Requirements Documentation"/>
+        <role id="5" name="Tester"/>
+        <role id="6" name="Requirements &amp; Documentation Editor"/>
+        <role id="7" name="Project Schedule Editor"/>
+        <role id="8" name="Git master | Testing Requirements"/>
+    </roles>
+</project>

BlankProjectTemplate/README.md

-# Project Name
+# Snake 2.o
 
-Team Name: ?
+Team Name: VUA30
 
-Team Members: ?, ?, ?
+Team Members: Usman Irfan, Andy Hameed, Vaihbav Chadha
 
 
-This project is a reimplementation of ...
+This project is a reimplementation of Snake, an open-source front-end implementation of the classical snake game using JS, HTML and CSS
 
 The folders and files for this project are as follows:
 

BlankProjectTemplate/src/Food.py

+## @file Food.py
+#  @author Usman Irfan
+#  @brief implements an abstract data type for a snake's food
+#  @date 11/09/2018
+from random import randint
+from init import *
+
+## @brief An Abstract Data type which represents a one-unit of food
+class Food():
+
+
+    ## @brief Food constructor
+    #  @details Initializes the size of the food, this needs to be the same as 
+    #   snake's block size
+    #  @param blockSize the width and height of the square block representing the food
+    def __init__(self, blockSize):
+        self.size = blockSize
+
+    ## @brief Draw method uses pygame to draw the food object on the window
+    #  @param location A list which consists the x and y location of the food
+    def draw_food(self, location):
+        pygame.draw.rect(win, blue , (location[0],location[1], self.size, self.size))
+
+    ## @brief redraw_food method redraws the food on the screen randomly
+    #  @param x is the location of snake's x-axis head location
+    #  @param y is the location of snake's y-axis head location
+    #  @param location is a list that gives the location of present food
+    #  @param screenSize is the size of the screen
+    def redraw_food(self, x, y, location,screenSize, snake_loc):
+        
+        if(abs(x - location[0]) < 15 and abs(y - location[1]) < 15):
+            location[0] = randint(0, grid_length - 1) * self.size
+            location[1] = randint(0, grid_length - 1) * self.size
+            if(location[0], location[1] in snake_loc):
+               location[0] = randint(0, grid_length - 1) * self.size
+               location[1] = randint(0, grid_length - 1) * self.size

BlankProjectTemplate/src/Gameplay.py

+## @file Snake_2.o.py
+#  @author Andy Hameed, Usman Irfan
+#  @brief implements gameplay and connects the different components of the game
+#  @date 11/09/2018
+
+from random import randint
+from Snake import *
+from Food import *
+
+def game(speed, colour, backgroundColour):
+    x = randint(0, grid_length) * size
+    y = randint(0, grid_length) * size
+    #defining a list to update snanke's length
+    snake_loc = []
+    #variable to increment snake's length, initially it would be 1
+    snake_length = 1
+
+    # 0 gives (- direction)
+    # 1 gives (+ direction)
+    direction = 1
+    # 0 - x-axis , 1 - y-axis
+    axis = 0
+
+    score = 0
+
+    # parameters for initializing food on the screen
+    food_location = []
+    food_x = randint(0, grid_length - 1) * size
+    food_y = randint(0, grid_length - 1) * size
+    food_location = [food_x, food_y]
+
+    ##initialize snake and draw snake body somewhere on the screen
+
+    snake = Snake(size, 0, 20, 1)
+    pygame.draw.rect(win, colour , [x,y, size, size])
+    food = Food(size)
+
+
+    #Loop through the events as long as the game is running
+    run = True 
+    while run:
+        
+        #delay controls part of speed
+        pygame.time.delay(speed) 
+
+        for event in pygame.event.get():
+
+            if event.type == pygame.QUIT:
+                run = False
+
+            #Each event type has an integer assigned to it. KEYDOWN has the code 2
+            if event.type == pygame.KEYDOWN:
+                if (event.key == pygame.K_LEFT):
+                    # if snake is moving up or down, turn left, otherwise don't turn
+                    if (snake.axis): snake.direct = -1
+                    snake.axis = 0
+                if (event.key == pygame.K_RIGHT):
+                    #if snake is moving up or down turn right, otherwise dont turn
+                    if (snake.axis): snake.direct = 1 
+                    snake.axis = 0
+                if (event.key == pygame.K_UP):
+                    #if snake is moving left or right turn up, otherwise dont turn
+                    if (not snake.axis): snake.direct = -1 
+                    snake.axis = 1
+                if (event.key == pygame.K_DOWN):
+                    #if snake is moving left or right turn down, otherwise dont turn
+                    if (not snake.axis): snake.direct = 1 
+                    snake.axis = 1
+
+        #Snake moving depending on axis and direction
+        if (snake.axis):
+            y += (size)*snake.direct
+        else:
+            x += (size)*snake.direct
+       
+        #Boundary conditions for snake hitting window edge
+        if (x < 0 or
+            y < 0 or
+            y > screenSize - size or
+            x > screenSize - size):
+            
+            pygame.quit() #for now, quit the game when snake hits boundary
+
+    ##        snake.die()
+
+    #---------------------FOR WRAPING SNAKE AROUND WINDOW---------------------
+        
+    ##    if x < 0:
+    ##        #x = 0
+    ##        x = screenSize - size
+    ##    if y < 0:
+    ##        #y = 0
+    ##        y = screenSize - size
+    ##    if y > screenSize - size:
+    ##        #y = 500 - size
+    ##        y = 0
+    ##    if x > screenSize - size:
+    ##        #x = 500 - size
+    ##        x = 0
+
+    #-------------------------------------------------
+
+        if(abs(x - food_location[0]) < 15 and abs(y - food_location[1]) < 15):
+            score += 10
+
+            #increment the length by 3 unit every time
+            snake_length += 3
+
+            
+        win.fill(backgroundColour)
+        
+        font = pygame.font.SysFont("times",30)
+        text = font.render("Score = " + str(score),True,[50,250,50])
+        win.blit(text,(0,0))
+        
+        if ([x,y] in snake_loc) and snake_length > 1:        
+            pygame.time.delay(1000)
+            pygame.quit() #quit for now, but should return to main menu
+        
+        snake_head = []
+        snake_head.append(x)
+        snake_head.append(y)
+
+        snake_loc.append(snake_head)
+        
+        #function to print 
+        #consumption of food block
+        food.redraw_food(x, y, food_location, screenSize, snake_loc)
+
+        snake_blocks = len(snake_loc)
+
+        #Draw food item
+        food.draw_food(food_location)
+
+        
+        if snake_blocks > snake_length:
+            #keep updating the new block
+            del snake_loc[0]
+        '''
+        Logic for updating the length is taken from:
+        CodeWithHarry, CodeWithHarry. “Snakes Game: Length Increment Logic - Python Game Development Using Pygame In Hindi #17.”
+        YouTube, YouTube, 2 Oct. 2018,
+        www.youtube.com/watch?v=mkGJb0W03DM&index=17&list=PLu0W_9lII9ailUQcxEPZrWgDoL36BtPYb.
+        '''
+        
+        #Draw snake
+        snake.draw(snake_loc)
+        #update display
+        pygame.display.update()
+
+    pygame.quit()
+
+#game(70, [255,0,0], [255,255,255])

BlankProjectTemplate/src/Interface.py

+## @file interface.py
+#  @author Vaibhav Chadha
+#  @brief implements the main interface of this game
+#  @date 11/09/2018
+#importing necessary libraries
+import pygame, sys
+import highscore, theme
+
+## @brief A Class that will contain useful functions in order for the creation of main interface
+class GUI():
+
+  ## @brief A method to create a button
+  #  @details This method will make a box on the interface
+  #  @param surface The background (surface) the box should be made on
+  #  @param color The color of the button to be made
+  #  @param Rect The coordinate of the button with the length and width
+  #  @param width The width of the sides of button
+  def button(Surface, color,Rect,width):
+    pygame.draw.rect(Surface, color,Rect,width)
+
+  ## @brief A method to display text
+  #  @details This function will print the text on the interface
+  #  @param text The text to be printed
+  #  @param fontStyle The font Style of the text to be displayed
+  #  @param fontSize The size of the text written
+  #  @param color The color of the text
+  #  @param coord The coordinate at which the text should start displaying
+  #  @param surface The background (surface) the text should be printed on
+  def text(text,fontStyle,fontSize,color,coord,surface):
+    font = pygame.font.SysFont(fontStyle,fontSize)
+    text = font.render(text,True,color)
+    surface.blit(text,coord)
+## @brief Makes the main interface of this game
+#  @details This will output the main page of this game by using the class above
+def main():
+  pygame.init()
+  lightBlue = [89,131,145]
+  darkgray = [100,100,100]
+  image1 = pygame.image.load("Snake_Game_Logo_background.png")
+##  image2 = pygame.image.load("snake_image.png")
+
+  #while loop required to always refresh the page
+  run = True
+  while run:
+      game = pygame.display.set_mode((800, 610))
+      game.blit(image1,(0,0))
+##      game.blit(image2,(550,0))
+      mousepos = pygame.mouse.get_pos() #checking mouse position
+      mouseclick = pygame.mouse.get_pressed()#checking mouse pressed
+      pygame.display.set_caption("Lets Play")
+
+      #Adding the play game button
+      if (400 <= mousepos[0] <= 400+170 and 250 <= mousepos[1] <= 300+50 ):
+        #checks if the mouse is hovering over the button
+          GUI.button(game,darkgray, [400,250,170,50], 0)
+          #checking if the button is clicked
+          if mouseclick[0] == 1:
+            theme.Themes.themes(100)        
+      else:
+          GUI.button(game,lightBlue, [400,250,170,50], 0)
+      GUI.text('Beginner',"maiandragd", 25,[239, 245, 224],(438,260),game)
+
+      if (430 <= mousepos[0] <= 430+220 and 350 <= mousepos[1] <= 350+50 ):
+        #checks if the mouse is hovering over the button
+          GUI.button(game,darkgray, [430,350,220,50], 0)
+          #checking if the button is clicked
+          if mouseclick[0] == 1:
+            theme.Themes.themes(70)          
+      else:
+          GUI.button(game,lightBlue, [430,350,220,50], 0)
+      GUI.text('Intermediate',"maiandragd", 25,[239, 245, 224],(470,357),game)
+
+      if (400 <= mousepos[0] <= 400+180 and 450 <= mousepos[1] <= 450+50 ):
+        #checks if the mouse is hovering over the button
+          GUI.button(game,darkgray, [400,450,180,50], 0)
+          #checking if the button is clicked
+          if mouseclick[0] == 1:
+            theme.Themes.themes(50)         
+      else:
+          GUI.button(game,lightBlue, [400,450,180,50], 0)
+      GUI.text('Advanced',"maiandragd", 25,[239, 245, 224],(435,457),game)
+
+      if (15 <= mousepos[0] <= 15+115 and 565 <= mousepos[1] <= 565+35 ):
+        if mouseclick[0] == 1:
+          highscore.main()
+
+      if (725 <= mousepos[0] <= 725+50 and 565 <= mousepos[1] <= 565+35 ):
+        if mouseclick[0] == 1:
+          pygame.quit()
+          sys.exit()
+      
+      pygame.display.update()
+
+if __name__ == "__main__":
+  main()
+
+
+

BlankProjectTemplate/src/Snake.py

+## @file Snake.py
+#  @author Andy Hameed
+#  @brief implements an abstract data type for a snake
+#  @date 11/09/2018
+
+
+from init import *
+
+## @brief An Abstract Data type representing a snake character object
+class Snake():
+
+    ## @brief Snake constructor
+    #  @details Initializes a Snake object with its initial attributes
+    #  @param blockSize the width and height of the square block representing the snake 
+    #  @param direct The direction of the snake's movement
+    #  @param speed The initial speed of the snake's movement
+    def __init__(self, blockSize, direct, speed, axis):
+        self.speed = speed
+        self.direct = direct
+        self.size = blockSize
+        self.axis = axis
+
+    ## @brief Draw method uses pygame to draw the snake object
+    #  @param x The x-coordinate where the block should be drawn 
+    #  @param y The y-coordinate where the block should be drawn
+    def draw(self,snake_loc):
+        for x,y in snake_loc:
+            pygame.draw.rect(win, red , [x,y, self.size, self.size])
+  
+    def die():
+        #---------------------INSERT CODE -----------------
+        # create some pop up message saying game over
+        return
+        
+
+