New release - utopian-cli 0.5.2

Last week I released utopian-cli 0.4.2, and now I'm back again with the new and improved utopian-cli 0.5.2. I've added quite a lot of features in this update, so I will try and condense it as much as possible and give an overview of everything below! Use the following command to upgrade if you have already installed it

pip install utopian --upgrade

otherwise use the command to install it

pip install utopian

Features overview

The commands "contributions", "moderators", "sponsors" and "performance" have all received some form of an update. I've also fixed some bugs, but they were all caused by me, so they don't count haha. I will give an overview of the added/changed/updated commands in a table below each command and also describe what it does or what has changed.

You can also check out the usage of all commands in the README.

Improved features

Contributions

Option	Description
--reviewed/--unreviewed	I have removed this, since it was made redundant by the new --filter_by option
-f, --filter_by	Allows the user to filter contributions by all, review, active and inactive
-st, --status	Allows the user to filter contributions by its status any, pending and reviewed
-si, --similarity	Allows the user to search for similar contributions using the bySimilarity query

As you can see all the new options are used for filtering contributions, just like you would do on Utopian.io.

Moderators

I've also changed some options for the moderators command. I will give an overview of the added/changed commands in the table below and give each a short description

Option	Description
-s, --supervisor	Flag for only showing supervisors. This already existed, but -s makes it a lot easier to use!
-m, --moderator	Flag for only showing moderators. Works the same as the --supervisor option
--data	Shows moderators/supervisors in JSON format. This is just the renamed --j option.
-a, --account	Allows the user to specify specific accounts. Now also supports multiple accounts just like the other commands.
-s, --sort	Allows the user to sort the table of moderators/supervisors by id, moderator, referrer, reviewed and rewards.

Moderators are now also printed in a pretty table, just like the "performance" and "project" commands.

Sponsors

Option	Description
--data	Shows moderators/supervisors in JSON format. This is just the renamed --j option.
-a, --account	Allows the user to specify specific accounts. Now also supports multiple accounts just like the other commands.
--witness	Only shows sponsors that are witnesses.
--not-witness	Only shows sponsors that aren't witnesses.
-s, --sort	Allows the user to sort the table of sponsors by id, sponsor, witness, percentage and shares.

Sponsors are now also printed in a pretty table, just like the "performance" and "project" commands.

Performance

Option	Description
-i, --individual	When a user wants to see the performance of multiple accounts they can use this flag to print each user's individual performance instead of their collective performance. This is useful for printing an overview of a supervisor's team, for example.

I also realised (thanks to @zonguin) that when it was checking a moderator's performance, it would look at the date the contribution was created instead of when the moderator actually reviewed the contribution. Because of this, if a moderator reviewed a post today, but the post was submitted last week, then it wouldn't count towards their peformance of the last day. This is now fixed!

How to contribute?

1. Fork the repository
2. Create a feature branch with git checkout -b your-feature
3. Code and document your feature
4. Commit your changes with git commit -m "add my features"
5. Push to your branch with git push origin your-feature
6. Create a new pull request

Anything you can add to the project is valuable to me, be it bug reports, suggestions etc. so please don't hesitate!

---

Posted on Utopian.io - Rewarding Open Source Contributors

---