DialogPlus

Additional

Language
Java
Version
4.1.4 (Dec 10, 2019)
Created
Jul 17, 2019
Updated
Dec 10, 2019
Owner
ma7madfawzy
Contributors
ma7madfawzy
muhammadnomany25
Ali Gamal (aligamal-dev)
3
Activity
Badge
Generate
Download
Source code
APK file

Show card

DialogPlus

An Android library that lets you create a custom dialog in a simple and easy way ,with different types which you can use easily without any boilerplate code and with a great flexibility to fit your desired user interface.

Many types of dialogs provided: Message, Confirmation Dialog(a yes/no dialog), Code Entry, Success, Error, Multi Options, List, Rating, Year Picker, Month Picker , Day Picker, Month/Year Picker, Month/Day Picker, Date Picker(Fully functional and can accept minimum date or maximum date), and Localized Country Picker Dialog(32 Languages supported).


Quick Setup

1- Include library

Using Gradle

dependencies {
implementation  'com.dialog:plus:4+'
}

Using Maven

<dependency>
  <groupId>com.dialog</groupId>
  <artifactId>plus</artifactId>
  <version>4+</version>
  <type>pom</type>
</dependency>

2- Usage

2.1 MESSAGE:

new DialogPlusBuilder("Message Dialog", "message dialog_plus sample\n Welcome Back")
               //@ColorRes int positiveBackground, @ColorRes int negativeColorRes, @ColorRes int headerBgColor
               .setTexts("alright")
               .setBackgrounds(R.color.colorPrimary, R.color.colorAccent)
               .buildMessageDialog(new DialogListener() {//implement functions
               })
               .show(this.getSupportFragmentManager(), "Message Dialog");

2.2 CONFIRMATION:

 new DialogPlusBuilder("Confirmation Dialog", "confirmation dialog_plus message content ...")
               .setTexts("confirm", "cancel").blurBackground()
               .setBackgroundColors(R.color.colorPrimary, R.color.white, R.color.colorPrimary)
               .buildConfirmationDialog(false,new DialogListener() {
                   // implement methods
               })
               .show(this.getSupportFragmentManager(), "Confirmation Dialog");

2.3 SUCCESS:

 new DialogPlusBuilder("Success message content..")
               .setSuccessDialog("Cool").blurBackground()
               .setBackgroundColors(R.color.colorPrimary, R.color.colorAccent, R.color.colorPrimary)
               .build(new DialogListener() {
                   // implement methods
               })
               .show(this.getSupportFragmentManager(), "Success Dialog");

2.4 ERROR:

new DialogPlusBuilder("Error Dialog content message")
               .setErrorDialog("Peace").blurBackground()
               .setBackgroundColors(R.color.colorPrimary, R.color.colorAccent, R.color.colorPrimary)
               .build(new DialogListener() {
                   // implement methods
               })
               .show(this.getSupportFragmentManager(), "Error Dialog");

2.5 CODE:

 new DialogPlusBuilder("Code Dialog", "code dialog_plus sample with send enabled, resend enabled and counter 10 seconds")
               .setTexts("Confirm").blurBackground()
               .setDialogCodeTextColor(getResources().getColor(R.color.colorPrimaryDark))
               .setBackgroundColors(R.color.colorPrimary, R.color.colorAccent, R.color.colorPrimary)
               .buildCodeDialog("12345", 60, true, true, new DialogListener() {
                   // implement methods
               })
               .show(this.getSupportFragmentManager(), "Code Dialog");

2.6 Multi Options:

  new DialogPlusBuilder().setTitle("Multi Options Dialog Sample Title")
                .setHeaderBgColor(R.color.dialogTransparent).setHeaderTextColor(R.color.black)
                .hideCloseIcon().blurBackground()
                .buildMultiOptionsDialog(getOptions()
                        , new MultiOptionsDialog.ActionListener() {...})
                        .show(this.getSupportFragmentManager(), "Multi Options Dialog");

2.7 List:

 new DialogPlusBuilder().setTitle("List Dialog").blurBackground()
               .buildListDialog(getListItems(), new DialogPlus.DialogListListener() {
                   @Override
                   public void onItemClicked(String title, int index, DialogPlus dialogPlus) {
                       super.onItemClicked(title, index, dialogPlus);
                       Toast.makeText(MainActivity.this, title, Toast.LENGTH_SHORT).show();
                   }
               })
               .show(this.getSupportFragmentManager(), "List Dialog");

2.8 Year Picker:

new DialogPlusBuilder().blurBackground().setHeaderBgDrawable(R.drawable.bg_header).buildYearPickerDialog(pickedYear ->
               Toast.makeText(this, "picked year: " + pickedYear, Toast.LENGTH_SHORT).show())
               .show(getSupportFragmentManager(), "Year Picker");

2.9 Month Picker:

  new DialogPlusBuilder().blurBackground().setHeaderBgColor(R.color.white).setHeaderTextColor(R.color.colorPrimaryDark)
                         .buildYearPickerDialog(pickedYear ->
                             Toast.makeText(this, "picked year: " + pickedYear, Toast.LENGTH_SHORT).show())
               .show(getSupportFragmentManager(), "Month Picker");

2.10 Rate:

    new DialogPlusBuilder("Rating Dialog", "Rate dialog_plus message content ...")
               .setTexts("rate", "cancel").blurBackground()
               .buildRatingDialog(1.7f, false, new DialogPlus.DialogRateListener() {
                   @Override
                   public void onRateGiven(float rate, DialogPlus dialogPlus) {
                       Toast.makeText(MainActivity.this, "rated with " + rate, Toast.LENGTH_SHORT).show();
                           }
               })
               .show(this.getSupportFragmentManager(), "Rating Dialog");

2.11 Country Picker:

    new DialogPlusBuilder().setTitle("Countries List Dialog").blurBackground()
               .buildCountriesListDialog(true,new DialogPlus.CountriesDialogListener() {
                   @Override
                   public void onItemClicked(CountryDataModel countryDataModel, DialogPlus dialogPlus) {
                       super.onItemClicked(countryDataModel, dialogPlus);
                       Toast.makeText(MainActivity.this, "country:" + countryDataModel.getName() + " ,Code: " + countryDataModel.getPhone_code(), Toast.LENGTH_SHORT).show();
                   }
               })
               .show(this.getSupportFragmentManager(), "Countries List Dialog");

Note you can use CountryRepo to retrieve any country in any language using the country code

String arabicStr = new CountryRepo(MainActivity.this).getCounty("ar", 20).getName();

2.12 Day Picker:

    new DialogPlusBuilder().blurBackground()
               .setHeaderBgColor(R.color.white).setHeaderTextColor(R.color.colorPrimaryDark)
               .buildDayPickerDialog(2, 2019, 1, pickedDay ->
                       Toast.makeText(this, "picked day: " + pickedDay, Toast.LENGTH_SHORT).show())
               .show(getSupportFragmentManager(), "Day Picker");

2.13 Month/Day Picker:

   new DialogPlusBuilder().blurBackground()
               .setHeaderBgColor(R.color.white).setHeaderTextColor(R.color.colorPrimaryDark)
               .buildMonthDayPickerDialog(Calendar.getInstance(),
                       (pickedMonth, pickedDay) -> //TODO
               .show(getSupportFragmentManager(), "Month Day Picker");

2.14 Month/Year Picker:

    new DialogPlusBuilder().blurBackground()
               .setHeaderBgColor(R.color.white).setHeaderTextColor(R.color.colorPrimaryDark)
               .buildMonthYearPickerDialog(Calendar.getInstance(),
                       (pickedYear, pickedMonth) -> //TODO
               .show(getSupportFragmentManager(), "Year/Month Picker");

2.15 Date Picker:

    new DialogPlusBuilder().blurBackground().setHeaderBgColor(R.color.white).setHeaderTextColor(R.color.colorPrimaryDark)
               .buildDatePickerDialog(nowCalendar, afterYearCalendar
                       , (pickedYear, pickedMonth, pickedDay) -> //TODO
               .show(getSupportFragmentManager(), "Date Picker");

2.16 Custom Dialog: Accepts a layoutRes to a layout xml file and adds it to the dialog(Supports Data Binding)

    CustomLayoutDialog dialog = new DialogPlusBuilder().setTitle("pick a choice").buildCustomLayoutDialog(R.layout.layout_language_dialog);
               dialog.showNow(getChildFragmentManager(), "languageDialog");
               LayoutLanguageDialogBinding languageDialogBinding=(LayoutLanguageDialogBinding) dialog.getCustomLayoutBinding();
               languageDialogBinding.arabic.setOnCheckedChangeListener(...);

2.17 Message With Image Dialog: Accepts a DrawableRes to a an image(Supports Gif)

    new DialogPlusBuilder("Image Message Dialog", "message dialog_plus sample\n Welcome Back")
               .setTexts("alright").blurBackground()
               .setBackgrounds(R.color.colorPrimary, R.color.colorAccent)
               .buildMessageDialog(R.drawable.send_anim
                       , new DialogListener() {//implement functions
                       }).show(this.getSupportFragmentManager(), "Image Message Dialog");

2.18 Custom Layout:

      new DialogPlusBuilder()
               .buildCustomLayoutDialog(R.layout.custom_layout,BR.dataModel,dataModel)
               .show(this.getSupportFragmentManager(), "Custom Layout Dialog");

2.19 Focus View: Borrows a view (that already added to a parent) with it's attributes and view it in the dialog

    new DialogPlusBuilder().blurBackground()
               .buildCustomLayoutDialog(findViewById(R.id.viewToShow))
               .show(this.getSupportFragmentManager(), "Custom Layout Dialog");
Note that Focus View is not stable yet, We are still applying different scenarios. For better performance you better add the "viewToShow" in a viewGroup ust holding it. You can Use CustomLayout for a more stable behaviour.

3 Listeners:

You can implement the action you like to listen to(non-abstract methods used)

DialogActionListener Used with MESSAGE ,CONFIRMATION ,SUCCESS and ERROR dialogs.

CodeTypeListener Used with the Code dialog.

DialogRateListener Used with the Rate dialog.

PickerListener Used with Year,Month and Day Pickers(Individually).

YearMonthPickerListener Used with the Date Picker dialog(for month and year pickers).

DatePickerListener Used with Date Picker.

4 Customizing:

4.1 per use

 new DialogPlusBuilder("Dialog Title", "dialog content ...")
                 .setTitle(null)//will hide the header view
                 .setContent(null)//will hide the content view
                //(@ColorRes int positiveBackground, @ColorRes int negativeColorRes, @ColorRes int headerBgColor)
                .setBackgroundColors(R.color.colorPrimary, R.color.colorAccent, R.color.colorPrimary)
                
                //(@DrawableRes int positiveBackground, @DrawableRes int negativeBackground, @DrawableRes int headerBackground)
                .setBackgrounds(R.drawable.cross, R.drawable.bg_header, R.drawable.checked)
                
                //(@ColorRes int positiveTextColor, @ColorRes int negativeTextColor, @ColorRes int headerTextColor)
                .setTextColors(R.color.colorPrimary, R.color.colorAccent, R.color.colorPrimary)
                
                //(@ColorRes int primaryColor)--> sets the positiveBgColor and the headerBgColor
                .setPrimaryBgColor(R.color.colorPrimary)
                //(@ColorRes int primaryColor)--> sets the negativeBgColor
                .setSecondaryBgColor(R.color.colorAccent)
                
                //(@ColorRes int primaryColor)--> sets the positiveTextColor 
                .setPrimaryTextColor(R.color.colorPrimary)
                //(@ColorRes int secondaryColor)--> sets the negativeTextColor
                .setSecondaryBgColor(R.color.colorAccent)

                //(@ColorRes int primaryColor)--> sets the positiveBgDrawable and the headerBgDrawable
                .setPrimaryDrawable(R.drawable.bg_header)
                //(@ColorRes int secondaryDrawable)--> sets the negativeTextDrawable
                .setSecondaryBgDrawable(R.drawable.bg_header)
                
                //(@ColorRes int headerBgColor)
                .setHeaderBgColor(R.color.colorAccent)
                //(@DrawableRes int headerBgDrawable)
                .setHeaderBgDrawable(R.drawable.bg_header)
           
                // @ColorInt int colorInt
                .setCodeTextColor(Color.BLACK)
                 //blurs the background
                .blurBackground()
                //hides the close icon
                .hideCloseIcon()       

4.2 Per project

  • You can target the dialog's main colors to affect it's general theme by overriding these resources:
    <color name="dialogPlusContentBgColor">@color/app_background</color> <!-- default: white-->
    <color name="dialogPlusColorPrimary">@color/blue_50</color> <!-- default: colorPrimary-->
    <color name="dialogPlusColorPrimaryDark">@color//blue_200</color> <!-- default: colorPrimaryDark-->
    <color name="dialogPlusColorAccent">@color//orange_50</color> <!-- default: colorAccent-->
    <color name="dialogPositiveTextColor">@color/app_background</color> <!-- default: dialogPlusContentBgColor-->
    <color name="dialogPositiveBgColor">@color/colorPrimaryTransparent</color> <!-- default: dialogPlusColorPrimary-->
  • Dialog's resources

Dimensions

    <dimen name="dialog_corner_radius">15dp</dimen>
    <dimen name="dialog_margin">@dimen/_30sdp</dimen>
    <dimen name="dialog_timeup_text_size">@dimen/_10ssp</dimen>

    <dimen name="dialog_header_max_height">@dimen/_40sdp</dimen>
    <dimen name="dialog_header_text_size">@dimen/_14ssp</dimen>
    <dimen name="dialog_header_padding">@dimen/_8sdp</dimen>
    <dimen name="dialog_close_icon_padding">@dimen/_4sdp</dimen>

    <dimen name="dialog_content_margin">@dimen/_15sdp</dimen>
    <dimen name="dialog_content_message_text_size">@dimen/_12ssp</dimen>

    <dimen name="dialog_list_item_text_size">@dimen/_12ssp</dimen>
    <dimen name="dialog_list_search_bar_text_size">@dimen/_11ssp</dimen>
    <dimen name="dialog_list_search_bar_padding">@dimen/_5sdp</dimen>
    <dimen name="dialog_list_search_bar_corner">0dp</dimen>
    <dimen name="dialog_list_search_bar_elevation">0dp</dimen>
    <dimen name="dialog_list_Search_bar_margin">0dp</dimen>

    <dimen name="dialog_country_flag_width">@dimen/_25sdp</dimen>
    <dimen name="dialog_country_flag_margin">@dimen/_8sdp</dimen>
    <dimen name="dialog_country_row_padding">@dimen/_2sdp</dimen>

    <dimen name="dialog_action_buttons_margin">@dimen/_10sdp</dimen>
    <dimen name="dialog_action_button_corner">50dp</dimen>
    <dimen name="dialog_action_buttons_height">@dimen/_35sdp</dimen>

    <!--    space for showing elevation-->
    <dimen name="dialog_action_buttons_bottom_margin">5dp</dimen>

    <dimen name="dialog_action_button_textSize">@dimen/_12ssp</dimen>

    <dimen name="dialog_positive_button_elevation">1dp</dimen>

    <dimen name="dialog_negative_button_stroke">1dp</dimen>
    <dimen name="dialog_negative_button_elevation">0dp</dimen>

    <dimen name="dialog_title_padding">@dimen/_4sdp</dimen>

    <dimen name="dialog_close_icon_radius">@dimen/_24sdp</dimen>
    <dimen name="dialog_zero">0dp</dimen>
    <dimen name="dialog_code_entry_margin">@dimen/_8sdp</dimen>
    <dimen name="dialog_elevation">2dp</dimen>

    <dimen name="dialog_options_header_padding">@dimen/_7sdp</dimen>

    <dimen name="dialog_list_row_margin_top">@dimen/_4sdp</dimen>
    <dimen name="dialog_list_row_margin_start">@dimen/_8sdp</dimen>
    <dimen name="dialog_list_separator_margin">@dimen/_16sdp</dimen>

    <dimen name="dialog_rating_bar_margin">@dimen/_15sdp</dimen>
    <dimen name="dialog_image_width">@dimen/_150sdp</dimen>
    <dimen name="dialog_plus_min_width">@dimen/_200sdp</dimen>
    <dimen name="dialog_list_recycler_margin">@dimen/_8sdp</dimen>


    <dimen name="dialog_picker_separator_margin_start_end">@dimen/_2sdp</dimen>
    <dimen name="dialog_picker_separator_margin_top_bottom">40dp</dimen>

Integers

    <integer name="dialog_content_maxLines">4</integer>
    <integer name="dialog_width_percent">80</integer>
    <integer name="dialog_header_maxLines">1</integer>
    <!-- changing dialog_plus_blur_radius value will change the blur effect's radius-->
    <integer name="blur_radius">15</integer>
    
    <integer name="dialog_year_picker_weight">10</integer>
    <integer name="dialog_month_picker_weight">10</integer>
    <integer name="dialog_day_picker_weight">10</integer>

Colors

    <color name="colorPrimary">#0698B5</color>
    <color name="colorPrimaryDark">#05839C</color>
    <color name="colorAccent">#757575</color>

    <color name="dialogPlusColorPrimary">@color/colorPrimary</color>
    <color name="dialogPlusColorPrimaryDark">@color/colorPrimaryDark</color>
    <color name="dialogPlusColorAccent">@color/colorAccent</color>

    <color name="titleTextColor">@color/dialogPositiveTextColor</color>
    <color name="dialogContentTextColor">@color/dialogPlusColorAccent</color>

    <color name="dialogListItemTextColor">@color/dialogPlusColorPrimary</color>
    <color name="dialogListSearchBarBackgroundColor">@color/carbon_grey_300</color>
    <color name="dialogListSearchBarTextColor">@color/carbon_grey_600</color>

    <color name="dialogTransparent">#00000000</color>
    <color name="dialogPlusBgColor">@color/dialogTransparent</color>
    <color name="dialogPlusContentBgColor">@color/dialog_white</color>
    <color name="dialogDarkTransparent">#50000000</color>
    <color name="dialogBlack">#000000</color>

    <color name="dialogNegativeBgColor">@color/dialogTransparent</color>
    <color name="dialogNegativeTextColor">@color/carbon_red_800</color>

    <color name="dialogPositiveBgColor">@color/dialogPlusColorPrimary</color>
    <color name="dialogPositiveTextColor">@color/dialog_white</color>

    <color name="dialogTimeUpTextColor">@color/dialogNegativeTextColor</color>

    <color name="dialogActionButtonsStrokeColor">@color/dialogPlusColorAccent</color>

    <color name="dialog_send_background">@color/dialogPlusColorPrimary</color>
    <color name="dialog_resend_text_color">@color/dialogPlusColorPrimary</color>

    <color name="dialog_white">#ffffff</color>

    <color name="dialog_error_accent_color">@color/carbon_red_600</color>
    <color name="dialog_success_accent">@color/carbon_green_500</color>

    <color name="dialog_option_background">@color/carbon_grey_200</color>
    <color name="dialog_option_text_color">@color/dialogPlusColorPrimary</color>
    <color name="dialog_option_close_text_color">@color/dialogPlusColorPrimaryDark</color>
    <color name="dialog_option_title_text_color">@color/dialogBlack</color>
    <color name="dialog_action_separator">@color/carbon_grey_400</color>

    <color name="dialog_month_year_action_background">#00000000</color>
    <color name="dialog_month_year_action_text_color">@color/dialogPlusColorPrimary</color>

    <color name="dialog_rating_bar_active_color">@color/dialogPlusColorPrimary</color>
    <color name="dialog_rating_bar_accent_color">@color/dialogPlusColorAccent</color>
    <color name="dialog_code_text_color">@color/dialogBlack</color>

    <color name="dialog_custom_layout_background">@color/dialogTransparent</color>

    <color name="dialog_plus_number_picker_text_color">@color/dialogBlack</color>
    <color name="dialog_picker_separator_color">@color/dialogPlusColorAccent</color>

Strings

    <string name="dialog_negative_text">Cancel</string>
    <string name="dialog_ok_text">Ok</string>
    <string name="dialog_positive_text">Confirm</string>
    <string name="dialog_resend">Resend</string>
    <string name="dialog_time_up">Time up</string>
    <string name="dialog_incomplete_code_msg">Please enter complete code</string>
    <string name="dialog_options_close">Close</string>

    <string name="dialog_list_search_hint">Type here to search</string>

    <string name="dialog_pick_year_title">Pick a year</string>
    <string name="dialog_pick_month_title">Pick a month</string>
    <string name="dialog_pick_month_year_title">Pick a date</string>
    <string name="dialog_pick_day_title">Pick a day</string>

Styles

    <style name="dialog_header_style" parent="@android:style/TextAppearance">
        <item name="android:textSize">@dimen/dialog_header_text_size</item>
        <item name="android:textColor">@color/titleTextColor</item>
        <item name="android:textAllCaps">false</item>
        <item name="android:textStyle">bold</item>
    </style>

    <style name="dialog_content_message_style" parent="@android:style/TextAppearance">
        <item name="android:textSize">@dimen/dialog_content_message_text_size</item>
        <item name="android:textColor">@color/dialogContentTextColor</item>
        <item name="android:textStyle">normal</item>
        <item name="android:textAllCaps">false</item>
    </style>

    <style name="dialog_list_item_text_style" parent="@android:style/TextAppearance">
        <item name="android:textSize">@dimen/dialog_list_item_text_size</item>
        <item name="android:textColor">@color/dialogListSearchBarTextColor</item>
        <item name="android:textStyle">normal</item>
        <item name="android:textAllCaps">false</item>
    </style>

    <style name="dialog_list_Search_bar_text_style" parent="@android:style/TextAppearance">
        <item name="android:textSize">@dimen/dialog_list_search_bar_text_size</item>
        <item name="android:textColor">@color/dialogListSearchBarTextColor</item>
        <item name="android:textStyle">normal</item>
        <item name="android:textAllCaps">false</item>
    </style>

    <style name="dialog_positive_button_style" parent="@android:style/TextAppearance">
        <item name="android:text">@string/dialog_positive_text</item>
        <item name="android:textSize">@dimen/dialog_action_button_textSize</item>
        <item name="android:textColor">@color/dialogPositiveTextColor</item>
        <item name="android:textAllCaps">false</item>
        <item name="android:textStyle">normal</item>
    </style>

    <style name="dialog_option_button_style" parent="@android:style/TextAppearance">
        <item name="android:text">@string/dialog_positive_text</item>
        <item name="android:textSize">@dimen/dialog_action_button_textSize</item>
        <item name="android:textColor">@color/dialogPositiveTextColor</item>
        <item name="android:textAllCaps">false</item>
        <item name="android:textStyle">normal</item>
    </style>

    <style name="dialog_negative_button_style" parent="@android:style/TextAppearance">
        <item name="android:text">@string/dialog_negative_text</item>
        <item name="android:textSize">@dimen/dialog_action_button_textSize</item>
        <item name="android:textColor">@color/dialogNegativeTextColor</item>
        <item name="android:textStyle">normal</item>
        <item name="android:maxLines">@integer/dialog_content_maxLines</item>
    </style>

    <style name="dialog_error_button_style" parent="@android:style/TextAppearance">
        <item name="android:text">@string/dialog_ok_text</item>
        <item name="android:textSize">@dimen/dialog_action_button_textSize</item>
        <item name="android:textAllCaps">false</item>
        <item name="android:textColor">@color/dialog_white</item>
        <item name="android:textStyle">normal</item>
    </style>

    <style name="dialog_success_button_style" parent="@android:style/TextAppearance">
        <item name="android:text">@string/dialog_ok_text</item>
        <item name="android:textSize">@dimen/dialog_action_button_textSize</item>
        <item name="android:textAllCaps">false</item>
        <item name="android:textColor">@color/dialog_white</item>
        <item name="android:textStyle">normal</item>
    </style>

    <style name="dialog_plus_number_picker">
        <item name="android:textSize">@dimen/_12ssp</item>
        <item name="colorControlNormal">#00000000</item>
        <item name="android:textColorPrimary">#000</item>
        <item name="android:layout_width">@dimen/_100sdp</item>
        <item name="android:layout_height">@dimen/_100sdp</item>
    </style>

    <style name="dialog_rating_bar_style" parent="Widget.AppCompat.RatingBar">
        <item name="colorControlActivated">@color/dialog_rating_bar_active_color</item>
        <item name="colorControlNormal">@color/dialog_rating_bar_accent_color</item>
    </style>

    <style name="dialog_plus_style" parent="Base.Theme.AppCompat.Dialog">
        <item name="android:windowBackground">@color/dialogTransparent</item>
        <item name="android:layout_gravity">center</item>
        <item name="android:windowNoTitle">true</item>
        <item name="android:windowFullscreen">false</item>
        <item name="android:windowIsFloating">true</item>
        <item name="android:windowMinWidthMajor">50%</item>
        <item name="android:windowMinWidthMinor">50%</item>
        <item name="android:backgroundDimAmount">0.6</item>

    </style>

Happy Coding

Authors

License

This project is licensed under the MIT License - see the LICENSE.md file for details