Metadata-Version: 1.0
Name: configtreeview
Version: 0.1.2a
Summary: An easily configurable GtkTreeView implementation for pygtk.
Home-page: http://github.com/wrhansen/ConfigTreeView
Author: Wesley Hansen
Author-email: wes@ridersdiscount.com
License: GPLv3
Description: ==============
        ConfigTreeView
        ==============
        	This is an implementation of a GtkTreeView in python( using pygtk v 2) that
        	allows for easy, fast, and dynamic setting up of a TreeView, its
        	TreeViewColumns and CellRenderers. This ConfigTreeView can create a TreeView
        	with all its properties initialized through the use of a simple config-type
        	file. This config file can be in a python dictionary format, or even read
        	in from a JSON object.
        	
        The Why (Why use a ConfigTreeView?)
        ===================================
        	* The ConfigTreeView was designed in such a way to abstract the developer
        	  from having to set up indices for how a ListStore row of data should look.
        	  The config file creates an easy way to do it and allows you to supply a
        	  row of data in python dict form while initializing all the properties,
        	  columns, cell renderers that could possbily be used in creating a
        	  TreeView.
        	
        	* Eliminates the several lines of code it takes to initialize a TreeView.
        	  A TreeView is a very useful but also very complicated widget in the gtk 
        	  arsenal and this implementation takes away that complication.
        	
        	* Useful for data models that could change frequently without having
        	  to go in and change the code.--This is actually the use case that I ran
        	  into at my place of work that inspired me to create the ConfigTreeView. We
        	  have an application that many people use in the office that is connected
        	  to a server. The application gets all of the data from the server, but we
        	  wanted a system set in place that could allow for us to change the data
        	  the server was sending without having to go in and change the code in the
        	  clients in order to properly display the newly changed data. With a
        	  ConfigTreeView you can do just this: the server can supply a config
        	  structure to initialize the clients, eliminating the need for changing the
        	  client code.
        
        How to use it
        =============
        	* It's easy! All you need to do is create a config file( either as a python
        	  dict in a .py file or as a JSON file). 
        	* Then with a config file, you're ready to create a ConfigTreeView::
        	
        		from config_treeview import ConfigTreeView
        		#Import the config structure(it's a python dict named config)
        		from myconfigfile import config
        		#Create a ConfigTreeView using config as the configuration structure
        		treeview = ConfigTreeView(config)
        		#Apply the config structure to finish initalizing the TreeView
        		treeview.apply_config() 
        	
        
        For more information refer to
        =============================
        
        	For setting up the config file refer to:
        		docs/how_to_config_file.txt
        		
        	For creating a custom ConfigTreeView prototype refer to:
        		docs/how_to_custom.txt
        		
        	For example config file structures refer to:
        		examples/config_example.py
        		
        	For example using a ConfigTreeView refer to:
        		examples/using_config_treeview.py
        		
        	For example of a ConfigTreeView prototype refer to:
        		examples/custom_treeview.py
        
        
        	
        
Platform: POSIX
Platform: Windows
