Autodocumenting Makefiles

This page summarizes the projects mentioned and recommended in the original post on news.ycombinator.com

Our great sponsors
  • InfluxDB - Power Real-Time Data Analytics at Scale
  • WorkOS - The modern identity platform for B2B SaaS
  • SaaSHub - Software Alternatives and Reviews
  • dvc

    🦉 ML Experiments and Data Management with Git

  • For data science specifically, I would strongly suggest looking into DVC: https://dvc.org/.

    You can easily write DVC stage files by hand as a straightforward Makefile replacement, and integrate other features into your workflow as needed/desired.

  • just

    🤖 Just a command runner

  • If you're using Make as a command runner or a "standard entry point" to a project, instead of a build system that tracks dependencies between files, I highly recommend using `just` instead: https://github.com/casey/just

    It has this functionality built-in, and avoids a lot of Make's idiosyncrasies. (Not affiliated, just a fan.)

  • InfluxDB

    Power Real-Time Data Analytics at Scale. Get real-time insights from all types of time series data with InfluxDB. Ingest, query, and analyze billions of data points in real-time with unbounded cardinality.

    InfluxDB logo
  • makefiles

    Collection of Makefiles

  • Example: https://github.com/denibertovic/makefiles/blob/master/bare.m...

  • MakefileViz

    graphical representation of makefile targets and their dependencies

  • or stick to the most basic functionality it may be of use as a way to visualize the execution graph (DAG)

    https://github.com/TomConlin/MakefileViz

  • docker_makefiles

    Docker Makefiles

  • I have approached the problem in a similar way, but without python.

    I published my self-documenting docker Makefiles here:

    https://github.com/Infused-Insight/docker_makefiles

  • jobflow

    runs stuff in parallel (like GNU parallel, but much faster and memory-efficient)

  • Another part I think might be parallel execution, running multiple shells at the same time

    https://github.com/rofl0r/jobflow

  • yplatform

    Self-service bootstrap/build/CI/CD. Software and configuration that supports various cycles of software development.

  • This is exactly my experience which lead me to create https://github.com/ysoftwareab/yplatform - with a consistent make interface https://github.com/ysoftwareab/yplatform/tree/master/build.m...

    PS: quite feature complete but not yet well marketed so to speak. I'm actually recording an asciinema session this week in order for a visitor to grasp quicker the mentioned benefits.

  • WorkOS

    The modern identity platform for B2B SaaS. The APIs are flexible and easy-to-use, supporting authentication, user identity, and complex enterprise features like SSO and SCIM provisioning.

    WorkOS logo
NOTE: The number of mentions on this list indicates mentions on common posts plus user suggested alternatives. Hence, a higher number means a more popular project.

Suggest a related project

Related posts