GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  PATH::FINDDEV::OBJECT (3)

.ds Aq ’

NAME

Path::FindDev::Object - Object oriented guts to FindDev

CONTENTS

VERSION

version 0.5.2

SYNOPSIS



    require Path::FindDev::Object;
    my $finder = Path::FindDev::Object->new();
    my $dev = $finder->find_dev($path);



DESCRIPTION

This module implements the innards of Path::FindDev, and is only recommended for use if the Exporter API is insufficient for your needs.

METHODS

CWhas_set

Determines if the set attribute exists

CWhas_uplevel_max

Determines if the uplevel_max attribute is provided.

CWfind_dev

Find a parent at, or above $OtherPath that resembles a devel directory.



    my $path = $object->find_dev( $OtherPath );



ATTRIBUTES

CWset

<B>(optional)B>

The Path::IsDev::HeuristicSet subclass for your desired Heuristics.

CWuplevel_max

If provided, limits the number of uplevel iterations done.

( that is, limits the number of times it will step up the hierarchy )

CWnest_retry

The number of dev directories to ignore in the hierarchy.

This is provided in the event you have a dev directory within a dev directory, and you wish to resolve an outer directory instead of an inner one.

By default, this is 0, or "stop at the first dev directory"

CWisdev

The Path::IsDev object that checks nodes for dev-ishness.

PRIVATE METHODS

CW_instance_id

An opportunistic sequence number for help with debug messages.

Note: This is not guaranteed to be unique per instance, only guaranteed to be constant within the life of the object.

Based on refaddr, and giving out new ids when new refaddr’s are seen.



    my $id = $object->_instance_id;



CWBUILD

BUILD is an implementation detail of Moo/Moose.

This module hooks BUILD to give a self report of the object to *STDERR after ->new when under $DEBUG

CW_debug

The debugger callback.



    export PATH_FINDDEV_DEBUG=1



to get debug info.



    $object->_debug($message);



CW_error

The error reporting callback.



    $object->_error($message);



CW_step

Inner code path of tree walking.



    my ($dev_levels, $uplevels ) = (0,0);

    my $result = $object->_step( path($somepath), \$dev_levels, \$uplevels );

    $result->{type} eq stop   # if flow control should end
    $result->{type} eq next   # if flow control should ascend to parent
    $result->{type} eq found  # if flow control has found the "final" dev directory



AUTHOR

Kent Fredric <kentfredric@gmail.com>

COPYRIGHT AND LICENSE

This software is copyright (c) 2014 by Kent Fredric <kentfredric@gmail.com>.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.

Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 PATH::FINDDEV::OBJECT (3) 2014-08-16

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.