Skip to content

peterkmurphy/isityaml

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

17 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Is it YAML?

About

"Is it YAML?" is a Django application for checking whether text is YAML ("a human friendly data serialization standard for all programming languages"), or not. Users type and/or copy and paste text and clicks the "Submit" button above. If valid YAML has been entered, the input is presented in canonical form. If not, the application presents an error message.

YAML is just a text format for exchanging data. It exists for cases where XML is too much overhead. I like YAML. I find it more robust in practice than XML (where one missing angle bracket could corrupt a whole file), yet easier to type by hand.

I conjured up "Is it YAML?" while writing a specification for YPath - a language for addressing parts of a YAML document, as XPath does for XML. To do a proper job of things, I had to write YAML example files. However, I sometimes needed to check if the example files are good and proper. "Is it YAML?" gave me a test bed where I can copy-and-paste my examples, and see if they really are YAML.

Installation and Dependencies

Apart from Django, the app depends on PyYAML, a Python parser for YAML. You can get the application from PyPI through the command:

pip install isityaml

Once installed, just add "isityaml" to your INSTALLED_APPS list in settings.py, and add the desired URL in one of the urls.py files.

The HTML template file used to generate HTML has been redesigned to work with the Mezzanine CMS. The redesign removed any explicit references to particular stylesheets found with earlier versions. Feel free to customise: the app is released under a 3 clause BSD license. See LICENSE.txt for more information. If you wish to do any changes, pop over to the GitHub repository for the app.

History

  • 0.1 (August 30th 2011) - Create setup script for files.
  • 0.2 (April 25th 2013) - Try to make a half-decent PyPI package.
  • 0.3 (January 30th 2014) - Updated to be compatible with Django 1.6 and Mezzanine 3.0.
  • 0.4 (February 15th 2014) - Added more error handling and styling to be compatible with Bootstrap.
  • 0.5 (August 13th 2014) - Making error handling more generous.
  • 0.6 (February 28th 2017) - Updated to be compatible with Django 1.10.
  • 0.7 (December 6th 2020) - Run through 2to3 for Python 3 changes.

Copyright

The isityaml app is copyright (c) 2008-2020 Peter Murphy <[email protected]>.

About

A Django app for checking files if they are YAML

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published