Data Processing

Acquiring Data

Via ActiveRecord (acts_as_reportable)
FeatureCoverage
How AAR is loaded ("ruport" vs. "ruport/acts_as_reportable") CS:AAR
report_table() basics CS:AAR d3 | v1.2
using :include CS:AAR d3 | v1.2
using :except, :only, :methods CS:AAR d3 | v1.2
using :filters and :transforms CS:AAR d3 | v1.2
report_table_by_sql CS:AAR d3 | v1.2
acts_as_reportable defaults CS:AAR d3 | v1.2
Eager loading discussion (how to disable) CS:AAR d3 | v1.2
Unordered result-set discussion and workaround CS:AAR
Via Raw SQL (Ruport::Query)
FeatureCoverage
List of DBI DSNs and brief DBI overview CS:query d2 | v1.2
Configuration CS:query d2 | v1.2
Query as an enumerable data set CS:query d2 | v1.2
Raw data processing CS:query d2 | v1.2
execute() for non-returning queries CS:query d2 | v1.2
Using multiple sources CS:query d2 | v1.2
An interesting generator example CS:query d2 | v1.2
From CSV
FeatureCoverage
FasterCSV Intro / Overview Chapter TBD
Basic Loading / Parsing Chapter TBD
Using :csv_options Chapter TBD
Using :filters and :transforms Chapter TBD
Using Table() shortcut Chapter TBD

Manipulating Data

Table and Record
FeatureCoverage
Decent Explanation of Record Indexing and Constructor Tutorial Intro
Column operations (*_column) CS:data_manip d2 | v1.2
Sums (sigma) CS:data_manip d2 | v1.2
sub_table / reduce CS:data_manip d2 | v1.2
Searching Tables (rows_with) CS:data_manip d2 | v1.2
Using :filters and :transforms, and block feeder CS:data_manip d2 | v1.2
Sorting tables CS:data_manip d2 | v1.2
Table() PayR Formatting 1
Feeder
FeatureCoverage
Explain what feeders are for CS:data_manip d2 | v1.2
Filters CS:data_manip d2 | v1.2
Transforms CS:data_manip d2 | v1.2
Custom Data Feeders Example Chapter TBD
Group and Grouping
FeatureCoverage
Sums (sigma) CS:data_manip d2 | v1.2
Subgroupings (/) missing in CS:data_manip d2
Summarizing Grouped Data (#summary) CS:data_manip d2 | v1.2
Sorting Groupings CS:data_manip d2 | v1.2
Grouping() shortcut Tutorial Intro, PayR Formatting 1

Formatting and Rendering

Ruport's Formatting System

FeatureCoverage
Suitable Introduction to the system as a whole CS:formatting2 d4 | v1.2

Renderers

Ruport::Renderer
FeatureCoverage
Basics (prepare,stages,finalize,options) CS:formatting2 d4 | v1.2
setup CS:renderer_logic d2 | v1.2
Helpers module CS:renderer_logic d2 | v1.2
Renderer::Hooks CS:renderer_logic d2 | v1.2
Table and Row Renderer
FeatureCoverage
All formatter hooks CS:formatting2 d4 | v1.2
Default layout options Chapter TBD
Grouping and Group Renderer
FeatureCoverage
All formatter hooks Chapter TBD
Default layout options Chapter TBD

Formatters

Ruport::Formatter
FeatureCoverage
Basics (renders :format, :for => Renderer, etc.) CS:formatting2 d4 | v1.2
Background on how output works Chapter TBD
Formatter::RenderingTools Payr Formatting 1
Per-format selectors (e.g. pdf { ... }) CS:renderer_logic d2 | v1.2
build :stage syntax Payr Formatting 1, CS:formatting2
Templates
FeatureCoverage
Overview of creating and applying a template CS:formatting2 d4 | v1.2
Using default templates CS:formatting2
CSV
FeatureCoverage
Template usage instructions Chapter TBD
format_options example (TSV output?) Chapter TBD
grouping style example Chapter TBD
HTML
FeatureCoverage
Template usage instructions Chapter TBD
html_table() Chapter TBD
textile() PayR Formatting 1
grouping style example PayR Formatting 1
Text
FeatureCoverage
Template usage instructions Chapter TBD
Show how to set fixed widths for columns Chapter TBD
Show how to disable truncation / truncate at a certain limit Chapter TBD
PDF
FeatureCoverage
Template usage instructions CS:formatting2 d4 | v1.2
Show how to build standard report headers CS:printable d2 | v1.2
Per-page headers CS:printable d2 | v1.2
Custom Table Drawing with draw_table CS:printable d2 | v1.2
Page numbering missing in CS:printable d2
PDF::DrawingHelpers CS:printable d2 | v1.2
center_image_in_box() CS:printable d2 | v1.2
draw_text!() CS:printable d2 | v1.2
rounded_text_box() CS:printable d2 | v1.2

Utilities

ruport-util

rope
FeatureCoverage
Configuration CS:rope d6 | v1.2
Generating Renderers and Reports CS:rope d6 | v1.2
Generating and using ActiveRecord models CS:rope d6 | v1.2
Using Templates across reports Missing in CS:rope d6
Mailer
FeatureCoverage
Configuration CS:report d3 | v1.2
Authenticated Configuration Chapter TBD
Basic use with Ruport::Report CS:report d3 | v1.2
Dealing with multiple recipients Chapter TBD
Standalone use Chapter TBD
PayR Mailer Example Chapter TBD
Report and ReportManager
FeatureCoverage
Renderer::Hooks and using as(), save_as() CS:report d3 | v1.2
Using query() CS:report d3 | v1.2
Dynamically managing many reports (ReportManager) CS:report d3 | v1.2
Practical Examples in PayR Chapter TBD
PDF Form Helpers
FeatureCoverage
General Usage / Simple Example PayR Formatting 2
form_field details Chapter TBD
option_box details Chapter TBD
Graphing
FeatureCoverage
Simple SVG Example Chapter TBD
Simple XML/SWF Example Chapter TBD
Using SVG in web app Chapter TBD
JPG / PNG via RMagick? PayR Formatting 2
draw_graph PayR Formatting 2