specs2016

A re-writing of the specs pipeline stage from CMS, only changed quite a bit

"specs" is a command line utility for parsing and re-arranging text input. It allows re-alignment of fields, some format conversion, and re-formatting multiple lines into single lines or vice versa. Input comes from standard input, and output flows to standard output.

This version is liberally based on the CMS Pipelines User's Guide and Reference, especially chapters 16, 24, and 20.

News

10-May-2024: Version 0.9.2 is here What's New:

• An unthreaded mode of operation
• Compound SET statements
• Reduced necessity of quoting complex conditions for if and while
• Bug fixes

29-JAN-2023: Version 0.9.1 is here What's New:

• Allow execution of the output with the --shell or -X command line parameters
• New function pretty
• Usability improvements for functions wordcount, fieldcount.
• Compiler alignment
• Bug fixes

Sources

To download your copy of specs, you can get it from github in either of two ways:

1. Using git: git clone https://github.com/yoavnir/specs2016.git
2. Using http: wget https://github.com/yoavnir/specs2016/archive/dev.zip

Building

If you have downloaded a git repository, first make sure to check out a stable tag such as v0.9:

git checkout v0.9.2

A simple way to get the latest stable release is to check out the stable branch and rebase to its tip:

git checkout stable
git rebase

After that, cd to the specs/src directory, and run the following three commands:

• python setup.py
• make some
• sudo make install

Note: Windows does not need sudo.

Note: On some Mac machines, sudo make install will cause a warning about being the wrong user.

Known Issues

• Regular expression grammars other than the default ECMAScript don't work except on Mac OS.
• On Windows with Python support the appropriate dll (like python38.dll) must be in the path.

Contributing

Anyone can contribute. So far, I have written most of the code, but if you want to help, I'll be very happy. Feel free to:

• Submit bug reports or feature requests at the Issue Tracker.
• Help solve some existing issue.
• Submit pull requests

Contributors

• Yoav Nir (yoavnir)
• Jean-Baptiste Jouband (Gawesomer)

Documentation

The documentation for specs2016 exists in two places:

• In the manpage installed with the utility on Linux and Mac OS.
• In the docs directory.

License

specs2016 is licensed under the MIT License.