Next: Introduction, Previous: (dir), Up: (dir) [Contents][Index]
This is the fare-mop Reference Manual, version 1.0.1, generated automatically by Declt version 4.0 beta 2 "William Riker" on Mon Aug 15 04:31:46 2022 GMT+0.
Next: Systems, Previous: The fare-mop Reference Manual, Up: The fare-mop Reference Manual [Contents][Index]
fare-mop has a few simple utilities relying on the MOP.
It depends on CLOSER-MOP for portable MOP access.
The main utilities are:
SIMPLE-PRINT-OBJECT-MIXIN
class mixin to give you a useful PRINT-OBJECT method for free
SIMPLE-PRINT-OBJECT
a simple PRINT-OBJECT function you can use it without the mixin
(useful when you don't want to change the class hierarchy of
some library you're using, but still want to simply inspect objects
and/or define a PRINT-OBJECT method on them).
COLLECT-SLOTS
a utility used by the above function, to collect a p-list
describing the slots bound in an object
SLOTS-TO-PRINT
a way to customize which slots get printed by SIMPLE-PRINT-OBJECT-MIXIN
Other utilities include:
REMAKE-OBJECT
a utility for "copying" objects by calling make-instance with
the "same" initialization arguments as an original objects,
plus overriding keyword arguments.
Useful for experimenting with a pure functional OO style.
Not for use where performance is important.
See documentation strings for details.
Next: Files, Previous: Introduction, Up: The fare-mop Reference Manual [Contents][Index]
The main system appears first, followed by any subsystem dependency.
Utilities using the MOP; notably make informative pretty-printing trivial
Francois-Rene Rideau
fare-mop is a small collection of utilities using the MOP.
It notably contains a method SIMPLE-PRINT-OBJECT, and
a mixin SIMPLE-PRINT-OBJECT-MIXIN that allow you to trivially define
PRINT-OBJECT methods that print the interesting slots in your objects,
which is great for REPL interaction and debugging.
1.0.1
Next: Packages, Previous: Systems, Up: The fare-mop Reference Manual [Contents][Index]
Files are sorted by type and then listed depth-first from the systems components trees.
Next: fare-mop/package.lisp, Previous: Lisp, Up: Lisp [Contents][Index]
fare-mop (system).
Next: fare-mop/utilities.lisp, Previous: fare-mop/fare-mop.asd, Up: Lisp [Contents][Index]
fare-mop (system).
Previous: fare-mop/package.lisp, Up: Lisp [Contents][Index]
package.lisp (file).
fare-mop (system).
Next: Definitions, Previous: Files, Up: The fare-mop Reference Manual [Contents][Index]
Packages are listed by definition order.
Next: Indexes, Previous: Packages, Up: The fare-mop Reference Manual [Contents][Index]
Definitions are sorted by export status, category, package, and then by lexicographic order.
Previous: Definitions, Up: Definitions [Contents][Index]
Next: Generic functions, Previous: Public Interface, Up: Public Interface [Contents][Index]
Given an OBJECT and SLOTS designating a list of slot designators,
return a p-list of an INITARG and VALUE
for each of those of the specified slots that are bound.
A slot designator may be a SLOT-DEFINITION object,
a KEYWORD specifying the INITARG of the slot,
or a SYMBOL naming the slot.
If the slot has no INITARG, the slot name is used instead in the p-list
A function to build a new object of the same class as OBJECT,
initialized with the specified KEYS, plus keys deduced from the original object
by those slots that both are bound and have a defined initarg.
Note: this function is useful for experimental programming,
but use of runtime introspection means
this function isn’t suited where performance is important.
This function will introspect you object’s slots to print it.
You can call it explicitly from your print-object methods,
or implicitly by just inheritting from SIMPLE-PRINT-OBJECT-MIXIN.
If SLOTS is T (the default), print all slots as per CLOSER-MOP:COMPUTE-SLOTS.
If SLOTS is a list of slot designators, print them.
Slots are printed as a p-list as per FARE-MOP:COLLECT-SLOTS.
The IDENTITY keyword is as per PRINT-UNREADABLE-OBJECT.
Next: Standalone methods, Previous: Ordinary functions, Up: Public Interface [Contents][Index]
Next: Classes, Previous: Generic functions, Up: Public Interface [Contents][Index]
Previous: Standalone methods, Up: Public Interface [Contents][Index]
Mixin to trivially give a print-object method to your class.
If you don’t want to print all slots, define a method on FARE-MOP:SLOTS-TO-PRINT
to return a list of slot designators for those slots you want to print,
as per FARE-MOP:COLLECT-SLOTS.
Previous: Definitions, Up: The fare-mop Reference Manual [Contents][Index]
| Jump to: | C F G M P R S |
|---|
| Jump to: | C F G M P R S |
|---|
| Jump to: | C F P S U |
|---|
| Jump to: | C F P S U |
|---|