Rose::DB::Object is a base class for objects that encapsulate a
single row in a database table. It provides the following functions:
* Create a row in the database by saving a newly constructed object.
* Initialize an object by loading a row from the database.
* Update a row by saving a modified object back to the database.
* Delete a row from the database.
* Fetch an object referred to by a foreign key in the current object.
(i.e., "one to one" and "many to one" relationships.)
* Fetch multiple objects that refer to the current object, either directly
through foreign keys or indirectly through a mapping table. (i.e., "one
to many" and "many to many" relationships.)
* Load an object along with "foreign objects" that are related through any
of the supported relationship types.
Rose::DB is a wrapper and abstraction layer for DBI-related
functionality. A Rose::DB object "has a" DBI object; it is not a
subclass of DBI.
Tip: Are you looking for an object-relational mapper (ORM)? If so,
please see the Rose::DB::Object module. Rose::DB::Object is an ORM
that uses this module to manage its database connections. Rose::DB
alone is simply a data source abstraction layer; it is not an ORM.
Rose::Class is a generic base class for classes. It provides a
single class method (error), but may be expanded further in the
future.
A class that inherits from Rose::Class is not expected to allow
objects of that class to be instantiated, since the namespace for
class and object methods is shared. For example, it is common for
Rose::Object-derived classes to have error methods, but this would
conflict with the Rose::Class method of the same name.
The Rose::DateTime::* modules provide a few convenience functions
and objects for use with DateTime dates.
Rose::DateTime::Util contains a simple date parser and a slightly
customized date formatter.
Rose::DateTime::Parser encapsulates a date parser with an associated
default time zone.
This module (Rose::DateTime) exists mostly to provide a version
number for CPAN. See the individual modules for some actual
documentation.
This module provides a general-purpose clone function to make deep
copies of Perl data structures. It calls itself recursively to copy
nested hash, array, scalar and reference types, including tied
variables and objects.
The clone() function takes a scalar argument to copy. To duplicate
arrays or hashes, pass them in by reference:
The clone() function also accepts an optional second parameter that
can be used to limit the depth of the copy. If you pass a limit of
0, clone will return the same value you supplied; for a limit of
1, a shallow copy is constructed; for a limit of 2, two layers of
copying are done, and so on.
This module provides a simple routine for installing code into
packages without looking at typeglobs or thinking about warnings
or strictures.
It also doesn't muddy up UNIVERSAL.
This module understands the formats used by MySQL for its DATE,
DATETIME, TIME, and TIMESTAMP data types. It can be used to parse
these formats in order to create DateTime objects, and it can take
a DateTime object and produce a string representing it in the MySQL
format.
This module understands the formats used by PostgreSQL for its
DATE, TIME, TIMESTAMP, and INTERVAL data types. It can be used to
parse these formats in order to create DateTime or DateTime::Duration
objects, and it can take a DateTime or DateTime::Duration object
and produce a string representing it in a format accepted by
PostgreSQL.
A Time::Clock object is a twenty-four hour clock with nanosecond
precision and wrap-around. It is a clock only; it has absolutely
no concept of dates. Vagaries of date/time such as leap seconds
and daylight savings time are unsupported.
When a Time::Clock object hits 23:59:59.999999999 and at least one
more nanosecond is added, it will wrap around to 00:00:00.000000000.
This works in reverse when time is subtracted.
Time::Clock objects automatically stringify to a user-definable
format.
#------------------------------------------------------------------------
# Version 2.19 - 27th April 2007
#------------------------------------------------------------------------
* Applied a patch to t/fileline.t from Steffen M�ller which fixes the
problems running on Win32 with backslashes in paths.
https://rt.cpan.org/Ticket/Display.html?id=20488
* Applied a patch to the XS Stash from Randy Kobes which fixes some other
Win32 problems.
http://tt2.org/pipermail/templates/2007-February/009247.html
* Applied another patch to the XS Stash from Steve Peters which fixes
a problem with tied hashes under more recent version of Perl.
http://tt2.org/pipermail/templates/2007-January/009181.html
* Fixed a problem in the Perl Stash when using objects that have
overloaded comparison operators. Thanks to Randal Schwartz, Tatsuhiko
Miyagawa and Daisuke Maki for their contributions.
http://tt2.org/pipermail/templates/2007-March/009265.html
* Applied a patch from Bill Moseley to Template::Provider which adds
negative caching and moves some functionality into separate methods
to make subclassing easier. Also added the STAT_TTL configuration
parameter.
http://tt2.org/pipermail/templates/2007-January/009183.html
* Added the url filter as a less aggressive form of the uri filter.
Whereas the uri filter now (from v2.16 onwards) encodes all the
reserved characters (@, :, /, etc.) as per RFC2396, the url filter
leaves them intact and thus behaves just like the uri filter used
to.
http://tt2.org/pipermail/templates/2007-March/009277.html
#------------------------------------------------------------------------
# Version 2.18a - 9th February 2007
#------------------------------------------------------------------------
* Applied a patch from Steve Peters to the Stash.xs to allow it to
compile with bleadperl 5.9.x
https://rt.cpan.org/Public/Bug/Display.html?id=22506
#------------------------------------------------------------------------
# Version 2.18 - 9th February 2007
#------------------------------------------------------------------------
* Merged in Adam's changes in 2.16 and 2.17 back into the developer CVS
repository and added his name to the credits.
* Changed the parser grammar to accept expressions as arguments to a
subroutine, method or virtual method call. I'm embarrassed to admit
that it was a one line change that could (and should) have been made
long ago, if only I had realised just how trivial it was. Anyway,
you can now write nested expressions like this:
[% add(a+5, b < 10 ? c : d + e*5) %]
* Put the t/fileline.t test back in as this was fixed in 2.15a
* Added the Template::Toolkit documentation-only module.
#------------------------------------------------------------------------
# Version 2.17 - 8th Feb 2007
#------------------------------------------------------------------------
Another interim release from Adam Kennedy.
* Change in Makefile.PL to force an upgrade to File::HomeDir 0.64 on darwin.
This is due to problems caused by changes made to Perl on the new Intel
versions of Mac OS X.
* skip_all filelines.t on darwin
#------------------------------------------------------------------------
# Version 2.16 - 23rd Jan 2007
#------------------------------------------------------------------------
Interim release from Adam Kennedy.
* Skip fileline.t on Win32, as it has some hard-coded path seperator
assumptions. This will be fixed more comprehensively later.
* Handle spurious errors in Makefile.PL when a dev version of
ExtUtils::MakeMaker is installed.
* Don't say "nmake" on Win32 when $Config{make} is 'dmake'.
This corrects the message on Strawberry Perl.
#------------------------------------------------------------------------
# Version 2.15c - Not released ## DEVELOPER RELEASE ##
#------------------------------------------------------------------------
* Fixed a bug in Template::Parser which caused it to get confused about
block names if it encountered a syntax error inside a BLOCK. Thanks
to Bill Moseley for reporting the problem.
http://tt2.org/pipermail/templates/2006-July/008815.html
* Fixed a minor buglet in Template::Provider which came to light while
investigating the above problem. If a previously cached template is changed
on disk and then fails to compile, the provider now invalidates the cache
entry immediately. Without this fix, the provider would report the error
once, then reuse the cached good version of the template until $STAT_TTL
ticked over when it would try to load and compile the disk version again.
The problem was that error messages were only reported once every $STAT_TTL
second(s) and any requests for the same template in the interim time would
mysteriously work. This way errors get reported consistently and immediately
and no-one has to waste an afternoon trying to figure out where the errors
went!
#------------------------------------------------------------------------
# Version 2.15b - 30th May 2006 ## DEVELOPER RELEASE ##
#------------------------------------------------------------------------
* Changed the uri filter to escape all reserved characters as per
URI::Escape and RFC2396. This now includes &, @, /, ;, :, =, +, ?
and $ which were previously not escaped. Thanks to islue@cpan.org
for reporting the problem.
http://rt.cpan.org/Ticket/Display.html?id=19593
* Also changed the uri filter to encode all wide characters as the
equivalent UTF escapes. Thanks to Jonathan Rockway for reporting
the problem.
http://rt.cpan.org/Ticket/Display.html?id=19354
* Fixed the redirect filter to not support relative paths. Thanks to
Paul Seamons for spotting the problem and providing a solution.
* Moved all the virtual methods out of Template::Stash and into
a new Template::VMethods module.
* Fixed the version number of Template::Stash which had rolled over
to 2.102 making it appear to predate the 2.86 stash in TT v2.14.
Thanks to Randal Schwartz for reporting the problem. Changed all
version numbers in other modules to be a hard-coded numbers instead
of grokking it automagically from the CVS revision.
* Changed the _recover() method of Template::Service to check if the
error thrown is a Template::Exception object rather than just a
reference. Thanks to David Wheeler for reporting the problem.
http://rt.cpan.org/Ticket/Display.html?id=17630
* Fixed the some tests in stash.t and stash-xs.t which were failing
under Perl 5.6.2 due to a slightly different error message being
generated. Thanks to Anton Berezin for reporting the problem.
* Fixed a bug in the Template::Provider _load() method to check that
$data is a hash ref before trying to mess with its innards. Thanks
to barbie@cpan.org for reporting the problem.
http://rt.cpan.org/Ticket/Display.html?id=18653
#------------------------------------------------------------------------
# Version 2.15a - 29th May 2006 ## DEVELOPER RELEASE ##
#------------------------------------------------------------------------
* Removed the latex filter from Template::Filters and related config
variables from Template::Config
* Changed the t/fileline.t test to remove the line number from what Perl
reports as "(eval $line)". It appears to get the $line wrong on
FreeBSD, although the correct line number is reported following that
so the tests still do the right thing. Thanks to Anton Berezin for
reporting the problem.
* Changed the t/compile3.t test to do something similar.
0.6602 2007-05-29
- There was a bug in the 04local.t tests that did not manifest itself
on my dev machine, but would've been seen on any machine with an
/etc/default/init file. Reported by Jonathan Leffler.
0.6601 2007-05-08
- 0.66 screwed up the test count in 04local.t if certain tests were
skipped. Reported by David Precious.
0.66 2007-05-07
- This release is based on version 2007f of the Olson database, which
includes Haiti, Turks and Caicos Islands, and New Zealand.
- If /etc/localtime is a symlink, but trying to follow that link does
not find a zone name, fall back to trying to find a matching file in
/usr/share/zoneinfo. RT #26438.
- Require Cwd 3.0+, since Cwd;:abs_path() in older versions does not
following a chain of symlinks.
0.6501 2007-04-22
- The test for the new symlink handling could fail on some systems
(notably OSX). Reported by Randal Schwartz.
0.65 2007-04-21
- Handle cases where /etc/localtime is a symlink pointing to another
symlink (and so forth) by using Cwd::abs_path() instead of
readlink(). Fixes RT #26438.
- When creating an Olson time zone object, DT::TZ will now check to
see if the object being loaded is from an older version of the Olson
catalog than the current version of DT::TZ and issue warning if this
is the case. This is useful because obsolete module files may exist
when a zone name is replaced by a link, or just retired entirely.
0.64 2007-04-02
- This release is based on version 2007e of the Olson database
(changes in the Syria and Honduras time zones).
0.63 2007-03-20
- This release is based on version 2007d of the Olson database.
- Fix determination of local time zone on systems where /etc/localtime
is a symlink. This broke in 0.61. Reported by Bradley C Bailey. RT
#25348.
0.37 2007-03-30
[ BUG FIXES ]
- Require DateTime::Locale 0.34, which fixes a problem that manifested
when thawing a DateTime.pm object. See
http://www.mail-archive.com/datetime@perl.org/msg05633.html for some
discussion of this.
- Added pod coverage tests, and added some POD for undocumented
methods as a result.
[ ENHANCEMENTS ]
- This distro is now GPG-signed, per RT #24776.
1.49
- Thanks to Backcountry.com for sponsoring work on this release. [GSM]
- Add the statement handle attribute ParamTypes, and fix an error
in ParamValues. ParamTypes requires DBI 1.49 or better. [GSM]
- Strip the final newline from error messages, so that die can add
in the line number. (CPAN bug #18900) [GSM]
- Make workaround for PQresultErrorField not returning proper
result when an error is set and we are connecting via TCP/IP.
This allows correct $dbh->state() values. [GSM]
- Fix incorrect quoting preventing compiling. (CPAN bug #18640)
- Add support for quoting and binding of geometric types: POINT,
LINE, LSEG, BOX, PATH, POLYGON, and CIRCLE. Also added the
TID type. [GSM]
0.25 Mon 14 May 2007
- Adding the _CLASSISA and _SUBCLASS functions to fill
a gap between _CLASS and _DRIVER
0.24 Wed 9 May 2007
- Adding the _DRIVER function for use in writing driver APIs
By: smueller on 2007/04/30
* Patch from Jos Boumans: Remove use of "static" variable.
By: smueller on 2006/10/28
* parse_dist_name now supports versions starting with a 'v'.
[Changes for 0.74 - 2007-04-26]
* Same as 0.73_01, but not a developer release.
[Changes for 0.73_01 - 2007-03-28]
* Fixed bug "scan_deps doesn't show ALL the dependencies"
* Ensured all file entries are given by absolute paths
* Added a number of test artificial dependency trees as test data mainly for
"scan_deps doesn't show ALL the dependencies" bug
* Added tests for scandeps recurse option (all pass)
* Added tests for scandeps skip option (all pass)
* Added tests to show a duplicated dependency is in fact only shown once (all pass)
* Added Utils.pm test module containing generic_scandeps_rv_test and
compare_scandeps_rvs subroutines (Adrian Issott)
[Changes for 0.73 - 2007-03-25]
* Now being a little cleverer for detecting globs in diamond operators.
(Requiring a meta character within the <>.)
[Changes for 0.72 - 2007-02-03]
* Case-insensitive @INC removal for case-insensitive
filesystems (Eric Wilhelm)
[Changes for 0.71 - 2007-01-04]
* Added special cases for
Catalyst
Class::MakeMethods
Config::Any
DBIx::Class
Email::Send
Log::Log4perl
SQL::Translator
* print() the "# Legend..." line instead of warn()ing it.
[Changes for 0.70 - 2006-11-21]
* Added special case for Image::Info.
[Changes for 0.69 - 2006-11-07]
* Additional corner cases for LWP::UserAgent and LWP::Parallel::UserAgent and
friends.
Changes for 0.67 - Adam Kennedy]
* Tweaked the license detection code a bit
* Previous changes working well, going production
[Changes for 0.66_02 - Adam Kennedy]
* Adding detection of 'proprietary' license.
* "All rights reserved" clashes with or can invalidate most Open Source
licenses. Adding a warning to this effect.
[Changes for 0.66_01 - 2007-03-15]
* Adding tests_recursive to have M:I search for and explicitly list
all test scripts recursively.
* Adding configure_requires, test_requires and install_requires.
These are currently aliases for build_requires but will later result
in alternative consequences internally (ADAMK)
* Reorganising Module::Install::With on the assumption that CPAN.pm will
be implementing PERL5_CPAN_IS_EXECUTING.
[Changes for 0.65 - 2007-03-06]
* Add install_as_core, install_as_cpan, install_as_vendor
commands to control the "installdirs" metadata field.
Requested by: Tels (renamed by ADAMK and AUDREYT)
* Add the preop command for users to customize the PREOP rule. (BINGOS)
* Implement support for $ENV{PERL5_CPANPLUS_IS_EXECUTING} in the
experimental Module::Install::With. (ADAMK)
* Remove the use of features in the Module::Install Makefile.PL.
Developers should be quite capable of installing them all. (ADAMK)
* Remove the use of auto_provides in Module::Install Makefile.PL
until we fix it to not break without a pre-existing MANIFEST. (ADAMK)
* YAML::Tiny is now used as a fallback for generating META.yml. The
order of precedence is now YAML::Syck, YAML::Tiny, then YAML.
* META.yml output is now conformant to spec 1.3.
* Add MIT license to those detectable by license_from() (GAAL)
- Added is_vmsish(), is_windowsish(), and is_unixish() boolean
convenience functions. Fixes some test failures on platforms where
$^O is set to a value we don't know about (like 'gnu').
- Upgraded to version.pm 0.7203. [John Peacock]
- Support get_action_docs() =head2 style. [ewilhelm]
- Workaround Test::Pod::Coverage @INC bug. [Eric Wilhelm]
- Fixed the command-line args --extra_compiler_flags and
--extra_linker_flags so they properly shell-split their arguments.
0.2807 - Sat Mar 24 22:19:02 2007
- Upgraded to version.pm 0.71. [John Peacock]
- Removed a couple small constructs in the tests ("use warnings;" and
"qw$foo bar$[1]") that caused test failures under perl 5.005.
- Added support for an explicit default value of undef in prompt().
[Eric Wilhelm]
- Improved our prompt() method, which could sometimes hang before the
user got a chance to see a prompt. [Andreas Koenig]
- Added a note about --allow_mb_mismatch to the error message that
happens right before someone might want to use that parameter.
- Added DragonflyBSD to the list of known Unix OSes.
- get_action_docs() dies on error rather than twiddling $@
- Made ModuleInfo's _evaluate_version_line() compatible with 'use
version ...$VERSION' lines. [Eric Wilhelm]
- Added some verbiage in Module::Build::API that officially blesses
the _build/prereqs file for external consumption. [Suggested by Andreas Koenig]
- Added test profiles support via the test_types property and "testall"
target. [Eric Wilhelm, Jeff Lavallee]
- Use syscopy() on OS/2 in copy_if_modified() so we make sure to
overwrite any existing target file. [Ilya Zakharevich]
- Removed seemingly silly '~~' test in t/tilde.t.
- In our test-time utility library t/lib/MBTest.pm, we need to know
about a few .exe-like extensions on OS/2. [Ilya Zakharevich]
- In t/ppm.t, use DynaLoader::mod2fname() (if available) to determine
the correct translation of our test module's name into a DLL
name. [Ilya Zakharevich]
- Avoid an unlink() error on OS/2 when fixing shebang lines. [Ilya
Zakharevich]
- When we're protecting the world from the evils of long RedHat
$ENV{PERL5LIB} variables, don't assume $ENV{PERL5LIB} is already
defined. This gets rid of a huge number of warnings for some
people. [Dave Rolsky]
2.18
- Added some UNITCHECK stuff, which (I think) makes XS code able to
do UNITCHECK blocks. [Nicholas Clark]
- Changed 'use re "eval";' to 'BEGIN { $^H |= 0x00200000 };' so we
can compile re.xs in bleadperl. [Yves Orton]
- Fix an undefined-variable warning related to 'inout' parameter
processing.
2.17 - Mon Nov 20 17:07:27 2006
- Stacked $filepathname to make #line directives in #INCLUDEs work.
[Nicholas Clark]
- Sprinked dVAR in with dXSARGS, for God-(Jarkko)-knows-what
reason. [Jarkko Hietaniemi]
- Use printf-style formats in Perl_croak() for some significant
savings in number of distinct constant strings in the linked
binaries we create. [Alexey Tourbin]
- Don't use 'class' as a variable name in the t/XSTest.xs module,
since that's a keyword in C++. [Jarkko Hietaniemi]
2.16 Fri Sep 15 22:33:24 CDT 2006
- Fix a problem with PREFIX not working inside INTERFACE
sections. [Salvador Fandin~o]
- When building as part of the perl core (so this is irrelevant for
people downloading from CPAN) we now try a little harder to find
the perl sources. [Jos Boumans]
- Fixed a part of the manifest thingy that got broken on 64-bit
Windows platforms in version 0.18. [Steve Hay, Jan Dubois]
