https://github.com/gildemberg-santos/salesforce
Este projeto tem como objetivo fornecer uma interface simples e eficiente para autenticação, consultas e manipulação de dados via Salesforce.
https://github.com/gildemberg-santos/salesforce
api integration ruby
Last synced: 6 months ago
JSON representation
Este projeto tem como objetivo fornecer uma interface simples e eficiente para autenticação, consultas e manipulação de dados via Salesforce.
- Host: GitHub
- URL: https://github.com/gildemberg-santos/salesforce
- Owner: gildemberg-santos
- License: mit
- Created: 2022-06-01T10:24:20.000Z (about 4 years ago)
- Default Branch: main
- Last Pushed: 2025-05-02T12:43:32.000Z (about 1 year ago)
- Last Synced: 2025-05-02T13:57:43.847Z (about 1 year ago)
- Topics: api, integration, ruby
- Language: Ruby
- Homepage:
- Size: 300 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
# Salesforce Ruby Gem
[](https://github.com/gildemberg-santos/salesforce/actions)
Uma gem Ruby para facilitar a integração com a API do Salesforce.
Este projeto tem como objetivo fornecer uma interface simples e eficiente para autenticação, consultas e manipulação de dados via Salesforce.
---
## 📦 Instalação
### Adicionando ao Gemfile
```ruby
gem 'salesforce'
```
Depois, execute:
```bash
bundle install
```
### Ou instalação manual
```bash
gem install salesforce
```
### Dependência do sistema
> **Importante:** Para sistemas baseados em Debian/Ubuntu, é necessário instalar o `ruby-dev`:
```bash
sudo apt install ruby-dev
```
---
## 🚀 Uso
### Console Interativo
Execute o seguinte comando para iniciar um prompt interativo com a gem carregada:
```bash
bin/console
```
### Exemplo de utilização
```ruby
require 'salesforce'
client = Salesforce::Client.new(
client_id: ENV['SALESFORCE_CLIENT_ID'],
client_secret: ENV['SALESFORCE_CLIENT_SECRET'],
username: ENV['SALESFORCE_USERNAME'],
password: ENV['SALESFORCE_PASSWORD']
)
# Exemplo de query
result = client.query("SELECT Id, Name FROM Account LIMIT 10")
puts result
```
> Mais exemplos de uso estarão disponíveis em breve.
---
## 🛠 Desenvolvimento
### Clonando e configurando o projeto
Após clonar o repositório, execute:
```bash
bin/setup
```
Para iniciar um console interativo com o ambiente carregado:
```bash
bin/console
```
### Instalando localmente
Para instalar a gem localmente:
```bash
bundle exec rake install
```
### Publicando nova versão
1. Atualize a versão em `lib/salesforce/version.rb`
2. Execute:
```bash
bundle exec rake release
```
Este comando:
- Cria uma nova tag no Git
- Envia os commits e a tag para o GitHub
- Publica a nova versão no [RubyGems.org](https://rubygems.org)
---
## 🤝 Contribuindo
Relatórios de bugs e pull requests são bem-vindos no [repositório do GitHub](https://github.com/gildemberg-santos/salesforce).
Este projeto segue um ambiente de colaboração saudável e respeitosa. Consulte o nosso [Código de Conduta](https://github.com/gildemberg-santos/salesforce/blob/master/CODE_OF_CONDUCT.md) para mais informações.
---
## 📄 Licença
Este projeto é licenciado sob a licença [MIT](https://opensource.org/licenses/MIT).