https://github.com/sigmavirus24/salesforceid

Golang library for interacting with and validating Salesforce Identifiers
https://github.com/sigmavirus24/salesforceid

base62 go golang salesforce sfid

Last synced: over 1 year ago
JSON representation

Golang library for interacting with and validating Salesforce Identifiers

• Host: GitHub
• URL: https://github.com/sigmavirus24/salesforceid
• Owner: sigmavirus24
• License: mit
• Created: 2019-06-13T11:30:45.000Z (about 7 years ago)
• Default Branch: master
• Last Pushed: 2021-04-30T00:35:07.000Z (about 5 years ago)
• Last Synced: 2025-01-31T10:43:21.144Z (over 1 year ago)
• Topics: base62, go, golang, salesforce, sfid
• Language: Go
• Size: 28.3 KB
• Stars: 1
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.markdown
  • License: LICENSE

Awesome Lists containing this project

README

          
# salesforceid

[![GoDoc Reference](https://godoc.org/github.com/sigmavirus24/salesforceid?status.svg)](https://godoc.org/github.com/sigmavirus24/salesforceid)

[![CircleCI Build Status](https://circleci.com/gh/sigmavirus24/salesforceid.svg?style=svg)](https://circleci.com/gh/sigmavirus24/salesforceid)

[![Azure Pipelines Build Status](https://dev.azure.com/graffatcolmingov/sigmavirus24/_apis/build/status/sigmavirus24.salesforceid?branchName=master)](https://dev.azure.com/graffatcolmingov/sigmavirus24/_build/latest?definitionId=1&branchName=master)

[![GolangCI Status](https://golangci.com/badges/github.com/sigmavirus24/salesforceid.svg)](https://golangci.com)

This is a library that enables handling and manipulation of Salesforce 

Identifiers. Specifically it enables converting identifiers between 15 

character (case-sensitive) and 18 character (case-insensitive) versions.

This library parses a Salesforce identifier for the user and provides 

some convenience methods for handling interactions with the identifier.

## Examples

It's possible to have different versions of a Salesforce identifier. 15 

character identifiers are case-sensitive while 18 character identifers are 

not. As a result, this library always checks and adjusts the casing of 

identifiers and always produces 18 character identifiers. This allows users to 

confidently use which ever form they prefer.

```go

package main

import (

	"fmt"

	"os"

	"github.com/sigmavirus24/salesforceid"

)

func main() {

	// Note that we're using an 18-character, entirely lower-cased Salesforce identifier here

	sfid, err := salesforceid.New("00d000000000062eaa")

	if err != nil {

		fmt.Printf("encountered unexpected error: %q", err)

		os.Exit(1)

	}

	fmt.Println(sfid)

}

```

Furthermore, one can use this library to perform arithmetic on the 

identifiers. For an example of where this might be useful see the 

[example](./example_test.go) in this project.