toml
cli-guidelines
Our great sponsors
toml | cli-guidelines | |
---|---|---|
45 | 47 | |
19,134 | 2,777 | |
0.6% | 2.7% | |
4.3 | 3.6 | |
10 days ago | 24 days ago | |
Python | CSS | |
MIT License | Creative Commons Attribution Share Alike 4.0 |
Stars - the number of stars that a project has on GitHub. Growth - month over month growth in stars.
Activity is a relative number indicating how actively a project is being developed. Recent commits have higher weight than older ones.
For example, an activity of 9.0 indicates that a project is amongst the top 10% of the most actively developed projects that we are tracking.
toml
-
Let's meet Black: Python Code Formatting
Black uses by default the pyproject.toml file. This file contains a section for each different tool we want to use. The use of a configuration file like pyproject.toml is quite a good choice and helps the contributors to use the same tools and configurations you're using.
-
Why the fuck are we templating YAML? (2019)
> I don't think even though TOML has some official spec
Read it on https://toml.io/ (Full spec on upper-right… with its evolutions up to final 1.00 version).
-
'Hypermodernize' your Python Package
ini2toml which automatically translates .ini/.cfg files into TOML
-
An INI Critique of TOML
toml 1.1 will allow non-ascii in keys (and multi-line inline tables)
See https://github.com/toml-lang/toml/blob/main/CHANGELOG.md
- What Is Wrong with TOML?
- TOML: Tom's Obvious Minimal Language
-
What do ya'll think of TOML's - Support almost all programming language popularized today.
GitHub - toml-lang/toml: Tom's Obvious, Minimal Language
-
`toml` vs `toml_edit` (ie `toml` 0.6 is out)
See https://github.com/toml-lang/toml/blob/main/CHANGELOG.md
-
The YAML Document from Hell
> I still think it's the best format out there.
What do you think of https://toml.io ?
-
7 Python 3.11 new features 🤩
TOML built-in support
cli-guidelines
- Ask HN: Where to read about terminal UIs?
-
Ask HN: Do you read Secrets from Environment Variables
The Command Line Interface Guidelines [1] says:
> Do not read secrets from environment variables
> Secrets should only be accepted via credential files, pipes, `AF_UNIX` sockets, secret management services, or another IPC mechanism
Which one of these do you use? On github it seems common for projects to use environment variables for secrets.
[1] https://clig.dev/#environment-variables
-
Command Line Interface Guidelines
Seems they took a small step back from their previous "don't bother with man pages" stance. Now it's "Consider providing man pages."
I still find it a rather shocking order of priority, honestly.
-
Ask HN: Best way to do scoped commands in a CLI app
- E. `blah project foo --edit`
Wondering if there was any guidance on this from the UNIX people. Perhaps scoping should be done using the file system. `cd path/to/project && blah edit`. Like git does with `git --cwd=path/to/project`. Maybe a virtual FS could even be used. Then you wouldn't have to continuously type in the scope with each command. Interesting thinking about how to maintain state in the terminal...thinking about how Python's virtual env bin/activate modifies the shell.
Found an interesting guide here: https://clig.dev/
-
CLI user experience case study
Capturing these guidelines is one of the primary reasons that https://clig.dev/ exists.
-
Introducing my Password Manager project - Seeking Feedback and Contributions
You may want to take a look at various existing CLIs to get inspiration on how they operate, the user feedback loop and the ergonomics on using them. Here is a great website on some CLI structing guidance https://clig.dev/
What are some alternatives?
tomli - A lil' TOML parser
redox - Mirror of https://gitlab.redox-os.org/redox-os/redox
json5 - JSON5 — JSON for Humans
nodejs-cli-apps-best-practices - The largest Node.js CLI Apps best practices list ✨
starship - ☄🌌️ The minimal, blazing-fast, and infinitely customizable prompt for any shell!
bubblewrap - Low-level unprivileged sandboxing tool used by Flatpak and similar projects
dhall - Maintainable configuration files
typer - Typer, build great CLIs. Easy to code. Based on Python type hints.
docker-selenium - Provides a simple way to run Selenium Grid with Chrome, Firefox, and Edge using Docker, making it easier to perform browser automation
cligen - Nim library to infer/generate command-line-interfaces / option / argument parsing; Docs at
tomlplusplus - Header-only TOML config file parser and serializer for C++17.
argparse-benchmarks-rs - Collected benchmarks for arg parsing crates written in Rust [Moved to: https://github.com/rosetta-rs/argparse-rosetta-rs]