The main motivation was mainly due to the design itself, though a bit on the functional requirements. I hope this makes it easier to maintain or to add more features in the future. Do take note of these changes should you upgrade it from `v1.6.5` or lower.
**TLDR:** If you're just using the basic functions as per default settings, there is essentially little to no change.
**What's new** (in ascending order of importance, probably):
- **Logging**. This should be able to distinguish if you're using `v1.x.x` or `v2.0`.
before
Candidate username(s): ['...']
Successfully logged in to Kattis!
after
[login] Candidate username(s): ['...']
[login] Successfully logged in to Kattis as ...!
[database] Listed all available languages!
[database] Listed all available countries!
[database] Listed all available universities!
- **Better testing**. I wanted to have a generalized testing function so it's easier to add more tests in the future. Simply provide a test name, the function, and the arguments, then you're good to go.
- **More documentation**. README changes are basic, so I decided to up the ante by adding example JSON return values within each method's docstring whenever necessary. Use the Python `help` function to read them!
- **Decoupling of main classes**. I decided to not make `NUSKattis` inherit `OpenKattis` but decouple both and make them inherit a single (abstract) class. This makes it easier to implement more Kattis classes in the future.
- **Database manager**. Instead of hardcoding them on a single file, a `DatabaseManager` that takes the same data directly from Kattis should provide more accurate results, especially the languages provided since they might differ on different Kattis classes. With this, we no longer need the `database` and the `scraper` directories.
- **Login manager**. Similar to the database manager, this is also made into a separate class `LoginManager` so that it's easier to handle different login behaviors in the future.
- **More common utilities**. Be it a bunch of functions, or just more enums recently added to avoid magic numbers. However, to avoid grandparent relative importing like `from ..grandparent import something`, I decided to move `utils/__init__.py` to `api/utils.py`. Let's see how well that works out later.
- **The methods themselves**. Here's some exhaustive changes should you cannot care less about the detailed changes:
- **For `OpenKattis`**
- You can still use `Kattis`, but moving forward this package will be using `OpenKattis` as the term for anything happening at `open.kattis.com`.
- `problems`
Can still use as usual, except it now supports full/low detail mode. You can still get all existing problems by just doing `problems(*[True]*4)` as per example on the README.
- `problems_v2`
***Is now disabled***. Please use `problems` with `low_detail_mode=True` arguments. For the record, `problems_v2(show_non_ac=True)` is currently implemented as `problems(low_detail_mode=True, show_solved=False)`.
- `problem`
Instead of providing variable arguments, aggregate them within a sequence/iterable. For example, use `problem(['a', 'b', 'c'])` instead of `problem('a', 'b', 'c')`. It is now optional for you to download the files from the metadata by setting `download_files=True`.
- `stats`
Same as `problem`, without the file downloading part.
- `achievements`
`verbose` is no longer a parameter (with a default value) because I did not see a good reason to have it 😄
- `ranklist`
Now divided to five separate methods: `ranklist`, `user_ranklist`, `country_ranklist`, `university_ranklist`, and `challenge_ranklist`.
- The default remains the same: get users around you.
- To get the top 100 user ranklist, we no longer use `ranklist(top_100=True)`. Instead, use `user_ranklist()`.
- To get the country ranklist, we can now get either the top 100 countries or the top 50 users in a specific country (as opposed to only being able to get the latter). So, instead of using `ranklist(country=<country>)`, use either `country_ranklist()` or `country_ranklist(<country>)`.
- To get the university ranklist, we can now get either the top 100 universities or the top 50 users in a specific university (as opposed to only being able to get the latter). So, instead of using `ranklist(university=<university>)`, use either `university_ranklist()` or `university_ranklist(<university>)`.
- Added challenge ranklist by using the `challenge_ranklist` method.
- **For `NUSKattis`**
- `problems`
Can still use as usual, except it now **ONLY supports low detail mode**. You can **NO LONGER** get all existing problems by just doing `problems(*[True]*4)` as per example on the old README. Instead, treat this as the new `problems_v2`. For the record again, `problems_v2(show_non_ac=True)` is currently implemented as `problems(show_solved=False)`.
- `problems_v2`
Same as the one for `OpenKattis`, i.e. disabled.
- `problem`
In terms of how you call this method, same as the one for `OpenKattis`.
In terms of what it does now, due to security issues, you can't treat it the same as the one for `OpenKattis`. It will only be accessible (i.e. show some non-empty result) if it is part of an existing course offering, be it a past one or a current one. Check out the docstring for more information about its JSON fields.
- `stats`
Same as the one for `OpenKattis`.
I hope you enjoy reading all of that (or not?). If any changes are required, `v2.0.1` or `v2.1` shall await, depending on the significance of the change!
**Full Changelog**: https://github.com/RussellDash332/autokattis/compare/v1.6.5...v2.0