thefox-wallet 0.8.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: c7c1ba3617a57f9c4291350ffb2b035cd41c5904
+  data.tar.gz: 2cb59e3a489b3ff322bb70a00986fac90f56027e
+SHA512:
+  metadata.gz: 0d14831c7cc6199f946266b3b1908f715072c0f6694f430811f8fc12e50039925a6508d1e7cec26e5408b9551ebebb5986988e4823589e68f55d9ac0900170e9
+  data.tar.gz: 736ba6899807150cc510348e6a113a0f7ce22ba034a9c614a8fc4ebb03ed5f2960b1aa6c3713e999633ea77babc0422f9b6741a6632e2c3151c09d9fcf0e569d

data/.gitignore

@@ -0,0 +1,9 @@
+.setup
+CHANGELOG-*.txt
+/bin/test
+/releases/
+/wallet/
+/wallet_test/
+*.csv
+*.txt
+*.yml

data/Gemfile

@@ -0,0 +1,3 @@
+
+source 'https://rubygems.org'
+gemspec

data/Gemfile.lock

@@ -0,0 +1,32 @@
+PATH
+  remote: .
+  specs:
+    thefox-wallet (0.8.0)
+      ArgsParser (~> 1.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    ArgsParser (1.0.0)
+    coderay (1.1.0)
+    method_source (0.8.2)
+    minitest (5.8.3)
+    pry (0.10.3)
+      coderay (~> 1.1.0)
+      method_source (~> 0.8.1)
+      slop (~> 3.4)
+    rake (10.4.2)
+    slop (3.6.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.10)
+  minitest (~> 5.7)
+  pry (~> 0.10)
+  rake (~> 10.0)
+  thefox-wallet!
+
+BUNDLED WITH
+   1.10.2

data/Makefile

@@ -0,0 +1,4 @@
+
+GEM_NAME = thefox-wallet
+
+include Makefile.common

data/Makefile.common

@@ -0,0 +1,50 @@
+
+# Ruby Common Big
+# 2015-12-07
+
+MV = mv -nv
+RM = rm -rf
+MKDIR = mkdir -p
+BUNDLER = bundle
+GEMSPEC_FILE = $(GEM_NAME).gemspec
+
+.PHONY: all
+all: setup
+
+.PHONY: setup
+setup: .setup
+
+.setup:
+	$(BUNDLER) install
+	touch $@
+
+.PHONY: install
+install:
+	gem_file=$$(gem build $(GEMSPEC_FILE) | grep 'File:' | tail -1 | awk '{ print $$2 }'); \
+	sudo gem install $$gem_file; \
+	$(RM) $$gem_file
+
+.PHONY: uninstall
+uninstall:
+	sudo gem uninstall $(GEM_NAME)
+
+.PHONY: update
+update:
+	$(BUNDLER) update
+
+.PHONY: clean
+clean:
+	$(RM) .setup
+
+.PHONY: release
+release: | releases
+	set -e; \
+	gem_file=$$(gem build $(GEMSPEC_FILE) | grep 'File:' | tail -1 | awk '{ print $$2 }'); \
+	dst="releases/$$gem_file"; \
+	[ ! -f $$dst ]; \
+	$(MV) $$gem_file releases; \
+	gem push $$dst; \
+	echo 'done'
+
+releases:
+	$(MKDIR) $@

data/README.md

@@ -0,0 +1,38 @@
+# Wallet
+
+A spreadsheet likewise Ruby library to track your finances. Using the best data format ever, YAML. It's designed to host the data offline, e.g. in a Git repository.
+
+## Why this project?
+
+While conventionally programs like Microsoft Excel or [LibreOffice](https://www.libreoffice.org/) uses [proprietary file formats](https://en.wikipedia.org/wiki/Proprietary_format) and [binary files](https://en.wikipedia.org/wiki/Binary_file) to save your data this script uses [YAML](https://en.wikipedia.org/wiki/YAML). YAML is a human-readable data serialization format. This means you can edit the YAML files on any [operating system](https://en.wikipedia.org/wiki/Operating_system) with any text editor.
+
+## Features
+
+- Save revenues/expenses entries monthly.
+- List saved entries.
+- Import CSV files.
+- Export data to CSV.
+- Generate HTML summary.
+- VI/editor import mode. (CSV)
+
+## Install
+
+The preferred method of installation is via RubyGems.org:  
+<https://rubygems.org/gems/thefox-wallet>
+
+	gem install thefox-wallet
+
+or via `Gemfile`:
+
+	gem 'thefox-wallet', '~>0.8'
+
+Use it in your sources:
+
+	require 'thefox-wallet'
+
+## License
+Copyright (C) 2015 Christian Mayer <http://fox21.at>
+
+This program 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.
+
+This program 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 this program. If not, see <http://www.gnu.org/licenses/>.

data/Rakefile

@@ -0,0 +1,2 @@
+
+require 'bundler/gem_tasks'

data/bin/wallet

@@ -0,0 +1,328 @@
+#!/usr/bin/env ruby
+
+require 'tempfile'
+require 'bundler/setup'
+require 'wallet'
+require 'ArgsParser'
+
+
+parser = ArgsParser.parser
+parser.bind(:wallet, :w, 'Wallet', 'wallet')
+parser.bind(:title, :t, 'Title')
+parser.bind(:date, :d, 'Date', Date.today.to_s)
+parser.bind(:revenue, :r, 'Revenue', 0)
+parser.bind(:expense, :e, 'Expense', 0)
+parser.bind(:category, :c, 'Category')
+parser.bind(:comment, :o, 'Comment')
+parser.bind(:path, :p, 'Path')
+
+command, params = parser.parse(ARGV)
+command = command.to_s
+
+# puts 'command: ' + command.to_s
+# puts 'params:  ' + params.to_s
+# puts
+
+# Command Aliases
+if command == 'i'
+	command = 'int'
+elsif command == 'l'
+	command = 'list'
+elsif command == 'lc'
+	command = 'cat'
+end
+
+wallet = params[:wallet].to_s
+title = params[:title].to_s
+date = params[:date].to_s
+revenue = params[:revenue].to_s.gsub('.', '').sub(/,/, '.').to_f.round(3).abs
+category = params[:category].to_s
+comment = params[:comment].to_s
+path = params[:path].to_s
+import = params[:i]
+
+path_is_temp = false
+
+expense = 0.0
+export = false
+if params[:expense].is_a? TrueClass
+	export = true
+else
+	expense = -params[:expense].to_s.gsub('.', '').sub(/,/, '.').to_f.round(3).abs
+end
+
+# puts 'argv len: ' + ARGV.length.to_s
+# puts 'command:    ' + '%-10s' % command.class.to_s + '     "' + command.to_s + '"'
+# puts 'wallet:     ' + '%-10s' % wallet.class.to_s + '     "' + wallet.to_s + '"'
+# puts 'title:      ' + '%-10s' % title.class.to_s + '     "' + title + '"'
+# puts 'date:       ' + '%-10s' % date.class.to_s + '     "' + date + '"'
+# puts 'revenue:    ' + '%-10s' % revenue.class.to_s + '     "' + revenue.to_s + '"'
+# puts 'expense:    ' + '%-10s' % expense.class.to_s + '     "' + expense.to_s + '"'
+# puts 'category:   ' + '%-10s' % category.class.to_s + '     "' + category + '"'
+# puts 'comment:    ' + '%-10s' % comment.class.to_s + '     "' + comment.to_s + '"'
+# puts 'path:       ' + '%-10s' % path.class.to_s + '     "' + path.to_s + '"'
+# puts
+
+if command == 'help' || command.length == 0
+	script_name = File.basename(__FILE__)
+	padding = ' ' * (script_name.length + 8)
+	
+	puts "#{::TheFox::Wallet::NAME} #{::TheFox::Wallet::VERSION} (#{::TheFox::Wallet::DATE})"
+	puts 'Usage: ' + script_name + ' COMMAND OPTIONS'
+	puts
+	puts 'Commands:'
+	puts padding + 'help                Show this help'
+	puts padding + 'add                 Add a new entry'
+	puts padding + 'i|int               Add a new entry interactively'
+	puts padding + 'l|list              List entries'
+	puts padding + 'lc|cat              List categories'
+	puts padding + 'html                Generate HTML files'
+	puts padding + 'csv                 Import/Export CSV file'
+	puts padding + 'vi                  Import per VIM editor'
+	puts
+	puts 'Options:'
+	puts padding + '-w|--wallet PATH    Optional'
+	puts padding + '-t|--title TITLE    Required for command "add"'
+	puts padding + '-d|--date           Optional'
+	puts padding + '-r|--revenue        Optional. Default: 0'
+	puts padding + '-e|--expense        Optional. Default: 0'
+	puts padding + '-c|--category       Optional. Default: default'
+	puts padding + '-o|--comment        Optional'
+	puts padding + '-i|-e               Import or Export. Default: -i'
+	puts padding + '-p|--path PATH      Required for command "csv"'
+	
+	exit 3
+end
+
+if command == 'int'
+	command = 'add'
+	
+	print 'title: [' + title + '] '
+	title_t = STDIN.gets.strip
+	if title_t.length > 0
+		title = title_t
+	end
+	
+	print 'date: [' + date + '] '
+	date_t = STDIN.gets.strip
+	if date_t.length > 0
+		date = date_t
+	end
+	
+	print 'revenue: [' + revenue.to_s + '] '
+	revenue_t = STDIN.gets.strip
+	if revenue_t.length > 0
+		revenue = revenue_t.to_s.gsub('.', '').sub(/,/, '.').to_f.round(3).abs
+	end
+	
+	print 'expense: [' + expense.to_s + '] '
+	expense_t = STDIN.gets.strip
+	if expense_t.length > 0
+		expense = -expense_t.to_s.gsub('.', '').sub(/,/, '.').to_f.round(3).abs
+	end
+	
+	if category.to_s.length == 0
+		category = 'default'
+	end
+	print 'category: [' + category + '] '
+	category_t = STDIN.gets.strip
+	if category_t.length > 0
+		category = category_t
+	end
+	
+	print 'comment: [' + comment + '] '
+	comment_t = STDIN.gets.strip
+	if comment_t.length > 0
+		comment = comment_t
+	end
+	
+	puts '-' * 20
+elsif command == 'vi'
+	vi_file = Tempfile.create('wallet-vi-import', '/tmp')
+	vi_file.puts('# This is a comment line.')
+	vi_file.puts('# Date,Title,Revenue,Expense,Category,Comment')
+	vi_file.puts('# Date,Title,Expense')
+	vi_file.close
+	
+	puts 'cwd:    ' + Dir.pwd
+	puts 'editor: ' + ENV['EDITOR']
+	puts 'file:   ' + vi_file.path
+	sleep 1
+	
+	system(ENV['EDITOR'] + ' ' + vi_file.path)
+	system('grep -v "#" ' + vi_file.path + ' | grep -v ^$ > ' + vi_file.path + '.ok')
+	
+	command = 'csv'
+	path = vi_file.path + '.ok'
+	path_is_temp = true
+	import = true
+	
+	File.unlink vi_file.path
+end
+
+wallet = TheFox::Wallet::Wallet.new(wallet)
+
+if command == 'add'
+	if category.to_s.length == 0
+		category = 'default'
+	end
+	
+	if title == ''
+		puts 'ERROR: Option --title is required for command "' + command + '"'
+		exit 1
+	end
+	
+	puts 'title:    ' + title
+	puts 'date:     ' + Date.parse(date).to_s
+	puts 'revenue:  ' + revenue.to_s
+	puts 'expense:  ' + expense.to_s
+	puts 'balance:  ' + (revenue + expense).to_f.round(3).to_s
+	puts 'category: ' + category.to_s
+	puts 'comment:  ' + comment.to_s
+	
+	wallet.add TheFox::Wallet::Entry.new(title, date, revenue, expense, category, comment)
+elsif command == 'list'
+	puts
+	
+	year, month, day = date.scan(/^(\d{2,4}).?(\d{0,2}).?(\d{0,2})/).shift.map{ |x|
+		y = x.to_i
+		y == 0 ? nil : y
+	}
+	
+	entries = wallet.entries(year, month, day, category)
+	
+	entries_l = entries.map{ |day_name, day_items| day_items.count }.inject{ |sum, n| sum + n }.to_s.length
+	title_l = entries.map{ |month_item| month_item[1].map{ |day_item| day_item['title'].length } }.flatten.max.to_i
+	revenue_l = entries.map{ |month_item| month_item[1].map{ |day_item| (::TheFox::Wallet::NUMBER_FORMAT % day_item['revenue']).length } }.flatten.max.to_i
+	expense_l = entries.map{ |month_item| month_item[1].map{ |day_item| (::TheFox::Wallet::NUMBER_FORMAT % day_item['expense']).length } }.flatten.max.to_i
+	balance_l = entries.map{ |month_item| month_item[1].map{ |day_item| (::TheFox::Wallet::NUMBER_FORMAT % day_item['balance']).length } }.flatten.max.to_i
+	category_l = entries.map{ |month_item| month_item[1].map{ |day_item| day_item['category'].length } }.flatten.max.to_i
+	comment_l = entries.map{ |month_item| month_item[1].map{ |day_item| day_item['comment'].length } }.flatten.max.to_i
+	
+	has_category_col = entries.map{ |month_item| month_item[1].map{ |day_item| day_item['category'] } }.flatten.select{ |i| i != 'default' }.count > 0
+	has_comment_col = entries.map{ |month_item| month_item[1].map{ |day_item| day_item['comment'] } }.flatten.select{ |i| i != '' }.count > 0
+	
+	if title_l < 6
+		title_l = 6
+	end
+	if title_l > 25
+		title_l = 25
+	end
+	
+	if revenue_l < 7
+		revenue_l = 7
+	end
+	if expense_l < 7
+		expense_l = 7
+	end
+	if balance_l < 7
+		balance_l = 7
+	end
+	if category_l < 8
+		category_l = 8
+	end
+	if comment_l > 25
+		comment_l = 25
+	end
+	
+	entries_f = '%' + entries_l.to_s + 's'
+	title_f = '%-' + title_l.to_s + 's'
+	revenue_f = '%' + revenue_l.to_s + 's'
+	expense_f = '%' + expense_l.to_s + 's'
+	balance_f = '%' + balance_l.to_s + 's'
+	category_f = '%-' + category_l.to_s + 's'
+	comment_f = '%-' + comment_l.to_s + 's'
+	
+	header = ''
+	header += '#' * entries_l + '  '
+	header += 'Date ' + ' ' * 7
+	header += title_f % 'Title' + '  '
+	header += revenue_f % 'Revenue' + '  '
+	header += expense_f % 'Expense' + '  '
+	header += balance_f % 'Balance'
+	header += '  ' + category_f % 'Category' if has_category_col
+	header += '  ' + comment_f % 'Comment' if has_comment_col
+	
+	header_l = header.length
+	header.sub!(/ +$/, '')
+	puts header
+	puts '-' * header_l
+	
+	revenue_total = 0.0
+	expense_total = 0.0
+	balance_total = 0.0
+	previous_date = ''
+	entry_no = 0
+	entries.sort.each do |day_name, day_items|
+		day_items.each do |entry|
+			entry_no += 1
+			
+			title = entry['title']
+			title = title[0, 22] + '...' if title.length >= 25
+			
+			revenue_total += entry['revenue']
+			expense_total += entry['expense']
+			balance_total += entry['balance']
+			
+			category = entry['category'] == 'default' ? '' : entry['category']
+			has_category = category != ''
+			
+			comment = entry['comment']
+			comment = comment[0, 22] + '...' if comment.length >= 25
+			
+			out = ''
+			out += entries_f % entry_no
+			out += '  ' + '%10s' % (entry['date'] == previous_date ? '' : entry['date'])
+			out += '  ' + title_f % title
+			out += '  ' + revenue_f % (::TheFox::Wallet::NUMBER_FORMAT % entry['revenue'])
+			out += '  ' + expense_f % (::TheFox::Wallet::NUMBER_FORMAT % entry['expense'])
+			out += '  ' + balance_f % (::TheFox::Wallet::NUMBER_FORMAT % entry['balance'])
+			out += '  ' + category_f % category if has_category_col
+			out += '  ' + comment_f % comment if has_comment_col
+			
+			out.sub!(/ +$/, '')
+			puts out
+			
+			previous_date = entry['date']
+		end
+	end
+	puts
+	
+	out = ''
+	out += ' ' * (12 + entries_l)
+	out += '  ' + title_f % 'TOTAL'
+	out += '  ' + revenue_f % (::TheFox::Wallet::NUMBER_FORMAT % revenue_total)
+	out += '  ' + expense_f % (::TheFox::Wallet::NUMBER_FORMAT % expense_total)
+	out += '  ' + balance_f % (::TheFox::Wallet::NUMBER_FORMAT % balance_total)
+	puts out
+elsif command == 'cat'
+	categories = wallet.categories
+	puts 'categories(' + categories.count.to_s + '):'
+	categories.each do |category_item|
+		puts "\t" + category_item
+	end
+elsif command == 'html'
+	puts 'generate html to ' + wallet.html_path + ' ...'
+	wallet.gen_html
+	puts 'generate html done'
+elsif command == 'csv'
+	if path == ''
+		puts 'ERROR: Option --path is required for command "' + command + '"'
+		exit 1
+	end
+	
+	if import || !export
+		puts 'import csv ' + path + ' ...'
+		wallet.import_csv_file path
+		puts 'import csv ' + path + ' done'
+		
+		if path_is_temp
+			puts 'delete ' + path
+			File.unlink(path)
+		end
+	elsif export
+		puts 'export csv ' + path + ' ...'
+		wallet.export_csv_file path
+		puts 'export csv ' + path + ' done'
+	end
+end