webino/webino-name-day-lib

Name day Library

Webino Name Day Library

, _(*1)

Provides API to resolve name day. Still under development. (currently only Slovak), _(*2)

Features

• Today and tomorrow name day according to the date
• Reverse resolving, name day date for a name
• Holy day flag

Setup

Following steps are necessary to get this library working:, _(*3)

1. Add "minimum-stability": "dev" to your composer.json, because this lib is under development, _(*4)

2. Run php composer.phar require webino/webino-name-day-lib:dev-develop, _(*5)

Requirements

• PHP 5.3

QuickStart

    // Create the name day service
    $locale  = 'sk_SK';
    $factory = new \WebinoNameDayLib\Factory;
    $nameDay = $factory->create($locale);

    // Get the name day
    $result = $nameDay->today();

    // Holy day logic (optional)
    if ($result->isHolyDay()) {
        $text = 'Today is';
    } else {
        $text = 'Name-day today celebrating';
    }

    // Name day of the day
    $result->getName();

    // Get tomorrow name day
    $result = $nameDay->tomorrow();

    // Get today & tomorrow name day
    $arrayOfResults = $nameDay->combo();

Functions

The service

• NameDayResult today($date = 'now')
• NameDayResult tomorrow($date = 'now')
• array[NameDayResult, NameDayResult] combo($date = 'now')
• DateTime nameDate($name)
• DateTime nearestNameDate($name)

The result

• string getName()
• bool isHolyDay()

Develop

Requirements, _(*6)

• Linux (recommended)
• NetBeans (optional)
• Phing
• PHPUnit

Setup, _(*7)

1. Clone this repository and run: phing update, _(*8)

   Now your development environment is set., _(*9)

2. Open project in the (NetBeans) IDE, _(*10)

Adding region names, _(*11)

1. Look at the \WebinoNameDayLib\Region\Sk
2. It's best to extend \WebinoNameDayLib\Region\AbstractNames

Testing, _(*12)

• Run phpunit in the test directory

• Run phing test in the module directory to run the tests and code insights, _(*13)

  NOTE: To run the code insights there are some tool requirements., _(*14)

Todo

• Add Czech names
• Add other nation names
• Tests for nameDate() & nearesetNameDate()

Addendum

Please, if you are interested in this library report any issues and don't hesitate to contribute., _(*15)