[IMAGE: https://media.discordapp.net/attachments/404587860872921088/416937640668168192/utopian-cli-052.png]

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.

[IMAGE: https://res.cloudinary.com/hpiynhbhq/image/upload/v1519473778/iof4c4djgqeefkximcqt.png]

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.

[IMAGE: https://res.cloudinary.com/hpiynhbhq/image/upload/v1519473604/xaii3bch0kviecjeioot.png]

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.

[IMAGE: https://res.cloudinary.com/hpiynhbhq/image/upload/v1519473563/wui5jypzr2wdz5h2uxeb.png]

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.

[IMAGE: https://res.cloudinary.com/hpiynhbhq/image/upload/v1519474376/jc5skczvwas4duwrnnyk.png]

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