Bukkit

Configfile / Konfigfájl

ENGLISH

Description:

This is a library plugin for a configuration file management in UTF-8 or other encoding. I wrote it for other plugins, so on its own it is good for nothing, but from going forward all my plugins, which need configuration file will use it. If you would like to, you can write plugins which use this plugin.

Features:

• Load configuration file with UTF-8 or other encoding
• Save configuration file with UTF-8 or other encoding
• Save path of loaded configuration file
• Get string from configuration file without placing placing any quotation marks or apostrophes for the text.
• Get adresslist, datalist or doublelist (array of adress+given separator string+data strings)
• Set value for a given adress (if adress doesn´t exists, it and its parent adresses will be created)
• Modify value for a given adress (if adress is exists, its value will be changed to the given value)
• Delete from configuration file (deletes the given adress and all its child adresses)

Plans:

• Manage configuration file without loading the whole file to the memory (advantageous in bigger files)
• Trouble shooting when any problem occurs (when I write a plugin and something comes to my mind, what should be in this plugin)
• Your ideas (if you would like anything to put in, please write a comment)

What probably never appears in the plugin:

• Getting data in all formats (it's unnecessery, if you need the data in other formats, you can convert the string into your own plugin)
• Supporting more file formats (if I need managing other file formats, I will write a plugin for each format)

MAGYAR

Leírás:

Ez egy konfigurációs fájl kezelési könyvtár plugin, ami képes UTF-8 vagy egyéb kódolásban más pluginokhoz tartozó konfigurációs fájlokat kezelni. A plugin önmagában nem tud semmit, viszont mostantól kezdve az összes pluginomhoz, ami használ konfigfájlt, fog ez kelleni. Amennyiben szeretnétek ti is írhattok vele plugint

Előnyei:

• Konfigfájl betöltése UTF-8 vagy más kódolással
• Konfigfájl mentése UTF-8 vagy más kódolással
• Konfigfájl elérési útvonalának eltárolása
• Konfigfájlból való karakterlánc lekérés, annélkül, hogy bármilyen idézőjelek vagy aposztrófok közé kéne raknunk a szöveget
• Konfigfájlból való címlista, adatlista és kettőslista(cím+megadott elválasztó szöveg+adat karakterláncokból álló tömb)
• Konfigfájlban lévő adat beállítása egy megadott címre(ha nincs ilyen cím, akkor létrehozza a hozzá szükséges főcímekkel együtt)
• Konfigfájlban lévő adat átírása(csak akkor módosítja az adatot, ha a megadott cím létezik már)
• Konfigfájlban lévő törlés (a megadott címet és az ahhoz tartozó összes alcímet törli)

Tervek:

• Konfigfájl kezelése a teljes konfigfájl betöltése nélkül (nagyobb konfigfájloknál előnyös dolog)
• Szükség esetén előjövő probléma orvoslása (plugin írás közben, ha eszembe jut valami, ami kéne még a konfigfájlhoz)
• Ötletetek (ha szeretnétek, hogy valamit belerakjak, akkor írjatok egy hozzászólást)

Nem lesz benne valószínűleg soha:

• Adatlekérés bármilyen formátumban (felesleges a bármilyen formátum, amennyiben más formátumban van szükséged az adatra, azt a saját pluginodban meg tudod írni)
• Több fajta fájlformátum (amennyiben más fajta fájlformátumra van szükségem, írok rá egy másik plugint)