NAME¶
sb_dbexpimp.py - Bayes database export/import
DESCRIPTION¶
This utility has the primary function of exporting and importing a spambayes
database into/from a CSV file. This is useful in a number of scenarios.
- Platform portability of database - CSV files can be exported and imported
across platforms (Windows and Linux, for example).
- Database implementation changes - databases can survive database
implementation upgrades or new database implementations. For example, if a
dbm implementation changes between python x.y and python x.y+1...
- Database reorganization - an export followed by an import reorgs an
existing database, <theoretically> improving performance, at least
in some database implementations.
- Database sharing - it is possible to distribute particular databases for
research purposes, database sharing purposes, or for new users to have a
'seed' database to start with.
- Database merging - multiple databases can be merged into one quite easily
by specifying -m on an import. This will add the two database nham
and nspams together and for wordinfo conflicts, will add spamcount and
hamcount together.
Usage:¶
- sb_dbexpimp [options]
- options:
- -e
- : export
- -i
- : import
- -f: FN : flat file to export to or import from -p: FN : name
of pickled database file to use -d: FN : name of dbm database file
to use -m : merge import into an existing database file. This
is
- meaningful only for import. If omitted, a new database file will be
created. If specified, the imported wordinfo will be merged into an
existing database. Run dbExpImp -h for more information.
- -o: section:option:value :
- set [section, option] in the options database to value
- -h
- : help
If neither
-p nor
-d is specified, then the values in your
configuration file (or failing that, the defaults) will be used. In this way,
you may convert to and from storage formats other than pickle and dbm.
- Export pickled mybayes.db into mybayes.db.export as a CSV file
- sb_dbexpimp -e -p mybayes.db -f
mybayes.db.export
- Import mybayes.db.export into a new DBM mybayes.db
- sb_dbexpimp -i -d mybayes.db -f
mybayes.db.export
- Convert a bayes database from pickle to DBM
- sb_dbexpimp -e -p abayes.db -f abayes.export
sb_dbexpimp -i -d abayes.db -f abayes.export
- Create a new DBM database (newbayes.db) from two
- DBM databases (abayes.db, bbayes.db) sb_dbexpimp -e -d
abayes.db -f abayes.export sb_dbexpimp -e -d
bbayes.db -f bbayes.export sb_dbexpimp -i -d
newbayes.db -f abayes.export sb_dbexpimp -i -m
-d newbayes.db -f bbayes.export
SEE ALSO¶
The full documentation for
option is maintained as a Texinfo manual. If
the
info and
option programs are properly installed at your
site, the command
- info option
should give you access to the complete manual.