Aglyph cookbook

Release:3.0.0.post1

• Understand the general features of Aglyph
  • Aglyph supports Python 2 and 3 (CPython), PyPy, Stackless, IronPython, and Jython
  • Aglyph does not require framework-specific changes to your application code
  • Any object (application-specific, Python standard library, or 3rd-party) can be an Aglyph component
• Choose a configuration approach for Aglyph
  • Declarative XML configuration
    • XMLContext configures mutable builtin objects safely
    • XMLContext is Unicode-aware and supports automatic character set conversion
  • Programmatic configuration using the Context fluent API
  • Custom configuration using Context
• Common usage scenarios
  • Describe a simple component (a class or an unbound factory function)
    • Using declarative XML configuration
    • Using fluent API configuration
  • Describe any Python builtin type as a component
    • Using declarative XML configuration
    • Using fluent API configuration
  • Use a reference to another component as a dependency
    • Using declarative XML configuration
    • Using fluent API configuration
  • Defer the resolution of injection values until assembly time
    • Use a Reference to defer the assembly of a component
    • Use a partial function or an Evaluator to defer the evaluation of a runtime value
  • Declare a method to be called on an object after its dependencies have been injected
    • Using declarative XML configuration
    • Using fluent API configuration
  • Declare a method to be called on a singleton, borg, or weakref object before it is cleared from cache
    • Using declarative XML configuration
    • Using fluent API configuration
  • Avoid circular dependencies
• Component inheritance using templates
  • Use a template to declare common dependencies, and child components to declare specific dependencies
    • Using declarative XML configuration
    • Using fluent API configuration
  • “Extend” a component by using another component as the parent
    • Using declarative XML configuration
    • Using fluent API configuration
  • Use templates to declare the lifecycle methods used by similar components
    • Using declarative XML configuration
    • Using fluent API configuration
• Other notable usage scenarios
  • Describe components for static methods, class methods, or nested classes
    • Using declarative XML configuration
    • Using fluent API configuration
  • Describe components for module or class members
    • Using declarative XML configuration
    • Using fluent API configuration
  • Describe components for Python implementation-specific objects (Stackless, PyPy, IronPython, Jython)
    • Example 1: Describe a component for a Stackless Python or PyPy tasklet
    • Example 2: Describe a component for a .NET XmlReader
    • Example 3: Describe a component for a Java™ LinkedHashMap
  • Use a custom XML parser for XMLContext
  • Clear the Aglyph singleton, weakref, and borg memory caches
• Integrating Aglyph
  • Use Aglyph to configure your CherryPy application
    • Using declarative XML configuration
    • Using fluent API configuration
  • Provide dependency injection support to your application using AglyphDIPlugin
    • Using declarative XML configuration
    • Using fluent API configuration
  • Manage the lifecycles of your application components