✨ Update the generator to work with external client packages (#78)

### Description
Update the generator to support parsing functions from a specified
client package
Added optional '-c' / '--client_path' parameter to provide the path to
an OpenAPI-generated client package.
Removed replace directive to enable installing via 'go install' and
explicitly set a client package path using the new parameter.

<!--
Please add any detail or context that would be useful to a reviewer.
-->

- [ ]  This change is covered by existing or additional automated tests.
- [ ] Manual testing has been performed (and evidence provided) as
automated testing was not feasible.
- [X] Additional tests are not required for this change (e.g.
documentation update).

---------

Co-authored-by: aorabdel <aorabdel@users.noreply.github.com>

Author: aorabdel

.github/workflows/update-client.yml

@@ -95,7 +95,7 @@ jobs:
         go mod tidy
         go run main.go -i ../all-service-definition/all-def-flat.yaml -o ../extensions/extension_entities.gen.go -t templates/entities.go.tmpl -g collections
         go run main.go -i ../all-service-definition/all-def-flat.yaml -o ../extensions/extension_jobs.gen.go -t templates/jobs.go.tmpl -g jobs
-        go run main.go -i ../all-service-definition/all-def-flat.yaml -o ../extensions/extension_link_followers.gen.go -t templates/linkfollowers.go.tmpl -g links
+        go run main.go -i ../all-service-definition/all-def-flat.yaml -o ../extensions/extension_link_followers.gen.go -t templates/linkfollowers.go.tmpl -g links -c ../client
     - name: Copy extensions to client
       run: |
         if [ -d ./extensions/ ] ; then cp -r extensions/. ${{ env.go_module }}/ ; fi

changes/20250401193344.feature

@@ -0,0 +1 @@
+Updated client due to schema changes

changes/20250401201356.feature

@@ -0,0 +1 @@
+:sparkles: Update the generator to work with external client packages

changes/20250403121709.feature

@@ -0,0 +1 @@
+Updated client due to schema changes

client/api_authorization.go

@@ -33,7 +33,7 @@ import (
 )
 
 func main() {
-	permissionItem := *openapiclient.NewPermissionItem([]string{"Operations_example"}, "fpga-connection", "worker_1234-job-5678", "9c2d1b2f-3d4e-456a-a7fc-12b5d9c6e8a4", "GenericWorkJobItem", "b7f6c5d1-2a44-4f9a-9d77-6e5a8c9d4e1b", "arm_pat_HGfmzxFblhr6AXiTnyaUqd1pgA9waIiO") // PermissionItem | Data required to check permissions on a resource.
+	permissionItem := *openapiclient.NewPermissionItem([]string{"Operations_example"}, "worker_1234-job-5678", "9c2d1b2f-3d4e-456a-a7fc-12b5d9c6e8a4", "GenericWorkJobItem", "b7f6c5d1-2a44-4f9a-9d77-6e5a8c9d4e1b", "arm_pat_HGfmzxFblhr6AXiTnyaUqd1pgA9waIiO") // PermissionItem | Data required to check permissions on a resource.
 	acceptVersion := "1.0.0" // string | Versioning: Optional header to request a specific version of the API. While it is possible to specify a particular major, minor or patch version it is not recommended for production use cases. Only the major version number should be specified as minor and patch versions can be updated without warning. (optional)
 
 	configuration := openapiclient.NewConfiguration()

client/docs/AuthorizationAPI.md

@@ -9,7 +9,6 @@ SPDX-License-Identifier: Apache-2.0
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
 **Operations** | **[]string** | The list of allowed CRUDL operations. | 
-**Origin** | **string** | The function or service under which the permission is being evaluated. | 
 **ResourceInstance** | **string** | The unique identifier of the resource instance. | 
 **ResourceOwnerName** | **string** | The unique identifier of the user or system entity that owns the specified resource instance. | 
 **ResourceType** | **string** | The type of resource for which permission is being checked. This should only refer to items and not collections. | 
@@ -20,7 +19,7 @@ Name | Type | Description | Notes
 
 ### NewPermissionItem
 
-`func NewPermissionItem(operations []string, origin string, resourceInstance string, resourceOwnerName string, resourceType string, userName string, userToken string, ) *PermissionItem`
+`func NewPermissionItem(operations []string, resourceInstance string, resourceOwnerName string, resourceType string, userName string, userToken string, ) *PermissionItem`
 
 NewPermissionItem instantiates a new PermissionItem object
 This constructor will assign default values to properties that have it defined,
@@ -65,26 +64,6 @@ SetOperations sets Operations field to given value.
 `func (o *PermissionItem) UnsetOperations()`
 
 UnsetOperations ensures that no value is present for Operations, not even an explicit nil
-### GetOrigin
-
-`func (o *PermissionItem) GetOrigin() string`
-
-GetOrigin returns the Origin field if non-nil, zero value otherwise.
-
-### GetOriginOk
-
-`func (o *PermissionItem) GetOriginOk() (*string, bool)`
-
-GetOriginOk returns a tuple with the Origin field if it's non-nil, zero value otherwise
-and a boolean to check if the value has been set.
-
-### SetOrigin
-
-`func (o *PermissionItem) SetOrigin(v string)`
-
-SetOrigin sets Origin field to given value.
-
-
 ### GetResourceInstance
 
 `func (o *PermissionItem) GetResourceInstance() string`

client/docs/PermissionItem.md

@@ -8,6 +8,7 @@ SPDX-License-Identifier: Apache-2.0
 
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
+**Artefacts** | Pointer to [**HalLinkData**](HalLinkData.md) |  | [optional] 
 **Cancel** | Pointer to [**HalLinkData**](HalLinkData.md) |  | [optional] 
 **Collection** | Pointer to [**HalLinkData**](HalLinkData.md) |  | [optional] 
 **Delete** | Pointer to [**HalLinkData**](HalLinkData.md) |  | [optional] 
@@ -34,6 +35,31 @@ NewVhtRunJobItemLinksWithDefaults instantiates a new VhtRunJobItemLinks object
 This constructor will only assign default values to properties that have it defined,
 but it doesn't guarantee that properties required by API are set
 
+### GetArtefacts
+
+`func (o *VhtRunJobItemLinks) GetArtefacts() HalLinkData`
+
+GetArtefacts returns the Artefacts field if non-nil, zero value otherwise.
+
+### GetArtefactsOk
+
+`func (o *VhtRunJobItemLinks) GetArtefactsOk() (*HalLinkData, bool)`
+
+GetArtefactsOk returns a tuple with the Artefacts field if it's non-nil, zero value otherwise
+and a boolean to check if the value has been set.
+
+### SetArtefacts
+
+`func (o *VhtRunJobItemLinks) SetArtefacts(v HalLinkData)`
+
+SetArtefacts sets Artefacts field to given value.
+
+### HasArtefacts
+
+`func (o *VhtRunJobItemLinks) HasArtefacts() bool`
+
+HasArtefacts returns a boolean if a field has been set.
+
 ### GetCancel
 
 `func (o *VhtRunJobItemLinks) GetCancel() HalLinkData`