Summary: This multi part project will provide you an chance to practiceyour programming skills and practice with the agile software development methodology, continuous integration, automated testingand other more industry oriented practices that we don't often use in academia.
Agile: This project will be done in the agile methodology in that it will be done in a series of sprints. Each week there willbe a 3-6 hour (estimated – this assumes you start early enough to walk away when things get complected) assignment which builds on theprevious assignment. So be sure to be careful to practice good software development techniques so that you don't make life difficultfor yourself later.
Individual work: Later in the semester we will work on group work. For this project you will work individually. Youmay ask your classmates for pointers on getting your git/github/jetbrains toolchain setup, but each student should bedoing their own work. You can of course use my "as long as you are just talking and no one is on a recording device like a computer"guidelines to point each other at good libraries to do this work.
Tools: Use the the correct Jetbrains IDE for your language of choice (see below). If you have not yet done so, activate your jetbrains student account to get one year of academic use of the jetbrains professional development tools.
Version Control: In this class we will use git for version control.
Git for linux: use your package manager to install git. (eg: on debian based systems like ubuntu use sudo apt install git) for redhat based systems use yum
Git for mac or windows: download and install from The official git download site
We will use github for the first project (and likely the second as well). If you have not already doneso, make a github account – and send me your github ID via an official electronic communications mechanism (BSU email or slack/MSTeams – at the time of writing this I hadn’t finalized the class on Slack or MS Teams). It is free for the kind of stuff we are doingin class.
Programming languages: You may use one of several programming languages for this first project so long as you make itworks on my machine (not just yours). With that in mind the following language are supported in this class.
Python: use Python versions 3.6-3.8. I've not yet installed python 3.9 but if you are really wanting a feature from 3.9 talk to me, I might be able to get it done in the time frame. Also include a requirements.txt. Use pytest as your testing framework.
Java: Java 11 is the current LTS (Long Term Service) version of Java, that's what I'll run/test your work on. If you are using java, use gradle to manage your dependencies in intellij. Be sure to check in the entire project with the build.gradle files when committing/pushing your version control
Go: if you use go, tell me which dependencies I need to go get.
Rust: If you use rust, be sure to have all your dependencies properly in your cargo.toml
C or C++ if you want to do C or C++ be sure to have a configure file and a makefile so it builds properly.
Other languages, if you want to use other languages, see me to make sure I can support them.
Due: Sunday Feb 7th at 11:59pm
Create a project in your jetbrain's IDE for your language of choice. Be sure to include your name in your project name (for example jsantoreJobsProject would be a fine name for me to use for this project. I have 70+ students doing some variation of this project and so I'll have a lot of problems with dozens of "project1" projects.
Add the project to git using either the built in jetbrains tools or command line git
share the project on github using either the built in jetbrains tools or command line git. Be sure to include any build files that I need.
Add the appropriate github actions script to your github project, be sure to include a test runner and a linter.
Register for an API key to get government data: https://api.data.gov/signup/
write a program which will (in at least three methods/functions so you can test properly)
use your API key to get college data, see this site: https://github.com/RTICWDT/open-data-maker/blob/master/API.md for documentation
you can find the possible field names for data in https://collegescorecard.ed.gov/assets/CollegeScorecardDataDictionary.xlsx
get the data for all universities with degrees of type 2 and 3
get the following fields at least:
school.name
school.city
2018.student.size
2017.student.size
2017.earnings.3_yrs_after_completion.overall_count_over_poverty_line
2016.repayment.3_yr_repayment.overall
MAKE SURE YOU get all the pages
of data – by default it comes in 20 at a time. You need all
3000+ entries
Be sure to git commit and git push often so you don’t lose anything to a dead laptop.
For this first sprint, just save the data to a file
Be Sure to use the “secrets file” approach so you don’t commit your api-key to github and push your project
Write a readme.md for your project in the github project (you can do it with your jetbrains IDE if you like)
the readme should have
your name
any install and run directions I need beyond the basics.
a brief description of what your project does
a brief description of what is missing from the project (if anything)
make me a collaborator on the project
to submit, make me a collaborator on your project. I'll git clone it, run it and the tests and linter, make an innocuous change to your project, and make sure the github actions work and grade based on these things.
As Part of my grading for at least one sprint – usually this first one, I generally make a small commit to your project and push it to github. Be prepared to do a merge between your work and mine.
This project is as much about getting all of the tools and devops stuff setup and working properly as it is about getting the code to work right. You can find the grading distribution in the Project1Sprint1Grading file