- Table of contents
- uInterface (GUI application)
- uInterface (Python & Rust library)
- Contributing
- Mentions & bibliography
uInterface is an application that can be used alternatively to the UVa judge and uHunt websites. It offers pretty much the same functionalities as them, but with the key advantage that is not having to switch over multiple tabs in your web browser. Following there are a set of instructions to install uInterface, as well as a full-on explanation of the features of this application.
In order to install and use uInterface, you will have to follow the installation guide for your operating system.
To install the application on Windows ust go to releases and download the project. Make sure all dependencies are installed by running python setup.py install. Then, navigate to gui/ and execute
To install the application for linux, go to releases and download the source code. Once downloaded, extract the files and execute the shell script run_linux.sh. Note you may need to give the script permission to execute with sudo chmod +x run_linux.sh. The script will download all the dependencies needed to run the application and run it. Note that once the dependencies are installed, they will not be downloaded next time you execute the script.
uInterface has some unique features, which will be descriped below.
The app allows users to log-in to their UVa judge accounts (same system as uHunt) to see their last submissions and position in the global ranking. Also, they can search for a problem, wich will promt the user with the pdf of that problem, statistics for it and last submissions to the problem by the logged in user (if any submissions were done). Problems can also be submited here by clicking the button Sumbit this problem, which will take them to the UVa judge submission page. Note that they will have to be logged in to their UVa judge account on the website, otherwise they will be asked to log-in and take them to the main page of the judge.
For correct development of the GUI application, a Python library was coded using Rust. This library can also be used in Rust and links to both PyPI and crates.io are found at the end of the README under Mentions & bibliograpy.
The library(es) provide an easy to use interface to make requests to uHunt's API. This requests get parsed to a struct or a dictionary (rust and python respectively), which allow to access the fields of the responses.
To install the libraries, run either pip install uInterface for python or add the following dependency to your Cargo.toml file:
uInterface=1.0.0
To get a look on how to use these libraries, go to the PyPI/crates.io page for the libraries (Mentions & bibliograpy) and read the full documentation, which contains the functions implemented by this libraries. To check Python documentation, head over to gui/docs.md
To contribute to the project, please read the short CONTRIBUTING.md file. If you want to submit a new issue, follow the issue templates. Pull requests don't have a template, but they should be linked to an isuue and tagged properly.
Special thanks to:
- Felix Halim, creator of uHunt website and uHunt's API
- Universidad de Valladolid, for hosting the UVa judge