flutter_nameday_api 0.0.2 copy "flutter_nameday_api: ^0.0.2" to clipboard
flutter_nameday_api: ^0.0.2 copied to clipboard

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

Namedays example

Flutter nameday API logo

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 #

  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.

Much namedays, such tiles!

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!

0
likes
130
points
51
downloads

Publisher

unverified uploader

Weekly Downloads

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

Repository (GitHub)

Documentation

API reference

License

unknown (license)

Dependencies

flutter, http

More

Packages that depend on flutter_nameday_api