xibless 0.5.2
Generate Objective-C code that builds Cocoa UIs. Replaces XCode's XIBs
License: BSD

===================================
xibless - Get rid of XIBs and XCode
===================================

``xibless`` is a library that generates Objective-C code that builds Cocoa UIs. The goal of this library
is to replace XIBs in XCode and, if you want, get rid of XCode altogether.

With ``xibless``, instead of designing UIs with a WYSIWYG editor, you build them in a Python script,
similarly to what you do when you build Qt UIs without the Designer. For example, a script like this::

    result = Window(330, 110, "Tell me your name!")
    nameLabel = Label(result, text="Name:")
    nameField = TextField(result, text="")
    helloLabel = Label(result, text="")
    button = Button(result, title="Say Hello")

    nameLabel.width = 45
    nameLabel.moveTo(Pack.UpperLeft)
    nameField.moveNextTo(nameLabel, Pack.Right, align=Pack.Middle)
    nameField.fill(Pack.Right)
    helloLabel.moveNextTo(nameLabel, Pack.Below, align=Pack.Left)
    helloLabel.fill(Pack.Right)
    button.moveNextTo(helloLabel, Pack.Below, align=Pack.Right)
    nameField.setAnchor(Pack.UpperLeft, growX=True)
    helloLabel.setAnchor(Pack.UpperLeft, growX=True)
    button.setAnchor(Pack.UpperRight)

would generate Objective-C code that build a form with a name field, a text label and a button. The
second part of the script places the widgets on the form appropriately.

**Although xibless is written in Python, the Objective-C code it generates has no Python dependency,
so this tool is suitable for any Cocoa developer.**

``xibless`` runs on Python 2.7 and up. This means that if you're on OS X 10.7 or newer, you can use
the built-in Python. Otherwise, you'll have to install a more recent version of Python.

**Installation and usage:** Please refer to the `Documentation <http://packages.python.org/xibless/>`_
for installation and usage instructions.

Early Development
-----------------

``xibless`` is in very early development and the number of rough edges at the moment are
incalculable. There are no error message for invalid UI scripts, so it might be very hard, for now,
to figure out why your scripts don't work.


Changes
=======

Version 0.5.2 -- 2016/01/09
---------------------------

* Fix ``Menu.removeItem()`` bug resulting in un-compilable code generation.
* Fix compilation warnings with identifier-less ``TabViewItem``.

Version 0.5.1 -- 2013/11/10
---------------------------

* Fixed a crash with UI scripts containing non-ascii text

Version 0.5.0 -- 2012/10/08
---------------------------

* Added VHLayout.
* Added Box.
* In View, added delegate, fixedHeight, fixedWidth and accessibilityDescription attributes as well
  as moveTo() (a more powerful version of packToCorner()) and fillAll() methods.
* In Segment, added image and accessibilityDescription attributes.
* Added SplitView.dividerStyle and added documentation for a direct split view hierarchy.
* Added TableView.borderType and View.focusRingType.
* Added Button.bordered
* Added MenuItem.state
* Added TabView.tabViewType.
* Added TextField.usesSingleLineMode.
* Added margin and align arguments to layouts.
* Deprecated View.packToCorner().
* Layouts can now contain sublayouts.
* Allow Color() to receive values in the range of 0-255 in addition to 0.0-1.0.
* Don't localize strings containing only "-" (they're used to indicate a separator menu item).
* RadioButtons' height now depends on the number of rows it has.
* Fixed filler resizing in layouts in cases where there are other views next to the filler.
* Allow UI scripts to import units that are from the same folder.
* Replaced Button.keyEquivalent with Button.shortcut.
* Fixed runtemplate so that the XiblessSupport unit is compiled in the RunUI executable.
* Fixed a bug where we would sometimes end up with two generated item with the same varname.
* Always set growX/growY to False in setAnchor() for views that have a fixed width/height.
* The "text" argument of TextField's constructor is now optional.
* Support sides and middle in View.setAnchor().
* Generated units now have a comment indicating generation time and xibless version.
* Moved TextField.alignment down to Control
* Only copy XiblessSupport unit when it changed, thus avoiding needless recompilation.
* Fixed TabView's layout deltas for cases where there's no tabs.
* Support shortcuts involving the '+' character.
* Improved default margins in layouts, control heights and all other little tweaks of this sort.

Version 0.4.1 -- 2012/08/08
---------------------------

* Added NLSTR to UI scripts namespace.
* Don't wrap Window.autosaveName in localization calls.
* Fixed a bug causing some strings not to be wrapped in localization calls.
* Set RadioButton's "autosizesCells" to True upon creation.

Version 0.4.0 -- 2012/07/30
---------------------------

* Added Panel, SplitView, OutlineView, ListView, Toolbar, SegmentedControl, SearchField, Slider
  and NumberFormatter.
* Added Layouts.
* Added support for many, many, many new attributes, constants and types.
* Now generates a ".h" to go alongside the generated unit.
* Added Property and its subclasses, an easier way to add support for new attributes, even the
  complex ones.
* It's now possible to override margins in layout method calls.
* Added support for bindings with the new ``View.bind()`` method.
* Added the new ``defaults`` global variable, which can be used to bind to user defaults.
* Constants accessed with ``const`` can now be bitwise OR-ed.
* Generated code is now formatted to look a bit better and be easier to debug.
* Added new constants for menu shortcuts for special keys (arrows, enter etc.).
* Added support for UI script arguments.


Version 0.3.1 -- 2012/07/20
---------------------------

* Pushed down the `action` attribute from `Button` to `Control`.
* `RadioButtons` is now a `Control` subclass.
* Made window recalculate its view loop after having generated its children.

Version 0.3.0 -- 2012/07/09
---------------------------

* Added RadioButtons, TableView, TabView, TextView, ImageView and ProgressIndicator.
* Added support for string localization.
* Added TextField.alignment and TextField.textColor.
* Added Button.keyEquivalent.
* Added canClose, canResize and canMinimize to Window.
* Added a Control subclass.
* View can now be directly instantiated in UI scripts (They're like "Custom Views" in IB).
* `xibless run` can now be run on script for which the result is a View.
* Improved layout system.
* Window origin is now supplied in terms of screen proportions rather than absolute positions.
* Fixed 'id' ownerclass in main function prototype generation and added the "ownerimport" global
  variable in the UI script.
* Escape newlines in string code generation.
* Added documentation for Button.buttonType and Button.bezelStyle and added a demo for a button
  with a different bezel style.
* Fixed the most glaring memory leaks.
* Fixed a bug where attributes like class-level default fonts wouldn't be generated when generating
  more than one UI script in the same python session.
* Windows are not released when closed by default.
* Added support for circular references (a window setting one of its properties to an item that
  required that window before being created, for example, initialFirstResponder). We previously
  couldn't generate code for such bindings.
* Made the `align` argument in `View.packRelativeTo()` optional.

Version 0.2.0 -- 2012/06/28
---------------------------

* Added Sphinx documentation
* Added the ``xibless run`` command for quick UI previews.
* Added Combobox and Popup.

Version 0.1.0 -- 2012/06/25
---------------------------

* Initial pre-alpha release