#361 Proper way to comment your code!

Topics covered in this episode:

• The many shapes and sizes of keyboards
• appeal - a CLI framework from Larry Hastings
• Graphinate: Data to Graphs
• A Disorganized List of Maintainer Tasks
• Extras
• Joke

Watch on YouTube

About the show

Sponsored by Scout APM

Connect with the hosts

• Michael: @mkennedy@fosstodon.org
• Brian: @brianokken@fosstodon.org
• Show: @pythonbytes@fosstodon.org

Join us on YouTube at pythonbytes.fm/live to be part of the audience. Usually Tuesdays at 11am PT. Older video versions available there too.

Michael #1: The many shapes and sizes of keyboards

• Many keyboards discussed
• Focus on health and safety (as it should!)
• I swear by Microsoft Sculpt Ergonomic (which wasn’t mentioned)
• More options still over at Wire Cutter

Brian #2: appeal - a CLI framework from Larry Hastings

• “Give your program APPEAL!”
• Appeal is a command-line argument processing library for Python, like argparse, optparse, getopt, docopt, Typer, and click. But Appeal takes a refreshing new approach.

• Hello World example:

  import appeal app = appeal.Appeal() @app.command() def hello(name): print(f"Hello, {name}!") app.main()

• looks fun, no idea how to test with it “yet”.

  • But I plan on looking into that.

Michael #3: Graphinate: Data to Graphs

• via Eran Rivlis
• Graphinate is a python library that aims to simplify the generation of Graph Data Structures from Data Sources.
• Write a function to definite the edges as a generator, call materialize
• Based on NetworkX
• See the github page for visual examples

Brian #4: A Disorganized List of Maintainer Tasks

• David Lord
  • Plus, David Lord, lead maintainer of Flask, Jinja, Click, … on Pallets, also PSF Fellow, has a blog. Neat.
• TLDR; Next time you want to ask "When's the next release?", instead look at the project and see where you can start getting involved. The more help maintainers have, the more they can get done.
• Long list of stuff David thinks about when maintaining a project.
  • My list is shorter, but it’s still long, and my projects are tiny in comparison to his

Extras

Brian:

• Do you do enough testing? pytest to the Rescue! webinar from this morning
• The Complete pytest Course will be 16 chapters, 11 are released, the 12th is recorded and almost released, and the 13th should be next week, … I should be done with all 16 by the end of the year.
• Testing argparse Applications
  • Python Test Podcast episode 109: Testing argparse Applications
  • Blog post on pythontest.com: Testing argparse Applications
• Black Friday sale on The Complete pytest Course
  • Use code BLACKFRIDAY for 50% off of
  • The Complete pytest Course, Full Course + Full Access

Michael:

• It’s Black Friday at Talk Python
• Python 3.13.0 alpha 1 is now available
• Python Developers Survey 2023

Joke: The proper way to comment your code!