/ 
SPOPS-0.65
River stage one • 2 direct dependents • 2 total dependents

Changes for version 0.65 - 2002-08-21

  • Overall:
    • Build process will now run without intervention; DBI and LDAP tests require environment variables being set or running the process manually (perl Makefile.PL MANUAL=1). See 'README' for the environment variables used.
    • Fixed and added lots of documentation on relationships and multifield primary keys, Thanks to Gert Thiel (thiel@baerkatalog.de) for pointing out deficiencies and inconsistencies.
    • Added lots of tests
    • Cleaned up some items from the base SPOPS class
  • Individual:
    • doc/Manual/Error.pod:
      • Deleted all content with pointer to SPOPS::Manual::Exception. This doc will be removed in a near future release.
    • doc/Manual/Object.pod:
      • Clarified what to use with multifield primary keys.
    • doc/Manual/Relationships.pod:
      • Added tons of documentation and examples. Some of it was pulled from other locations, but most is new.
    • Makefile.PL:
      • Lots of changes so the build process will run without intervention. You can skip the DBI/LDAP tests or specify the relevant information in environment variables. (See 'README' for the environment variables to use.) This should make acme happy :-)
    • SPOPS.pm:
      • Removed the timestamp methods. They never did anything, were marked for removal, and the functionality can be added as a pre_save rule.
      • Added a set_global_debug() method so we can programmatically set debugging.
      • Added documentation for set_global_debug() as well as the _w() and _wm() debugging methods.
      • Remove Storable from ISA and instead create methods 'store', 'retrieve' and 'nstore' which just act as delegates for the Storable methods.
      • Rename fetch_determine_limit() to SPOPS::Utility->determine_limit() and modify all uses in the library.
      • All objects returned from new() now have the 'changed' flag explicitly set and the and the 'saved' flag explicitly cleared.
      • Be able to turn on strict field checking for individual objects (pass a 'strict_field => true' to new())
    • SPOPS/ClassFactory/DBI.pm:
      • Enable fetch() to use either an arrayref or a string with multifield primary keys. Thanks to Gert Thiel <thiel@baerkatalog.de> for prompting the change.
    • SPOPS/ClassFactory/DefaultBehavior.pm:
      • Add brief documentation for the different methods.
    • SPOPS/DBI.pm:
      • Update field_update() so it can operate as a class method, and add documentation to match. Thanks to Ray Zimmerman for noting the tangential reference to class method usage in previous docs.
      • Add SET_DEBUG_FETCH() and SET_DEBUG_SAVE() to programmatically set debugging levels.
    • SPOPS/SQLInterface.pm:
      • Add SET_DEBUG_SELECT(), SET_DEBUG_INSERT(), SET_DEBUG_UPDATE() and SET_DEBUG_DELETE() to programmatically set debugging levels.
    • SPOPS/Tool/CreateOnly.pm:
      • Issue a die() rather than a warn() on a save/update.
    • SPOPS/Tool/ReadOnly.pm:
      • Issue a die() rather than a warn() on a save() or remove()
    • t/00_base.t:
      • Add tests for the base SPOPS methods (metadata, constructor, cloning, etc.)
    • t/20_gdbm.t:
      • Separate the tests that were combining different tests in one.
    • t/30_dbi.t:
      • Add tests for field_update() as a class method
    • t/32_dbi_inline_config.t:
      • Add tests for SPOPS::Tool::DBI::Datasource
    • t/33_dbi_discover_field.t:
      • Add tests for SPOPS::Tool::DBI::DiscoverField
    • t/34_dbi_find_defaults.t;
      • Add tests for SPOPS::Tool::DBI::FindDefaults
    • t/50_rule_create_only.t:
      • Add tests for SPOPS::Tool::CreateOnly
    • t/51_rule_read_only.t:
      • Add tests for SPOPS::Tool::ReadOnly

Documentation

SPOPS::Manual
User Guide and Reference Manual for SPOPS
SPOPS::Manual::CodeGeneration
How SPOPS builds classes
SPOPS::Manual::Configuration
Description of variables used in the SPOPS configuration process
SPOPS::Manual::Cookbook
Recipes for SPOPS usage
SPOPS::Manual::Datasource
SPOPS datasource use and how you can customize
SPOPS::Manual::Exceptions
Error handling in SPOPS
SPOPS::Manual::ImportExport
Moving data (and more) with SPOPS
SPOPS::Manual::Intro
Introduction and overview of SPOPS
SPOPS::Manual::Object
Shows how you interact with SPOPS objects.
SPOPS::Manual::ObjectRules
Use rules to give your object custom behavior
SPOPS::Manual::Relationships
SPOPS object relationships
SPOPS::Manual::Security
SPOPS security system and how you can customize
SPOPS::Manual::Serialization
How SPOPS serializes objects
test_dbd_driver.pl
Perform tests on a DBD driver to see if it may work with SPOPS

Modules

SPOPS
Simple Perl Object Persistence with Security
SPOPS::ClassFactory
Create SPOPS classes from configuration and code
SPOPS::ClassFactory::DBI
Define additional configuration methods
SPOPS::ClassFactory::DefaultBehavior
Default configuration methods called from SPOPS.pm
SPOPS::ClassFactory::LDAP
Create relationships among LDAP objects
SPOPS::Configure
DEPRECATED
SPOPS::Configure::DBI
DEPRECATED
SPOPS::Configure::Ruleset
DEPRECATED
SPOPS::DBI
Implement SPOPS class, serializing into a DBI database
SPOPS::DBI::InterBase
InterBase-specific routines for the SPOPS::DBI
SPOPS::DBI::MySQL
MySQL-specific code for DBI collections
SPOPS::DBI::Oracle
Oracle-specific routines for the SPOPS::DBI
SPOPS::DBI::Pg
PostgreSQL-specific routines for the SPOPS::DBI
SPOPS::DBI::SQLite
SQLite-specific code for DBI collections
SPOPS::DBI::Sybase
Sybase-specific routines for the SPOPS::DBI
SPOPS::Error
(DEPRECATED) Centralized error messages from all SPOPS objects.
SPOPS::Exception
Base class for exceptions in SPOPS
SPOPS::Exception::DBI
SPOPS exception with extra DBI parameters
SPOPS::Exception::LDAP
SPOPS exception with extra LDAP parameters
SPOPS::Exception::Security
SPOPS exception with extra security parameters
SPOPS::Export
Export SPOPS objects to various formats
SPOPS::Export::DBI::Data
Export SPOPS objects as data for importing directly into a DBI table
SPOPS::Export::Object
Dump SPOPS objects to a portable format
SPOPS::Export::Perl
Dump SPOPS objects to a pure serialized Perl format
SPOPS::Export::SQL
Export SPOPS objects as a series of SQL statements
SPOPS::Export::XML
Export SPOPS objects in XML format
SPOPS::GDBM
Store SPOPS objects in a GDBM database
SPOPS::HashFile
Implement as objects files containing perl hashrefs dumped to text
SPOPS::Import
Factory and parent for importing SPOPS objects
SPOPS::Import::DBI::Data
Import raw data to a DBI table
SPOPS::Import::DBI::Table
Import a DBI table structure
SPOPS::Import::DBI::TableTransform
Factory class for database-specific transformations
SPOPS::Import::Object
Import SPOPS objects
SPOPS::Initialize
Provide methods for initializing groups of SPOPS objects at once
SPOPS::Iterator
Class to cycle through results and return SPOPS objects
SPOPS::Iterator::DBI
Implementation of SPOPS::Iterator for SPOPS::DBI
SPOPS::Iterator::LDAP
Implementation of SPOPS::Iterator for SPOPS::LDAP
SPOPS::Iterator::WrapList
SPOPS::Iterator wrapper around object lists
SPOPS::Key::DBI::HandleField
Retrieve an auto-increment value from a DBI statement or database handle
SPOPS::Key::DBI::Identity
Retrieve IDENTITY values from a supported DBI database
SPOPS::Key::DBI::Pool
Retrieves ID field information from a pool
SPOPS::Key::DBI::Sequence
Retrieve sequence values from a supported DBI database
SPOPS::Key::Random
Creates a random alphanumeric code for the ID field
SPOPS::Key::UUID
Creates a Universally Unique ID (UUID) as a key
SPOPS::LDAP
Implement object persistence in an LDAP datastore
SPOPS::LDAP::MultiDatasource
SPOPS::LDAP functionality but fetching objects from multiple datasources
SPOPS::Loopback
Simple SPOPS class used for testing rules and other goodies
SPOPS::SQLInterface
Generic routines for DBI database interaction
SPOPS::Secure
Implement security across one or more classes of SPOPS objects
SPOPS::Secure::Hierarchy
Define hierarchical security
SPOPS::Tie
Simple class implementing tied hash with some goodies
SPOPS::Tie::StrictField
Enable field checking for SPOPS objects
SPOPS::Tool::CreateOnly
Make a particular object create-only -- it cannot be updated
SPOPS::Tool::DBI::Datasource
Embed the parameters for a DBI handle in object configuration
SPOPS::Tool::DBI::DiscoverField
SPOPS::ClassFactory rule implementing autofield discovery
SPOPS::Tool::DBI::FindDefaults
Load default values from a particular record
SPOPS::Tool::LDAP::Datasource
Embed the parameters for a LDAP handle in object configuration
SPOPS::Tool::ReadOnly
Make a particular object read-only
SPOPS::Tool::UTFConvert
Provide automatic UTF-8 conversion
SPOPS::Utility
Utility methods for SPOPS objects
My::Security
My::User

Provides

SPOPS::Import::DBI::TableTransform::InterBase
in SPOPS/Import/DBI/TableTransform/InterBase.pm
SPOPS::Import::DBI::TableTransform::MySQL
in SPOPS/Import/DBI/TableTransform/MySQL.pm
SPOPS::Import::DBI::TableTransform::Oracle
in SPOPS/Import/DBI/TableTransform/Oracle.pm
SPOPS::Import::DBI::TableTransform::Pg
in SPOPS/Import/DBI/TableTransform/Pg.pm
SPOPS::Import::DBI::TableTransform::SQLite
in SPOPS/Import/DBI/TableTransform/SQLite.pm
SPOPS::Import::DBI::TableTransform::Sybase
in SPOPS/Import/DBI/TableTransform/Sybase.pm
SPOPS::TieFileHash
in SPOPS/HashFile.pm

Examples

Other files