Metadata-Version: 2.1
Name: resultr_format
Version: 0.1.0
Summary: Making UCL PHAS results better
Home-page: https://github.com/haykkh/resultr
Author: Hayk Khachatryan
Author-email: hi@hayk.io
License: MIT
Description: #  resultr-format
        >  back end for [resultr](https://github.com/haykkh/resultr)   
        
        **note** it's very possible that I made mistakes so take what this gives with a bucketload of salt.
        
        UCL Physics and Astronomy publishes the results for every year as a pdf with this format: 
        
        **Candidate Number**|**Devcom**|**Module1**|**Mark**|**Module2**|**Mark**|**Module3**|**Mark**|**Module4**|**Mark**|**Module5**|**Mark**|**Module6**|**Mark**|**Module7**|**Mark**|**Module8**|**Mark**|**Provisional outcome**| 
        :-----:|:-----:|:-----:|:-----:|:-----:|:-----:|:-----:|:-----:|:-----:|:-----:|:-----:|:-----:|:-----:|:-----:|:-----:|:-----:|:-----:|:-----:|:-----:
        ABCD0|100|PHAS0000|99|PHAS0001|98|PHAS0002|97|PHAS0003|96|PHAS0004|95|PHAS0005|94|PHAS0006|93|PHAS0007|92|P| 
        ABCD1|24|PHAS0003|93|PHAS0001|55|PHAS0004|43|PHAS0007|40|PHAS0002|34|PHAS0006|25|PHAS0005|15|PHAS0000|3|>>| 
        
        resultr-format lets you:
          * get your weighted average for a year
          * get your rank in your year
          * re-format the results by module (as below) and output to csv
        
        output format:
        
        **Devcom**|**PHAS0000**|**PHAS0001**|**PHAS0002**|**PHAS0003**|**PHAS0004**|**PHAS0005**|**PHAS0006**|**PHAS0007**|**Averages**
        :-----:|:-----:|:-----:|:-----:|:-----:|:-----:|:-----:|:-----:|:-----:|:-----:
        100|99|98|97|96|95|94|93|92|95.5
        24|3|55|34|93|43|15|25|40|39 
        
        
        ## Usage example
        
        Requires:
          * [Python 3](https://www.python.org/downloads/)
          * [python-inquirer](https://github.com/magmax/python-inquirer) for the user input
        
        
        ### Making the PDF usable
        
        You're going to need to convert the .pdf given by UCL into a csv, delimited with ','. To do this I used [smallpdf](https://smallpdf.com/pdf-to-excel)'s PDF to Excel converter (this makes an xlsx with a sheet for every page of the page of the pdf). Then I used [Google Docs](https://docs.google.com) to export each sheet as a csv, and combined them in a texteditor (note though that you should remove the heading lines (cand, devcom, module1, etc) from all pages apart from the first)
        
        
        ### Running resultr-format
        
        You can run interact with resultr-format using [inquirer](https://github.com/magmax/python-inquirer) prompts:
        
        ![ask demo](demoAsk.gif)
        
        Or equivalently by passing arguments when you run resultr-format:
        
        ![args demo](demoArgs.gif)
        
        ```sh
        $ python resultr-format.py -h 
          usage: resultr-format.py [-h] [--input INPUT] [--format FORMAT][--my]
                             [--year YEAR] [--rank] [--candidate CANDIDATE]
          
          Makes UCL PHAS results better
          
          optional arguments:
            -h, --help              show this help message and exit
        
            --input, -i INPUT
                                    csv file to import
        
            --format, -f FORMAT
                                    reformats results by module and exports it to file
                                    specified
        
            --my, -m                returns your weighted average for the year
        
            --year, -y YEAR         specify your year
        
            --rank, -r              returns your rank in the year
        
            --candidate, -c CANDIDATE
                                    specify your candidate number
        ```
        
        
        ## Release History
        
        * 0.1.0
            * The first proper release
        
        
        ## Meta
        
        Hayk Khachatryan – hi@hayk.io
        
        Distributed under the MIT license. See ``LICENSE`` for more information.
        
        [https://github.com/haykkh](https://github.com/haykkh/)
        
        ## Contributing
        
        1. Fork it (<https://github.com/haykkh/resultr-format/fork>)
        2. Create your feature branch (`git checkout -b feature/fooBar`)
        3. Commit your changes (`git commit -am 'Add some fooBar'`)
        4. Push to the branch (`git push origin feature/fooBar`)
        5. Create a new Pull Request
        
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Description-Content-Type: text/markdown
