Table of Contents

Corning Community College

CSCS1730 UNIX/Linux Fundamentals

Project: GRADE FIGURE-OUTERER (gfo0)

Objective

Scripting is a great way to automate otherwise manual and time consuming tasks. The objective for this project is to give you another opportunity to play with your ever-expanding UNIX and command-line skills, and assist you with developing an even finer relationship between process and data: by having you calculate your grade in the class based on your evaluation data.

Background

Throughout the semester your participation, weekly journal entries, and projects have been gradually tallying up and made available to you via the super-nifty status tool.

In order to pull up your information, you merely need to invoke the command with the pertinent class:

lab46:~$ status unix

And you will be greeted with the summary data related to your standing in the class (you can also append the detail option to get even more of an information line-by-line breakdown):

lab46:~$ status unix detail

But, throughout all this, some very obvious data points are lacking: your actual, calculated results. All I am giving you is the raw data, and while I have scripts that can quickly give me an overview of your progress, I've left that same role up to you to fill.

And since you're all unprocrastinating, highly motivated and impassioned learners, I figured I'd give you a project that you've probably finished weeks ago in your individual quests for perfection: to write a script that will collect, process, and output that very information (you're welcome).

Grading Policy

You'll recall from the syllabus that the grading policy for the class is divided into three areas:

Letter grades are on the following scale:

Each component needs to be calculated separately to gain the total number of points, and then those points summed together to get your final result.

Of course, we're not done yet, so new data is being added all the time (with each passing week, journal entry, and evaluated project), which means whatever value you may come up with today would potentially be obsolete come tomorrow.

The algorithms and the process for determining your grade based on the available data, however, remain the same.

Which is why this makes for such a great scripting project.

Task

As previously mentioned, throughout the semester you've been able to see the processed results of your various efforts in the class (projects, journal, participation). That information was made available to you via the handy status tool (expanded some more with the detail argument given).

Participation

Participation is evaluated on a weekly basis, based on the participation claims you've registered via the wcp tool.

Data will appear as follows:

PARTICIPATION
    4:wcp1:final tally of results (4/4)
    8:wcp2:final tally of results (8/8)
    12:wcp3:final tally of results (12/12)

Journal

The journal data is recorded, currently, in three categories per week, eligible to earn up to 8 points per weekly entry:

Data can look something like this:

    8:week1:final tally of results (8/8)
    6:week2:final tally of results (6/8)
    8:week3:final tally of results (8/8)
    8:week4:final tally of results (8/8)
    5:week5:final tally of results (5/8)
    6:week6:final tally of results (6/8)
    3:extra:final tally of results (3/0)

Projects

That data, specifically for projects, is of the format (sample follows):

4:uxi0:final tally of results (4/5)
*:uxi0:cloned lab46 mercurial repository [1/1]
*:uxi0:subscribed lab46 address to class mailing list [1/1]
*:uxi0:subscribed to class mailing list [0/1]
*:uxi0:customized opus intro [1/1]
*:uxi0:customized opus title [1/1]
16:pbx0:final tally of results (16/16)
*:pbx0:lab46 submission successful [8/8]
*:pbx0:email submission successful [8/8]
16:pbx1:final tally of results (16/16)
*:pbx1:content correct [8/8]
*:pbx1:lab46 submission successful [8/8]
3:bonus:final tally of results (3/0)
*:bonus:uxi0 early submission bonus (2 days) [2/0]
*:bonus:pbx1 early submission bonus (1 day) [1/0]

You should see 2 types of lines. The first is the “final tally” line:

YOUR_SCORE:PROJECT_NAME:final tally of results (YOUR_SCORE/TOTAL_POSSIBLE_SCORE)

The data lines all start with an '*', and merely provide a deeper level of detail (how we arrived at that grand total for the project). It is of the format:

*:PROJECT_NAME:description [YOUR_POINT/TOTAL_POINT]

Each line item's point value (against its total) is presented at the very end of the line in square brackets (as shown).

Finally, to handle bonus points, notice what happens: the “total” values are all out of 0… so it ONLY counts for you, should we get any bonus points, and doesn't count against you should you not gain any.

Each project is clumped together, its “final tally” line leading the stanza, with the follow-up line items beneath it (note: NOT an average, but a tally).

Should there be any points deducted for lateness, they should be on the second line of the stanza (immediately following the “final tally” line). And would have the following format:

*:cus0:LATE penalty (1 day) [-26]

Questions/Sub-Tasks

On the command-line, how would you:

The script

Your ultimate task for this project is to write a script that scrapes the data generated by the status tool and computes your overall grade in the class.

I'd like your script to conform to a particular output format, described below.

Output Specification

Here is an example of the sort of information I'd like to see your script output:

lab46:~/src/unix/gfo0$ ./gfo0.sh
==================================================================================
UNIX      uxi0 pbx0 cus0 pbx1 arc0 wpa0 udr0 sfp0 bns prjct+ptcpn+jrnal= result
==================================================================================
username: 100  86   91   79   99   0    0    83   3   41/52+11/13+12/13= 82/100 B
==================================================================================
lab46:~/src/unix/gfo0$ 

NOTE that in the above, “username” should actually display YOUR USERNAME.

And note that the actual scores are left justified underneath the column heading listing the project name.

Useful tools

By no means an exhaustive nor implied list, you may want to ensure familiarity with the following tools/concepts when performing this project:

Often times related and potentially useful commands you may want to know about can be found in the “SEE ALSO” section near the bottom of many manual pages.

bash debugging

If you add a -x argument to bash (in the shabang, or on the command-line if running your script that way), it will be immensely more verbose, reporting more precisely on its actions. This can prove most useful when trying to figure out various problems, be it syntax errors in your script or spurious logic errors.

Submission

Successful completion will result in the following criteria being met:

Submit

Please submit as follows:

lab46:~/src/unix/gfo0$ submit unix gfo0 gfo0.sh
Submitting unix project "gfo0":
    -> gfo0.sh(OK)

SUCCESSFULLY SUBMITTED
lab46:~/src/unix/gfo0$ 

Things I'll be looking for:

78:gfo0:final tally of results (78/78)
*:gfo0:gfo0.sh submit via submit tool [1/1]
*:gfo0:gfo0.sh is well and consistently commented [4/4]
*:gfo0:gfo0.sh is well and consistently indented [4/4]
*:gfo0:gfo0.sh generates no errant output during run [4/4]
*:gfo0:gfo0.sh caches and references status output at run [13/13]
*:gfo0:gfo0.sh output matches project specifications [13/13]
*:gfo0:gfo0.sh generates results live through calculations [13/13]
*:gfo0:gfo0.sh has no line exceeding 80 characters in length [13/13]
*:gfo0:gfo0.sh is a fully automated script, no interaction [13/13]