How-to Guides

How-to guides are recipes that take the user through steps in key subjects. They are more advanced than tutorials and assume a lot more about what the user already knows than tutorials do, and unlike documents in the tutorial they can stand alone.

• Getting Started with Rubicon
• You’re just not my type: Using Objective-C types in Python
  • Type annotations
  • Type conversions
  • Python-style APIs and methods for Objective-C objects
  • Manual conversions
• Memory management for Objective-C instances
  • Reference counting in Rubicon Objective-C
  • Reference cycles in Objective-C
• Using and creating Objective-C protocols
  • Looking up a protocol
  • Implementing a protocol
  • Writing custom protocols
• Asynchronous Programming with Rubicon
  • Integrating asyncio with CoreFoundation
  • Integrating asyncio with AppKit and NSApplication
  • Integrating asyncio with iOS and UIApplication
• Calling plain C functions from Python
  • A simple example: puts
  • Inline functions (e.g. NSLocationInRange)
  • Global variables and constants (e.g. NSFoundationVersionNumber)
  • A complex example: dispatch_get_main_queue
  • Further information
• How to contribute code to Rubicon
  • Set up your development environment
• Contributing to the documentation
  • Create a .rst file
  • Build documentation locally
• Internal How-to guides
  • How to cut a Rubicon-ObjC release