api/uniter: Skeleton of remaining calls/objects

state/api/uniter/unit.go

Index: state/api/uniter/unit.go 
=== modified file 'state/api/uniter/unit.go' 
--- state/api/uniter/unit.go	2013-08-08 13:06:35 +0000 
+++ state/api/uniter/unit.go	2013-08-19 19:44:51 +0000 
@@ -1,4 +1,4 @@ 
-// Copyright 2012, 2013 Canonical Ltd. 
+// Copyright 2013 Canonical Ltd. 
 // Licensed under the AGPLv3, see LICENCE file for details. 
 
 package uniter 
@@ -6,15 +6,19 @@ 
 import ( 
	"fmt" 
 
+	"launchpad.net/juju-core/charm" 
	"launchpad.net/juju-core/state/api/params" 
	"launchpad.net/juju-core/state/api/watcher" 
 ) 
 
 // Unit represents a juju unit as seen by a uniter worker. 
 type Unit struct { 
-	tag string 
-	life params.Life 
-	st *State 
+	st *State 
+	tag string 
+	life params.Life 
+	serviceTag string 
+	// TODO: Uncomment after added to params. See Resolved() 
+	//resolvedMode params.ResolvedMode 
 } 
 
 // Tag returns the unit's tag. 
@@ -34,6 +38,7 @@ 
	return err 
	} 
	u.life = life 
+	// TODO: Update resolvedMode as well 
	return nil 
 } 
 
@@ -86,3 +91,163 @@ 
	w := watcher.NewNotifyWatcher(u.st.caller, result) 
	return w, nil 
 } 
+ 
+// Service returns the service. 
+func (u *Unit) Service() (*Service, error) { 
+	return u.st.Service(u.serviceTag) 
+} 
+ 
+// ConfigSettings returns the complete set of service charm config settings 
+// available to the unit. Unset values will be replaced with the default 
+// value for the associated option, and may thus be nil when no default is 
+// specified. 
+func (u *Unit) ConfigSettings() (charm.Settings, error) { 
+	// TODO: Call Uniter.ConfigSettings() 
+	panic("not implemented") 
+} 
+ 
+// ServiceName returns the service name. 
+func (u *Unit) ServiceName() string { 
+	// TODO: Convert u.serviceTag to a service name and return it. 
+	panic("not implemented") 
+} 
+ 
+// Destroy, when called on a Alive unit, advances its lifecycle as far as 
+// possible; it otherwise has no effect. In most situations, the unit's 
+// life is just set to Dying; but if a principal unit that is not assigned 
+// to a provisioned machine is Destroyed, it will be removed from state 
+// directly. 
+func (u *Unit) Destroy() (err error) { 
+	// TODO: Call Uniter.Destroy() 
+	panic("not implemented") 
+} 
+ 
+// Resolved returns the resolved mode for the unit. 
+// TODO: Copy state.ResolvedMode type and constants in 
+// state/api/params/constants.go, then uncomment this. 
+//func (u *Unit) Resolved() params.ResolvedMode { 
+//	// TODO: Update u.resolvedMode on Refresh() as well as u.life. 
+//	return u.resolvedMode 
+//} 
+ 
+// IsPrincipal returns whether the unit is deployed in its own container, 
+// and can therefore have subordinate services deployed alongside it. 
+// 
+// NOTE: This differs from state.Unit.IsPrincipal() by returning an 
+// error as well, because it needs to make an API call. 
+func (u *Unit) IsPrincipal() (bool, error) { 
+	// TODO: Call Uniter.GetPrincipal() 
+	panic("not implemented") 
+} 
+ 
+// SubordinateNames returns the names of any subordinate units. 
+// 
+// NOTE: This differs from state.Unit.SubordinateNames() by returning 
+// an error as well, because it needs to make an API call. 
+func (u *Unit) SubordinateNames() ([]string, error) { 
+	// TODO: Call Uniter.SubordinateNames() 
+	panic("not implemented") 
+} 
+ 
+// PublicAddress returns the public address of the unit and whether it 
+// is valid. 
+// 
+// NOTE: This differs from state.Unit.PublicAddres() by returning 
+// an error as well, because it needs to make an API call. 
+// 
+// TODO: We might be able to drop this, once we have machine 
+// addresses implemented fully. 
+func (u *Unit) PublicAddress() (string, bool, error) { 
+	// TODO: Call Uniter.PublicAddress() 
+	panic("not implemented") 
+} 
+ 
+// SetPublicAddress sets the public address of the unit. 
+// 
+// TODO: We might be able to drop this, once we have machine 
+// addresses implemented fully. 
+func (u *Unit) SetPublicAddress(address string) (err error) { 
+	// TODO: Call Uniter.SetPublicAddress() 
+	panic("not implemented") 
+} 
+ 
+// PrivateAddress returns the private address of the unit and whether 
+// it is valid. 
+// 
+// NOTE: This differs from state.Unit.PrivateAddress() by returning 
+// an error as well, because it needs to make an API call. 
+// 
+// TODO: We might be able to drop this, once we have machine 
+// addresses implemented fully. 
+func (u *Unit) PrivateAddress() (string, bool, error) { 
+	// TODO: Call Uniter.PrivateAddress() 
+	panic("not implemented") 
+} 
+ 
+// SetPrivateAddress sets the private address of the unit. 
+// 
+// TODO: We might be able to drop this, once we have machine 
+// addresses implemented fully. 
+func (u *Unit) SetPrivateAddress(address string) error { 
+	// TODO: Call Uniter.SetPrivateAddress() 
+	panic("not implemented") 
+} 
+ 
+// OpenPort sets the policy of the port with protocol and number to be 
+// opened. 
+// 
+// TODO: We should really be opening and closing ports on machines, 
+// rather than units. 
+func (u *Unit) OpenPort(protocol string, number int) (err error) { 
+	// TODO: Call Uniter.OpenPort() 
+	panic("not implemented") 
+} 
+ 
+// ClosePort sets the policy of the port with protocol and number to 
+// be closed. 
+// 
+// TODO: We should really be opening and closing ports on machines, 
+// rather than units. 
+func (u *Unit) ClosePort(protocol string, number int) (err error) { 
+	// TODO: Call Uniter.ClosePort() 
+	panic("not implemented") 
+} 
+ 
+// CharmURL returns the charm URL this unit is currently using. 
+// 
+// NOTE: This differs from state.Unit.CharmURL() by returning 
+// an error as well, because it needs to make an API call. 
+func (u *Unit) CharmURL() (*charm.URL, bool, error) { 
+	// TODO: Call Uniter.CharmURL() 
+	panic("not implemented") 
+} 
+ 
+// SetCharmURL marks the unit as currently using the supplied charm URL. 
+// An error will be returned if the unit is dead, or the charm URL not known. 
+func (u *Unit) SetCharmURL(curl *charm.URL) (err error) { 
+	// TODO: Call Uniter.SetCharmURL() 
+	panic("not implemented") 
+} 
+ 
+// ClearResolved removes any resolved setting on the unit. 
+func (u *Unit) ClearResolved() error { 
+	// TODO: Call Uniter.ClearResolved() 
+	panic("not implemented") 
+} 
+ 
+// Name returns the unit name. 
+func (u *Unit) Name() string { 
+	// TODO: Convert u.tag to a unit name and return it. 
+	panic("not implemented") 
+} 
+ 
+// WatchConfigSettings returns a watcher for observing changes to the 
+// unit's service configuration settings. The unit must have a charm URL 
+// set before this method is called, and the returned watcher will be 
+// valid only while the unit's charm URL is not changed. 
+func (u *Unit) WatchConfigSettings() (*watcher.NotifyWatcher, error) { 
+	// TODO: Call Uniter.WatchConfigSettings(), passing the unit tag 
+	// as argument, then start a client NotifyWatcher, like 
+	// uniter.Unit.Watch() does. 
+	panic("not implemented") 
+}