init commit

Author: anekkanti

.github/dependabot.yml

@@ -0,0 +1,17 @@
+# To get started with Dependabot version updates, you'll need to specify which
+# package ecosystems to update and where the package manifests are located.
+# Please see the documentation for all configuration options:
+# https://docs.github.com/github/administering-a-repository/configuration-options-for-dependency-updates
+
+version: 2
+updates:
+  # Maintain dependencies for gomod
+  - package-ecosystem: "gomod" # See documentation for possible values
+    directory: "/" # Location of package manifests
+    schedule:
+      interval: "daily"
+  # Maintain dependencies for GitHub Actions
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "daily"

.github/workflows/build.yml

@@ -0,0 +1,15 @@
+name: Pull Request Pipeline
+on: [pull_request]
+jobs:
+  tests:
+    runs-on: ubuntu-latest
+    name: sanity checks - pull request
+    steps:
+      - uses: actions/checkout@v3
+      - uses: actions/setup-go@v3
+        with:
+          go-version: '^1.18'
+      - name: run tests and build
+        run: make clean test bins
+      - name: lint
+        run: make tools lint

.github/workflows/security.yml

@@ -0,0 +1,16 @@
+name: Leaked Secrets Scan
+on: [pull_request]
+jobs:
+  TruffleHog:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v3
+        with:
+          fetch-depth: 0
+      - name: TruffleHog OSS
+        uses: trufflesecurity/trufflehog@v3.4.3
+        with:
+          path: ./
+          base: ${{ github.event.repository.default_branch }}
+          head: HEAD

.gitignore

@@ -0,0 +1,6 @@
+/tcld
+/releases
+/proto
+.vscode/
+.idea/
+/.coverage

LICENSE

@@ -0,0 +1,21 @@
+The MIT License
+
+Copyright (c) 2022 Temporal Technologies Inc.  All rights reserved.
+
+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.

Makefile

@@ -0,0 +1,54 @@
+.PHONY: clean test bins lint tools
+PROJECT_ROOT = github.com/temporalio/tcld
+
+# default target
+default: clean test bins
+
+TAG_COMMIT := $(shell git rev-list --abbrev-commit --tags --max-count=1)
+TAG := $(shell git describe --abbrev=0 --tags ${TAG_COMMIT} 2>/dev/null || true)
+COMMIT := $(shell git rev-parse --short HEAD)
+DATE := $(shell git log -1 --format=%cd --date=format:"%Y%m%d")
+VERSION := $(TAG:v%=%)
+APPPKG := $(PROJECT_ROOT)/app
+LINKER_FLAGS := -X $(APPPKG).BuildDate=$(DATE) -X $(APPPKG).Commit=$(COMMIT) -X $(APPPKG).Version=$(VERSION)
+
+
+ALL_SRC := $(shell find . -name "*.go")
+TEST_DIRS := $(sort $(dir $(filter %_test.go,$(ALL_SRC))))
+TEST_ARG ?= -race -timeout=5m -cover -count=1
+
+tcld:
+	@go build -ldflags "$(LINKER_FLAGS)" -o tcld ./cmd/tcld/*.go
+
+bins: tcld
+
+test:
+	@$(foreach TEST_DIR,$(TEST_DIRS),\
+		go test $(TEST_ARG) $(TEST_DIR) &&) echo passed
+
+clean:
+	@rm -rf ./tcld
+
+define build
+	@echo "building release for $(1) $(2) $(3)..."
+	@mkdir -p releases
+	@GOOS=$(2) GOARCH=$(3) go build -ldflags "-w $(LINKER_FLAGS)" -o releases/$(1)_$(2)_$(3)$(4) ./cmd/tcld/*.go
+	@tar -cvzf releases/$(1)_$(2)_$(3).tar.gz releases/$(1)_$(2)_$(3)$(4) &>/dev/null
+endef
+
+release:
+	@rm -rf releases && mkdir -p releases
+	$(call build,tcld,linux,amd64)
+	$(call build,tcld,darwin,amd64,)
+	$(call build,tcld,darwin,arm64,)
+	$(call build,tcld,windows,amd64,.exe)
+
+tools:
+	@go install github.com/golangci/golangci-lint/cmd/golangci-lint@v1.45.2
+	@GO111MODULE=off go get -u github.com/golang/mock/mockgen
+
+lint:
+	golangci-lint run
+
+mocks:
+	@mockgen -source services/loginservice.go -destination services/loginservicemock.go -package services

README.md

@@ -0,0 +1,66 @@
+# tcld (`Beta`)
+A cli tool for temporal cloud operations.
+
+> This cli tool is currently in `beta` and access to temporal cloud using the cli is restricted. Please reach out to temporal-cloud support for more information.
+
+# Installation
+## Build from source
+1. Verify that you have Go 1.18+ installed. If `go` is not installed, follow instructions on [the Go website](https://golang.org/doc/install).
+ ```sh
+    $ go version
+```
+2. Run go install.
+```
+    $ go install github.com/temporalio/tcld/cmd/tcld@latest
+```
+3. Run `tcld version` to check if it worked.
+```
+    $ tcld version
+```
+
+# Authentication and Login
+In order to use the cli you must first login by running the following command:
+```
+    $ tcld login
+```
+You will be sent a link to confirm your device code and login. After logging in, you are now authenticated and can make requests with this cli.
+
+# Namespace Management
+
+### List namespaces user has access to:
+```
+    $ tcld namespace list
+```
+
+### Get namespace information:
+```
+    $ tcld namespace get -n <namespace>
+```
+
+### Update the ca certificate:
+```
+    $ tcld namespace update accepted-client-ca set -n <namespace> --ca-certificate-file <ca-pem-filepath>
+```
+> :warning: Any clients (tctl/workers) using the old certificates will fail to connect to the namespace after the update.
+
+### Add new search attributes:
+```
+    $ tcld namespace update search-attributes add -n <namespace> --sa "<attribute-name>=<search-attribute-type>" --sa "<attribute-name>=<search-attribute-type>"
+```
+Supported search attribute types: `SearchAttributeTypeKeyword SearchAttributeTypeText SearchAttributeTypeInt SearchAttributeTypeDouble SearchAttributeTypeDatetime SearchAttributeTypeBool`
+
+### Rename existing search attribute:
+```
+    $ tcld namespace update search-attributes rename -n <namespace> --existing-name <existing-attribute-name> --new-name <new-attribute-name>
+```
+> :warning: Any workflows that are use the old search attribute name will fail after the update.
+
+# Asynchronous Operations
+Any update operations making changes to the namespaces hosted on temporal-cloud are async. Such operations are tracked using `request-id` that can be passed in when invoking the update operation or will be autogenerated if one is not passed. Once a asynchronous request is initiated a `request-id` is returned. Use the `request get` command to query the status of an asynchronous request.
+```
+    $ tcld request get -r <request-id> -n <namespace>
+```
+
+# License
+
+MIT License, please see [LICENSE](https://github.com/temporalio/tcld/blob/master/LICENSE) for details.