lewt 0.5.12

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 5b3e642248afd3ef3d87a72ad3ea77fe7233bd00
+  data.tar.gz: 2f1cdbcdc9f6bb46c0a6a6e6af37ead5a75e9c29
+SHA512:
+  metadata.gz: 832a00f6f7ae4d399cb02131bf6efff644674ce013aec8cbc434afa35e0494a7e1c9cb218ad218d9a126e1c36b3f7978d12748c6193e6c9f0ecc8b11190a1556
+  data.tar.gz: ef329864a9f15c557976cecd041fd148f0ceaf226dc5eb7de82403e0ac3dbe24b44f021a50ceaaedc5279dc404ddb6ad97a7495b00a5b7f34ac1103d4a1b1854

data/LICENSE.md

@@ -0,0 +1,22 @@
+The MIT License (MIT)
+
+Copyright (c) 2014 Jason Wijegooneratne
+
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,238 @@
+# LEWT v0.5.12
+
+LEWT is a command line program & library written in Ruby that can help you invoice customers, manage expenses, generate reports and much more. It is designed to encourage lazy accounting, to get more out of it, and to be extended with minimal friction. 
+
+**Features**
+
+- Can operate in a terminal or as a drop in library for your Ruby programs.
+- Simple & concise architecture. Less than 1300 lines of ruby code including the bundled core extensions and tests.
+- A nifty extension system that plays well with Ruby Gems.
+
+## Installation
+
+LEWT requires you have [Ruby](https://www.ruby-lang.org/en/) & [Ruby Gems](https://rubygems.org) installed on your machine. Once you have that sorted:
+
+```
+ gem install lewt
+```
+
+then test with:
+
+```
+# output lewt's version number
+lewt --version
+```
+
+LEWT ships with some dummy data and config so you can jump straight into the quick start guide.
+
+## Quick Start
+
+The LEWT program is based around a procedure I call *extract, process, render* [EPR]. Data is extracted from some source(s) and transformed into a general ledger data structure, this is then passed to the specified processor(s) which may use it to perform calculations, the processed data is then finally passed onto a renderer for outputting in a useful format. All EPR operations are handled by LEWT Extensions, thus a basic LEWT command only involves you specify which extensions to use for the EPR procedure:
+
+```
+# -e = extractor, -p = processor, -o = renderer. Outputs an invoice for target customer Wayne Corp [alias: WCorp] since 1 sep 2014
+lewt -x calendar -p invoice -o liquid -t WCorp -s 01-09-2014
+
+...
+
+# sample text output
+*******
+Dear Bruce Wayne,
+
+You have recived a new invoice from Jason Wijegooneratne
+
+*******
+
+Date Created: 17/09/14
+ID: 12-4d7d2c79
+
+INVOICED TO:
+Wayne Corp,
+2 Wayne Street
+90210, Gotham,
+Cartoon Land,
+abn: 45 443 23 123.
+
+
+INVOICED FROM:
+Your Trading Name,
+13 Your Street,
+0, O-state,
+O-stralia,
+abn 45 443 23 123.
+
+ITEMS:
+--
+ 03/09/14  7:00pm >>> 04/09/14  5:45am
+ $150 * 10.75 hrs = $1612.5
+ Hacking on the bat mobile in secrecy. 
+--
+ 10/09/14  7:00pm >>> 11/09/14  3:00am
+ $150 * 8.0 hrs = $1200.0
+ Hacking on the bat mobile in secrecy. 
+
+
+---------------------------
+SUB-TOTAL: 2812.5
+TAX [gst]: 281.25
+---------------------------
+TOTAL: 3093.75
+
+*******
+
+```
+
+You can also extract from multiple sources at once:
+
+```
+# extract time sheet data, expenses, and milestone data for all customers since begining of year and mash it up into a report.
+lewt -x expenses,calendar,milestones -s 01-01-2014 -p report -o liquid
+
+...
+
+# sample text output
+*******
+
+Date Created: 17/09/14
+Included:
+ ACME
+ Wayne Corp
+         
+Revenue: 63737.5
+Expenses: -740.0
+Tax-Levees:
+ income tax[0.0]: 0.0
+ income tax[0.19]: 3609.81
+ income tax[0.325]: 12020.86
+ GST[0.1]: 6373.75
+
+Bottom Line: 40993.08
+-----------------------------------
+Hours Worked: 311.0
+*******
+
+```
+
+LEWT's default liquid template rendering extension supports multiple output formats, it can even use WebKit to render a PDF from one of your templates complete with CSS stylesheets support!
+
+```
+# output an invoice for specified customer as text, save a pdf simultaneously.
+lewt -x expenses,calendar -p invoice -o liquid -t WCorp -s 01-09-2014 --method pdf,text --save-path wcorp-invoice.pdf
+
+# create separate pdf invoices for all customers using some naming templates
+lewt -x expenses,calendar -p invoice -o liquid --method pdf -s 01-09-2014 --save-path "#date #alias.pdf"
+
+...
+
+# sample output. files will be written to FS.
+20XX-MM-DD ACME.pdf
+20XX-MM-DD WCorp.pdf
+```
+
+LEWT does not use a database, persisting data is done on a file system:
+
+```
+# Persist some processed data in YAML format using the store extension
+lewt -t ACME -p invoice -o store >> invoice.yml
+
+# reuse it and output it in plain text
+cat invoice.yml | lewt pipe render -p invoice -m text
+```
+
+LEWT can even help you generate basic statistics on the fly and supports embedded [metatags](https://github.com/jdwije/LEWT/wiki/Metatags) in your extraction sources:
+
+```
+# output a frequency table of hash tags #good-day, #bad-day by customer. use
+# store for output as liquid template is dodgy.
+lewt -x calendar -p metastat --tags good-day,bad-day -s 01-01-2014 -o store
+
+...
+
+# sample YAML output
+---
+- frequency_table:
+    ACME:
+      bad_day: 10
+      good_day: 5
+    Wayne Corp:
+      good_day: 5
+      bad_day: 4
+```
+
+For a list of options available run:
+
+```
+lewt --help
+```
+
+You can perform all of the above using LEWT as a library in your projects as well.
+
+```
+require "LEWT"
+
+
+options = {
+	:extract => 'calendar',
+	:process => 'invoice',
+	:render => 'liquid',
+	:target => 'ACME',
+	:dump_output => false
+}
+
+# returns a hash containing the invoice data for further use
+lewt_invoice = LEWT::Lewt.new( options ).run 
+
+```
+
+## LEWT Extensions
+
+LEWT by itself is basically just an extension system, all the EPR operations are performed by extensions making LEWT very customisable. Being a beta version of this software, I have shipped LEWT with some basic extension which I find useful in my day to day contracting operations but I'm hoping others will replace them with better versions in time :) these *core extensions* as I will call them for now are:
+
+1. Calendar Timekeeping: Extract Time sheet data from iCal, OSX Calendar, and Google Calender sources and transform it for further processing.
+2. Simple Invoices: Process extract data as an invoice.
+3. Simple Reports: Process extract data as a report.
+4. Liquid Renderer: Liquid template rendering with support for text, html, and PDF tempting.
+5. Simple Expenses: Manage expenses with in simple CSV file and extract it into LEWT.
+6. Simple Milestones: Manage milestone payments in a CSV file and extract it into LEWT.
+7. Store: Persist lewt data as YAML formatted files. Re-use this data later.
+8. Metastat: Generate simple statistics from your data sources using embedded metatags.
+
+Conceptually, there are 3 different kinds of extensions: **Extractors, Processors, and Renderers**, however for now they all inherit from the same **LEWT::Extension** base class. This class provides some convenience methods for the extensions as well as a means for them to register themselves within LEWT.
+
+It's pretty easy to get started creating your own extension for LEWT, see the [Authoring LEWT Extensions](https://github.com/jdwije/LEWT/wiki/3-Creating-Extensions-for-LEWT) for more information.
+
+
+## Configuration
+
+LEWT (and it's extensions) want config. They want it in the form of flat YAML files which can be stored in your ```/config``` directory, see [Installation & Setup](https://github.com/jdwije/LEWT/wiki/2-Installation-&-Setup) for more on this. LEWT's default config directory is ```path/to/lewt/lib/config/``` but you can change this if you like.
+
+## Want to learn more?
+
+Checkout the [WIKI](https://github.com/jdwije/LEWT/wiki) section for a bunch of tutorials on setting LEWT up and getting started writing extensions.
+
+Finally go browse through the source code, there is only ~1300 lines of ruby including comments with which I have tried to be liberal.
+
+
+## Disclaimer
+
+LEWT is very much beta-ware. I only just started using it myself in my contracting operations, however it's making thing's easier for me so I thought I'd release it as is - when you find those bugs I would love to hear about them!
+
+## License
+
+LEWT is distributed under the terms and conditions of the MIT license, see LICENSE.md for more information.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+

data/bin/lewt

@@ -0,0 +1,10 @@
+#!/usr/bin/env ruby
+
+# This is the command line tool wrapper for LEWT. RubyGEMS makes this available at $PATH.
+
+require 'lewt'
+
+lewt = LEWT::Lewt.new
+
+# invoke the logic loop
+lewt.run

data/lib/config/customers.yml

@@ -0,0 +1,33 @@
+---
+-
+ name: ACME
+ business_number: 45 443 23 123
+ address:
+   lines: 2 ACME Rd
+   city    : Old Skool
+   state   : Digidom
+   postal  : 90210
+   country: Cartoon Land
+ contact:
+  name: 
+   first: Wiley
+   last: Coyote
+  email: wiley@acme.com
+ alias: AC
+ rate: 100
+-
+ name: Wayne Corp
+ business_number: 45 443 23 123
+ address:
+   lines: 2 Wayne Street
+   city    : Gotham City
+   state   : Gotham
+   postal  : 90210
+   country: Cartoon Land
+ contact:
+  name: 
+   first: Bruce
+   last: Wayne
+  email: bruce@waynecorp.com
+ alias: WCorp
+ rate: 150

data/lib/config/enterprise.yml

@@ -0,0 +1,54 @@
+---
+name: Your Trading Name
+business_number: 123456
+address:
+ lines:	13 Your Street
+ city    : O-town
+ state   : O-state
+ postal  : 0000
+ country: O-stralia
+contact:
+ name: Your Name
+ email: your@email.com
+alias: YTN
+rate: 50
+invoice-tax: 0.10
+tax_levees:
+ -
+   applies_to: income
+   name: income tax
+   lower_threshold: 0
+   upper_threshold: 18000
+   rate: 0.00
+ -
+   applies_to: income
+   name: income tax
+   lower_threshold: 18001
+   upper_threshold: 37000
+   rate: 0.19
+ -
+   applies_to: income
+   name: income tax
+   lower_threshold: 37001
+   upper_threshold: 80000
+   flatrate: 3572
+   rate: 0.325
+ -
+   applies_to: income
+   name: income tax
+   lower_threshold: 80001
+   upper_threshold: 180000
+   flatrate: 17547
+   rate: 0.37
+ -
+   applies_to: income
+   name: income tax
+   lower_threshold: 180000
+   upper_threshold: ~
+   flatrate: 54547
+   rate: 0.45
+ -
+   applies_to: revenue
+   name: GST
+   rate: 0.10
+ 

data/lib/config/settings.yml

@@ -0,0 +1,10 @@
+---
+ical_filepath: tests/LEWT Schedule.ics
+osxcal_path: /path/to/osxcalender/dir/
+gmail_username: you@google.com
+gmail_password: your_secret
+gmail_app_name: some-goggle-hash-code
+expenses_filepath: tests/expenses.csv
+milestones_filepath: tests/milestones.csv
+store_path: /path/to/store/dir/
+invoice_id_counter: 12

data/lib/config/templates/invoice.html.liquid

@@ -0,0 +1,63 @@
+<html>
+<head>
+  <link rel="stylesheet" type="text/css" href="style.css" />
+</head>
+<body>
+<hr />
+
+<p>
+  <b>Date Created:</b> {{ date_created }} <br />
+  <b>ID:</b> {{ id }} <br />
+</p>
+
+<h3>INVOICED TO:</h3>
+<address>
+  {{ billed_to.name }},<br />
+  {{ billed_to.address.lines }},<br />
+  {{ billed_to.address.postal }}, {{ billed_to.address.state }},<br />
+  {{ billed_to.address.country }},<br />
+  abn: {{ billed_to.business_number }}.
+</address>
+
+<h3>INVOICED FROM:</h3>
+<address>
+  {{ billed_from.name }},<br />
+  {{ billed_from.address.lines }},<br />
+  {{ billed_from.address.postal }}, {{ billed_from.address.state }},<br />
+  {{ billed_from.address.country }},<br />
+  abn: {{ billed_from.business_number }}.
+</address>
+
+<h2>ITEMS:</h2>
+<ul class="unstyled invoice-items">
+  {% for item in items %}
+   <li>
+     <table>
+       <tr>
+	 <td><strong>Start:</strong> {{ item.start }}</td> 
+	 <td><strong>End:</strong> {{ item.end }}</td>
+	 <td><strong>Rate:</strong> ${{ item.rate }}</td>
+	 <td><strong>Duration:</strong> {{ item.duration }}</td> 
+	 <td><strong>Total:</strong> ${{ item.total }}</td>
+       </tr>
+	 <tr class="invoice-item-description">
+	   <td colspan="5">
+	     {{ item.description }}
+	   </td>
+	 <tr>
+     </table>
+   </li>
+  {% endfor %}
+</ul>
+
+<p>
+  <b>SUB-TOTAL:</b> {{ sub-total }}<br />
+  <b>TAX [gst]:</b> {{ tax }}
+</p>
+
+<h3>TOTAL: <span>{{ total }}</span></h3>
+
+<hr />
+</body>
+</html>
+

data/lib/config/templates/invoice.text.liquid

@@ -0,0 +1,40 @@
+Dear {{ billed_to.contact.name.first }} {{ billed_to.contact.name.last }},
+
+You have recived a new invoice from Jason Wijegooneratne
+
+*******
+
+Date Created: {{ date_created }}
+ID: {{ id }}
+
+INVOICED TO:
+{{ billed_to.name }},
+{{ billed_to.address.lines }}
+{{ billed_to.address.postal }}, {{ billed_to.address.state }},
+{{ billed_to.address.country }},
+abn: {{ billed_to.business_number }}.
+
+
+INVOICED FROM:
+{{ billed_from.name }},
+{{ billed_from.address.lines }},
+{{ billed_from.address.postal }}, {{ billed_from.address.state }},
+{{ billed_from.address.country }},
+abn {{ billed_to.business_number }}.
+
+ITEMS:
+{% for item in items %}--
+ {{ item.start }} >>> {{ item.end }}
+ ${{ item.rate }} * {{ item.duration }} hrs = ${{ item.total }}
+ {{ item.description }}
+{% endfor %}
+
+---------------------------
+SUB-TOTAL: {{ sub-total }}
+TAX [gst]: {{ tax }}
+---------------------------
+TOTAL: {{ total }}
+
+*******
+
+

data/lib/config/templates/meta.text.liquid

@@ -0,0 +1 @@
+Meta Log not yet fully implemented.

data/lib/config/templates/metastat.html.liquid

@@ -0,0 +1,2 @@
+Meta Stat not yet fully implemented. Output with store instead i.e. -o store
+----------------------------------------------------------------------------

data/lib/config/templates/metastat.text.liquid

@@ -0,0 +1,8 @@
+Meta Stat not yet fully implemented. Output with store instead i.e. -o store
+----------------------------------------------------------------------------
+
+{% for f in frequency_table %}
+{% for tag in f %}
+{{ tag }}    
+{% endfor %}
+{% endfor %}

data/lib/config/templates/report.html.liquid

@@ -0,0 +1,29 @@
+<hr />
+<img id="logo" src="/Users/JWIJESWWW/Documents/lewtstash/templates/logo.jpg" />
+
+<p><b>Date Created:</b> {{ date_created }}</p>
+
+Included:
+<ul>
+{% for target in included_customers %} 
+<li>{{ target.name }}</li>
+{% endfor %}
+</ul>
+
+<p><b>Revenue:</b> {{ revenue }}</p>
+<p><b>Expenses:</b> {{ expenses }}</p>
+
+Tax-Levees:
+<ul>
+{% for tax in taxes %} 
+<li>{{ tax.name }}[{{ tax.rate }}]: {{ tax.amount }}</li>
+{% endfor %}
+</ul>
+
+<p><b>Bottom Line:</b> {{ bottom_line }}</p>
+
+<hr />
+
+<p><b>Hours Worked:</b> {{ hours }}</p>
+
+<hr />

data/lib/config/templates/report.text.liquid

@@ -0,0 +1,15 @@
+*******
+
+Date Created: {{ date_created }}
+Included:
+{% for target in included_customers %} {{ target.name }}
+{% endfor %}    	 
+Revenue: {{ revenue }}
+Expenses: {{ expenses }}
+Tax-Levees:
+{% for tax in taxes %} {{ tax.name }}[{{ tax.rate }}]: {{ tax.amount }}
+{% endfor %}
+Bottom Line: {{ bottom_line }}
+-----------------------------------
+Hours Worked: {{ hours }}
+*******