Blux 0.0.3

data/Manifest

@@ -0,0 +1,15 @@
+COPYING
+Manifest
+README.markdown
+Rakefile
+bin/blux
+bin/blux_textile_to_html
+bin/blux_wp_publish
+lib/blog_manager.rb
+lib/blux_config_reader.rb
+lib/blux_option_parser.rb
+lib/draft_manager.rb
+lib/indexer.rb
+spec/blog_manager_spec.rb
+spec/blux_config_reader_spec.rb
+spec/draft_manager_spec.rb

data/README.markdown

@@ -0,0 +1,81 @@
+# Blux
+Blux is an offline blog manager that lets you manage your blog posts offline and publish them to any blog engine that supports AtomPub. 
+
+## install
+gem install Blux
+
+That's it!
+
+## configuration
+Blux reads its configuration info from  ~/.bluxrc. The first time you run blux, it will create this file for you, but will immediately complain about missing configuration items. Use the following configuration example for a Wordpress blog and edit each line as needed:
+
+	editor: vim
+	html_converter: blux_textile_to_html
+	
+	blog: myWordpressBlog
+	author_name: Mr. Author
+	user_name: my_user_id
+	password: my_password
+
+**editor:** this is the shell command that will be executed to launch your editor of choice
+
+**html_converter:** Blux will use this shell command to convert your blog draft to html. In the example above, Blux will use the blux_textile_to_html script, which is included with this application. The script will transform your post, written in the textile markup language, and convert it to html.
+
+**blog:** this is your Wordpress blog ID
+
+**author_name:** the name of the author
+
+**user_name:** your Wordpress user name that Blux will use to publish your posts
+
+**password:** your Wordpress password
+
+## Blux from command line
+
+Blux is a command line tool that currently operates without a GUI of any sort. Here are a few of the commands you can use:
+
+> 	$ blux -n  (--new)
+
+this command launches your text editor. As soon as you quit the editor, it will create a draft in the Blux draft folder in ~/.blux/draft
+
+> 	$ blux -s (--set) --latest title "a title"
+
+this command sets a title on the latest created draft
+
+> 	$ blux -s -f draft1.23 title "a title"
+
+the -f <filename> option can be used to tell Blux to operate on a specific draft by use the draft's filename (without the path)
+
+> 	$ blux -s --title "old title" title "new title"
+
+use --title <title> to tell Blux to operate on a draft with a specific title. In this case, blux will change the title of the "old title" draft to "new title"
+
+> 	$ blux -l (--list)
+
+this command will list all your drafts, showing each draft by filename
+
+> 	$ blux -l --with-preview
+
+use --with-preview when you want to show a small snippet of each draft during the listing
+
+> 	$ blux -l --details -f draft1.23
+
+user --details to see each draft filename followed by the drafts attributes in JSON format when listing
+
+> 	$ blux -o (--out) -f draft1.23
+
+this command will output the content of your draft to stdin
+
+> 	$ blux -c (--convert) --latest
+
+this command will invoke the specified converter to convert your post to html
+
+> 	$ blux -e (--edit) --title "title 1"
+
+use this command to edit a draft
+
+> 	$ blux -e -f draft1.23 --verbose
+
+when using the --verbose option, Blux will output a lot of extra information to the screen as it works
+
+## community
+feel free to post your comments or questions to the Blux Google group here: blux_manager@googlegroups.com 

data/Rakefile

@@ -0,0 +1,19 @@
+require 'rubygems'
+require 'rake'
+require 'echoe'
+
+Echoe.new('Blux', '0.0.3') do |p|
+	p.description = 'An offline blog manager'
+	p.url = 'http://github.com/louissalin/blux'
+	p.author = 'Louis Salin'
+	p.email = 'louis.phil@gmail.com'
+	p.ignore_pattern = ["tags", "TODO", "plan", "gem-public_cert.pem"]
+	p.development_dependencies = ["OptionParser >=0.5.1",
+								  "atom-tools >=2.0.5",
+								  "json >=1.4.6",
+								  "RedCloth >=4.2.3"]
+	p.runtime_dependencies = ["OptionParser >=0.5.1",
+							  "atom-tools >=2.0.5",
+							  "json >=1.4.6",
+							  "RedCloth >=4.2.3"]
+end

data/bin/blux

@@ -0,0 +1,107 @@
+#!/usr/bin/env ruby
+#
+# Copyright 2010 Louis-Philippe Salin de l'Etoile, aka Louis Salin
+# email: louis.phil@gmail.com
+#
+# This file is part of Blux.
+#
+# Blux is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# Blux is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with Blux.  If not, see <http://www.gnu.org/licenses/>.
+
+require "#{File.dirname(__FILE__)}/../lib/blux_option_parser.rb"
+require "#{File.dirname(__FILE__)}/../lib/blog_manager.rb"
+
+def validate_command(options)
+	if (options.command != nil)
+		yield options
+	else
+		STDERR << "No command specified. Use -h for a list of possible commands\n"
+	end
+end
+
+def validate_set_options(options)
+	if options.attributes.length.modulo(2) == 0
+		yield options.attributes[0], options.attributes[1]
+	else
+		STDERR << "Attribute error: you must specify an attribute name and a value."
+	end
+end
+
+def check_filename(options, blog_manager)
+	filename = blog_manager.draft_manager.get_latest_created_draft if options.use_latest
+	filename = blog_manager.draft_manager.get_draft_by_title(options.title) if options.use_title
+	filename = options.filename || filename
+
+	puts "check_filename: #{filename}" if options.verbose
+	if filename != nil
+		yield filename
+	else
+		STDERR << "Please specify the draft file you want to work with. If you want to work with the latest created/edited draft, use the --latest option. You can also tell blux to get a draft with a specific title with --title."
+	end
+end
+
+validate_command(BluxOptionParser.parse(ARGV)) do |options|
+	puts "#{options}" if options.verbose
+
+	draft_manager = DraftManager.new
+	mgr = BlogManager.new(draft_manager, :verbose => options.verbose)	
+	mgr.load_config
+	mgr.start
+
+	case options.command
+	when :new
+		mgr.draft_manager.create_draft
+	when :edit
+		check_filename(options, mgr) do |filename|
+			mgr.draft_manager.edit_draft filename
+		end
+	when :list
+		mgr.draft_manager.list.each do |item|
+			break if options.filename != nil && options.filename != item
+			puts "#{item}"
+			puts "  #{mgr.draft_manager.show_info(item)}" if options.list_details
+			puts "  #{mgr.draft_manager.show_preview(item)}" if options.list_preview
+		end
+	when :set
+		check_filename(options, mgr) do |filename|
+			validate_set_options(options) do |attribute, value|
+				mgr.draft_manager.set_attribute(filename, attribute, value)
+			end
+		end
+	when :out
+		check_filename(options, mgr) do |filename|
+			STDOUT.puts(mgr.draft_manager.output filename)
+		end
+	when :convert
+		check_filename(options, mgr) do |filename|
+			system "blux --out -f #{filename} | #{mgr.config.html_converter_cmd}"
+		end
+	when :publish
+		check_filename(options, mgr) do |filename|
+			puts "publishing" if options.verbose
+			mgr.publish filename
+		end
+	when :update
+		check_filename(options, mgr) do |filename|
+			puts "updating" if options.verbose
+			mgr.update filename
+		end
+	when :set_edit_url
+		check_filename(options, mgr) do |filename|
+			ARGF.each do |url|
+				mgr.set_attribute(filename, 'edit_url', url.strip)
+			end
+		end
+	end
+end
+

data/bin/blux_textile_to_html

@@ -0,0 +1,25 @@
+#!/usr/bin/env ruby
+#
+# Copyright 2010 Louis-Philippe Salin de l'Etoile, aka Louis Salin
+# email: louis.phil@gmail.com
+#
+# This file is part of Blux.
+#
+# Blux is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# Blux is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with Blux.  If not, see <http://www.gnu.org/licenses/>.
+
+require 'redcloth'
+
+ARGF.each do |line|
+	STDOUT.puts RedCloth.new(line).to_html
+end

data/bin/blux_wp_publish

@@ -0,0 +1,142 @@
+#!/usr/bin/env ruby
+## Copyright (c) 2007 John Mettraux
+## Released under the MIT license
+## http://www.opensource.org/licenses/mit-license.php
+##
+## Modifications by Louis Salin, October 2010
+## => reading blog information from the configuration file
+
+require 'optparse'
+require 'net/http'
+require 'atom/entry' # sudo gem install atom-tools
+require 'atom/collection'
+require "#{File.dirname(__FILE__)}/../lib/blux_config_reader"
+
+
+#
+# parse options
+
+tags = []
+title = nil
+type = 'html'
+bluxrc = nil
+command = :post
+entry_id = nil
+
+opts = OptionParser.new
+opts.banner = "Usage: post.rb [options]"
+opts.separator ""
+opts.separator "options :"
+
+opts.on(
+	"-c",
+	"--categories {list}",
+	"comma separated list of tags/categories") do |v|
+
+	tags = v.split ","
+	end
+
+opts.on(
+	"-t",
+	"--title {title}",
+	"title for the post") do |v|
+
+	title = v
+	end
+
+opts.on(
+	"-T",
+	"--type {html|xhtml|text}",
+	"type of the content. ('html' is the default).") do |v|
+
+	type = v
+	end
+
+opts.on(
+	"--config {config_file}",
+	"blux config file path") do |f|
+	bluxrc = f
+	end
+
+opts.on(
+	"--update {entry_id}",
+	"update an existing post") do |id|
+	command = :put
+	entry_id = id
+	end
+
+opts.on(
+	"-h",
+	"--help",
+	"displays this help") do
+
+	puts
+	puts opts.to_s
+	puts
+	exit 0
+	end
+
+opts.parse ARGV
+
+raise "please specify a title for the post with the -t option" unless title
+
+# a great thanks to the devs of all the libs used here
+#
+# some info about you and your blog
+
+config = BluxConfigurationReader.new
+config.load_config bluxrc
+
+blog = config.blog
+authorname = config.author_name
+username = config.user_name
+password = config.password
+
+bloguri = "http://#{blog}.wordpress.com"
+base = "https://#{blog}.wordpress.com/wp-app.php"
+
+#
+# gather content
+
+content = ""
+loop do
+	line = STDIN.gets
+	break unless line
+	content += line
+end
+
+# create entry
+
+entry = Atom::Entry.new
+entry.title = title
+entry.updated!
+
+author = Atom::Author.new
+author.name = authorname
+author.uri = bloguri
+entry.authors << author
+
+tags.each do |t|
+	c = Atom::Category.new
+	c["scheme"] = bloguri
+	c["term"] = t.strip
+	entry.categories << c
+end
+
+entry.content = content
+entry.content["type"] = type if type
+
+h = Atom::HTTP.new
+h.user = username
+h.pass = password
+h.always_auth = :basic
+
+c = Atom::Collection.new(base + "/posts", h)
+if command == :post
+	res = c.post! entry
+	puts Atom::Entry.parse(res.read_body).edit_url
+elsif command == :put
+	entry.edit_url = entry_id
+	res = c.put! entry
+end
+

data/lib/blog_manager.rb

@@ -0,0 +1,99 @@
+#
+# Copyright 2010 Louis-Philippe Salin de l'Etoile, aka Louis Salin
+# email: louis.phil@gmail.com
+#
+# This file is part of Blux.
+#
+# Blux is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# Blux is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with Blux.  If not, see <http://www.gnu.org/licenses/>.
+require "#{File.dirname(__FILE__)}/draft_manager"
+require "#{File.dirname(__FILE__)}/blux_config_reader"
+require "#{File.dirname(__FILE__)}/indexer"
+
+class BlogManager
+	attr_accessor :home, :blux_dir, :blux_rc, :blux_tmp_dir, :draft_dir
+	attr_accessor :draft_manager 
+	attr_accessor :config
+	attr_accessor :index
+	attr_accessor :index_file
+
+	include BluxIndexer
+
+	def initialize(draft_manager, options = {})
+		@options = options
+		@verbose = options[:verbose] ||= false
+
+		@home = ENV['HOME']
+		@blux_dir = "#{@home}/.blux"
+		@draft_dir = "#{@blux_dir}/draft"
+		@blux_tmp_dir = "#{@blux_dir}/tmp"
+		@blux_rc = "#{@home}/.bluxrc"
+		@index_file = "#{@blux_dir}/.published"
+
+		@draft_manager = draft_manager
+	end
+
+	def start
+		unless Dir.exists?(@blux_dir)
+			puts "creating #{@blux_dir}\n" if @verbose
+			Dir.mkdir(@blux_dir) 
+		end
+
+		unless Dir.exists?(@draft_dir)
+			puts "creating #{@draft_dir}\n" if @verbose
+			Dir.mkdir(@draft_dir) 
+		end
+
+		unless Dir.exists?(@blux_tmp_dir)
+			puts "creating #{@blux_tmp_dir}\n" if @verbose
+			Dir.mkdir(@blux_tmp_dir) 
+		end
+
+		load_index
+	end
+
+	def load_config
+		@config = BluxConfigurationReader.new
+		@config.load_config @blux_rc, @verbose
+
+		@draft_manager.setup(@config.launch_editor_cmd, @blux_tmp_dir, @draft_dir, @options)
+	end
+
+	def publish(filename)
+		title = @draft_manager.get_attribute(filename, "title") || 'no title'
+
+		cmd = "blux --convert -f #{filename} | blux_wp_publish -t #{title} --config #{@blux_rc} | blux --set_edit_url -f #{filename}"
+		cmd = cmd + " --verbose" if @verbose
+
+		puts cmd if @verbose
+		system cmd
+		
+		load_index
+		set_attribute(filename, :published_time, Time.now)
+	end
+
+	def update(filename)
+		title = @draft_manager.get_attribute(filename, "title") || 'no title'
+		url = get_attribute(filename, "edit_url")
+
+		raise "couldn't find an edit url for the draft: #{filename}" unless url 
+
+		cmd = "blux --convert -f #{filename} | blux_wp_publish.rb -t #{title} --update #{url} --config #{@blux_rc}"
+
+		puts cmd if @verbose
+		system cmd
+		
+		set_attribute(filename, :published_time, Time.now)
+	end
+	
+end