rics#

My little CLI program.

Synopsis#

[1]:
!rics --help
Usage: rics [OPTIONS] COMMAND [ARGS]...

  👻 RiCS: My little CLI program.

Options:
  -v, --verbose  Controls application logging to stderr.

                 Verbosity levels:
                   0 = Logging disabled (default).
                   1 = rics: INFO (20)
                   2 = root: INFO (20)
                   3 = rics: DEBUG (10)
                   4 = root: DEBUG (10)
                 Repeat up to 4 times for increased verbosity.  [env var: RICS_VERBOSE]
  --help         Show this message and exit.

Commands:
  repos   Get licenced GitHub repositories with releases.
  timeit  Run a multivariate performance test.
  vc      Verify commits.

  Python package documentation:
      https://id-translation.readthedocs.io/
      https://time-split.readthedocs.io/
      https://rics.readthedocs.io/
  Please let me know if any of these resources helped you!

The verbosity flag#

You may repeat the -v flag up to four times, increasing logging output. Regular prints (to stdout) are not controlled this way.

Log messages are sent to to stderr. By default, no log messages are shown. Logging is configured using the [@logging_verbosity_option](https://rics.readthedocs.io/en/stable/api/rics.click.html#rics.click.logging_verbosity_option) decorator.

[2]:
!rics -v repos -u astral-sh
2025-05-11T09:52:54.577 [rics.repos:INFO] Found 43 repo(s) for 1 user(s): 'astral-sh'.
2025-05-11T09:52:56.241 [rics.repos:INFO] Processed 13/43 matching repos in 2.1s.
                                  Release tag            Last push  Stars  Issues                                                   Description                                                  Link      License    Created
Repo name
astral-sh/ruff                         0.11.9 2025-05-11T09:40:06Z  38716    1404  An extremely fast Python linter and code formatter, written                      https://github.com/astral-sh/ruff          MIT 2022-08-09
astral-sh/ruff-action                  v3.3.1 2025-05-11T08:20:30Z    142       7                                   A GitHub Action to run Ruff              https://github.com/astral-sh/ruff-action   Apache-2.0 2024-09-29
astral-sh/uv                            0.7.3 2025-05-11T02:55:59Z  53492    1739  An extremely fast Python package and project manager, writte                       https://github.com/astral-sh/uv   Apache-2.0 2023-10-02
astral-sh/python-build-standalone    20250409 2025-05-09T20:19:28Z   2961     129                      Produce redistributable builds of Python  https://github.com/astral-sh/python-build-standalone      MPL-2.0 2018-12-18
astral-sh/ruff-pre-commit             v0.11.9 2025-05-09T16:25:34Z   1273      22                                   A pre-commit hook for Ruff.          https://github.com/astral-sh/ruff-pre-commit   Apache-2.0 2022-09-20
astral-sh/setup-uv                     v6.0.1 2025-05-09T10:58:05Z    398      12  Set up your GitHub Actions workflow with a specific version                  https://github.com/astral-sh/setup-uv          MIT 2024-08-23
astral-sh/rye                          0.44.0 2025-05-08T00:28:11Z  14187     332                               a Hassle-Free Python Experience                      https://github.com/astral-sh/rye          MIT 2023-04-22
astral-sh/uv-pre-commit                 0.7.3 2025-05-07T20:05:48Z    182      21                                                          None            https://github.com/astral-sh/uv-pre-commit   Apache-2.0 2024-03-22
astral-sh/cargo-dist                  v0.28.5 2025-05-06T20:16:05Z     37      11                             📦 shippable application packaging               https://github.com/astral-sh/cargo-dist   Apache-2.0 2025-04-03
astral-sh/ruff-vscode               2025.22.0 2025-05-06T01:13:01Z   1352      63  A Visual Studio Code extension with support for the Ruff lin              https://github.com/astral-sh/ruff-vscode  NOASSERTION 2022-11-08
astral-sh/packse                       0.3.46 2025-03-27T20:11:10Z    117       9                                    Python packaging scenarios                   https://github.com/astral-sh/packse   Apache-2.0 2023-12-13
astral-sh/tokio-tar                    v0.5.2 2025-03-18T02:24:44Z     25       3        A tar archive reading/writing library for async Rust.                 https://github.com/astral-sh/tokio-tar   Apache-2.0 2024-12-09
astral-sh/ruff-lsp                    v0.0.62 2025-02-10T13:17:59Z   1445      30           A Language Server Protocol implementation for Ruff.                 https://github.com/astral-sh/ruff-lsp  NOASSERTION 2022-12-17

Environment variables#

Environment variables may be used to set argument defaults. These follow the form:

RICS_<COMMAND>_<ARGUMENT>=<value>

Explicit arguments take precedence; passing -vvv overrides the fallback value of RICS_VERBOSE=1 (which is equivalent to a single -v).

[3]:
!rics repos --help
Usage: rics repos [OPTIONS]

  Get licenced GitHub repositories with releases.

Options:
  -u, --user TEXT                 User or organization on GitHub.  [default:
                                  rsundqvist]
  -d, --max-days INTEGER RANGE    Max days since the last push.  [x>=0]
  --sort [created|name|push|stars]
                                  Column to sort on.  [default: push]
  --max-width INTEGER             Maximum width for the 'Description' column.
                                  Zero=no limit.
  --help                          Show this message and exit.
[4]:
%env RICS_VERBOSE=1
%env RICS_REPOS_USER=astral-sh pallets
env: RICS_VERBOSE=1
env: RICS_REPOS_USER=astral-sh pallets
[5]:
!rics -vvv repos --sort=stars
2025-05-11T09:52:57.476 [rics.repos:DEBUG] Found GitHub auth token: '/home/dev/.rics/github-token'.
2025-05-11T09:52:58.054 [rics.repos:DEBUG] Halt user='astral-sh' at page=1; query returned 43 repos < per_page=100.
2025-05-11T09:52:58.054 [rics.repos:DEBUG] Found 43 repo(s) for user 1/2: 'astral-sh'.
2025-05-11T09:52:58.388 [rics.repos:DEBUG] Halt user='pallets' at page=1; query returned 17 repos < per_page=100.
2025-05-11T09:52:58.388 [rics.repos:DEBUG] Found 17 repo(s) for user 2/2: 'pallets'.
2025-05-11T09:52:58.388 [rics.repos:INFO] Found 60 repo(s) for 2 user(s): 'astral-sh', 'pallets'.
2025-05-11T09:52:58.388 [rics.repos:DEBUG] Skip repo='astral-sh/.github': no licence.
2025-05-11T09:52:58.749 [rics.repos:DEBUG] Skip repo='astral-sh/archive-in-git-test': no releases.
2025-05-11T09:52:58.750 [rics.repos:DEBUG] Skip repo='astral-sh/pypi-proxy': no licence.
2025-05-11T09:52:58.758 [rics.repos:DEBUG] Skip repo='astral-sh/mypy_primer': no releases.
2025-05-11T09:52:58.770 [rics.repos:DEBUG] Skip repo='astral-sh/nginx_pypi_cache': no releases.
2025-05-11T09:52:58.779 [rics.repos:DEBUG] Skip repo='astral-sh/pubgrub': no releases.
2025-05-11T09:52:58.780 [rics.repos:DEBUG] Skip repo='astral-sh/lsp-types': no releases.
2025-05-11T09:52:58.783 [rics.repos:DEBUG] Skip repo='astral-sh/docs': no releases.
2025-05-11T09:52:59.111 [rics.repos:DEBUG] Skip repo='astral-sh/reqwest-middleware': no releases.
2025-05-11T09:52:59.125 [rics.repos:DEBUG] Skip repo='astral-sh/sanitize-wheel-test': no licence.
2025-05-11T09:52:59.206 [rics.repos:DEBUG] Skip repo='astral-sh/ruff-issue-template-test': no releases.
2025-05-11T09:52:59.513 [rics.repos:DEBUG] Skip repo='astral-sh/trusted-publishing-examples': no licence.
2025-05-11T09:52:59.521 [rics.repos:DEBUG] Skip repo='astral-sh/tl': no releases.
2025-05-11T09:52:59.524 [rics.repos:DEBUG] Skip repo='astral-sh/RustPython': no releases.
2025-05-11T09:52:59.526 [rics.repos:DEBUG] Skip repo='astral-sh/schemastore': no releases.
2025-05-11T09:52:59.527 [rics.repos:DEBUG] Skip repo='astral-sh/RustPython-Parser': no releases.
2025-05-11T09:52:59.566 [rics.repos:DEBUG] Skip repo='astral-sh/uv-docker-example': no licence.
2025-05-11T09:52:59.833 [rics.repos:DEBUG] Skip repo='astral-sh/ty': no releases.
2025-05-11T09:52:59.833 [rics.repos:DEBUG] Skip repo='astral-sh/uv-flask-example': no licence.
2025-05-11T09:52:59.872 [rics.repos:DEBUG] Skip repo='astral-sh/ty-vscode': no releases.
2025-05-11T09:52:59.877 [rics.repos:DEBUG] Skip repo='astral-sh/uv-dynamic-metadata-test': no releases.
2025-05-11T09:52:59.877 [rics.repos:DEBUG] Skip repo='astral-sh/uv-stale-egg-info-test': no licence.
2025-05-11T09:52:59.878 [rics.repos:DEBUG] Skip repo='astral-sh/workspace-in-root-test': no licence.
2025-05-11T09:52:59.878 [rics.repos:DEBUG] Skip repo='astral-sh/workspace-virtual-root-test': no licence.
2025-05-11T09:52:59.878 [rics.repos:DEBUG] Skip repo='astral-sh/workspace-with-root-dependency-test': no licence.
2025-05-11T09:52:59.878 [rics.repos:DEBUG] Skip repo='pallets/.github': no licence.
2025-05-11T09:52:59.882 [rics.repos:DEBUG] Skip repo='astral-sh/transformers': no releases.
2025-05-11T09:52:59.892 [rics.repos:DEBUG] Skip repo='astral-sh/uv-backwards-path-test': no releases.
2025-05-11T09:52:59.909 [rics.repos:DEBUG] Skip repo='astral-sh/uv-aws-lambda-example': no releases.
2025-05-11T09:53:00.085 [rics.repos:DEBUG] Skip repo='astral-sh/uv-fastapi-example': no releases.
2025-05-11T09:53:00.142 [rics.repos:DEBUG] Skip repo='astral-sh/uv-path-dependency-test': no releases.
2025-05-11T09:53:00.195 [rics.repos:DEBUG] Skip repo='pallets/actions': no releases.
2025-05-11T09:53:00.258 [rics.repos:DEBUG] Skip repo='pallets/flask-docs': no releases.
2025-05-11T09:53:00.385 [rics.repos:DEBUG] Skip repo='pallets/flask-sphinx-themes': no releases.
2025-05-11T09:53:00.386 [rics.repos:DEBUG] Skip repo='pallets/website-2016': no licence.
2025-05-11T09:53:00.490 [rics.repos:DEBUG] Skip repo='pallets/werkzeug-website': no licence.
2025-05-11T09:53:00.500 [rics.repos:DEBUG] Skip repo='pallets/flask-website': no releases.
2025-05-11T09:53:01.078 [rics.repos:DEBUG] Skip repo='pallets/website': no releases.
2025-05-11T09:53:01.079 [rics.repos:INFO] Processed 22/60 matching repos in 3.6s.
                                  Release tag            Last push  Stars  Issues                                                   Description                                                  Link       License    Created
Repo name
pallets/flask                           3.1.0 2025-03-30T20:17:35Z  69505       7     The Python micro framework for building web applications.                      https://github.com/pallets/flask  BSD-3-Clause 2010-04-06
astral-sh/uv                            0.7.3 2025-05-11T02:55:59Z  53492    1739  An extremely fast Python package and project manager, writte                       https://github.com/astral-sh/uv    Apache-2.0 2023-10-02
astral-sh/ruff                         0.11.9 2025-05-11T09:40:06Z  38716    1404  An extremely fast Python linter and code formatter, written                      https://github.com/astral-sh/ruff           MIT 2022-08-09
pallets/click                           8.2.0 2025-05-10T22:22:42Z  16338     121              Python composable command line interface toolkit                      https://github.com/pallets/click  BSD-3-Clause 2014-04-24
astral-sh/rye                          0.44.0 2025-05-08T00:28:11Z  14187     332                               a Hassle-Free Python Experience                      https://github.com/astral-sh/rye           MIT 2023-04-22
pallets/jinja                           3.1.6 2025-03-05T20:15:47Z  10830      82                   A very fast and expressive template engine.                      https://github.com/pallets/jinja  BSD-3-Clause 2010-10-17
pallets/werkzeug                        3.1.3 2025-04-18T20:12:06Z   6749      16               The comprehensive WSGI web application library.                   https://github.com/pallets/werkzeug  BSD-3-Clause 2010-10-18
pallets/quart                          0.20.0 2024-12-24T20:19:23Z   3280      54  An async Python micro framework for building web application                      https://github.com/pallets/quart           MIT 2017-11-10
pallets/itsdangerous                    2.2.0 2025-01-14T21:45:38Z   3002       1  Safely pass trusted data to untrusted environments and back.               https://github.com/pallets/itsdangerous  BSD-3-Clause 2011-06-24
astral-sh/python-build-standalone    20250409 2025-05-09T20:19:28Z   2961     129                      Produce redistributable builds of Python  https://github.com/astral-sh/python-build-standalone       MPL-2.0 2018-12-18
astral-sh/ruff-lsp                    v0.0.62 2025-02-10T13:17:59Z   1445      30           A Language Server Protocol implementation for Ruff.                 https://github.com/astral-sh/ruff-lsp   NOASSERTION 2022-12-17
astral-sh/ruff-vscode               2025.22.0 2025-05-06T01:13:01Z   1352      63  A Visual Studio Code extension with support for the Ruff lin              https://github.com/astral-sh/ruff-vscode   NOASSERTION 2022-11-08
astral-sh/ruff-pre-commit             v0.11.9 2025-05-09T16:25:34Z   1273      22                                   A pre-commit hook for Ruff.          https://github.com/astral-sh/ruff-pre-commit    Apache-2.0 2022-09-20
pallets/markupsafe                      3.0.2 2025-01-14T21:45:29Z    654       8              Safely add untrusted strings to HTML/XML markup.                 https://github.com/pallets/markupsafe  BSD-3-Clause 2010-06-22
astral-sh/setup-uv                     v6.0.1 2025-05-09T10:58:05Z    398      12  Set up your GitHub Actions workflow with a specific version                  https://github.com/astral-sh/setup-uv           MIT 2024-08-23
astral-sh/uv-pre-commit                 0.7.3 2025-05-07T20:05:48Z    182      21                                                          None            https://github.com/astral-sh/uv-pre-commit    Apache-2.0 2024-03-22
astral-sh/ruff-action                  v3.3.1 2025-05-11T08:20:30Z    142       7                                   A GitHub Action to run Ruff              https://github.com/astral-sh/ruff-action    Apache-2.0 2024-09-29
astral-sh/packse                       0.3.46 2025-03-27T20:11:10Z    117       9                                    Python packaging scenarios                   https://github.com/astral-sh/packse    Apache-2.0 2023-12-13
pallets/pallets-sphinx-themes           2.3.0 2024-10-24T18:55:28Z     55       1               Sphinx themes for Pallets and related projects.      https://github.com/pallets/pallets-sphinx-themes  BSD-3-Clause 2015-08-07
astral-sh/cargo-dist                  v0.28.5 2025-05-06T20:16:05Z     37      11                             📦 shippable application packaging               https://github.com/astral-sh/cargo-dist    Apache-2.0 2025-04-03
astral-sh/tokio-tar                    v0.5.2 2025-03-18T02:24:44Z     25       3        A tar archive reading/writing library for async Rust.                 https://github.com/astral-sh/tokio-tar    Apache-2.0 2024-12-09
pallets/flask-ext-migrate               1.0.1 2017-07-10T15:39:37Z     23       0               A script for migrating extension import syntax.          https://github.com/pallets/flask-ext-migrate   NOASSERTION 2015-03-23
[ ]: