CHANGELOG.md

 
+<a name="v1.10.1"></a>
+## [v1.10.1] - 2022-10-16
+### Bug Fixes
+- fix assign the correct value to the proxy
+
+### Changes
+- chore add license texts
+
+
 <a name="v1.10.0"></a>
 ## [v1.10.0] - 2022-10-15
 ### Code Refactoring
@@ -114,6 +123,7 @@
 <a name="v1.0.0"></a>
 ## v1.0.0 - 2022-10-04
 
+[v1.10.1]: https://gitlab.schukai.com/oss/libraries/go/application/xflags/compare/v1.10.0...v1.10.1
 [v1.10.0]: https://gitlab.schukai.com/oss/libraries/go/application/xflags/compare/v1.9.0...v1.10.0
 [v1.9.0]: https://gitlab.schukai.com/oss/libraries/go/application/xflags/compare/v1.8.3...v1.9.0
 [v1.8.3]: https://gitlab.schukai.com/oss/libraries/go/application/xflags/compare/v1.8.2...v1.8.3

README.md

@@ -57,16 +57,17 @@ type Definition struct {
 
 The following tags are supported:
 
-| Tag           | Context | Description                                |
-|---------------|---------|--------------------------------------------|
-| `short`       | Value   | Short name of the flag.                    |
-| `long`        | Value   | Long name of the flag.                     |
-| `description` | Value   | Description of the flag.                   |
-| `required`    | Value   | Flag is required.                          |
-| `shadow`      | Value | Copy the value to the shadow structure.    |
-| `command`     | Command | Flag is a command.                         |
-| `call`        | Command | Function to call when the command is used. |
-| `ignore`      | -/-     | Property is ignored.                       |
+| Tag           | Context  | Description                                    |
+|---------------|----------|------------------------------------------------|
+| `short`       | Value    | Short name of the flag.                        |
+| `long`        | Value    | Long name of the flag.                         |
+| `description` | Value    | Description of the flag.                       |
+| `required`    | Value    | Flag is required.                              |
+| `proxy`       | Value    | Copy the value to the proxy structure.         |
+| `command`     | Command  | Flag is a command.                             |
+| `call`        | Command  | Function to call when the command is used.     |
+| `ignore`      | -/-      | Property is ignored.                           |
+
 
 ### Callbacks
 
@@ -148,9 +149,8 @@ setting.Execute()
 
 ### Proxy
 
-The proxy structure is used to copy the values of the flags to the
-proxy structure. The proxy structure is used to access the values of the
-flags.
+The proxy structure is used to copy the values of the flags to a other
+structure. 
 
 The proxy structure must implement the `Proxy` interface.
 
@@ -174,6 +174,8 @@ func main() {
 }
 ```
 
+The path in the structure is defined by the tag `proxy`.
+
 ### Arguments
 
 the free arguments can be fetched with the method `Args()`.

command.go

@@ -12,6 +12,7 @@ type cmd[C any] struct {
 	name         string
 	flagSet      *flag.FlagSet
 	tagMapping   map[string]string
+	proxyMapping map[string]string
 	commands     []*cmd[C]
 	settings     *Settings[C]
 	valuePath    []string
@@ -60,6 +61,7 @@ func buildCommandStruct[C any](s *Settings[C], name, fkt string, errorHandling f
 		commands:     []*cmd[C]{},
 		settings:     s,
 		tagMapping:   map[string]string{},
+		proxyMapping: map[string]string{},
 		valuePath:    path,
 		functionName: fkt,
 	}
@@ -148,6 +150,10 @@ func (c *cmd[C]) parseStruct(dta any) {
 				continue
 			}
 
+			if m[tagProxy] != "" {
+				c.proxyMapping[v.Type().Field(i).Name] = m[tagProxy]
+			}
+
 			if m[tagShort] != "" {
 				c.tagMapping[m[tagShort]] = v.Type().Field(i).Name
 			}

execute_test.go

@@ -12,12 +12,12 @@ import (
 type testExecutionStruct struct {
 	callbackCounter int `ignore:"true"`
 
-	// for tag shadow see TestFlagCopyToShadow
-	Global1  bool `short:"a" long:"global1" description:"Global 1" shadow:"ValGlobal1"`
+	// for tag proxy see TestFlagCopyToProxy
+	Global1  bool `short:"a" long:"global1" description:"Global 1" proxy:"ValGlobal1"`
 	Global2  bool `short:"b" long:"global2" description:"Global 2"`
 	Command1 struct {
 		Command1Flag1 bool `short:"c" long:"command1flag1" description:"Command 1 Flag 1"`
-		Command1Flag2 bool `short:"d" long:"command1flag2" description:"Command 1 Flag 2" shadow:"ValCommand1Flag2"`
+		Command1Flag2 bool `short:"d" long:"command1flag2" description:"Command 1 Flag 2" proxy:"ValCommand1Flag2"`
 		Command2      struct {
 			Command2Flag1 bool `short:"e" long:"command2flag1" description:"Command 2 Flag 1"`
 			Command2Flag2 bool `short:"f" long:"command2flag2" description:"Command 2 Flag 2"`

licenses/github.com/davecgh/go-spew/spew/LICENSE

+ISC License
+
+Copyright (c) 2012-2016 Dave Collins <dave@davec.name>
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

licenses/github.com/pmezard/go-difflib/difflib/LICENSE

+Copyright (c) 2013, Patrick Mezard
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are
+met:
+
+    Redistributions of source code must retain the above copyright
+notice, this list of conditions and the following disclaimer.
+    Redistributions in binary form must reproduce the above copyright
+notice, this list of conditions and the following disclaimer in the
+documentation and/or other materials provided with the distribution.
+    The names of its contributors may not be used to endorse or promote
+products derived from this software without specific prior written
+permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
+IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
+PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
+TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
+PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

licenses/github.com/stretchr/testify/assert/LICENSE

+MIT License
+
+Copyright (c) 2012-2020 Mat Ryer, Tyler Bunnell and contributors.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

licenses/gopkg.in/yaml.v3/LICENSE

+
+This project is covered by two different licenses: MIT and Apache.
+
+#### MIT License ####
+
+The following files were ported to Go from C files of libyaml, and thus
+are still covered by their original MIT license, with the additional
+copyright staring in 2011 when the project was ported over:
+
+    apic.go emitterc.go parserc.go readerc.go scannerc.go
+    writerc.go yamlh.go yamlprivateh.go
+
+Copyright (c) 2006-2010 Kirill Simonov
+Copyright (c) 2006-2011 Kirill Simonov
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
+of the Software, and to permit persons to whom the Software is furnished to do
+so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+### Apache License ###
+
+All the remaining project files are covered by the Apache license:
+
+Copyright (c) 2011-2019 Canonical Ltd
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

licenses/gopkg.in/yaml.v3/NOTICE

+Copyright 2011-2016 Canonical Ltd.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

mapping.go

@@ -53,6 +53,10 @@ func (s *Settings[C]) assignValues(c cmd[C]) {
 			s.errors = append(s.errors, err)
 		}
 
+		if c.proxyMapping[k] != "" {
+			p = c.proxyMapping[k]
+		}
+
 		s.mapping[p] = value
 
 		return

mapping_test.go

@@ -21,7 +21,7 @@ type ConfigStruct6 struct {
 	ValSub           ConfigStruct6Sub1
 }
 
-func TestFlagCopyToShadow(t *testing.T) {
+func TestFlagCopyToProxy(t *testing.T) {
 
 	c := ConfigStruct6{}
 	c.ValSub.Command3Flag1 = true
@@ -40,8 +40,9 @@ func TestFlagCopyToShadow(t *testing.T) {
 }
 
 func (s *ConfigStruct6) Copy(m map[string]any) {
-	pathfinder.SetValue(s, "ValGlobal1", (m["Global1"]))
-	pathfinder.SetValue(s, "ValCommand1Flag2", (m["Command1.Command1Flag2"]))
+	for k, v := range m {
+		pathfinder.SetValue(s, k, v)
+	}
 }
 
 func TestCopyable(t *testing.T) {

release.json

-{"version":"1.10.0"}
+{"version":"1.10.1"}

tags.go

@@ -15,6 +15,7 @@ const (
 	tagShort       = "short"
 	tagLong        = "long"
 	tagDescription = "description"
+	tagProxy       = "proxy"
 )
 
 func getTagMap(field reflect.StructField) (value map[string]string) {