WIP: Add translate command

CHANGELOG.md

@@ -3,6 +3,19 @@
 This file lists the main changes with each version of the Fyne toolkit.
 More detailed release notes can be found on the [releases page](https://github.com/fyne-io/fyne/releases). 
 
+## 2.6.0 - Ongoing
+
+### Added
+
+### Changed
+
+ * ActionItems in an Entry should now match the standard button size
+
+### Fixed
+
+ * Odd looking SelectEntry with long PlaceHolder (#4430)
+
+
 ## 2.5.1 - 24 August 2024
 
 ### Fixed
@@ -1352,7 +1365,7 @@ The import path is now `fyne.io/fyne/v2` when you are ready to make the update.
 * Don't add a button bar to a form if it has no buttons
 * Moved driver/gl package to internal/driver/gl
 * Clicking/Tapping in an entry will position the cursor
-* A container with no layout will not change the position or size of it's content
+* A container with no layout will not change the position or size of its content
 * Update the fyne_demo app to reflect the expanding feature set
 
 ### Fixed

animation.go

@@ -45,7 +45,7 @@ type Animation struct {
 }
 
 // NewAnimation creates a very basic animation where the callback function will be called for every
-// rendered frame between time.Now() and the specified duration. The callback values start at 0.0 and
+// rendered frame between [time.Now] and the specified duration. The callback values start at 0.0 and
 // will be 1.0 when the animation completes.
 //
 // Since: 2.0

app.go

@@ -7,9 +7,9 @@ import (
 
 // An App is the definition of a graphical application.
 // Apps can have multiple windows, by default they will exit when all windows
-// have been closed. This can be modified using SetMaster() or SetCloseIntercept().
-// To start an application you need to call Run() somewhere in your main() function.
-// Alternatively use the window.ShowAndRun() function for your main window.
+// have been closed. This can be modified using SetMaster or SetCloseIntercept.
+// To start an application you need to call Run somewhere in your main function.
+// Alternatively use the [fyne.io/fyne/v2.Window.ShowAndRun] function for your main window.
 type App interface {
 	// Create a new window for the application.
 	// The first window to open is considered the "master" and when closed
@@ -27,7 +27,7 @@ type App interface {
 	// SetIcon sets the icon resource used for this application instance.
 	SetIcon(Resource)
 
-	// Run the application - this starts the event loop and waits until Quit()
+	// Run the application - this starts the event loop and waits until [App.Quit]
 	// is called or the last window closes.
 	// This should be called near the end of a main() function as it will block.
 	Run()
@@ -43,7 +43,7 @@ type App interface {
 	Driver() Driver
 
 	// UniqueID returns the application unique identifier, if set.
-	// This must be set for use of the Preferences() functions... see NewWithId(string)
+	// This must be set for use of the [App.Preferences]. see [NewWithID].
 	UniqueID() string
 
 	// SendNotification sends a system notification that will be displayed in the operating system's notification area.
@@ -75,7 +75,7 @@ type App interface {
 	CloudProvider() CloudProvider // get the (if any) configured provider
 
 	// SetCloudProvider allows developers to specify how this application should integrate with cloud services.
-	// See `fyne.io/cloud` package for implementation details.
+	// See [fyne.io/cloud] package for implementation details.
 	//
 	// Since: 2.3
 	SetCloudProvider(CloudProvider) // configure cloud for this app

app/app_desktop_darwin.go

@@ -53,6 +53,6 @@ func themeChanged() {
 	fyne.CurrentApp().Settings().(*settings).setupTheme()
 }
 
-func watchTheme() {
+func watchTheme(_ *settings) {
 	C.watchTheme()
 }

app/app_goxjs.go

@@ -61,7 +61,7 @@ var themeChanged = js.FuncOf(func(this js.Value, args []js.Value) interface{} {
 	return nil
 })
 
-func watchTheme() {
+func watchTheme(_ *settings) {
 	js.Global().Call("matchMedia", "(prefers-color-scheme: dark)").Call("addEventListener", "change", themeChanged)
 }
 func stopWatchingTheme() {

app/app_other.go

@@ -23,6 +23,6 @@ func (a *fyneApp) SendNotification(_ *fyne.Notification) {
 	fyne.LogError("Refusing to show notification for unknown operating system", nil)
 }
 
-func watchTheme() {
+func watchTheme(_ *settings) {
 	// no-op
 }

app/app_windows.go

@@ -95,6 +95,7 @@ func runScript(name, script string) {
 		fyne.LogError("Failed to launch windows notify script", err)
 	}
 }
-func watchTheme() {
-	go internalapp.WatchTheme(fyne.CurrentApp().Settings().(*settings).setupTheme)
+
+func watchTheme(s *settings) {
+	go internalapp.WatchTheme(s.setupTheme)
 }

app/app_xdg.go

@@ -119,17 +119,17 @@ func rootConfigDir() string {
 	return filepath.Join(desktopConfig, "fyne")
 }
 
-func watchTheme() {
+func watchTheme(s *settings) {
 	go func() {
 		// Theme lookup hangs on some desktops. Update theme variant cache from within goroutine.
 		internalapp.CurrentVariant.Store(uint64(findFreedesktopColorScheme()))
-		fyne.CurrentApp().Settings().(*settings).setupTheme()
+		s.setupTheme()
 
 		portalSettings.OnSignalSettingChanged(func(changed portalSettings.Changed) {
 			if changed.Namespace == "org.freedesktop.appearance" && changed.Key == "color-scheme" {
 				themeVariant := colorSchemeToThemeVariant(appearance.ColorScheme(changed.Value.(uint32)))
 				internalapp.CurrentVariant.Store(uint64(themeVariant))
-				fyne.CurrentApp().Settings().(*settings).setupTheme()
+				s.setupTheme()
 			}
 		})
 	}()

app/settings_desktop.go

@@ -62,7 +62,10 @@ func watchFile(path string, callback func()) *fsnotify.Watcher {
 func (s *settings) watchSettings() {
 	s.watcher = watchFile(s.schema.StoragePath(), s.fileChanged)
 
-	watchTheme()
+	a := fyne.CurrentApp()
+	if a != nil && s != nil && a.Settings() == s { // ignore if testing
+		watchTheme(s)
+	}
 }
 
 func (s *settings) stopWatching() {

app/settings_goxjs.go

@@ -17,7 +17,7 @@ func watchFile(path string, callback func()) {
 }
 
 func (s *settings) watchSettings() {
-	watchTheme()
+	watchTheme(s)
 }
 
 func (s *settings) stopWatching() {

canvas.go

@@ -2,7 +2,7 @@ package fyne
 
 import "image"
 
-// Canvas defines a graphical canvas to which a CanvasObject or Container can be added.
+// Canvas defines a graphical canvas to which a [CanvasObject] or Container can be added.
 // Each canvas has a scale which is automatically applied during the render process.
 type Canvas interface {
 	Content() CanvasObject
@@ -31,7 +31,7 @@ type Canvas interface {
 	// Size returns the current size of this canvas
 	Size() Size
 	// Scale returns the current scale (multiplication factor) this canvas uses to render
-	// The pixel size of a CanvasObject can be found by multiplying by this value.
+	// The pixel size of a [CanvasObject] can be found by multiplying by this value.
 	Scale() float32
 
 	// Overlays returns the overlay stack.

canvasobject.go

@@ -36,27 +36,27 @@ type CanvasObject interface {
 	Refresh()
 }
 
-// Disableable describes any CanvasObject that can be disabled.
+// Disableable describes any [CanvasObject] that can be disabled.
 // This is primarily used with objects that also implement the Tappable interface.
 type Disableable interface {
 	Enable()
 	Disable()
 	Disabled() bool
 }
 
-// DoubleTappable describes any CanvasObject that can also be double tapped.
+// DoubleTappable describes any [CanvasObject] that can also be double tapped.
 type DoubleTappable interface {
 	DoubleTapped(*PointEvent)
 }
 
-// Draggable indicates that a CanvasObject can be dragged.
+// Draggable indicates that a [CanvasObject] can be dragged.
 // This is used for any item that the user has indicated should be moved across the screen.
 type Draggable interface {
 	Dragged(*DragEvent)
 	DragEnd()
 }
 
-// Focusable describes any CanvasObject that can respond to being focused.
+// Focusable describes any [CanvasObject] that can respond to being focused.
 // It will receive the FocusGained and FocusLost events appropriately.
 // When focused it will also have TypedRune called as text is input and
 // TypedKey called when other keys are pressed.
@@ -75,18 +75,18 @@ type Focusable interface {
 	TypedKey(*KeyEvent)
 }
 
-// Scrollable describes any CanvasObject that can also be scrolled.
+// Scrollable describes any [CanvasObject] that can also be scrolled.
 // This is mostly used to implement the widget.ScrollContainer.
 type Scrollable interface {
 	Scrolled(*ScrollEvent)
 }
 
-// SecondaryTappable describes a CanvasObject that can be right-clicked or long-tapped.
+// SecondaryTappable describes a [CanvasObject] that can be right-clicked or long-tapped.
 type SecondaryTappable interface {
 	TappedSecondary(*PointEvent)
 }
 
-// Shortcutable describes any CanvasObject that can respond to shortcut commands (quit, cut, copy, and paste).
+// Shortcutable describes any [CanvasObject] that can respond to shortcut commands (quit, cut, copy, and paste).
 type Shortcutable interface {
 	TypedShortcut(Shortcut)
 }
@@ -95,12 +95,12 @@ type Shortcutable interface {
 //
 // Since: 2.1
 type Tabbable interface {
-	// AcceptsTab() is a hook called by the key press handling logic.
+	// AcceptsTab is a hook called by the key press handling logic.
 	// If it returns true then the Tab key events will be sent using TypedKey.
 	AcceptsTab() bool
 }
 
-// Tappable describes any CanvasObject that can also be tapped.
+// Tappable describes any [CanvasObject] that can also be tapped.
 // This should be implemented by buttons etc that wish to handle pointer interactions.
 type Tappable interface {
 	Tapped(*PointEvent)

cloud.go

@@ -1,7 +1,7 @@
 package fyne
 
 // CloudProvider specifies the identifying information of a cloud provider.
-// This information is mostly used by the `fyne.io/cloud ShowSettings' user flow.
+// This information is mostly used by the [fyne.io/cloud.ShowSettings] user flow.
 //
 // Since: 2.3
 type CloudProvider interface {

cmd/fyne/internal/commands/get.go

@@ -35,6 +35,12 @@ func Get() *cli.Command {
 				Usage:       "For darwin and Windows targets an appID in the form of a reversed domain name is required, for ios this must match a valid provisioning profile",
 				Destination: &g.AppID,
 			},
+			&cli.StringFlag{
+				Name:        "installDir",
+				Aliases:     []string{"o"},
+				Usage:       "A specific location to install to, rather than the OS default.",
+				Destination: &g.installDir,
+			},
 		},
 		Action: func(ctx *cli.Context) error {
 			if ctx.Args().Len() != 1 {
@@ -50,6 +56,7 @@ func Get() *cli.Command {
 // Getter is the command that can handle downloading and installing Fyne apps to the current platform.
 type Getter struct {
 	*appData
+	installDir string
 }
 
 // NewGetter returns a command that can handle the download and install of GUI apps built using Fyne.
@@ -98,7 +105,7 @@ func (g *Getter) Get(pkg string) error {
 		path = filepath.Join(path, dir)
 	}
 
-	install := &Installer{appData: g.appData, srcDir: path, release: true}
+	install := &Installer{appData: g.appData, installDir: g.installDir, srcDir: path, release: true}
 	if err := install.validate(); err != nil {
 		return fmt.Errorf("failed to set up installer: %w", err)
 	}