nowfound

Dev tools · January 24, 2013

IW

I wrote a book on idiomatic Python. Here's its insane build/test system

Background: I've been working on a book to help developers learn and write idiomatic Python. It's taken far longer than I imagined, but today I made it available for purchase (http://www.jeffknupp.com/writing-idiomatic-python-ebook). The automated build and test system I'm using is ridiculous. It uses: virtualenv, tox, pytest, coverage, doctest, pandoc, make, xelatex, makeindex, and a ~200 line Python script to collect and format the output. The details of the build/test system I created are described in detail here:…

Alternativestop 20% of January 2013

What it does

In the maker’s words, at launch

Background: I've been working on a book to help developers learn and write idiomatic Python. It's taken far longer than I imagined, but today I made it available for purchase (http://www.jeffknupp.com/writing-idiomatic-python-ebook). The automated build and test system I'm using is ridiculous. It uses: virtualenv, tox, pytest, coverage, doctest, pandoc, make, xelatex, makeindex, and a ~200 line Python script to collect and format the output. The details of the build/test system I created are described in detail here: http://www.jeffknupp.com/blog/2013/01/24/the-writing-idiomatic-python-ebook-is-finally-available/ The result is two PDF files... Does anyone who's done something similar have/know of an easier way to write a technical book (where code samples must be tested) that will eventually need to be translated into multiple formats? I know I'm not the first person to write a technical book, but I'm not aware of any existing tools (commercial or otherwise) to make the process easier. Does everyone who writes a technical book cobble together their own system? I ask because I plan to eventually write a book where C++ is the language being discussed. The thought of going through this all again makes me shudder. After finishing this book, I'm convinced there must be a better way.

Does the same job

all alternatives →
  • IW
    I wrote a book about Python2021 · pragprog.com · ▲181
  • IW
    I wrote a book on Python regular expressions2019 · ▲193

    My book titled "Python re(gex)?" is free to download through this weekend [1][2] The book covers both 're' and 'regex' modules, has plenty of examples and chapters also have cheatsheets and exercises. Code snippets, exercises, sample chapters, etc are available on GitHub repo [3] I used pandoc+xelatex [4] to generate the pdf. [1] https://gumroad.com/l/py_regex [2] https://leanpub.com/py_regex [3] https://github.com/learnbyexample/py_regular_expressions [4]…

  • HT
    How to make your Python code more idiomatic – 25 tips and tricks2018 · github.com · ▲56
  • PP
    Practical Python Projects book release2021 · practicalpython.yasoob.me · ▲88

    Hi everyone! I just released the Practical Python Projects book! (https://practicalpython.yasoob.me) I am happy to announce the first version as a release candidate. I have poured a lot of love into writing this book and would love to hear what you guys think. (A limited 100% off and discount coupons at the end) This is not a pure beginner book. The book does assume some background Python knowledge. You need to know the basics like methods, functions, classes, and such. If I use something that is not typically covered in beginner Python books, I will explain it before I use it.…

  • LP
    Learn Python the Right Way – free introduction to Python book2021 · learnpythontherightway.com · ▲245
  • HP
    Hello Python, my book about learning python, has just been released2012 · manning.com · ▲46

More dev tools this month

the category →
  • Dograh▲592

    The open source VAPI alternative

    Dev tools · 25d ago · dograh.com

  • Meridian▲530

    Don't let your work go unnoticed. Get promoted!

    Dev tools · 20d ago · meridiona.com

  • x1▲516

    Lovable for iPhone apps go from idea to App Store

    Dev tools · 11d ago · x1.new

  • The GTM Co-Founder▲402

    Open-source GTM skills for technical founders

    Dev tools · 29d ago · gtmcofounder.com

  • Open-Source eInk Bike Computer▲389

    OpenTrailPaper is open-source bike computer firmware for the LilyGO T5S3 4.7" E-Paper PRO. It supports offline maps, GPX routes, FIT recording and Bluetooth sensors.

    Dev tools · 1d ago · opentrailpaper.com

  • Nuphos▲380

    The AI-Native DevOps Workspace.

    Dev tools · 24d ago · nuphos.ai

Launched alongside, January 2013

the whole month →