Skip to main content

Flexible YAML loader.

Project description

Flexy – Flexible YAML Loader

Flexy provides lightweight and flexible YAML configs to applications.

Flexy is listed on PyPI.

I created this library in the despair of the fact that YAML's powerful features (explicit typing, anchors, aliases, etc.) are in fact of little use to me, as well as in the belief that simple is better than complex.

Hope it makes your life easier too.

Lightweight

Flexy ONLY supports Python built-in types: dict, list, str, int, float, bool. Flexy also guarantees that only these types are returned.

Flexible: file inclusion

Flexy supports non-intrusive file inclusion. Including entries are written in a special format in comments, very similar to C/C++ header inclusion.

conf: value
...
#include <parallel-conf.yaml>
#include <../another-config.yaml>
#include <~/.config/conf-in-my-home.yml>
#include </absolute/path/to/config.yml>
...

Inclusions are expanded as semantic-blind plain texts before sending them to YAML parser.

Flexible: variable substitutions

Flexy supports variable substitution with the great power of revo (PyPI).

Emacs yaml-mode hacks

Sample configs: contrib/yaml-mode-hack.el

(require 'yaml-mode)

(defun yaml-extra-highlights ()
  (font-lock-add-keywords 'yaml-mode
   '(;; included files
     ("^\\s-*\\(#\\s-*include\\)\\s-+\\(<[^>]*>\\)"
      (1 font-lock-preprocessor-face prepend)
      (2 font-lock-doc-face prepend))
     ;; variable dollar sign
     ("\\(\\$\\)(" 1 font-lock-keyword-face prepend)
     ;; variable name
     ("\\$(\\([^)$]+\\))" 1 font-lock-function-name-face prepend))))

(add-hook 'yaml-mode-hook 'yaml-extra-highlights)

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

flexy-0.1.1-py3-none-any.whl (3.5 kB view details)

Uploaded Python 3

File details

Details for the file flexy-0.1.1-py3-none-any.whl.

File metadata

  • Download URL: flexy-0.1.1-py3-none-any.whl
  • Upload date:
  • Size: 3.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.8.10

File hashes

Hashes for flexy-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 5bf40d1cc703a2c8568ca4123082b80283e2c18fe144f60e98edab756a18f1b3
MD5 93279411b9fc21bc0c366f971bb50155
BLAKE2b-256 5e97a634ce6762a565e1b38060aafc5d2802a03ffe90ca760f0b966af7b3043b

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page