Foundations of Software Engineering

Homework 4: MVC Model

For this homework, you will create simple model classes in Rails, write tests to run them, and practice using the basic version control features of Git.

You will do this homework as a team; however, each member of your team will be responsible for the completion of a particular task.

Each team member will choose one task from the list below to complete. All team members must do a different task. If your team has only three members, then ignore Task 4.

IMPORTANT: Be sure to add your university username (e.g., mine is “sdflming”) in a comment at the top of your model class file. (Otherwise, how will we know which work is yours?)

How to submit your team’s work

Before you can submit, all team members must have merged their code into the master branch and pushed the updates to GitHub. If a team member does not complete his/her work on time, you may submit without his/her contribution.

To submit your team’s work, you must “tag” the current commit in the master branch:

• git tag -a hw4v1 -m 'Tagged Homework 4 submission (version 1)'
• git push origin --tags

To grade your work, I will check out the appropriate tag, and run it on my machine.

Note that if for some reason you need to update your submission, simply repeat the tagging process, but increment the version number (e.g., hw4v2, hw4v3, hw4v4, etc.).

The Tasks

The tasks are given on the following pages. For each of the following tasks:

• Create model classes as per the given UML class diagram.
  • Use rails generate model ...
• Add attribute validations to one of the classes as specified. Here is a page to help you:
  • http://guides.rubyonrails.org/v5.1.4/active_record_validations.html
• Write unit tests as follows for both classes. For each attribute, write one test for a valid value of the attribute. For each validation of the attribute, write one test that violates the validation rule. For example, if a string attribute has a length validation and a presence validation, you will have 3 tests for that attribute: one with a valid string, one with a string of invalid length, and one with an empty string. In the case of an “allow_blank” validation, include a test for a blank value. Here are couple pages to help you:
  • http://guides.rubyonrails.org/v5.1.4/active_record_basics.html
  • http://guides.rubyonrails.org/v5.1.4/testing.html

Task 1

Model classes to create:

Add these validations to class Owner:

• length
  • name must be 30 characters or less.
• format
  • email must follow the general format of an email address.
• inclusion
  • gender must be "male", "female", or "other".
• uniqueness
  • name must be unique.
• presence
  • name and email must have values.
• allow_blank
  • gender and age may be blank.
• numericality
  • age must be in the range 18 to 122 (the age of the oldest known person ever).

Task 2

Model classes to create:

Add these validations to class Bartender:

• length
  • name must be 50 characters or less.
• format
  • phone must follow the general format of a 10-digit telephone number (e.g., "123-456-7890").
• inclusion
  • level must be "beginner", "intermediate", or "master".
• uniqueness
  • name must be unique.
• presence
  • name and phone must have values.
• allow_blank
  • level and years_experience may be blank.
• numericality
  • year_experience must be between 0 and 60.

Task 3

Model classes to create:

Add these validations to class Alcohol:

• length
  • name must be 60 characters or less.
• format
  • url must follow the general format of a URL.
• inclusion
  • category must be "top shelf", "midgrade", or "bottom shelf".
• uniqueness
  • name and url must be unique.
• presence
  • name and proof must have values.
• allow_blank
  • url and category may be blank.
• numericality
  • proof must be greater than 0 and less than 200.

Task 4

Model classes to create:

Add these validations to class Country:

• length
  • name must be no more than 36 characters.
• format
  • date_founded must follow this date format: YYYY-MM-DD (e.g., "2017-02-25").
• inclusion
  • continent must be "North America", "South America", "Europe", "Asia", "Africa", "Australia", or "Antarctica".
• uniqueness
  • name must be unique.
• presence
  • name and continent must have values.
• allow_blank
  • date_founded and gdp may be blank.
• numericality
  • gdp must be between 0 and 100,000 (in billions of dollars).

Rubric

Total marks: 100

Below, the top-level number is the items total point value. If an item is not submitted at all, 0 points will be awarded for that item. The sub-bullets indicate standard deductions for errors in a submitted item. The deduction list below may not be complete because there may be mistakes that we did not expect. The deduction for an unexpected mistake will be assessed at the time it’s discovered and will reflect how severe the instructor thinks the mistake is.

• 20 Create model class
  • Wrong attribute name: -3 each
  • UofM username not in a comment at top of file: -2
• 40 Attribute validations (total 9 or 10 validations in each task)
  • Missing validation: -5 each
  • Faulty validation: -1 to -5 each
• 40 Unit tests (for each validation there should be 2 test cases, 1 true and 1 false; also note that 1 test case may cover multiple validation)
  • Missing test case: -3 each

Other deductions:

• GitHub Submission:
  • No tag: -10
  • Latest tag not the full submission: -7
  • Tag does not follow naming convention: -3

© Scott D. Fleming 2018 • Made with GitHub Pages and Markdown