UR-0.44 - rich declarative transactional objects

Changes for version 0.44 - 2015-06-30

Added UR::Context::AutoUnloadPool - a mechanism for automatically unloading objects when a leaving a scope. Added methods to UR::Object::Type to introspect methods names relating to is_many properties. The MetaDB no longer tracks owner/schema. Classes using tables not in the default schema should have their table_name listed as "schema.table". Added copy() constructor to UR::Object Removed old, deprecated filter parser for turning text into a UR::BoolExpr within UR::Object::Command::List Meta-params like -order_by are now allowed in a delegated property's where clase. Retrieving values for doubly-delegated properties is more efficient. An id-by delegated property can point to a class with multiple ID properties. The linking value is the composite ID. Observers now have a 'once' property. Setting it to true ensures the callback will only ever fire one time. The Observer is deleted. Properties can have a 'calculated_default' subref. Works like default_value, but the return value from the subref is the default value rather than have a hardcoded default. Fixes to work with newer versions of SQLite Added __rollback__() to UR::Object, called when the base Context rolls-back. Subclasses can override this to provide special behavior during rollback. The override should also call SUPER::__rollback__().

Documentation

command-line interface to UR

UR::Env

Environment variables that control UR behavior

UR::Manual

Short list of UR's documentation

UR::Manual::Cookbook

Recepies for getting things working

UR::Manual::Metadata

Overview of the metadata classes in UR

UR::Manual::Overview

UR from Ten Thousand Feet

UR::Manual::Presentation

Slides for a presenation on UR

UR::Manual::SchemaDesign

Tips for designing an efficient schema for UR

UR::Manual::Tutorial

Step-by-step guide to building a set of classes for a simple database schema

tools to create and maintain a ur class tree

Modules

Command::DynamicSubCommands

auto-generate sub-commands based on other classes

Command::Tree

Command::V1

base class for modules implementing the command pattern

Command::V2

base class for modules implementing the command pattern

rich declarative transactional objects

UR::All

UR::BoolExpr

a "where clause" for objects

UR::BoolExpr::Template

a UR::BoolExpr minus specific values

UR::BoolExpr::Template::And

a rule which is true if ALL the underlying conditions are true

UR::BoolExpr::Template::Composite

an "and" or "or" rule

UR::BoolExpr::Template::Or

a rule which is true if ANY of the underlying conditions are true

UR::BoolExpr::Template::PropertyComparison

implements logic for rules with a logic_type of "PropertyComparison"

UR::BoolExpr::Template::PropertyComparison::Between

perform a 'between' test

UR::BoolExpr::Template::PropertyComparison::Equals

perform a strictly equals test

UR::BoolExpr::Template::PropertyComparison::False

evaluates to true if the property's value is false

UR::BoolExpr::Template::PropertyComparison::GreaterOrEqual

perform a greater than or equal test

UR::BoolExpr::Template::PropertyComparison::GreaterThan

perform a greater than test

UR::BoolExpr::Template::PropertyComparison::In

perform an In test

UR::BoolExpr::Template::PropertyComparison::Isa

Test whether a value is-a subclass of another class

UR::BoolExpr::Template::PropertyComparison::LessOrEqual

perform a less than or equal test

UR::BoolExpr::Template::PropertyComparison::LessThan

perform a less than test

UR::BoolExpr::Template::PropertyComparison::Like

perform an SQL-ish like test

UR::BoolExpr::Template::PropertyComparison::Matches

perform a Perl regular expression match

UR::BoolExpr::Template::PropertyComparison::NotBetween

perform a 'not between' test

UR::BoolExpr::Template::PropertyComparison::NotEquals

perform a not-equal test

UR::BoolExpr::Template::PropertyComparison::NotIn

perform a negated In comparison

UR::BoolExpr::Template::PropertyComparison::NotLike

perform a negated SQL-ish like test

UR::BoolExpr::Template::PropertyComparison::True

Evaluates to true if the property's value is true

UR::BoolExpr::Util

non-OO module to collect utility functions used by the BoolExpr modules

UR::Context

Manage the current state of the application

UR::Context::AutoUnloadPool

Automaticaly unload objects when scope ends

UR::Context::DefaultRoot

The base context used when no special base context is specified

UR::Context::ObjectFabricator

Track closures used to fabricate objects from data sources

UR::Context::Process

Impliments a generic interface to the current application.

UR::Context::Transaction

API for software transactions

UR::DBI

methods for interacting with a database.

UR::DBI::Report

a database report interface

UR::DataSource

manage the the relationship between objects and a specific storage system

UR::DataSource::CSV

Parent class for data sources using DBD::CSV

UR::DataSource::File

Parent class for file-based data sources

UR::DataSource::FileMux

Parent class for datasources which can multiplex many files together

UR::DataSource::Filesystem

Get and save objects to delimited text files

UR::DataSource::Meta

Data source for the MetaDB

UR::DataSource::MySQL

MySQL specific subclass of UR::DataSource::RDBMS

UR::DataSource::Oracle

Oracle specific subclass of UR::DataSource::RDBMS

UR::DataSource::Pg

PostgreSQL specific subclass of UR::DataSource::RDBMS

UR::DataSource::RDBMS

Abstract base class for RDBMS-type data sources

UR::DataSource::RDBMS::BitmapIndex

metadata about a data source's bitmap indexes

UR::DataSource::RDBMS::Entity

Parent class for all MetaDB-sourced classes

UR::DataSource::RDBMS::FkConstraint

metadata about a data source's foreign keys

UR::DataSource::RDBMS::FkConstraintColumn

metadata about a data source's foreign keys

UR::DataSource::RDBMS::PkConstraintColumn

metadata about a data source's primary keys

UR::DataSource::RDBMS::Table

Object-oriented class for RDBMS table objects.

UR::DataSource::RDBMS::Table::View::Default::Text

View class for RDBMS table objects

UR::DataSource::RDBMS::TableColumn

metadata about a data source's table's columns

UR::DataSource::RDBMS::TableColumn::View::Default::Text

View class for RDBMS column objects

UR::DataSource::RDBMS::UniqueConstraintColumn

metadata about a data source's unique constraints

UR::DataSource::SQLite

base class for datasources using the SQLite3 RDBMS

UR::Debug

Controls for debugging behavior

UR::DeletedRef

Represents an instance of a no-longer-existent object

UR::Exit

methods to allow clean application exits.

UR::ModuleBase

Methods common to all UR classes and object instances.

UR::ModuleBuild

a Module::Build subclass with UR extensions

UR::ModuleConfig

manage dynamic configuration of modules.

UR::ModuleLoader

UR hooks into Class::Autouse

UR::Namespace

Manage collections of packages and classes

UR::Namespace::Command::Base

Top-level Command module for the UR namespace commands

UR::Namespace::Command::Sys::ClassBrowser

WebApp for browsing the class structure

My::TAP::Parser::Iterator::Process::LSF

UR::Object

transactional, queryable, process-independent entities

UR::Object::Command::FetchAndDo

Base class for fetching objects and then performing a function on/with them.

UR::Object::Command::List

Fetches and lists objects in different styles.

UR::Object::Command::List::Csv

Fetches and lists objects in different styles.

UR::Object::Ghost

Abstract class for representing deleted objects not yet committed

UR::Object::Index

Indexing system for retrieving objects by non-id properties

UR::Object::Iterator

API for iterating through objects matching a rule

UR::Object::Property

Class representing metadata about a class property

UR::Object::Property::View::Default::Text

View class for UR::Object::Property

UR::Object::Property::View::DescriptionLineItem::Text

View class for UR::Object::Property

UR::Object::Property::View::ReferenceDescription::Text

View class for UR::Object::Property

UR::Object::Tag

Transitory attribute tags for a UR::Object at a given time.

UR::Object::Type

a meta-class for any class or primitive type

UR::Object::Type::AccessorWriter

Helper module for UR::Object::Type responsible for creating accessors for properties

UR::Object::Type::AccessorWriter::Product

Implements a calculation accessor which multiplies the values of its properties

UR::Object::Type::AccessorWriter::Sum

Implements a calculation accessor which sums the values of its properties

UR::Object::Type::Initializer

Class definition syntax

UR::Object::Type::ModuleWriter

Helper module for UR::Object::Type responsible for writing Perl modules

UR::Object::Type::View::Default::Text

View class for class metaobjects

UR::Object::Type::View::Default::Xml

View class for class metaobjects

UR::Object::View

a base class for "views" of UR::Objects

UR::Object::View::Aspect

a specification for one aspect of a view

UR::Object::View::Default::Gtk

Gtk adaptor for object views

UR::Object::View::Default::Gtk2

Gtk2 adaptor for object views

UR::Object::View::Default::Html

represent object state in HTML format

UR::Object::View::Default::Text

object views in text format

UR::Object::View::Default::Xml

represent object state in XML format

UR::Object::View::Default::Xsl

base class for views which use XSL on an XML view to generate content

UR::Object::View::Static::Html

represent object state in HTML format

UR::Object::View::Toolkit

UR::Object::View::Toolkit::Text

Declaration of Text as a View toolkit type

UR::ObjectV001removed

restores changes removed in UR version 0.01

UR::ObjectV04removed

restores changes removed in UR version 0.04

UR::Observer

bind callbacks to object changes

UR::Service::JsonRpcServer

A self-contained JSON-RPC server for UR namespaces

UR::Service::RPC::Executer

Base class for modules implementing RPC executers

UR::Service::RPC::Message

Serializable object appropriate for sending RPC messages

UR::Service::RPC::Server

Class for implementing RPC servers

UR::Service::UrlRouter

PSGI-aware router for incoming requests

UR::Service::WebServer

A PSGI-based web server

UR::Singleton

Abstract class for implementing singleton objects

UR::Util

Collection of utility subroutines and methods

above

auto "use lib" when a module is in the tree of the PWD

Provides

Command

in lib/Command.pm

Command::Common

in lib/Command/Common.pm

Command::Shell

in lib/Command/Shell.pm

Command::SubCommandFactory

in lib/Command/SubCommandFactory.pm

Command::Test

in lib/Command/Test.pm

Command::Test::Echo

in lib/Command/Test/Echo.pm

Command::Test::Tree1

in lib/Command/Test/Tree1.pm

Command::Test::Tree1::Echo1

in lib/Command/Test/Tree1/Echo1.pm

Command::Test::Tree1::Echo2

in lib/Command/Test/Tree1/Echo2.pm

Devel::callsfrom

in lib/Devel/callcount.pm

My::TAP::Parser::IteratorFactory::LSF

in lib/UR/Namespace/Command/Test/Run.pm

My::TAP::Parser::Multiplexer

in lib/UR/Namespace/Command/Test/Run.pm

My::TAP::Parser::Scheduler

in lib/UR/Namespace/Command/Test/Run.pm

My::TAP::Parser::Timer

in lib/UR/Namespace/Command/Test/Run.pm

UR::BoolExpr::BxParser

in lib/UR/BoolExpr/BxParser.pm

UR::BoolExpr::BxParser::Yapp::Driver

in lib/UR/BoolExpr/BxParser.pm

UR::BoolExpr::Util::clonedThing

in lib/UR/BoolExpr/Util.pm

UR::Change

in lib/UR/Change.pm

UR::Context::LoadingIterator

in lib/UR/Context/LoadingIterator.pm

UR::Context::Root

in lib/UR/Context/Root.pm

UR::DBI::db

in lib/UR/DBI.pm

UR::DBI::st

in lib/UR/DBI.pm

UR::DataSource::Code

in lib/UR/DataSource/Code.pm

UR::DataSource::Default

in lib/UR/DataSource/Default.pm

UR::DataSource::Pg::Operator::False

in lib/UR/DataSource/Pg/Operator/False.pm

UR::DataSource::Pg::Operator::True

in lib/UR/DataSource/Pg/Operator/True.pm

UR::DataSource::QueryPlan

in lib/UR/DataSource/QueryPlan.pm

UR::DataSource::RDBMS::Operator::Between

in lib/UR/DataSource/RDBMS/Operator/Between.pm

UR::DataSource::RDBMS::Operator::Equals

in lib/UR/DataSource/RDBMS/Operator/Equals.pm

UR::DataSource::RDBMS::Operator::False

in lib/UR/DataSource/RDBMS/Operator/False.pm

UR::DataSource::RDBMS::Operator::GreaterOrEqual

in lib/UR/DataSource/RDBMS/Operator/GreaterOrEqual.pm

UR::DataSource::RDBMS::Operator::GreaterThan

in lib/UR/DataSource/RDBMS/Operator/GreaterThan.pm

UR::DataSource::RDBMS::Operator::In

in lib/UR/DataSource/RDBMS/Operator/In.pm

UR::DataSource::RDBMS::Operator::LessOrEqual

in lib/UR/DataSource/RDBMS/Operator/LessOrEqual.pm

UR::DataSource::RDBMS::Operator::LessThan

in lib/UR/DataSource/RDBMS/Operator/LessThan.pm

UR::DataSource::RDBMS::Operator::Like

in lib/UR/DataSource/RDBMS/Operator/Like.pm

UR::DataSource::RDBMS::Operator::NotBetween

in lib/UR/DataSource/RDBMS/Operator/NotBetween.pm

UR::DataSource::RDBMS::Operator::NotEquals

in lib/UR/DataSource/RDBMS/Operator/NotEquals.pm

UR::DataSource::RDBMS::Operator::NotIn

in lib/UR/DataSource/RDBMS/Operator/NotIn.pm

UR::DataSource::RDBMS::Operator::NotLike

in lib/UR/DataSource/RDBMS/Operator/NotLike.pm

UR::DataSource::RDBMS::Operator::True

in lib/UR/DataSource/RDBMS/Operator/True.pm

UR::DataSource::RDBMSRetriableOperations

in lib/UR/DataSource/RDBMSRetriableOperations.pm

UR::DataSource::ValueDomain

in lib/UR/DataSource/ValueDomain.pm

UR::Doc::Pod2Html

in lib/UR/Doc/Pod2Html.pm

UR::Doc::Section

in lib/UR/Doc/Section.pm

UR::Doc::Writer

in lib/UR/Doc/Writer.pm

UR::Doc::Writer::Html

in lib/UR/Doc/Writer/Html.pm

UR::Doc::Writer::Pod

in lib/UR/Doc/Writer/Pod.pm

UR::Env::UR_COMMAND_DUMP_DEBUG_MESSAGES

in lib/UR/Env/UR_COMMAND_DUMP_DEBUG_MESSAGES.pm

UR::Env::UR_COMMAND_DUMP_STATUS_MESSAGES

in lib/UR/Env/UR_COMMAND_DUMP_STATUS_MESSAGES.pm

UR::Env::UR_CONTEXT_BASE

in lib/UR/Env/UR_CONTEXT_BASE.pm

UR::Env::UR_CONTEXT_CACHE_SIZE_HIGHWATER

in lib/UR/Env/UR_CONTEXT_CACHE_SIZE_HIGHWATER.pm

UR::Env::UR_CONTEXT_CACHE_SIZE_LOWWATER

in lib/UR/Env/UR_CONTEXT_CACHE_SIZE_LOWWATER.pm

UR::Env::UR_CONTEXT_LIBS

in lib/UR/Env/UR_USED_LIBS.pm

UR::Env::UR_CONTEXT_MONITOR_QUERY

in lib/UR/Env/UR_CONTEXT_MONITOR_QUERY.pm

UR::Env::UR_CONTEXT_ROOT

in lib/UR/Env/UR_CONTEXT_ROOT.pm

UR::Env::UR_DBI_DUMP_STACK_ON_CONNECT

in lib/UR/Env/UR_DBI_DUMP_STACK_ON_CONNECT.pm

UR::Env::UR_DBI_EXPLAIN_SQL_CALLSTACK

in lib/UR/Env/UR_DBI_EXPLAIN_SQL_CALLSTACK.pm

UR::Env::UR_DBI_EXPLAIN_SQL_IF

in lib/UR/Env/UR_DBI_EXPLAIN_SQL_IF.pm

UR::Env::UR_DBI_EXPLAIN_SQL_MATCH

in lib/UR/Env/UR_DBI_EXPLAIN_SQL_MATCH.pm

UR::Env::UR_DBI_EXPLAIN_SQL_SLOW

in lib/UR/Env/UR_DBI_EXPLAIN_SQL_SLOW.pm

UR::Env::UR_DBI_MONITOR_DML

in lib/UR/Env/UR_DBI_MONITOR_DML.pm

UR::Env::UR_DBI_MONITOR_EVERY_FETCH

in lib/UR/Env/UR_DBI_MONITOR_EVERY_FETCH.pm

UR::Env::UR_DBI_MONITOR_SQL

in lib/UR/Env/UR_DBI_MONITOR_SQL.pm

UR::Env::UR_DBI_NO_COMMIT

in lib/UR/Env/UR_DBI_NO_COMMIT.pm

UR::Env::UR_DBI_SUMMARIZE_SQL

in lib/UR/Env/UR_DBI_SUMMARIZE_SQL.pm

UR::Env::UR_DEBUG_OBJECT_PRUNING

in lib/UR/Env/UR_DEBUG_OBJECT_PRUNING.pm

UR::Env::UR_DEBUG_OBJECT_RELEASE

in lib/UR/Env/UR_DEBUG_OBJECT_RELEASE.pm

UR::Env::UR_DUMP_DEBUG_MESSAGES

in lib/UR/Env/UR_DUMP_DEBUG_MESSAGES.pm

UR::Env::UR_DUMP_STATUS_MESSAGES

in lib/UR/Env/UR_DUMP_STATUS_MESSAGES.pm

UR::Env::UR_IGNORE

in lib/UR/Env/UR_IGNORE.pm

UR::Env::UR_NO_REQUIRE_USER_VERIFY

in lib/UR/Env/UR_NO_REQUIRE_USER_VERIFY.pm

UR::Env::UR_NR_CPU

in lib/UR/Env/UR_NR_CPU.pm

UR::Env::UR_RUN_LONG_TESTS

in lib/UR/Env/UR_RUN_LONG_TESTS.pm

UR::Env::UR_STACK_DUMP_ON_DIE

in lib/UR/Env/UR_STACK_DUMP_ON_DIE.pm

UR::Env::UR_STACK_DUMP_ON_WARN

in lib/UR/Env/UR_STACK_DUMP_ON_WARN.pm

UR::Env::UR_TEST_QUIET

in lib/UR/Env/UR_TEST_QUIET.pm

UR::Env::UR_USED_MODS

in lib/UR/Env/UR_USED_MODS.pm

UR::Env::UR_USE_ANY

in lib/UR/Env/UR_USE_ANY.pm

UR::Env::UR_USE_DUMMY_AUTOGENERATED_IDS

in lib/UR/Env/UR_USE_DUMMY_AUTOGENERATED_IDS.pm

UR::ModuleBase::Message

in lib/UR/ObjectDeprecated.pm

UR::Namespace::Command

in lib/UR/Namespace/Command.pm

UR::Namespace::Command::Define

in lib/UR/Namespace/Command/Define.pm

UR::Namespace::Command::Define::Class

in lib/UR/Namespace/Command/Define/Class.pm

UR::Namespace::Command::Define::Datasource

in lib/UR/Namespace/Command/Define/Datasource.pm

UR::Namespace::Command::Define::Datasource::File

in lib/UR/Namespace/Command/Define/Datasource/File.pm

UR::Namespace::Command::Define::Datasource::Mysql

in lib/UR/Namespace/Command/Define/Datasource/Mysql.pm

UR::Namespace::Command::Define::Datasource::Oracle

in lib/UR/Namespace/Command/Define/Datasource/Oracle.pm

UR::Namespace::Command::Define::Datasource::Pg

in lib/UR/Namespace/Command/Define/Datasource/Pg.pm

UR::Namespace::Command::Define::Datasource::Rdbms

in lib/UR/Namespace/Command/Define/Datasource/Rdbms.pm

UR::Namespace::Command::Define::Datasource::RdbmsWithAuth

in lib/UR/Namespace/Command/Define/Datasource/RdbmsWithAuth.pm

UR::Namespace::Command::Define::Datasource::Sqlite

in lib/UR/Namespace/Command/Define/Datasource/Sqlite.pm

UR::Namespace::Command::Define::Db

in lib/UR/Namespace/Command/Define/Db.pm

UR::Namespace::Command::Define::Namespace

in lib/UR/Namespace/Command/Define/Namespace.pm

UR::Namespace::Command::Init

in lib/UR/Namespace/Command/Init.pm

UR::Namespace::Command::List

in lib/UR/Namespace/Command/List.pm

UR::Namespace::Command::List::Classes

in lib/UR/Namespace/Command/List/Classes.pm

UR::Namespace::Command::List::Modules

in lib/UR/Namespace/Command/List/Modules.pm

UR::Namespace::Command::List::Objects

in lib/UR/Namespace/Command/List/Objects.pm

UR::Namespace::Command::Old

in lib/UR/Namespace/Command/Old.pm

UR::Namespace::Command::Old::DiffRewrite

in lib/UR/Namespace/Command/Old/DiffRewrite.pm

UR::Namespace::Command::Old::DiffUpdate

in lib/UR/Namespace/Command/Old/DiffUpdate.pm

UR::Namespace::Command::Old::ExportDbicClasses

in lib/UR/Namespace/Command/Old/ExportDbicClasses.pm

UR::Namespace::Command::Old::Info

in lib/UR/Namespace/Command/Old/Info.pm

UR::Namespace::Command::Old::Redescribe

in lib/UR/Namespace/Command/Old/Redescribe.pm

UR::Namespace::Command::RunsOnModulesInTree

in lib/UR/Namespace/Command/RunsOnModulesInTree.pm

UR::Namespace::Command::Show

in lib/UR/Namespace/Command/Show.pm

UR::Namespace::Command::Show::Properties

in lib/UR/Namespace/Command/Show/Properties.pm

UR::Namespace::Command::Show::Schema

in lib/UR/Namespace/Command/Show/Schema.pm

UR::Namespace::Command::Show::Subclasses

in lib/UR/Namespace/Command/Show/Subclasses.pm

UR::Namespace::Command::Sys

in lib/UR/Namespace/Command/Sys.pm

UR::Namespace::Command::Sys::ClassBrowser::TreeItem

in lib/UR/Namespace/Command/Sys/ClassBrowser.pm

UR::Namespace::Command::Test

in lib/UR/Namespace/Command/Test.pm

UR::Namespace::Command::Test::Callcount

in lib/UR/Namespace/Command/Test/Callcount.pm

UR::Namespace::Command::Test::Callcount::List

in lib/UR/Namespace/Command/Test/Callcount/List.pm

UR::Namespace::Command::Test::Compile

in lib/UR/Namespace/Command/Test/Compile.pm

UR::Namespace::Command::Test::Eval

in lib/UR/Namespace/Command/Test/Eval.pm

UR::Namespace::Command::Test::Run

in lib/UR/Namespace/Command/Test/Run.pm

UR::Namespace::Command::Test::TrackObjectRelease

in lib/UR/Namespace/Command/Test/TrackObjectRelease.pm

UR::Namespace::Command::Test::Use

in lib/UR/Namespace/Command/Test/Use.pm

UR::Namespace::Command::Test::Window

in lib/UR/Namespace/Command/Test/Window.pm

UR::Namespace::Command::Test::Window::Tk

in lib/UR/Namespace/Command/Test/Window.pm

UR::Namespace::Command::Update

in lib/UR/Namespace/Command/Update.pm

UR::Namespace::Command::Update::ClassDiagram

in lib/UR/Namespace/Command/Update/ClassDiagram.pm

UR::Namespace::Command::Update::ClassesFromDb

in lib/UR/Namespace/Command/Update/ClassesFromDb.pm

UR::Namespace::Command::Update::Doc

in lib/UR/Namespace/Command/Update/Doc.pm

UR::Namespace::Command::Update::Pod

in lib/UR/Namespace/Command/Update/Pod.pm

UR::Namespace::Command::Update::RenameClass

in lib/UR/Namespace/Command/Update/RenameClass.pm

UR::Namespace::Command::Update::RewriteClassHeader

in lib/UR/Namespace/Command/Update/RewriteClassHeader.pm

UR::Namespace::Command::Update::SchemaDiagram

in lib/UR/Namespace/Command/Update/SchemaDiagram.pm

UR::Namespace::Command::Update::TabCompletionSpec

in lib/UR/Namespace/Command/Update/TabCompletionSpec.pm

UR::Object::Accessorized

in lib/UR/Object/Accessorized.pm

UR::Object::Command::List::Html