@@ -14,9 +14,10 @@ We will explore here how one can utilize OO to improve and enhance reporting cap
 Procedure
 =========
 
-You will use :download:`../examples/oo_intro/oo_intro.py` file as a starting point for your code.
+You will use :download:`report.py` and :download:`test_report.py` file as a starting point for your code.
 
-You will notice that ``Report`` class will have attributes and methods defined for you, including input parameters (and their types) as well as expected output. You will need to fill out the code for each defined method and docstrings containing additional information on what is expected.
+You will notice that ``Report`` class will have attributes and methods defined for you, including input parameters (and their types) as well as expected output.
+You will need to fill out the code for each defined method and docstrings containing additional information on what is expected.
 
 The ``Report`` class uses another class that is fully defined for you,
 the ``Row`` class. This class represents a single row in your report, and the report class will hold a list of the row instances.
 
@@ -0,0 +1,118 @@
+#!/usr/bin/env python
+
+"""
+A set of classes to facilitate report writing
+"""
+
+import math
+import operator
+from uuid import uuid4
+
+
+class Row:
+    """
+    This class represents a single row
+    with ID, first name, last name and state attributes
+    """
+    def __init__(self, fname, lname, state):
+        self.row_id = str(uuid4())  # randomly generated unique ID
+        self.fname = fname
+        self.lname = lname
+        self.state = state
+
+    def __str__(self):
+        return f"| {self.row_id} | {self.fname + ' ' + self.lname:<15} | {self.state} |"
+
+
+class Report:
+    def __init__(self, limit: int):
+        self.limit = limit
+        self.rows = []
+
+    def add_row(self, row):
+        """Add a row object to the list"""
+        pass
+
+    def remove_row(self, row_id):
+        """Remove a row object by the row ID"""
+        pass
+
+    def size(self):
+        """Return how many total rows the report has"""
+        pass
+
+    def get_number_of_pages(self):
+        """
+        Get how many pages the report has; this will be based on limit variable.
+        If your limit=4 and rows list has 6 records then there are two pages: page1 has 4 records, page2 has 2 records
+        hint: you'll want to round up
+        """
+        pass
+
+    def get_paged_rows(self, sort_field, page):
+        """Return a list of rows for a specific page number
+        :param sort_field:  field to sort on, "name" or "-name" (descending)
+        :param page:        specific page for returning data
+        :return:            list of row objects for specific page
+
+        Hints:
+        1. You'll want to determine if sort is reversed or not (remember that
+           sorted() takes in param for that) this is based on if the fields
+           start with a minus sign for DESCENDING sort
+        2. When sorting on passed in field you can use handy `operator` library
+           with `attrgetter` method (look up official docs)
+        3. To actually determine what rows belong on the specific page you'll be
+           using list slicing (remember the slicing lab?)
+
+           Here is an illustration to help with the code logic:
+
+           The list has 6 rows => [<row1>, <row2>, <row3>, <row4>, <row5>, <row6>]
+           for page=2 we expect to get => [<row5>, <row6>]
+           with slicing you'll want to offset your list by 4 in this case
+           (extra hint: we can define offset as `offset = (page - 1) * self.limit`)
+
+        """
+        pass
+
+
+if __name__ == "__main__":
+
+    report = Report(4)
+
+    report.add_row(Row("natasha", "smith", "WA"))
+    report.add_row(Row("devin", "lei", "WA"))
+    report.add_row(Row("bob", "li", "CA"))
+    report.add_row(Row("tracy", "jones", "OR"))
+    report.add_row(Row("johny", "jakes", "WA"))
+    report.add_row(Row("derek", "wright", "WA"))
+
+
+    def run_report(sort_field):
+        print(f"... PAGED REPORT SORTED BY: '{sort_field}'...")
+        page = 1
+        while True:
+            rows = report.get_paged_rows(sort_field, page=page)
+
+            if not rows:
+                break
+
+            input(f"Press ENTER to see page {page}")
+
+            print(f"PAGE: {page} of {report.get_number_of_pages()}")
+            print("---------------------------------------------------------------")
+
+            for row in rows:
+                print(row)
+
+            print("---------------------------------------------------------------")
+
+            page += 1
+
+
+    run_report("fname")
+
+    print(f"\n\nRemoving student: {report.rows[1].fname} [{report.rows[1].row_id}]... \n\n")
+
+    report.remove_row(report.rows[1].row_id)
+
+    run_report("-fname")
@@ -0,0 +1,3 @@
+"""
+test code for the Report class(es)
+"""
@@ -16,6 +16,6 @@ Intro to Object Oriented Programing
     :caption: Exercises
     :maxdepth: 1
 
-    ../../exercises/oo_intro.rst
+    ../../exercises/oo_intro/oo_intro.rst
     ../../exercises/mailroom/mailroom-oo.rst
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	`+"""`
	`2`	`+test code for the Report class(es)`
	`3`	`+"""`