README.md in uniq_logger-0.1.4 vs README.md in uniq_logger-0.1.5
- old
+ new
@@ -1,8 +1,11 @@
# UniqLogger
-TODO: Write a gem description
+- Add entries to an logfile, only if an uniq id is not already used.
+- automaticaly generate logfile rotations: new logfile für every day, motnh or year
+- send your logentries to another server per api using the same gem once as client and as a server
+- creates an CSV formated file which can be easely opened in e.g. Excel for endusers
## Installation
Add this line to your application's Gemfile:
@@ -18,10 +21,66 @@
$ gem install uniq_logger
## Usage
-TODO: Write usage instructions here
+Create a configuration file config/uniq_logger.yml (view section 'Configuration')
+
+To create a logentry use:
+
+```ruby
+require 'uniq_logger'
+uniq_logger = UniqLogger.new
+uniq_logger.create("UniqID", ["data","to","save"] )
+```
+
+## Configuration File
+
+app/config/uniq_logger.yml
+
+```yml
+#Use a additional Log-Rotator which generates new logfiles for ['day','month','year'].
+#Default 'none'
+log_rotator: "month"
+
+#If log_rotator is set, this will be the prefix for the file name
+log_rotator_prefix: "uniq_logger-"
+
+
+#Use a global LogFile [true,false]. Chech for existin logs only looks in global logfile
+#Default true
+global_logger: true
+
+#Name of the logfile to write to
+global_log_file_name: "uniq_logger.log"
+
+
+#if set to true, logentry creation returns 'false' if a logentry already exists with this ID
+# This is only on global Logfiles possible
+validates_uniqness_of_id: true
+
+#If a local Logfile should be created or a ftp Account ['local', 'remote']
+logfile_destination: "local"
+
+#Path where Logfiles should be saved
+path_to_local_logfiles: "../log/"
+
+#If logfile_destination is set to 'remote' use folloing api credentials
+remote:
+ auth_token: "xyz123abc"
+ server: "http://www.server.de"
+ endpoint: "/api/v1/logger"
+ url_param_for_id: "id"
+ url_param_for_data: "data"
+ basic_auth:
+ username: ""
+ password: ""
+
+#CSV Export Settings: Encoding Type (default 'utf8'), Column Separator (default ';')
+csv:
+ encoding: "UTF8"
+ col_sep: ";"
+```
## Contributing
1. Fork it ( https://github.com/[my-github-username]/uniq_logger/fork )
2. Create your feature branch (`git checkout -b my-new-feature`)