hyamamoto / hackerrank-core

API Wrappers and Bots for the coding competition site "HackerRank"

HackerRank Lib, API Wrappers and Bots for HackerRank

HackerRank Lib provides a small tool set for HackerRank Beta and Signup Game. This is made to aid those who have not much time to write their own API wrapper to build their bot for new challenges. It's written in Java 6 and tested on Mac OS X Lion, Gentoo Linux and Windows 7. It's currently used and maintained by higon (Hiroshi Yamamoto). Anyone is welcome to modify.

This kit includes:

• API Wrappers and Utilities
  • Splash Signup Game API
  • Closed Beta API
• Commandline scripts
  • Userstats command
  • Leaderboard command
  • SpaceX bot
  • Candies bot
  • and some more.

What Is HackerRank?

HackerRank is a new website you can play with. Basically it's a little coding competition site. Most exciting thing about HackerRank is that it has "Hack" on its name. So we can rationally safely assume we can hack their servers at will, can we.

Ya. I stop joking here.

Check out their site for more detail.

Quick Start (How to run)

There are only two ways to run.

1. Buy ( 7 + 8 + 9 + ... + 2559 + 2560) reasonably priced candies from Sam's.
2. Simulate and solve all the Candies games on a table with your girlfriend joyfully.
3. Travel somewhere in the middle of PRC.
4. Employ 100 labors.
5. Let them work on 111 problems each on SpaceX.
6. Pay them with a lotta candies.
7. Now, run.

or

1. Clone the repo and build. (Alternatively, you can just download the zipball.)
   $ git clone git://github.com/hyamamoto/hackerrank-core.git
   $ mvn install
   $ cd target
   $ tar xvfz *.tar.gz
2. Create an account on HackerRank. In this example, let's say you took a user "Mariacchi".
3. Run a SpaceX bot, then leave your machine for 4+ hours.
   $ cd hackerrank-toolkit/bin $ ./splash_spacex -U Mariacchi -from 1 -to 11100 ( or .\splash_spacex.bat on Windows )
4. Run a Candies bot then leave your machine for 12+ hours.
   $ ./splash_candies -U Mariacchi -from 1 -to 2560 ( or .\splash_candies.bat on Windows )

... So you see exceptions? Of course you can give me candies so that I can fix them.

HackerRank API Wrappers

Name     : HackerRank Splash API  
Class    : jp.freepress.hackerrank.splash.SplashAPI  
Includes : Calls for Sign-in, Sign-out, Sign-up, Leaderboard, User status, and Games (Candies, SpaceX)

For SplashAPI, see SampleMain.java or SampleApp.scala for actual code.

Name     : HackerRank Beta API (2012/07)
Class    : jp.freepress.hackerrank.beta.BetaAPI  
Includes : Calls for Sign-in, Sign-out, Leaderboard, and Submission list

BetaAPI is a wrapper based on Restful API of HackerRank Beta version that ought to be changed frequently.

Bots

Name : Splash Candies bot
Main class: jp.freepress.hackerrank.SplashCandiesMain
Description: This is a simple "pick candies" game solver. Algorythm's as follows.

1. If the number of candies is divisible by 6, skip the game since you'll always lose.
2. If the number is less than 6, take all candies and grin.
3. Otherwise, the pick should be a number that takes the remaining number to a multiple of six (see rule #1).

Usage:

-from        First # of the challenge  *Required*  
-to          Last # of the challenge   *Required*  
-U           Your username. Use with -P option.  
-P           A password for your username  
-slog        Log output directory 

Name : Splash SpaceX Bot
Main class: jp.freepress.hackerrank.SplashSpaceXMain
Description: This is a SpaceX game solver.

This bot rotates encrypted texts and brute-forces to decipher the most of questions a Scientist asks without any supplemental information. This bot sometimes stops when it's processing the problems from #10000 to #11100. When you find the bot has stopped on a certain problem, you may need to run the bot again on the problem later or solve it by hand. Note that you need to get Wolfram*Alpha APPID and specify "-waId {APPID}" command line argument if you are to challenge later than 11000th problem.

Usage:

-from        First # of the challenge  *Required*  
-to          Last # of the challenge   *Required*  
-U           Your username. Use with -P option.  
-P           A password for your username  
-slog        Log output directory  
-waId        Your Wolfram*Alpha APPID. This option is required to solve #11001+.  

Name : Splash Userstats
Main class: jp.freepress.hackerrank.SplashUserstatsMain
Description: This logins and gets a single user status from the rank leader board.

Usage:

-U           Your username. Use with -P option.  
-P           A password for your username  

Name : Splash Leaderboard
Main class: jp.freepress.hackerrank.SplashLeaderboardMain
Description: This retrieves a list of user statuses from the rank leader board.

Usage:

-L           limit

Name : Beta Leaderboard
Main class: jp.freepress.hackerrank.BetaLeaderboardMain
Description: This retrieves a list of user statuses from the rank leader board.

Usage:

-O           offset

License

All source code and experimental distributable files are released as an open source software under Apache Public License, version 2.0.

Happy Hacking! :D