# gulp-mswebdeploy-package

> Create Microsoft(TM) web deploy packages with grunt on any platform

Latest version **0.1.5** (published 2016-08-23) · MIT license · 0 weekly downloads

## Install

```sh
npm install gulp-mswebdeploy-package
pnpm add gulp-mswebdeploy-package
yarn add gulp-mswebdeploy-package
bun add gulp-mswebdeploy-package
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support; pre 1.0.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 0.1.5 |
| Published | 2016-08-23 |
| First published | 2016-01-18 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Node | >=0.10.0 |
| Dependencies | 7 |
| Known vulnerabilities | 0 (+5 in 1 direct dependencies) |
| Install scripts | no |
| GitHub stars | 2 |
| Author | NOAH HAMBAYI |
| Maintainers | nhambayi |
| Keywords | gulpplugin |

## Links

- npm: https://www.npmjs.com/package/gulp-mswebdeploy-package
- Repository: https://github.com/alphio/gulp-mswebdeploy-package
- Issues: https://github.com/alphio/gulp-mswebdeploy-package/issues
- npm.io page: https://npm.io/package/gulp-mswebdeploy-package

## Dependencies (7)

- [colors](https://npm.io/package/colors.md) ^1.1.2
- [lodash](https://npm.io/package/lodash.md) ^3.10.1
- [mkdirp](https://npm.io/package/mkdirp.md) ^0.5.1
- [archiver](https://npm.io/package/archiver.md) ^0.21.0
- [through2](https://npm.io/package/through2.md) ^0.6.3
- [gulp-util](https://npm.io/package/gulp-util.md) ^3.0.1
- [xmlbuilder](https://npm.io/package/xmlbuilder.md) ^4.2.0

## Recent versions

- 0.1.5 (latest) — 2016-08-23
- 0.1.4 — 2016-07-19
- 0.1.3 — 2016-01-22
- 0.1.2 — 2016-01-18
- 0.1.1 — 2016-01-18
- 0.1.0 — 2016-01-18

## README

# gulp-mswebdeploy-package

> Create Microsoft(TM) Web Deploy Packages With Gulp on Any Platform

## Introduction
gulp-mswebdeploy-package allows you to bundle you site file into a Microsoft(TM) compatible web deploy file that can be used to publish to IIS. It is useful for creating build for JavaScript \ HTML project that are built and publish with Visual Studio Online, Visual Studio Team Services, TFS or and system that supports Web Deploy. Please note this package DOES NOT DO THE ACTUAL DEPLOYMENT it simply creates the package.

## Getting Started


```shell
npm install gulp-mswebdeploy-package --save-dev
```


## Using the "mswebdeploy" task

```js

    var mswebdeploy = require('gulp-mswebdeploy');
    
    gulp.task('package', function(){
        gulp.src('app/')
        .pipe( mswebdeploy({ 'source' : 'app', "dest" : "deploy" }) )
        .pipe( gulp.dest('/deploy') );
    });

```


This sample creates a web deploy package using the files in 'app' in a folder called 'deploy' in a package named 'webdeploy.zip' The folder structure of the source folder will be maintained in the package. There is currently no way to add individual files.


## Using the "mswebdeploy" task with parameters

```js

gulp.task('webdeploypackage', ['build'], function() {

    gulp.src('app/')
        .pipe(mswebdeploy({
            'source': 'app',
            "dest": "webdeploy",
            'parameters': [
                {
                    'parameter': {
                        '@name': 'ApiUrl',
                        '@description': 'Base URL for API',
                        'parameterEntry': {
                            '@type': 'TextFile',
                            '@scope': 'app\\\\app.constants.js',
                            '@match': 'http://localhost:9000/api'
                        }
                    }
                }
            ]
        }))
        .pipe(gulp.dest('/deploy'));
});


```

This sample is similar to above, but also defines a web deploy parameter called 'ApiUrl' whose value will be injected into the `app\app.constants.js` file. See https://technet.microsoft.com/en-us/library/dd569084(WS.10).aspx for more details on Web Deploy parameters.

## Contributing
In lieu of a formal styleguide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality. Lint and test your code using [Mocha](https://mochajs.org/).

## Release History
0.1.0 : Beta Release  
0.1.2 : Updated docs  
0.1.3 : Updated package.json  
0.1.4 : Code clean up and refactoring
0.1.5 : Added support for parameters in the Web Deploy package  

# gulp-mswebdeploy-package

---
_Source: https://npm.io/package/gulp-mswebdeploy-package · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
