s3_logger 0.0.1

data/.gitignore

@@ -0,0 +1,3 @@
+pkg/*
+*.gem
+.bundle

data/Gemfile

@@ -0,0 +1,4 @@
+source :gemcutter
+
+# Specify your gem's dependencies in s3_logger.gemspec
+gemspec

data/README.md

@@ -0,0 +1,53 @@
+Why use S3 for logging?
+=======================
+I love [Heroku](http://heroku.com) and deploy there all the time - its a great way to work with Ruby and web applications.  But one of the "features" of Heroku is that its a read-only file system, which can make logging clumsy.
+
+The best way I've found to deal with this situation is to shove all your logging duties off to S3.  In fact, I have done this so often that I extracted the code I used to copy/paste from project to project and that's the point of this gem.
+
+Its built using the [EasyS3](https://github.com/jonallured/easy_s3) gem (which itself is built on the [Ruby S3 Gem](https://github.com/marcel/aws-s3)), so you have to be good with that.
+
+Install
+-------
+Just use the `gem` command:
+
+	gem install s3_logger
+
+If you don't have `easy_s3` or `aws-s3`, they will be installed as well.
+
+Setup
+-----
+S3Logger can't do anything until you [setup EasyS3](https://github.com/jonallured/easy_s3), so go check out that documentation first.  Then, you should probably set two more environment variables:
+
+	S3_LOGGER_FILE => your default log file
+	S3_LOGGER_PATH => your default log path
+
+You don't have to setup these defaults, but if you don't you'll have to explicitly set them every time and not having to do that is the whole point of this gem!
+
+Methods
+-------
+There is really just one method:
+
+	log(message, timestamp_flag=false, file=ENV['S3_LOGGER_FILE'], path=ENV['S3_LOGGER_PATH'])
+
+With four attributes:
+
+	data => the actual log message, required
+	timestamp_flag => prepends Time.now to message when true; optional; defaults to false
+	file => the file to write our message to; optional; default to the ENV variable
+	path => the path to our file; optional; defaults to the ENV variable
+
+Usage
+-----
+S3Logger supports a few different uses:
+
+	S3Logger.log('some smart log message')
+	# => writes this message to the default log file at the default path with no timestamp
+
+	S3Logger.log('some smart log message', true)
+	# => writes this message to the default log file at the default path with a timestamp
+
+	S3Logger.log('some smart log message', false, 'debug.log')
+	# => writes this message to the debug.log file at the default path with no timestamp
+
+	S3Logger.log('some smart log message', true, 'debug.log', 'debug/log/path/')
+	# => writes this message to the debug.log file using debug/log/path/ as the path with a timestamp

data/Rakefile

@@ -0,0 +1,2 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks

data/lib/s3_logger.rb

@@ -0,0 +1,10 @@
+require 'easy_s3'
+
+module S3Logger
+  def self.log(message, timestamp_flag=false, file=ENV['S3_LOGGER_FILE'], path=ENV['S3_LOGGER_PATH'])
+    message += "\n"
+    message = "[#{Time.now}]\n" + message if timestamp_flag
+    full_path = path + file
+    EasyS3.exists?(full_path) ? EasyS3.append(full_path, message) : EasyS3.write(full_path, message)
+  end
+end

data/lib/s3_logger/version.rb

@@ -0,0 +1,3 @@
+module S3Logger
+  VERSION = "0.0.1"
+end

data/s3_logger.gemspec

@@ -0,0 +1,21 @@
+# -*- encoding: utf-8 -*-
+require File.expand_path("../lib/s3_logger/version", __FILE__)
+
+Gem::Specification.new do |s|
+  s.name        = "s3_logger"
+  s.version     = S3Logger::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Jon Allured"]
+  s.email       = ["jon.allured@me.com"]
+  s.homepage    = "http://rubygems.org/gems/s3_logger"
+  s.summary     = "simple logging to S3 using the easy_s3 gem"
+  s.description = "aims to simplify the task of logging by making some assumptions and using the easy_s3 gem"
+
+  s.required_rubygems_version = ">= 1.3.6"
+
+  s.files        = `git ls-files`.split("\n")
+  s.executables  = `git ls-files`.split("\n").map{|f| f =~ /^bin\/(.*)/ ? $1 : nil}.compact
+  s.require_path = 'lib'
+  
+  s.add_dependency "easy_s3"
+end

metadata

@@ -0,0 +1,89 @@
+--- !ruby/object:Gem::Specification 
+name: s3_logger
+version: !ruby/object:Gem::Version 
+  hash: 29
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- Jon Allured
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-12-03 00:00:00 -06:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: easy_s3
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id001
+description: aims to simplify the task of logging by making some assumptions and using the easy_s3 gem
+email: 
+- jon.allured@me.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- Gemfile
+- README.md
+- Rakefile
+- lib/s3_logger.rb
+- lib/s3_logger/version.rb
+- s3_logger.gemspec
+has_rdoc: true
+homepage: http://rubygems.org/gems/s3_logger
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 23
+      segments: 
+      - 1
+      - 3
+      - 6
+      version: 1.3.6
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: simple logging to S3 using the easy_s3 gem
+test_files: []
+