consumo 0.1.0

Content consumption analyzer CLI

consumo

Content consumption analyzer CLI

Summary

consumo is a CLI built with Typer that calculates the time to consume some form of content using the Medium formula.

Supported Arguments

consumo is meant to primarily be used with a text file full of URLs, through the list subcommand. Basically, files that look like this:

https://github.com/gbr-ufs/pf
https://github.com/gbr-ufs/cses
https://github.com/gbr-ufs/notes
https://github.com/gbr-ufs/ies
https://github.com/gbr-ufs/hack-ia-mockup
https://github.com/gbr-ufs/probabilidade-detran-se
https://github.com/gbr-ufs/hello-r-markdown

File Types

• audio.
• text.

URLs

consumo supports any kind of URL. YouTube links are treated differently: passing a YouTube link to consumo returns its length.

Usage

consumo file FILE --output FILE --sort

consumo list FILE --output FILE --sort

consumo url TEXT --output FILE --sort

Skills

By developing this project, I demonstrate that I know:

• Git.
• GitHub.
• Markdown.
• Python.

Python

• av.
• bs4.
• pre-commit.
• pydantic.
• pyinstaller.
• pymupdf.
• pytest.
• pytest-cov.
• rich.
• ruff.
• trafilatura.
  • brotli.
  • faust-cchardet.
  • python-zstandard.
• ty.
• typer.
• uv.
• yt-dlp.
• zensical.

Additional Skills

• commitizen.
• Development Containers.
• direnv.
• EditorConfig.
• GitHub Actions.
• MIME Types.
• Nix.

Philosophies

• Dependency Injection.[^1]
• Parse, don't validate.
• Test Driven Development.[^1]

[^1]: Used for the HTML variant of calculate_consumption_time so the URL variant can reuse it. This is done in the video_duration_resolver parameter. [^2]: Beck, K. (2003) Test-driven development: By example. Boston: Addison-Wesley (The Addison-Wesley signature series).