Set::Relation
---------------------------------------------------------------------------
2009-02-05 Darren Duncan <perl@DarrenDuncan.net>
* Set::Relation version 0.4.0 for Perl 5 is released on CPAN as
Set-Relation-0.4.0.tar.gz.
* Updated external dependencies: Moose/etc to version 0.68.
* As of this release, Set::Relation for Perl 5 uses the
namespace::clean pragma for good hygiene; this distribution has now
gained an external dependency on the Perl 5 module 'namespace::clean',
which is not bundled with any version of Perl and will need to be
installed from CPAN; namespace::clean also has a few not-bundled
dependencies of its own.
* (Relation.pm) Added "use namespace::clean" statements inside the
package declaration following any other "use" statements, so their
exports into our package doesn't also become part of our own public API
as a side-effect; the only exception is the "meta" method that Moose
adds, which is kept.
* (Relation.pm) Added new documentation sub-section under
"DESCRIPTION" named "Appropriate Uses For Set::Relation", which should
hopefully answer some FAQs, such as why does the module exist, and
pointing out some strengths and weaknesses.
* (Relation.pm) Corrected a forgetful oversight in the module
documentation concerning Set::Relation's "has_frozen_identity" object
attribute; this attribute had an auto-generated read-only public
accessor method plus is automatically initialized from a same-named
constructor method; added "has_frozen_identity" to the accessor method
list, and updated the "new" constructor submethod signature.
* (Relation.pm, Set_Relation_50_Synopsis.t,
Set_Relation_51_Database_in_Depth_Example.t) Updated the "new"
constructor submethod so that it now accepts a single positional
argument as an invocation option, where before it just accepted named
arguments (and it still does); a single positional argument to "new" is
treated the same as a single "members" named argument. This change
means that the majority of current or anticipated future use cases of
Set::Relation are now terser by about 9-11 characters ("members => ")
per "new" invocation. (This new feature was implemented mainly by
adding a simple BUILDARGS method to Relation.pm.) Updated all the
examples and tests to use the new terser format.
* (Relation.pm) As a consequence of the previous change, the "new"
constructor has also been updated so that the "members" argument is no
longer allowed to be a Perl Hash (because a lone Hash positional
argument is one of the standard Moose format options to supply named
arguments) so any invocations of "new" which gave a Hash argument will
have to become 2 characters ("[]") more verbose, wrapping it in an
Array. Removed the example using a Hash.
* (Relation.pm) Added the Moose concerning recommended practice
"__PACKAGE__->meta()->make_immutable();" line to the end of the module,
which should help performance regarding Moose-generated stuff; this
would've been done before release 0.0.0 but was forgotten at the time.
* (Relation.pm) Updated the "LICENSE AND COPYRIGHT" documentation
section to change the Copyright declaration from "Darren Duncan" to
"Muldis Data Systems, Inc." (which is wholly owned by Darren Duncan).
2009-02-02 Darren Duncan <perl@DarrenDuncan.net>
* Set::Relation version 0.3.0 for Perl 5 is released on CPAN as
Set-Relation-0.3.0.tar.gz.
* (Relation.pm) Added these 5 object methods (still 20 to go):
"slice", "attr", "has_attrs", "attr_names", "transitive_closure".
* (Relation.pm) Other minor updates and fixes.
2009-02-01 Darren Duncan <perl@DarrenDuncan.net>
* Set::Relation version 0.2.0 for Perl 5 is released on CPAN as
Set-Relation-0.2.0.tar.gz.
* (Relation.pm) Added full documentation for the remaining 25 object
methods that Set::Relation expects to have implemented prior to being
moved to alpha development status; each is marked TODO in its title;
this change item doesn't have a list of said methods, but when they are
implemented in the next 1-3 releases, the change log will mention them
simply as being new, same as if they hadn't been pre-documented now
(and the TODO marker on their docs will be silently removed).
* (Relation.pm) Added placeholder code for said 25 TODO methods, each
of which will die with an "unimplemented" message if invoked.
* (Relation.pm) Other minor code updates.
2009-01-31 Darren Duncan <perl@DarrenDuncan.net>
* Set::Relation version 0.1.0 for Perl 5 is released on CPAN as
Set-Relation-0.1.0.tar.gz.
* This release features a few API changes, some significant feature
additions, and bug fixes to existing routines, but no public facing
routines have been added or removed. New routines should feature in
the next 0.Y.0 release.
* (Relation.pm) Updated each of the 5 functional methods ["union",
"exclusion", "intersection", "join", "product"] so it is now an N-adic
operator rather than a dyadic operator. Each method's "other"
parameter was renamed to "others" and now takes either a single
Set::Relation object as before or an Array of 0..N Set::Relation
objects which is new. With this change, these operators are now at
feature parity with the Muldis D functions they are based on, except
that they never handle the niladic option; being object methods, there
is always at least one operand which is the invocant.
* (Relation.pm) Updated each of the 4 functional methods
["(|cmpl_)restriction", "extension", "map"] to remove its optional
"assuming" parameter. This parameter was a fossil left over from the
original Muldis D versions of these operators that the Perl version was
ported from; the parameter was necessary in Muldis D to have reasonable
flexibility due to Muldis D lacking certain other features that Perl
has, which make this parameter unnecessary in Perl. The removal was to
keep the Perl simpler; it also sets the stage for the next change item.
* (Relation.pm, Set_Relation_51_Database_in_Depth_Example.t) Updated
each of the 4 functional methods ["(|cmpl_)restriction", "extension",
"map"] so that the Perl routine supplied as its "func" argument is now
assumed to have zero parameters rather than one, and the Perl routine
is now supplied its input tuple/Hash in $_, same as how Perl's built-in
map/grep operators work, rather than as a first/only argument. Thanks
to Todd Hepler for proposing that design change to "restriction" to
make it more DWIM.
* (Relation.pm, Set_Relation_51_Database_in_Depth_Example.t) Updated
each of the 4 functional methods ["(|cmpl_)projection", "extension",
"map"] so that the "(|result_)attrs" parameter can also take a Str
argument rather than just an Array of Str argument. Thanks to Todd
Hepler for proposing that design change to "projection" to make it more
DWIM. Also updated the Set::Relation constructor submethod similarly,
so its "members" parameter may also take a Str argument; this would
produce a relation object with 1 attribute and zero tuples.
* (Relation.pm) Fixed an "insert" mutator method bug so it detects
and blocks attempts to insert the invocant Set::Relation object into
itself as a value-typed component, which would have had the side-effect
of freezing the invocant, or would have conceptually been an infinite
recursive deep copy operation; also fixed the "delete" mutator with
the same detector since it would have had the same freezing problem.
* (Relation.pm) Updated all routines that take tuple-representing Hash
values from the user, either directly or as tuple-valued attrs, either
as a routine argument or a closure return value, so that each Hash is
tested for circular references between itself or its value-typed
components; this update fixes a general bug where the module could
infinitely recurse when processing that input, since tuple-representing
input from the user is deep-copied.
* (Relation.pm) Some POD reformatting: Took what used to be the 5
level-2 headings under the INTERFACE level-1 heading and changed said 5
into level-1 headings, but did not uppercase their text. Then
converted the routine lists from being "=over/=item <routine>/=back" to
each routine having its own level-2 heading. For each routine, the new
heading is just the short name of the routine, and the full signature
of the routine displays just as its own paragraph. All these changes
combined should look visually like we are faking 3 levels of headings,
with top and middle being upcased and mixed case "=head1" respectively.
* (Relation.pm) Minor code and POD updates and fixes.
2009-01-26 Darren Duncan <perl@DarrenDuncan.net>
* Set::Relation version 0.0.2 for Perl 5 is released on CPAN as
Set-Relation-0.0.2.tar.gz.
* (Relation.pm) Fixed two instances of a bug in the "rename" method.
Thanks to Todd Hepler for spotting the bug and providing a patch.
* Added new test file "t/Set_Relation_51_Database_in_Depth_Example.t",
which exercises more than a half-dozen Set::Relation methods that
previously had no tests; the "rename" bugs were exposed when writing
this. Thanks to Todd Hepler who authored and contributed this file.
* This distribution has gained a new direct external dependency on the
Test::Deep module, which currently is only used by the new test file.
* (Relation.pm) Minor code comment fixes and POD updates.
2009-01-21 Darren Duncan <perl@DarrenDuncan.net>
* Set::Relation version 0.0.1 for Perl 5 is released on CPAN as
Set-Relation-0.0.1.tar.gz.
* (Relation.pm) Fixed a bug in the "quotient" method, and further
updated it with some special-case shortcuts.
* (Relation.pm) Other minor updates.
* (README, Relation.pm) Previously the FORUMS pod section of
Relation.pm and 3 parts of the README file lacked content, and now they
have it; added documentation about where the Set::Relation version
control and support forums are.
2009-01-19 Darren Duncan <perl@DarrenDuncan.net>
* Set::Relation version 0.0.0 for Perl 5 is released on CPAN as
Set-Relation-0.0.0.tar.gz.
* It constitutes a rewrite of Set::Relation for Perl 6 that had been
made in 2006 but was never functional; the large body of work going
into the Muldis D language and Muldis Rosetta framework during the
intervening period also fed into this new Set::Relation module; it is
expected that this new Set::Relation for Perl 5 will be ported to Perl
6 in the near future and so upgrade that 2006 version; meanwhile, this
Changes entry refers only to the Perl 5 version.
* This is the first release of the Perl 5 Set::Relation distribution,
and the first release of any distribution to contain a Perl 5 module
named Set::Relation.
* This is the initial file manifest:
Changes
INSTALL
lib/Set/Relation.pm
LICENSE/GPL
LICENSE/LGPL
Makefile.PL
MANIFEST
MANIFEST.SKIP
README
t/Set_Relation_00_Compile.t
t/Set_Relation_50_Synopsis.t
TODO
* As of this release, Set::Relation is officially in pre-alpha
development status.
* This is the initial complement of routines; besides the "new"
constructor submethod, there are these 40 object methods: "clone",
"export_for_new", "freeze_identity", "which", "members", "heading",
"body", "evacuate", "insert", "delete", "degree", "is_nullary",
"cardinality", "is_empty", "is_member", "empty", "insertion",
"deletion", "rename", "projection", "cmpl_projection", "restriction",
"cmpl_restriction", "extension", "static_extension", "map",
"is_identical", "is_subset", "is_proper_subset", "is_disjoint",
"union", "exclusion", "intersection", "difference", "semidifference",
"semijoin", "join", "product", "quotient", "composition".
2009-01-04 Darren Duncan <perl@DarrenDuncan.net>
The next version of the Module List will list the following module:
modid: Set::Relation
DSLIP: cmpOl
description: Relation data type for Perl
userid: DUNCAND (Darren Duncan)
chapterid: 6 (Data_Type_Utilities)
enteredby: BDFOY (brian d foy)
enteredon: Mon Jan 5 06:12:12 2009 GMT
The resulting entry will be:
Set::
::Relation cmpOl Relation data type for Perl DUNCAND
2006-04-14 thru 2006-11-22
* A Perl 6 project named "Relation" is started (complementary to the
earlier existing to-be-named Muldis Rosetta project) which was intended
to provide native tuple and relation data types for ordinary use in
Perl 6 programs like other built-in collection types. The first commit
was Pugs SVN rev 9938, on 2006-04-14, and Pugs 6.2.12 (2006-06-26)
included it. Hence 2006 is the start of the declared copyright date
range for Set::Relation.
* On 2006-07-04, renamed this Perl 6 project to "Set-Relation", which
it remains to this day. Pugs 6.2.13 and later included this.
* The Perl 6 Set-Relation received various small updates thru
2007-02-03 (Pugs SVN rev 15168), but is now stagnant; it will likely
get un-stuck after the initially newer Perl 5 version is made to work.
2005-12-05
* Darren Duncan is introduced by David Wheeler to the truly relational
model of data, in a posting on the Bricolage development list in the
"Re: [6977] New branch for maintenance of Bricolage 1.10.x." thread.
* David said that Darren's expressed thought, that compound data types
in table fields was a violation of first normal form, was in fact a
misconception about the relational model. David then referenced a
recent interview with C. J. Date.
* This set off a chain of events which was the largest paradigm shift
to ever affect what evolved into the Muldis Rosetta project, and also
resulted in the genesis of the Set::Relation module.