setup.py

.idea/workspace.xml

@@ -2,7 +2,16 @@
 <project version="4">
   <component name="ChangeListManager">
     <list default="true" id="5c346737-53d8-4e87-88c5-7be2c8e7baeb" name="Default" comment="">
+      <change afterPath="$PROJECT_DIR$/cs101courseware_example/instructions.py" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/.idea/workspace.xml" beforeDir="false" afterPath="$PROJECT_DIR$/.idea/workspace.xml" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/README.md" beforeDir="false" afterPath="$PROJECT_DIR$/README.md" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/cs101courseware_example/Report0/Report0.report" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/cs101courseware_example/cs101report1.py" beforeDir="false" afterPath="$PROJECT_DIR$/cs101courseware_example/cs101report1.py" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/cs101courseware_example/cs101report1_grade.py" beforeDir="false" afterPath="$PROJECT_DIR$/cs101courseware_example/cs101report1_grade.py" afterDir="false" />
       <change beforePath="$PROJECT_DIR$/setup.py" beforeDir="false" afterPath="$PROJECT_DIR$/setup.py" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/unitgrade/__init__.py" beforeDir="false" afterPath="$PROJECT_DIR$/unitgrade/__init__.py" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/unitgrade/unitgrade.py" beforeDir="false" afterPath="$PROJECT_DIR$/unitgrade/unitgrade.py" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/unitgrade/unitgrade_helpers.py" beforeDir="false" afterPath="$PROJECT_DIR$/unitgrade/unitgrade_helpers.py" afterDir="false" />
     </list>
     <option name="SHOW_DIALOG" value="false" />
     <option name="HIGHLIGHT_CONFLICTS" value="true" />
@@ -54,8 +63,8 @@
   <component name="FileTemplateManagerImpl">
     <option name="RECENT_TEMPLATES">
       <list>
-        <option value="Python Script" />
         <option value="Setup Script" />
+        <option value="Python Script" />
       </list>
     </option>
   </component>
@@ -135,8 +144,8 @@
       <recent name="C:\Users\tuhe\Documents\unitgrade_private" />
     </key>
   </component>
-  <component name="RunManager" selected="Python.deploy_cs101 (1)">
-    <configuration name="cs101report1" type="PythonConfigurationType" factoryName="Python" temporary="true">
+  <component name="RunManager" selected="Python.cs101report1 (1)">
+    <configuration name="cs101report1 (1)" type="PythonConfigurationType" factoryName="Python" temporary="true" nameIsGenerated="true">
       <module name="unitgrade" />
       <option name="INTERPRETER_OPTIONS" value="" />
       <option name="PARENT_ENVS" value="true" />
@@ -144,12 +153,11 @@
         <env name="PYTHONUNBUFFERED" value="1" />
       </envs>
       <option name="SDK_HOME" value="" />
-      <option name="WORKING_DIRECTORY" value="$PROJECT_DIR$/cs101courseware" />
+      <option name="WORKING_DIRECTORY" value="$PROJECT_DIR$/cs101courseware_example" />
       <option name="IS_MODULE_SDK" value="true" />
       <option name="ADD_CONTENT_ROOTS" value="true" />
       <option name="ADD_SOURCE_ROOTS" value="true" />
-      <EXTENSION ID="PythonCoverageRunConfigurationExtension" runner="coverage.py" />
-      <option name="SCRIPT_NAME" value="$PROJECT_DIR$/cs101courseware/cs101report1.py" />
+      <option name="SCRIPT_NAME" value="$PROJECT_DIR$/cs101courseware_example/cs101report1.py" />
       <option name="PARAMETERS" value="" />
       <option name="SHOW_COMMAND_LINE" value="false" />
       <option name="EMULATE_TERMINAL" value="false" />
@@ -158,7 +166,7 @@
       <option name="INPUT_FILE" value="" />
       <method v="2" />
     </configuration>
-    <configuration name="cs101report1_grade" type="PythonConfigurationType" factoryName="Python" temporary="true">
+    <configuration name="deploy_cs101 (1)" type="PythonConfigurationType" factoryName="Python" temporary="true" nameIsGenerated="true">
       <module name="unitgrade" />
       <option name="INTERPRETER_OPTIONS" value="" />
       <option name="PARENT_ENVS" value="true" />
@@ -166,12 +174,11 @@
         <env name="PYTHONUNBUFFERED" value="1" />
       </envs>
       <option name="SDK_HOME" value="" />
-      <option name="WORKING_DIRECTORY" value="$PROJECT_DIR$/cs101courseware" />
+      <option name="WORKING_DIRECTORY" value="$PROJECT_DIR$/../unitgrade_private/cs101courseware" />
       <option name="IS_MODULE_SDK" value="true" />
       <option name="ADD_CONTENT_ROOTS" value="true" />
       <option name="ADD_SOURCE_ROOTS" value="true" />
-      <EXTENSION ID="PythonCoverageRunConfigurationExtension" runner="coverage.py" />
-      <option name="SCRIPT_NAME" value="$PROJECT_DIR$/cs101courseware/cs101report1_grade.py" />
+      <option name="SCRIPT_NAME" value="$PROJECT_DIR$/../unitgrade_private/cs101courseware/deploy_cs101.py" />
       <option name="PARAMETERS" value="" />
       <option name="SHOW_COMMAND_LINE" value="false" />
       <option name="EMULATE_TERMINAL" value="false" />
@@ -180,7 +187,7 @@
       <option name="INPUT_FILE" value="" />
       <method v="2" />
     </configuration>
-    <configuration name="deploy_cs101 (1)" type="PythonConfigurationType" factoryName="Python" temporary="true" nameIsGenerated="true">
+    <configuration name="deploy_cs101" type="PythonConfigurationType" factoryName="Python" temporary="true" nameIsGenerated="true">
       <module name="unitgrade" />
       <option name="INTERPRETER_OPTIONS" value="" />
       <option name="PARENT_ENVS" value="true" />
@@ -192,7 +199,7 @@
       <option name="IS_MODULE_SDK" value="true" />
       <option name="ADD_CONTENT_ROOTS" value="true" />
       <option name="ADD_SOURCE_ROOTS" value="true" />
-      <option name="SCRIPT_NAME" value="$PROJECT_DIR$/../unitgrade_private/cs101courseware/deploy_cs101.py" />
+      <option name="SCRIPT_NAME" value="C:\Users\tuhe\Documents\unitgrade_private\cs101courseware\deploy_cs101.py" />
       <option name="PARAMETERS" value="" />
       <option name="SHOW_COMMAND_LINE" value="false" />
       <option name="EMULATE_TERMINAL" value="false" />
@@ -201,7 +208,7 @@
       <option name="INPUT_FILE" value="" />
       <method v="2" />
     </configuration>
-    <configuration name="deploy_cs101" type="PythonConfigurationType" factoryName="Python" temporary="true" nameIsGenerated="true">
+    <configuration name="instructions" type="PythonConfigurationType" factoryName="Python" temporary="true" nameIsGenerated="true">
       <module name="unitgrade" />
       <option name="INTERPRETER_OPTIONS" value="" />
       <option name="PARENT_ENVS" value="true" />
@@ -209,11 +216,11 @@
         <env name="PYTHONUNBUFFERED" value="1" />
       </envs>
       <option name="SDK_HOME" value="" />
-      <option name="WORKING_DIRECTORY" value="$PROJECT_DIR$/../unitgrade_private/cs101courseware" />
+      <option name="WORKING_DIRECTORY" value="$PROJECT_DIR$/cs101courseware_example" />
       <option name="IS_MODULE_SDK" value="true" />
       <option name="ADD_CONTENT_ROOTS" value="true" />
       <option name="ADD_SOURCE_ROOTS" value="true" />
-      <option name="SCRIPT_NAME" value="C:\Users\tuhe\Documents\unitgrade_private\cs101courseware\deploy_cs101.py" />
+      <option name="SCRIPT_NAME" value="$PROJECT_DIR$/cs101courseware_example/instructions.py" />
       <option name="PARAMETERS" value="" />
       <option name="SHOW_COMMAND_LINE" value="false" />
       <option name="EMULATE_TERMINAL" value="false" />
@@ -244,19 +251,19 @@
       <method v="2" />
     </configuration>
     <list>
-      <item itemvalue="Python.cs101report1" />
-      <item itemvalue="Python.cs101report1_grade" />
       <item itemvalue="Python.unitgrade" />
       <item itemvalue="Python.deploy_cs101" />
       <item itemvalue="Python.deploy_cs101 (1)" />
+      <item itemvalue="Python.instructions" />
+      <item itemvalue="Python.cs101report1 (1)" />
     </list>
     <recent_temporary>
       <list>
+        <item itemvalue="Python.cs101report1 (1)" />
         <item itemvalue="Python.deploy_cs101 (1)" />
+        <item itemvalue="Python.instructions" />
         <item itemvalue="Python.deploy_cs101" />
         <item itemvalue="Python.unitgrade" />
-        <item itemvalue="Python.cs101report1" />
-        <item itemvalue="Python.cs101report1_grade" />
       </list>
     </recent_temporary>
   </component>
@@ -328,14 +335,14 @@
           <option name="timeStamp" value="10" />
         </line-breakpoint>
         <line-breakpoint enabled="true" suspend="THREAD" type="python-line">
-          <url>file://$PROJECT_DIR$/../unitgrade_private/cs101courseware/deploy_cs101.py</url>
-          <line>6</line>
-          <option name="timeStamp" value="12" />
+          <url>file://$PROJECT_DIR$/unitgrade/unitgrade_helpers.py</url>
+          <line>41</line>
+          <option name="timeStamp" value="15" />
         </line-breakpoint>
         <line-breakpoint enabled="true" suspend="THREAD" type="python-line">
-          <url>file://$PROJECT_DIR$/unitgrade/unitgrade.py</url>
-          <line>154</line>
-          <option name="timeStamp" value="13" />
+          <url>file://$PROJECT_DIR$/unitgrade/unitgrade_helpers.py</url>
+          <line>40</line>
+          <option name="timeStamp" value="16" />
         </line-breakpoint>
       </breakpoints>
     </breakpoint-manager>

README.md

@@ -2,20 +2,47 @@
 
 Easy-to-use, easy-to-build report evaluations in a framework building on pythons unittest classes
 
-- 100% Python; no dependencies on binary blobs
+- 100% Python
 - No configuration or test-files needed to use or develop
 - Easy to use for students: 
     - Run tests as a single python command 
     - See your score immediately 
     - Upload your results as a single file on campusnet with no risk of accidential tampering
 - All tests are simple classes so it will integrates well with debugger and any IDE 
-- Easy to use for teacher: New tests can be build in 100% python, with no need to specify expected output
 
-## What it looks like to a student
-Homework is broken down into **reports**. A report is a collection of questions which are individually scored, and each question may in turn involve multiple tests. Each report is therefore given an overall score based on a weighted average of how many tests are passed.
+## Installation
+Unitgrade can be installed through pip using 
+```
+pip install git+ssh://git@gitlab.compute.dtu.dk/tuhe/unitgrade.git
+```
+This will install unitgrade in your site-packages directory. If you are using anaconda+virtual environment you can install it as
+```
+source activate myenv
+conda install git pip
+pip install git+ssh://git@gitlab.compute.dtu.dk/tuhe/unitgrade.git
+```
+Alternatively, simply use git-clone of the sources and add unitgrade to your python path.
 
-In practice, a report consist of an ordinary python file which they simply run. It looks like this:
+When you are done, you should be able to import unitgrade:
+```
+import unitgrade
+```
+## Testing installation
+I have provided an example project which illustrates all main features in a self-contained manner and which should 
+work immediately upon installation. The source can be found here: https://lab.compute.dtu.dk/tuhe/unitgrade/-/tree/master/cs101courseware_example
+To run the example, first start a python console:
+```
+python
+```
+Then run the code
+```
+from cs101courseware_example import instructions
+```
+This will print on-screen instructions for how to use the system tailored to your user-specific installation path.
 
+## Evaluating a report
+Homework is broken down into **reports**. A report is a collection of questions which are individually scored, and each question may in turn involve multiple tests. Each report is therefore given an overall score based on a weighted average of how many tests are passed.
+In practice, a report consist of an ordinary python file which they simply run. It looks like this (to run this on your local machine, follow the instructions in the previous section):
 ```
 python cs101report1.py
 ```
@@ -50,9 +77,9 @@ To register your results, please run the file:
 >>> cs101report1_grade.py
 In the same manner as you ran this file.
 ```
-Once students are happy with the result, they run an alternative, not-easy-to-tamper-with script called `cs101report1_grade.py`:
+Once you are happy with the result, run the alternative, not-easy-to-tamper-with script called `cs101report1_grade.py`:
 
 ```
-python report1_grade.py
+python cs101report1_grade.py
 ```
-This runs the same tests, and generates a file `cs101report1.token` which they upload to campusnet. This file contains the results of the report evaluation, the script output, and so on. 
+This runs the same tests, and generates a file `Report0_handin_18_of_18.token`. The file name indicates how many points you got. Upload this file to campusnet.

cs101courseware_example/cs101report1.py

 from unitgrade.unitgrade import QuestionGroup, Report, QPrintItem
 from unitgrade.unitgrade_helpers import evaluate_report_student
-# from unitgrade.hidden_create_files import setup_answers, setup_grade_file_report
+from unitgrade_private.hidden_create_files import setup_answers, setup_grade_file_report
 
 class ListReversalQuestion(QuestionGroup):
     title = "Reversal of list"

cs101courseware_example/cs101report1_grade.py

@@ -2,4 +2,4 @@
             Note we perform manual and static analysis of the uploaded results.
             '''
 import bz2, base64
-exec(bz2.decompress(base64.b64decode('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')))
+exec(bz2.decompress(base64.b64decode('QlpoOTFBWSZTWWIfYn8ABUHfgERQev9/9/v//+7/////YAZcNlvrc3TmVWgFAoENCUPSan6o9TymgNPImj1MepA0D1HqNPUaAB6I0MjQaFPU01PJqeknpkp4jUeiPJkyBNMnqGgDEyMRmUGHGTBNDIZGRk0NAGgyMIBoNGmQxDQAYSCJPVP1NNTT9SempkaaaaAAAMjQaAGm0mmQHGTBNDIZGRk0NAGgyMIBoNGmQxDQASKCNAmgjU0Y0MSYU8k0MmmmhoGmNTT0gaaMkiSM1yP9ZCRt3GNNAzCwQz488b4lnfz4Kw6XfLjtxYyCAKkkaYaNb1tnoHIqxbG4iLzwUVyV61UBbW2NiHICyZ4fsHwmTcYZCBzUKRbBmjNCoviZ0bPxWugnO9VCbDF0+ernyWYxcL61vmxYwqTEIW5NCQggjXMbtZHbHnCVWCTy4w6hj6Kt54eYNhoG1ncxy/cxWeC56ioqCoIJ6sJQMGaBfAGlgcpxG+izDA8dpK3kfwD1JQ1T3A/MxwgqLxiqikiCZEZSiUnZWVD33fm3Ox/ENcBodEb0s9nODFBlTGrKbUjExCyDKjDPzdIvartrGmnoNmjJvR1Im4zXxo/XLTrmMHWUdv9zAjf1UrqcgANENbwIs40CbaySAY0WEYVkpihFcxZoZgq6z0MkxFV9OS2XoKpgcqV/BHLzPDtu+7JFbXVQF52xLGLB9ImJhGUrKTmVV56IzMdICCtVzZZDKQGGjfqzCNxCIV0EBuY8uLYwzs0LtNrYTbxbHdLXkr25GrGnhsGRWI88iIATCFeIiIAJzLojwE6Bcm/Q7V3N4OO2X/Z1kZLBPWY7xg7QBoFUSFAAEBWl2i2221McQ76JIAZBzAIGgoLrkoERDpikgPh3VKt3t4Af10nrSQHYkgJmQ+lJAcWiLCSAMvu1Lyt3jJIAxHHvAKaS2r9Qt7xiG0dnBgYebFZ5bem3RYh6V65WHXIO0udhHJnmRQbDY10h+m6IZlIanIPItduelmsdiCQ9lPO2bNp+Oyfga1zPWEs+f//C2Fm4gVi00xctaL8OBHdWhl5u6yGTBbVX36OhC9D1xHG+7LYIbJI/T1sILsn09ASURkr4LzjKhk167TwEkWT1+T1LNpyJICkc0J2JzOSUS4RHJhWwPQEQqVvz+HKqEbgXcV4IucAXNquQGdlnEUpU5JIuX229YHyZt1fUAZCfVVrp8m26sTntiVadSKiVclWe7U2x8LsLVGAb27w1U33CANA0q1gt0yA1DSDFT5XJEDBRexPrEs1N06Sw2VkVx1ykEiEg0CieBybJlqqg1xlCESp0KrRShxqVAchjaOGXiaDfRLTzBSUgQm5GTkk22kk5BKQOEINSjKUjIjOGIlhzjwXAsMGwZo4SytbCLOVIv3NKsIYRIhk1CIeLepAmoEln0szIIklmDiWw40d7TA3s6L798TKbujqgF1Vqqu6FYsAfkEAMaN3mNR1uLfceAHVTPsqRcwxBppIDDR09dVXNBQo2W9sfoGWhy3KrvyAmomdg0wtGTzdnP59TT110IJa7gGmFqJ5KygDlXvIOdUUcDRbvRkDzjNT6zqVGBrqA51S5fJsY0NnEjSYshon44qy8LsQsYpgc2r4xKBgWNrooErJKYAhyFAEv8SROcg5aRbibYccUGxAyAE2J00jNdts3VAWqahcg0zCKqTVrBwGrgh2G7sF9zQg4uWREMwzR+at0Uml7mHAqCNob5pzzaIMUD4QDX12AfE5Ua0CyyqH79pdituRGKy6C7b0QvOd8iO1JAfZsOnDacS4ldZtIiTSZ3MqmRN0TKC7fVmg3J8mSMW28tOKzv4wx45c1S1pICITPKIoihJaeA0bgMrB+NMs1r3hthci9ZInCI+9USCaqQg0RPLp6xNuQLZFiRsYooFVIZDN5mEpfGo7GgWQuZsRGOgkohj0EuTgWWgF42GZIiQSMq7uMfH8agx3GYsqatYEN55o1lRGJ5hkkPqSQEkEIzCGc3MtRmtGr2qDDwiXigqpoIMsg4XFFKYh7FNchSa03C72PO71dXejA22Soiz2oPZ8qncD49ma8Gnuq0hAUE1rbAYq2YhuNIg1vyVaiHDY84CRFMEFph7EkBLcplL/NHWe33eU5fwyfV6XF14/4u5IpwoSDEPsT+A==')))
\ No newline at end of file

cs101courseware_example/instructions.py

+
+import os
+import textwrap
+
+
+def fprint(s):
+    print("\n".join(textwrap.wrap(s, width=100)))
+
+def tprint(s):
+    print(f"\n> {s}\n")
+
+if __name__ == "__main__":
+    s = """
+This is an example script to illustrate unitgrade for a very simple, fictitious course. Because this is a build-in 
+example, the source code will likely reside in your site-packages directory. The full example can be found at:"""
+    print(s)
+    wdir = os.path.dirname(__file__)
+    tprint(wdir)
+    print("The directory contains the source for a fictitious course. The content of the directory is:")
+    for d in os.listdir(wdir):
+        if "__" not in d and d != "instructions.py":
+            print("> ", d)
+    print("")
+    fprint("The file homework1.py is the file you edit as part of the course; you are welcome to open it and inspect the content, but right now it consists of some simple programming tasks plus instructions.")
+    fprint("The file cs101report1.py contains the actual tests of the program. All the tests are easily readable and the script will work with your debugger if you are using pycharm, however, we will run the script for the command line. ")
+    fprint("To do so, open a console, and change directory to the cs101 main directory using e.g.:")
+    tprint(f'cd "{wdir}"')
+    print("Then run the script as usual")
+    tprint(f'python cs101report1.py')
+
+
+

setup.py

 from setuptools import setup
-
+# from unitgrade import version
+# version = "0.0.1"
+from unitgrade import __version__ as version
 setup(
     name='unitgrade',
-    version='0.0.1',
+    version=version,
     packages=['unitgrade', 'cs101courseware_example'],
     url='https://lab.compute.dtu.dk/tuhe/unitgrade',
     license='Apache',

unitgrade/__init__.py

+__version__ = "0.0.1"
 import os
 import compress_pickle
 

unitgrade/unitgrade.py

@@ -152,7 +152,7 @@ class Report():
         # working_directory = os.path.join(pathlib.Path(__file__).parent.absolute(), "payloads/")
         self.wdir, self.name = setup_dir_by_class(self, working_directory)
         # trace = inspect.trace()
-        self.computed_answers_file = self.wdir + "/" + self.name + ".report"
+        self.computed_answers_file = self.wdir + "/" + self.name + "_resources_do_not_hand_in.dat"
         self.questions = [(Q(working_directory=self.wdir),w) for Q,w in self.questions]
         if os.path.isfile(self.computed_answers_file):
             self.set_payload(cache_read(self.computed_answers_file))

unitgrade/unitgrade_helpers.py

@@ -27,6 +27,17 @@ def evaluate_report_student(report, question=None, qitem=None):
 
 def evaluate_report(report, question=None, qitem=None):
     now = datetime.now()
+    import pyfiglet
+    ascii_banner = pyfiglet.figlet_format("UnitGrade", font="doom")
+    # print(ascii_banner)
+
+    b = "\n".join( [l for l in ascii_banner.splitlines() if len(l.strip()) > 0] )
+    import unitgrade
+    print(b + " v" + unitgrade.__version__)
+
+
+
+
     dt_string = now.strftime("%d/%m/%Y %H:%M:%S")
     print("Starting on " + dt_string)
     print("Evaluating " + report.title)