User:Enus Linden/Pyogp Refactor Notes

From Second Life Wiki
Revision as of 14:24, 17 August 2009 by Enus Linden (talk | contribs) (Created page with 'I'll keep track generally of what I do here. Sometimes it will be very explicit, particularly when dealing with architecture, other times it will just be narrative... == Phase 1...')
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

I'll keep track generally of what I do here. Sometimes it will be very explicit, particularly when dealing with architecture, other times it will just be narrative...

Phase 1

ToDo List:
	1. move all license info to top of file in trunk of pyogp.lib.base, with a new line at the top so Sphinx doesn't capture it...
	
Done:
	1. removed the obvious directories

Last revision prior to the refactor starting.

	enus$ svn info
		Path: .
		URL: https://svn.secondlife.com/svn/linden/projects/2008/pyogp
		Repository Root: https://svn.secondlife.com/svn/linden
		Repository UUID: a6265765-422e-0410-accc-9fb60e44a920
		Revision: 2596
		Node Kind: directory
		Schedule: normal
		Last Changed Author: kotler.linden
		Last Changed Rev: 2595
		Last Changed Date: 2009-08-10 14:51:57 -0700 (Mon, 10 Aug 2009)

Directory listing of the root of https://svn.secondlife.com/svn/linden/projects/2008/pyogp:
	
	enus$ ls -l | awk -F" " '{print $9}'
		CONTRIBUTORS.txt
		LICENSE.txt
		apps
		buildouts
		examples
		indra
		pyogp.interop
		pyogp.lib.agentdomain
		pyogp.lib.base
		pyogp.testharness
		sandbox
		tests

First steps: clean up the root directory of cruft...
	
	https://svn.secondlife.com/svn/linden/projects/2008/pyogp should be the home for a set of packages, nothing more.
	To accomplish this, we need to:
		create pyogp.apps as a package
		create pyogp.test (move pyogp.interop components here, create a new test wrapper)

	 	removes apps/ (depends on: create pyogp.apps as a package)
		remove examples/
		remove indra/
		remove sandbox/
		remove tests/

		we'll also get rid of buildouts/, but must first come up with alternate install/config instructions
		
		CONTRIBUTORS.txt and LICENSE.txt need to move to each package 

	Done:
		1. removed the examples directory
		
			enus$ svn log examples
			------------------------------------------------------------------------
			r1348 | tao.takashi | 2008-10-23 14:09:06 -0700 (Thu, 23 Oct 2008) | 29 lines
		
			enus$ svn delete examples	
			D         examples/simplelogin/login.py
			D         examples/simplelogin/README.txt
			D         examples/simplelogin
			D         examples/presence/presence/configure.zcml
			D         examples/presence/presence/__init__.py
			D         examples/presence/presence/test1.py
			D         examples/presence/presence/events.py
			D         examples/presence/presence
			D         examples/presence/setup.py
			D         examples/presence/setup.cfg
			D         examples/presence
			D         examples/old_scripts/makepacketdict.py
			D         examples/old_scripts/zerocode.py
			D         examples/old_scripts/legacy/presence_code.py
			D         examples/old_scripts/legacy
			D         examples/old_scripts/README.txt
			D         examples/old_scripts/pyogp-login.py
			D         examples/old_scripts
			D         examples/README.txt
			D         examples

		2. removed the indra directory
		
			enus$ svn log indra
			------------------------------------------------------------------------
			r1189 | enus.linden | 2008-09-16 10:46:22 -0700 (Tue, 16 Sep 2008) | 1 line
			
			enus$ svn delete --force indra
			D         indra/indra.base/trunk/setup.py
			D         indra/indra.base/trunk/docs/HISTORY.txt
			D         indra/indra.base/trunk/docs
			D         indra/indra.base/trunk/README.txt
			D         indra/indra.base/trunk/indra/__init__.py
			D         indra/indra.base/trunk/indra/base/lllog.py
			D         indra/indra.base/trunk/indra/base/tests/testDocTests.py
			D         indra/indra.base/trunk/indra/base/tests/__init__.py
			D         indra/indra.base/trunk/indra/base/tests/indrabase.txt
			D         indra/indra.base/trunk/indra/base/tests
			D         indra/indra.base/trunk/indra/base/llsd.py
			D         indra/indra.base/trunk/indra/base/lluuid.py
			D         indra/indra.base/trunk/indra/base/__init__.py
			D         indra/indra.base/trunk/indra/base/cllsd_test.py
			D         indra/indra.base/trunk/indra/base/config.py
			D         indra/indra.base/trunk/indra/base/metrics.py
			D         indra/indra.base/trunk/indra/base
			D         indra/indra.base/trunk/indra
			D         indra/indra.base/trunk/setup.cfg
			D         indra/indra.base/trunk
			D         indra/indra.base/branches
			D         indra/indra.base/tags
			D         indra/indra.base
			D         indra/buildout/bootstrap.py
			D         indra/buildout/buildout.cfg
			D         indra/buildout/src/EXTERNAlS.txt
			D         indra/buildout/src
			D         indra/buildout
			D         indra/indra.ipc/trunk/indra.ipc.egg-info/SOURCES.txt
			D         indra/indra.ipc/trunk/indra.ipc.egg-info/top_level.txt
			D         indra/indra.ipc/trunk/indra.ipc.egg-info/namespace_packages.txt
			D         indra/indra.ipc/trunk/indra.ipc.egg-info/PKG-INFO
			D         indra/indra.ipc/trunk/indra.ipc.egg-info/entry_points.txt
			D         indra/indra.ipc/trunk/indra.ipc.egg-info/dependency_links.txt
			D         indra/indra.ipc/trunk/indra.ipc.egg-info/not-zip-safe
			D         indra/indra.ipc/trunk/indra.ipc.egg-info/paster_plugins.txt
			D         indra/indra.ipc/trunk/indra.ipc.egg-info/requires.txt
			D         indra/indra.ipc/trunk/indra.ipc.egg-info
			D         indra/indra.ipc/trunk/setup.py
			D         indra/indra.ipc/trunk/docs/HISTORY.txt
			D         indra/indra.ipc/trunk/docs
			D         indra/indra.ipc/trunk/README.txt
			D         indra/indra.ipc/trunk/indra/__init__.py
			D         indra/indra.ipc/trunk/indra/ipc/siesta.py
			D         indra/indra.ipc/trunk/indra/ipc/webdav.py
			D         indra/indra.ipc/trunk/indra/ipc/compatibility.py
			D         indra/indra.ipc/trunk/indra/ipc/llmessage.py
			D         indra/indra.ipc/trunk/indra/ipc/russ.py
			D         indra/indra.ipc/trunk/indra/ipc/tokenstream.py
			D         indra/indra.ipc/trunk/indra/ipc/httputil.py
			D         indra/indra.ipc/trunk/indra/ipc/llsdhttp.py
			D         indra/indra.ipc/trunk/indra/ipc/mysql_pool.py
			D         indra/indra.ipc/trunk/indra/ipc/saranwrap.py
			D         indra/indra.ipc/trunk/indra/ipc/__init__.py
			D         indra/indra.ipc/trunk/indra/ipc/xml_rpc.py
			D         indra/indra.ipc/trunk/indra/ipc/servicebuilder.py
			D         indra/indra.ipc/trunk/indra/ipc/siesta_test.py
			D         indra/indra.ipc/trunk/indra/ipc
			D         indra/indra.ipc/trunk/indra
			D         indra/indra.ipc/trunk/setup.cfg
			D         indra/indra.ipc/trunk
			D         indra/indra.ipc/branches
			D         indra/indra.ipc/tags
			D         indra/indra.ipc
			D         indra/indra.util/trunk/setup.py
			D         indra/indra.util/trunk/docs/HISTORY.txt
			D         indra/indra.util/trunk/docs
			D         indra/indra.util/trunk/README.txt
			D         indra/indra.util/trunk/indra/__init__.py
			D         indra/indra.util/trunk/indra/util/named_query.py
			D         indra/indra.util/trunk/indra/util/shutil2.py
			D         indra/indra.util/trunk/indra/util/helpformatter.py
			D         indra/indra.util/trunk/indra/util/llversion.py
			D         indra/indra.util/trunk/indra/util/llmanifest.py
			D         indra/indra.util/trunk/indra/util/__init__.py
			D         indra/indra.util/trunk/indra/util/llsubprocess.py
			D         indra/indra.util/trunk/indra/util/fastest_elementtree.py
			D         indra/indra.util/trunk/indra/util/term.py
			D         indra/indra.util/trunk/indra/util
			D         indra/indra.util/trunk/indra
			D         indra/indra.util/trunk/setup.cfg
			D         indra/indra.util/trunk
			D         indra/indra.util/branches
			D         indra/indra.util/tags
			D         indra/indra.util
			D         indra

		3. removed the sandbox directory
		
			enus$ svn log sandbox
			------------------------------------------------------------------------
			r1189 | enus.linden | 2008-09-16 10:46:22 -0700 (Tue, 16 Sep 2008) | 1 line
			
			enus$ svn delete sandbox
			D         sandbox/trunk/setup.py
			D         sandbox/trunk/sandbox/__init__.py
			D         sandbox/trunk/sandbox/mrtopf/zerocode.py
			D         sandbox/trunk/sandbox/mrtopf/example1.py
			D         sandbox/trunk/sandbox/mrtopf/__init__.py
			D         sandbox/trunk/sandbox/mrtopf/notes/highlevel_api1.txt
			D         sandbox/trunk/sandbox/mrtopf/notes
			D         sandbox/trunk/sandbox/mrtopf/networktest/1/client.py
			D         sandbox/trunk/sandbox/mrtopf/networktest/1/server.py
			D         sandbox/trunk/sandbox/mrtopf/networktest/1
			D         sandbox/trunk/sandbox/mrtopf/networktest/2/connection.py
			D         sandbox/trunk/sandbox/mrtopf/networktest/2/threadedclient.py
			D         sandbox/trunk/sandbox/mrtopf/networktest/2/threadedclient2.py
			D         sandbox/trunk/sandbox/mrtopf/networktest/2/network/selectudp.py
			D         sandbox/trunk/sandbox/mrtopf/networktest/2/network/threadedudp.py
			D         sandbox/trunk/sandbox/mrtopf/networktest/2/network/threadedudp2.py
			D         sandbox/trunk/sandbox/mrtopf/networktest/2/network/twistedudp.py
			D         sandbox/trunk/sandbox/mrtopf/networktest/2/network/__init__.py
			D         sandbox/trunk/sandbox/mrtopf/networktest/2/network/t.py
			D         sandbox/trunk/sandbox/mrtopf/networktest/2/network
			D         sandbox/trunk/sandbox/mrtopf/networktest/2/twistedclient.py
			D         sandbox/trunk/sandbox/mrtopf/networktest/2/t.py
			D         sandbox/trunk/sandbox/mrtopf/networktest/2/twistedclient2.py
			D         sandbox/trunk/sandbox/mrtopf/networktest/2/server.py
			D         sandbox/trunk/sandbox/mrtopf/networktest/2
			D         sandbox/trunk/sandbox/mrtopf/networktest/3/client.py
			D         sandbox/trunk/sandbox/mrtopf/networktest/3/server.py
			D         sandbox/trunk/sandbox/mrtopf/networktest/3
			D         sandbox/trunk/sandbox/mrtopf/networktest/4/server2.py
			D         sandbox/trunk/sandbox/mrtopf/networktest/4/mclient-1.py
			D         sandbox/trunk/sandbox/mrtopf/networktest/4/mclient.py
			D         sandbox/trunk/sandbox/mrtopf/networktest/4/mclient2.py
			D         sandbox/trunk/sandbox/mrtopf/networktest/4/client.py
			D         sandbox/trunk/sandbox/mrtopf/networktest/4/mclient3.py
			D         sandbox/trunk/sandbox/mrtopf/networktest/4/mclient4.py
			D         sandbox/trunk/sandbox/mrtopf/networktest/4/readme
			D         sandbox/trunk/sandbox/mrtopf/networktest/4/server.py
			D         sandbox/trunk/sandbox/mrtopf/networktest/4
			D         sandbox/trunk/sandbox/mrtopf/networktest/README.txt
			D         sandbox/trunk/sandbox/mrtopf/networktest
			D         sandbox/trunk/sandbox/mrtopf/._zerocode.py
			D         sandbox/trunk/sandbox/mrtopf
			D         sandbox/trunk/sandbox
			D         sandbox/trunk/setup.cfg
			D         sandbox/trunk
			D         sandbox/branches
			D         sandbox/tags
			D         sandbox
			
		4. removed the tests directory
		
			enus$ svn log tests
			------------------------------------------------------------------------
			r734 | tess.linden | 2008-07-03 16:43:08 -0700 (Thu, 03 Jul 2008) | 1 line
			
			enus$ svn delete tests
			D         tests/simulator
			D         tests/test_rez_avatar.py
			D         tests/agentdomain
			D         tests/test.py
			D         tests/test_request_rez_avatar.py
			D         tests/test_derez_avatar.py
			D         tests/client
			D         tests

		5. check it all in:
		
			enus$ svn ci -m "removing nonessential root directories" .
			Deleting       examples
			Deleting       indra
			Deleting       sandbox
			Deleting       tests

			Committed revision 2602.

Documentation

	Wiki:
		Current:
			https://wiki.secondlife.com/wiki/PyOGP
			https://wiki.secondlife.com/wiki/PyOGP_Client_Library_Development_Sandbox
			https://wiki.secondlife.com/wiki/PyOGP_Client_Library
			https://wiki.secondlife.com/wiki/PyOGP_Client_Library_Development
			https://wiki.secondlife.com/wiki/PyOGP_Client_Library_File_System
			https://wiki.secondlife.com/wiki/Pyogp/Client_Lib/Architecture
			https://wiki.secondlife.com/wiki/Pyogp/Client_Lib/Packet
			https://wiki.secondlife.com/wiki/Pyogp/Documentation/Specification/pyogp.lib.base
			https://wiki.secondlife.com/wiki/Pyogp/Documentation/Specification/pyogp.interop