Metadata-Version: 2.0
Name: pylpconcat
Version: 0.1.0
Summary: Concatenation plugin for Pylp
Home-page: https://github.com/pylp/pylpconcat
Author: Guillaume Gonnet
Author-email: gonnet.guillaume97@gmail.com
License: MIT
Keywords: pylp gulp concat
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Topic :: Utilities
Classifier: Topic :: Software Development :: Build Tools
Classifier: Framework :: AsyncIO
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.5
Classifier: Intended Audience :: Developers
Classifier: Natural Language :: English
Classifier: License :: OSI Approved :: MIT License

==========
PylpConcat
==========


Information
===========

| **pylpconcat** is a plugin for `Pylp`_ that can concatenate file contents.
|
| **Note**: due to Pylp's asynchronous piping system, the order of the files concatenated
  is undefined. This will be fix in the next version.


Installation
============

Install **pylpconcat** with ``pip``::

    pip install pylpconcat

If you don't have Python ``Scripts`` folder in your PATH, you can run also::

    python -m pip install pylpconcat


Usage
=====

The usual use of **pylpconcat** is as follows:

.. code:: python

    import pylp
    from pylpconcat import concat

    pylp.task('scripts', lambda:
        pylp.src('lib/*.js')
          .pipe(concat('all.js'))
          .pipe(pylp.dest('dist'))
    )

Moreover, you can specify the separator to add between files:

.. code:: python

    import pylp
    from pylpconcat import concat

    pylp.task('scripts', lambda:
        pylp.src('lib/*.js')
          .pipe(concat('all.js', sep=';'))
          .pipe(pylp.dest('dist'))
    )


.. _Pylp: https://github.com/pylp/pylp

