Code Monkey home page Code Monkey logo

easy-pdf-merge's Introduction

easy-pdf-merge

easy-pdf-merge is a node module to merge multiple PDFs into a single PDF easily. This module uses Apache PDFBox Library 2.0.1. No special softwares are required for the module to run. But Java 6 or higher must be present.

Currently only callback style is supported. That is only Async functions are supported.

Usage :

var merge = require('easy-pdf-merge');

merge(source_files,dest_file_path,function(err){

        if(err)
        return console.log(err);

        console.log('Success');

});

source_files must be an array of file paths, with two or more file paths, or the module throws an error accordingly. dest_file path is the destination path for the merged PDF to be saved.

For all files, it is recommended to give absolute paths to avoid possible path based problems in your code. Or, give paths relative to process.cwd(); , which is the current working directory of the process. But be careful when giving relative paths, to avoid bugs.

Example

Using relative file paths

merge(['File One.pdf','File Two.pdf'],'File Ouput.pdf',function(err){

        if(err)
        return console.log(err);

        console.log('Successfully merged!');

});

Using absolute file paths

merge(['/home/karuppiah/File One.pdf','/home/karuppiah/File Two.pdf'],'/home/karuppiah/Desktop/File Ouput.pdf',function(err){

        if(err)
        return console.log(err);

        console.log('Successfully merged!');

});

An App based on easy-pdf-merge!

PDF Merger is a cross platform Desktop App being developed using Electron Framework and easy-pdf-merge module. You can find the source code of the App here.

Coming Soon :

  1. Module will check if source files exist and return appropriate error.
  2. Merge PDFs showing the progess percentage - useful while there are lots of PDFs to be merged. But this feature would mean that - callback will be called more than once. But there will be status codes to ensure the end of calling callbacks.

Reporting Issues and Feature Requests

For reporting issues and for feature requests, go to the github issues page of the module

License - Apache License 2.0

Copyright 2016 Karuppiah N

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

easy-pdf-merge's People

Contributors

karuppiah7890 avatar

Watchers

James Cloos avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.