https://github.com/mike10004/concatenate-maven-plugin

Maven plugin that concatenates files.
https://github.com/mike10004/concatenate-maven-plugin

Last synced: 11 days ago
JSON representation

Maven plugin that concatenates files.

• Host: GitHub
• URL: https://github.com/mike10004/concatenate-maven-plugin
• Owner: mike10004
• License: apache-2.0
• Created: 2017-01-31T20:06:54.000Z (almost 8 years ago)
• Default Branch: master
• Last Pushed: 2021-03-31T20:46:26.000Z (almost 4 years ago)
• Last Synced: 2024-10-27T16:49:18.681Z (2 months ago)
• Language: Java
• Size: 99.6 KB
• Stars: 1
• Watchers: 2
• Forks: 1
• Open Issues: 5
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
[![Travis build status](https://travis-ci.org/mike10004/concatenate-maven-plugin.svg?branch=master)](https://travis-ci.org/mike10004/concatenate-maven-plugin)

[![AppVeyor build status](https://ci.appveyor.com/api/projects/status/ivrio01k770ctkxb?svg=true)](https://ci.appveyor.com/project/mike10004/concatenate-maven-plugin)

[![Maven Central](https://img.shields.io/maven-central/v/com.github.mike10004/concatenate-maven-plugin.svg)](https://repo1.maven.org/maven2/com/github/mike10004/concatenate-maven-plugin/)

concatentate-maven-plugin

=========================

Maven plugin that concatenates files. The current implementation is extremely

simple and does not allow for much configuration.

Basic Usage

-----------

Basic usage is like this:

    

        com.github.mike10004

        concatenate-maven-plugin

        0.4

        

            

                concatenate-css-files

                prepare-package 

                

                    cat

                

                

                    

                        

                            ${project.basedir}/src/main/parts

                            strict

                            none 

                            

                                head.txt

                                body*.txt

                                tail.txt

                            

                        

                    

                    ${project.build.outputDirectory}/concatenated-parts.txt

                

            

        

    

This produces a file named `target/classes/concatentated-parts.txt` that 

consists of the concatenated content of the files identified in the ``

section of the sources fileset.

Note that without `strict`, you wind up 

with the source files in (what I think is) whatever order the filesystem lists 

them on a call to `java.io.File.list()`. Depending on your use case, this may 

be okay, and you can get a performance benefit out of omitting the ordering 

strategy parameter.

The other option for `` is `alphabetical`, and it overrides the `strict`

ordering. Alphabetical sorting, if specified, is applied after the includes 

have been collected, and the files are sorted by the pathname that starts with

the ``.

Why you might want this

-----------------------

There are a few plugins for concatenating and optimizing resource files, but

none are dead simple. Most want to tool around in your classpath or obfuscate

and compress the output. If you're always on Linux with Bash and you know the

names of your files ahead of time, you can use `exec-maven-plugin' and `cat` 

everything to wherever you want it. But if you need build-time file selection

and cross-platform compatibility, this plugin might help you.

Running tests

-------------

To execute the tests in the projects in the `tests` folder, the full Maven 

lifecycle up to the `test` phase must execute. The plugin is executed during

the `process-test-resources` phase and the output is evaluated in the `test`

phase. (Therefore, running the tests as unit tests in an IDE may fail if the

IDE does not execute the preceding build phases.)

Deployment

----------

Run 

    $ mvn deploy

from the `concatenate-maven-plugin` child module directory instead of this

parent directory.