SeleneHR and the sample CLI sends files to an unpaid Jason's computer for him to upload automates uploading problem data to HackerRank through Selenium, cause I was too lazy to manually upload SCPE content.
SeleneHR requires selenium to be installed. The HackerRank CLI requires argparse and dotenv.
To use SeleneHR and the CLI, download the repository. You will need to edit .env and add your browser token to the SESSION field. To find this token, login to HackerRank and find the _hrank_session cookie under www.hackerrank.com. Copy the hexadecimal string in the Content field to the .env file.
Along with selene_hr.py, the actual Selenium wrapper, this repository has a small CLI to automate uploading problem information to HackerRank.
selene_hr.py is the file containing the actual Selenium wrapper. It contains a SeleneHR class, which can be used elsewhere to automatically update or upload problems and testcases. See hr_cli.py for sample usage.
Constructor: requires the content of a HackerRank cookie as a string. Also, logging can be toggled.
createNewProblem: Upload a problem statement to HackerRank under a new problem. All fields are required to create a new problem; errors and warnings will pop up if fields are incorrect or missing. This function returns the newly-created problem's ID.
editProblemDetails: Update an existing problem's statement and/or difficulty. Fields are optional; if any field is empty, it is ignored when editing the problem.
uploadTestcases: Upload a .zip containing some amount of testcases to a problem. This function takes in the problem's ID, and a filepath to the .zip. The .zip file must exactly follow HackerRank's testcase specifications; see the sample problem for an example.
This function may optionally specify how many testcases should be marked as sample testcases as samples. Additionally, a map of zero-indexed integer:string sampleDataMap can be passed in, to add explanations for sample testcases; for each sample testcase, if its index appears in sampleDataMap, the corresponding string is added to the input. There is currently no support for uploading images with text, besides manually hosting the image and adding the link in Markdown format.
close: Close the Selenium window. After this function is called, this object can no longer be used.
This is a CLI I use for ease of editing problem statements and testcases, along with uploading them to HackerRank. It has commands for testcase generation, problem statement parsing, uploading new problems, and updating existing problems. Every command requires the directory of the problem to be passed in afterwards. Commands are as follows:
tgen/tg: Generate testcases from a template and generator file, by calling gen.py in the root directory.
hr tg "sample\Euler's Multiples Redux"
tzip/tz: Zip existing testcases within the problem's testcases directory into testcases.zip.
hr tz "sample\Euler's Multiples Redux"
tbuild/tb: Calls tgen and tzip sequentially.
hr tb "sample\Euler's Multiples Redux"
tempty/te: Create testcases directory. Files input00.txt through input(n-1).txt are created in testcases/input, and output00.txt through output(n-1).txt are created in testcases/output.
hr tb "sample\Euler's Multiples Redux" 5
tupload/tu: Upload existing testcases in the problem's testcases.zip file into HackerRank, using SeleneHR. Fails if the problem is missing a hr_info/hr_pid.txt file, as the problem needs to exist on HackerRank before testcases are uploaded.
hr tu "sample\Euler's Multiples Redux"
mdparse/md: Parse an existing Markdown file into hr_info/statement.json. Fields are statement, inputFormat, constraints, and outputFormat. You can edit compileStatement.py to make a custom parser.
hr md "sample\Euler's Multiples Redux"
upload: Upload a problem statement into HackerRank, using SeleneHR. If the problem is missing a hr_info/hr_pid.txt file, creates a new problem and creates hr_info/hr_pid.txt with the new problem's ID. Otherwise, updates the problem with HackerRank ID matching the ID inside the text file. Requires hr_info/statement.json.
hr upload "sample\Euler's Multiples Redux"
push: Calls tbuild, mdparse, upload, and tupload sequentially.
hr push "sample\Euler's Multiples Redux"
With the exception of zip_tests.bat, .bat files are wrappers for the individual .py files, allowing a user to simply type in the filename to the terminal on Windows. For example, instead of typing in python hr_cli.py ..., a user only has to type in hr ....
zip_tests.bat generates a .zip file of the testcases of a directory. Later, I may change this to a Python file that accomplishes the same purpose.
With the exception of zip_tests.bat, all other .bat files can be safely removed.