Metadata-Version: 1.1
Name: toJiraTable
Version: 1.0
Summary: A tool which reads input from stdin and converts it to a JIRA table
Home-page: https://github.com/kata198/toJiraTable
Author: Tim Savannah
Author-email: kata198@gmail.com
License: GPLv3
Description: toJiraTable
        ===========
        
        Reads input from stdin and converts it to a JIRA table.
        
        
        The first line it reads is used as the table header, and all subsequent lines are made into the body. Supports shell-style splitting of fields (you can use quotes to "group" items with spaces into a single field).
        
        
        By default, it will split by whitespace, so each word becomes an item. The entire table, by default, will grow to the longest row, and fill in blanks where needed.
        
        
        If you need to split by an alternative thing, such as two-spaces (if columns are seperated by two-or-more spaces, and contain characters with spaces between) there are various \-\-split\-by options available, see usage below. See usage and examples for more information.
        
        
        **Usage:**
        
        
        	Usage: toJiraTable
        
        	Converts stdin to a JIRA table. If no arguments provided, it will use "shell-style" splitting
        
        		so quoting strings with spaces makes them a single column, otherwise spaces/tabs/whatever
        
        		splits. The first line passed in becomes the header, the remainder become the body.
        
        
        	By default, everything will be matched to the longest row. Any missing columns in a row will
        
        		be filled by blank columns at the end. Use --no-stretch to disable this.
        
        
        		Arguments:
        
        
        			--no-stretch                -  Do not stretch each row to the longest row. See above.
        
        			--split-header-by=X         -  Instead of using shell-style splitting, split by provided string for the header line
        
        			--split-body-by=X           -  Instead of using shell-style splitting, split by the provided string for body lines
        
        			--split-by=X                -  Split both header and body by the given string
        
        			--split-keep-empty          -  By default, using the --split-by* will strip empty columns. The default behaviour is 
        
        										 useful, in example: if a script outputs strings which are not quoted, but has at least two
        
        										 spaces between each real column, using --split-body-by='  '  will ensure that any place that 
        
        										 is separated by two or more spaces becomes a column. This option disables that feature.
        
        
        
        **Example Usage:**
        
        
        *Simple split:*
        
        
        	[myuser]$ ( echo 'Hostname "Free Space"'; cat hostnames.txt ) | toJiraTable 
        
        	||Hostname||Free Space||
        
        	|host1|500G|
        
        	|wwwprod1|120G|
        
        	|wwwdev1|11G|
        
        
        *More complicated split. In this case, we want the body to form columns any time there are at least two spaces:*
        
        
        (dataset)
        
        
        	[myuser]$ cat myData
        
        	Name Size Comment
        
        	George Jetson  500G    The man from the future
        
        	Jeeves  200M           Everyone's favourite butlet
        
        
        (convert to JIRA table)
        
        
        	[myuser]$ cat myData | ./toJiraTable --split-body-by="  "
        
        	||Name||Size||Comment||
        
        	|George Jetson|500G|The man from the future|
        
        	|Jeeves|200M|Everyone's favourite butlet|
        
        
        
        *Tab-deliminated split:*
        
        
        (dataset):
        
        	[myuser]$ python -c "import sys; sys.stdout.write(repr(open('myData', 'rt').read()).replace('\\\\n', '\\n') + '\n');"
        
        	"Name\tSize\tComment
        
        	George Jetson\t500G\tThe man from the future
        
        	Jeeves\t200M\tEveryone's favourite butlet
        
        	"
        
        
        (convert to JIRA table)
        
        	[myuser]$ cat myData | ./toJiraTable --split-by='\t'
        
        	||Name||Size||Comment||
        
        	|George Jetson|500G|The man from the future|
        
        	|Jeeves|200M|Everyone's favourite butlet|
        
        
        
Keywords: JIRA,table,to,toJiraTable,convert,string,stdin,input,header,body
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Programming Language :: Python
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Topic :: Internet :: WWW/HTTP
