flutter_nameday_api 0.0.2

A Flutter wrapper for Abalin.net nameday API that makes implementing nameday functionality easier than ever! Receive namedays from 20 countries worldwide.

Is nameday functionality needed in your app? This package lets you implement it by speeding up getting nameday data over the internet. It is a wrapper for Abalin.net nameday API, so you won't have to fiddle with requests and parsing JSON.

Abalin API is international, currently supporting namedays from 20 countries across the globe.

Table of contents

• Features
• List of supported countries
• Usage
• Example
• Credits
• Features, bugs and feedback

Features

1. Get namedays celebrated today, tomorrow or yesterday in 20 countries
2. Determine the date when a nameday is celebrated
3. Search nameday(s) by date

Supported countries

		Supported countries
Austria	Bulgaria	Croatia	Czechia	Denmark
Estonia	Finland	France	Germany	Greece
Hungary	Italy	Latvia	Lithuania	Poland
Russian Federation	Slovakia	Spain	Sweden	United States of America

Usage

Currently available methods are:

Method	Arguments
Nameday.today()	country
Nameday.tomorrow()	country
Nameday.yesterday()	country
Nameday.searchByName()	name, country
Nameday.specificDay()	country, day, month

Learn more about usage under examples or in Dart docs.

Example

All the above methods return their respective future classes, so just plug them into a FutureBuilder and you're good to go:

FutureBuilder(
  future: Nameday.today(),
  builder: (context, snapshot) {
    if (snapshot.hasData) {
      // snapshot.data is assigned to the type of class returned by the future
      // for later ease of use
      OneDayData nameDays = snapshot.data;
      return ExpansionTile(
        title: Text('Namedays today'),
        children: [
          // This fluff is where we process the data (lists) returned
          // so we get a bunch of decently pretty ExpansionTiles
          SingleChildScrollView(
            child: Column(
              children: [
                Text('Today is ${nameDays.month}/${nameDays.day}'),
                for (var element in nameDays.nameDays)
                  Text(
                    element,
                    style: _textStyle(),
                  ),
              ],
            ),
          ),
        ],
      );
    } else {
      return CircularProgressIndicator();
    }
  },
),

You can see a longer example with all the methods under examples tab.

Credits

This package is a Flutter wrapper for Abalin.net nameday API. Credit goes to Vojtech Nekvapil.

Features, bugs and feedback

Did you encounter any problems while using this package? Would you like to see a feature added to it? Feel free to create an issue here or send a pull request my way!