<commit_before>Jenkins Job Wrecker
-------------------

.. image:: https://travis-ci.org/ktdreyer/jenkins-job-wrecker.svg?branch=master
       :target: https://travis-ci.org/ktdreyer/jenkins-job-wrecker

Translate Jenkins XML jobs to YAML. The YAML can then be fed into Jenkins Job
Builder.

Have a lot of Jenkins jobs that were crafted by hand over the years? This tool
allows you to convert your Jenkins jobs to JJB quickly and accurately.

Installing
----------

The module is not yet on pypi, so just install it directly from GitHub::

     virtualenv venv
     git clone https://github.com/ktdreyer/jenkins-job-wrecker.git
     python setup.py develop

You will now have a ``jjwrecker`` utility in your ``$PATH``.

Usage
-----

Let's say you have an XML definition file for "my-job". Here's how you convert
that to YAML::

     jjwrecker -f path/to/my-job/config.xml -n 'my-job'

This will write ``my-job.yml`` in a directory named "``output``" in your
current working directory. You can then commit ``my-job.yml`` into your source
control and use JJB to manage the Jenkins job onward.

In addition to operating on static XML files, jjwrecker also supports querying
a live Jenkins server dynamically for a given job::

     jjwrecker -s http://jenkins.example.com/ -n 'my-job'

It will write ``output/my-job.yml`` as above.

To make jjwrecker translate every job on the server, don't specify any job
name::

     jjwrecker -s http://jenkins.example.com/

jjwrecker will iterate through all the jobs and write as ``.yml`` files in
``output/``.


License
-------
MIT (see ``LICENSE``)

Copyright (c) 2015 Red Hat, Inc.<commit_msg>README: fix grammer in "Usage"<commit_after>Jenkins Job Wrecker
-------------------

.. image:: https://travis-ci.org/ktdreyer/jenkins-job-wrecker.svg?branch=master
       :target: https://travis-ci.org/ktdreyer/jenkins-job-wrecker

Translate Jenkins XML jobs to YAML. The YAML can then be fed into Jenkins Job
Builder.

Have a lot of Jenkins jobs that were crafted by hand over the years? This tool
allows you to convert your Jenkins jobs to JJB quickly and accurately.

Installing
----------

The module is not yet on pypi, so just install it directly from GitHub::

     virtualenv venv
     git clone https://github.com/ktdreyer/jenkins-job-wrecker.git
     python setup.py develop

You will now have a ``jjwrecker`` utility in your ``$PATH``.

Usage
-----

Let's say you have an XML definition file for "my-job". Here's how you convert
that to YAML::

     jjwrecker -f path/to/my-job/config.xml -n 'my-job'

This will write ``my-job.yml`` in a directory named "``output``" in your
current working directory. You can then commit ``my-job.yml`` into your source
control and use JJB to manage the Jenkins job onward.

In addition to operating on static XML files, jjwrecker also supports querying
a live Jenkins server dynamically for a given job::

     jjwrecker -s http://jenkins.example.com/ -n 'my-job'

It will write ``output/my-job.yml`` as above.

To make jjwrecker translate every job on the server, don't specify any job
name::

     jjwrecker -s http://jenkins.example.com/

jjwrecker will iterate through all the jobs and create ``.yml`` files in
``output/``.


License
-------
MIT (see ``LICENSE``)

Copyright (c) 2015 Red Hat, Inc.
{'fraction_non_alphanumeric': 0.11673270344407193, 'fraction_numerical': 0.0024382810118866198, 'mean_word_length': 3.2512953367875648, 'pattern_counts': {'":': 0, '<': 3, '<?xml version=': 0, '>': 3, 'https://': 6, 'lorem ipsum': 0, 'www.': 0, 'xml': 2}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '2160973', 'n_tokens_mistral': 1078, 'n_tokens_neox': 1005, 'n_words': 426}