sloria

The Best of the Best Practices (BOBP) Guide for Python

A "Best of the Best Practices" (BOBP) guide to developing in Python.

In General

Values

• "Build tools for others that you want to be built for you." - Kenneth Reitz
• "Simplicity is alway better than functionality." - Pieter Hintjens

scottopell

Port forwarding should be fairly straightforward, but what Arris doesn't tell you is that you need to have the firewall on in order for port forwarding settings to have an effect.

I don't know why the "firewall off" option would mean "block everything", but as best I can tell, that was the case on my Arris DG2470A (from RCN, could be some custom firmware that RCN uses?)

So step by step:

noamtamim

How to use PlantUML with Markdown

PlantUML is a really awesome way to create diagrams by writing code instead of drawing and dragging visual elements. Markdown is a really nice documentation tool.

Here's how I combine the two, to create docs with embedded diagrams.

Step 0: Setup

Get the command-line PlantUML from the download page or your relevant package manager.

mihai-dinculescu

// build.rs

use embuild::build::LinkArgs;

fn main() -> anyhow::Result<()> {
    // Necessary because of this issue: https://github.com/rust-lang/cargo/issues/9641
    LinkArgs::output_propagated("ESP_IDF")?;

    Ok(())
}