The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

narada-new-1 - creates a skeleton project based on Narada framework v1.x

VERSION

This document describes narada-new-1 version v2.3.4

USAGE

    narada-new-1 [/path/to/project]

DESCRIPTION

WARNING: This script shouldn't be used for new projects, use narada-new instead. This script provided only for testing compatibility with Narada v1.x projects.

This script help you create skeleton project directory for using Narada framework.

Target directory shouldn't exists or must be empty.

If target directory doesn't exists - it will be created (parent directory must exists).

If executed without param will create skeleton project in current directory, which must be empty.

Target directory become "project root directory", and all other `narada-*` scripts must be executed in this directory.

INITIAL SETUP

File config/version will be initialized with value "PROJECTNAME-0.0.000", where PROJECTNAME is target directory name.

Will create var/patch/PROJECTNAME-0.0.000.tar with backup of current project. This backup should be used when installing this project elsewhere:

    unpack backup in empty project root
    (if needed) unpack backup in var/patch/.prev/
    put all updates into var/patch/
    run narada-patch
    setup config/* as needed for this installation

DIAGNOSTICS

narada-new-1: mkdir: %s

Target directory wasn't exists and mkdir failed (probably parent directory doesn't exist or have wrong permissions).

narada-new-1: not a directory: %s

Script's param point to existing file.

narada-new-1: opendir: %s

Target directory exists, but can't be read (probably have wrong permissions).

narada-new-1: directory not empty: %s

Target directory exists, but not empty.

narada-new-1: unpack failed

Script failed to unpack skeleton directory. Most likely reason - target directory doesn't writable. While unpacking it use `tar`, so maybe there some issue with it. Or this script was damaged (reinstall recommended).

narada-new-1: unable to detect project name

Failed to setup 'config/version' file using project directory name as default project name. Probably some issue with `pwd` command or unusual symbols in project directory name (\n for example).

narada-new-1: closedir: %s
narada-new-1: chdir: %s

Internal error.

CONFIGURATION AND ENVIRONMENT

narada-new-1 requires no configuration files or environment variables.

SUPPORT

Bugs / Feature Requests

Please report any bugs or feature requests through the issue tracker at https://github.com/powerman/Narada/issues. You will be notified automatically of any progress on your issue.

Source Code

This is open source software. The code repository is available for public review and contribution under the terms of the license. Feel free to fork the repository and submit pull requests.

https://github.com/powerman/Narada

    git clone https://github.com/powerman/Narada.git

Resources

AUTHOR

Alex Efros <powerman@cpan.org>

COPYRIGHT AND LICENSE

This software is Copyright (c) 2008-2016 by Alex Efros <powerman@cpan.org>.

This is free software, licensed under:

  The MIT (X11) License