plivo 4.35.0 → 4.37.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 4075dc6bb995418a806e88b984f8b016d6e0f141
-  data.tar.gz: 9bcdb5380421a73e49b73ea9c96f512f77f7a991
+  metadata.gz: 9bce183c37b08afe3c1c818c760ea19e23d59aa0
+  data.tar.gz: 758f85c1a34e730fdb6319f504b325f563087613
 SHA512:
-  metadata.gz: 612bb679799a48139ec8907873ebd28ba9b54c370dfc60424ea27b5b89f0204b90d0135a86987294342a70edf244c26ad823f35e1e26e69a1d35667944031cb9
-  data.tar.gz: 2467bacadfbd13bd45da25d0b5104552d033b76a38a54de058322dce285cbe9a9431122ea0697ddc9f0ee5fb7975417d2099823401b8cc7d48138e5a46cb049c
+  metadata.gz: 12826d9c8f1e56072dabf04120e67df56d6e1a7d5a0c6385c59ae8c419139d5c6d31c46543b1a17a6d21acdb84c31424de2d5be448dd88face0933e4d0b88452
+  data.tar.gz: 2e06406a3690697d405b1cb89dae6bebc5bc3bace1a3f463fa665ef36e62c43179838436abc56478614bfed1f9772ea3bb4c4f272389aa0cb35e6e7493a94d08

data/.gitignore

@@ -12,3 +12,4 @@ tmp/
 bin/
 # rspec failure tracking
 .rspec_status
+ruby-sdk-test/

data/CHANGELOG.md

@@ -1,8 +1,18 @@
 # Change Log
+## [4.37.0](https://github.com/plivo/plivo-ruby/tree/v4.37.0) (2023-02-23)
+**Feature - Enhance MDR filtering capabilities **
+- Added new fields on MDR object response
+
+
+## [4.36.0](https://github.com/plivo/plivo-ruby/tree/v4.36.0) (2022-01-25)
+**Adding new attribute - 'requester_ip' in Get Message and List Mssage APIs**
+- Add `requester_ip` to the response for the [list all messages API](https://www.plivo.com/docs/sms/api/message/list-all-messages/) and the [get message details API](https://www.plivo.com/docs/sms/api/message#retrieve-a-message)
+
 ## [4.35.0](https://github.com/plivo/plivo-ruby/tree/v4.35.0) (2022-01-18)
 **Adding new attribute - 'message_expiry' in Send Message API**
 - Added new attribute - message_expiry in Send Message API
 
+
 ## [4.34.0](https://github.com/plivo/plivo-ruby/tree/v4.34.0) (2022-12-16)
 **10DLC: Update Campaign API**
 - Added Update Campaign API

data/Dockerfile

@@ -0,0 +1,12 @@
+FROM ruby:3.0.1-alpine
+
+RUN apk update && apk add git vim bash make gcc musl-dev
+
+WORKDIR /usr/src/app
+RUN gem install json --source 'https://rubygems.org/'
+
+# Copy setup script
+COPY setup_sdk.sh /usr/src/app/
+RUN chmod a+x /usr/src/app/setup_sdk.sh
+
+ENTRYPOINT [ "/usr/src/app/setup_sdk.sh" ]

data/Makefile

@@ -0,0 +1,7 @@
+.PHONY: build test
+
+build:
+	docker-compose up --build --remove-orphans
+
+test:
+	docker exec -it $$CONTAINER /bin/bash -c "bundle exec rake"

data/README.md

@@ -9,7 +9,7 @@ The Plivo Ruby SDK makes it simpler to integrate communications into your Ruby a
 Add this line to your application's Gemfile:
 
 ```ruby
-gem 'plivo', '>= 4.35.0'
+gem 'plivo', '>= 4.37.0'
 ```
 
 And then execute:
@@ -173,3 +173,23 @@ More examples are available [here](https://github.com/plivo/plivo-examples-ruby)
 
 ## Reporting issues
 Report any feedback or problems with this version by [opening an issue on Github](https://github.com/plivo/plivo-ruby/issues).
+
+## Local Development
+> Note: Requires latest versions of Docker & Docker-Compose. If you're on MacOS, ensure Docker Desktop is running.
+1. Export the following environment variables in your host machine:
+```bash
+export PLIVO_AUTH_ID=<your_auth_id>
+export PLIVO_AUTH_TOKEN=<your_auth_token>
+export PLIVO_API_DEV_HOST=<plivoapi_dev_endpoint>
+export PLIVO_API_PROD_HOST=<plivoapi_public_endpoint>
+```
+2. Run `make build`. This will create a docker container in which the sdk will be setup and dependencies will be installed.
+> The entrypoint of the docker container will be the `setup_sdk.sh` script. The script will handle all the necessary changes required for local development.
+3. The above command will print the docker container id (and instructions to connect to it) to stdout.
+4. The testing code can be added to `<sdk_dir_path>/ruby-sdk-test/test.rb` in host  
+ (or `/usr/src/app/ruby-sdk-test/test.rb` in container)
+5. The sdk directory will be mounted as a volume in the container. So any changes in the sdk code will also be reflected inside the container.
+> To use the local code in the test file, import the sdk in test file using:   
+`require "/usr/src/app/lib/plivo.rb"`   
+6. To run unit tests, run `make test CONTAINER=<cont_id>` in host, where `<cont_id>` is the docker container id created in 2.   
+(The docker container should be running)

data/docker-compose.yml

@@ -0,0 +1,18 @@
+version: '3'
+
+services:
+
+  rubySDK:
+    build: 
+      context: .
+    image: rubysdk
+    container_name: rubySDK
+    environment:
+      - PLIVO_AUTH_ID=${PLIVO_AUTH_ID}
+      - PLIVO_AUTH_TOKEN=${PLIVO_AUTH_TOKEN}
+      - PLIVO_API_DEV_HOST=${PLIVO_API_DEV_HOST}
+      - PLIVO_API_PROD_HOST=${PLIVO_API_PROD_HOST}
+    volumes:
+      - .:/usr/src/app
+    stdin_open: true 
+    tty: true

data/lib/plivo/resources/messages.rb

@@ -30,7 +30,11 @@ module Plivo
           total_amount: @total_amount,
           total_rate: @total_rate,
           powerpack_id: @powerpack_id,
-          units: @units
+          units: @units,
+          tendlc_campaign_id: @tendlc_campaign_id,
+          destination_country_iso2: @destination_country_iso2,
+          tendlc_registration_status: @tendlc_registration_status
+          requester_ip: @requester_ip
         }.to_s
       end
     end
@@ -255,6 +259,9 @@ module Plivo
       # @option options[List]: media_urls Minimum one media url should be present in Media urls list to send mms. Maximum allowd 10 media urls inside the list (e.g, media_urls : ['https//example.com/test.jpg', 'https://example.com/abcd.gif'])
       # @option options[List]: media_ids Minimum one media ids should be present in Media ids list to send mms. Maximum allowd 10 media ids inside the list (e.g, media_ids : ['1fs211ba-355b-11ea-bbc9-02121c1190q7'])
       # @option options [String] :powerpack_id Filter the results by powerpack id
+      # @option options [string]:  tendlc_campaign_id - exact tendlc campaign id search
+      # @option options [string]:destination_country_iso2 - valid 2 character country_iso2
+      # @option options [string] : tendlc_registration_status - registered or unregistered enum allowed
       def list(options = nil)
         return perform_list if options.nil?
         valid_param?(:options, options, Hash, true)
@@ -262,7 +269,7 @@ module Plivo
         params = {}
         params_expected = %i[
           subaccount message_time message_time__gt message_time__gte
-          message_time__lt message_time__lte error_code powerpack_id
+          message_time__lt message_time__lte error_code powerpack_id tendlc_campaign_id tendlc_registration_status destination_country_iso2
         ]
         params_expected.each do |param|
           if options.key?(param) &&

data/lib/plivo/version.rb

@@ -1,3 +1,3 @@
 module Plivo
-  VERSION = "4.35.0".freeze
+  VERSION = "4.37.0".freeze
 end

data/setup_sdk.sh

@@ -0,0 +1,45 @@
+#!/bin/bash
+
+set -e
+testDir="ruby-sdk-test"
+GREEN="\033[0;32m"
+NC="\033[0m"
+
+if [ ! $PLIVO_API_PROD_HOST ] || [ ! $PLIVO_API_DEV_HOST ] || [ ! $PLIVO_AUTH_ID ] || [ ! $PLIVO_AUTH_TOKEN ]; then
+    echo "Environment variables not properly set! Please refer to Local Development section in README!"
+    exit 126
+fi
+
+cd /usr/src/app
+
+echo "Setting plivo-api endpoint to dev..."
+find /usr/src/app/lib/ -type f -exec sed -i "s/$PLIVO_API_PROD_HOST/$PLIVO_API_DEV_HOST/g" {} \;
+
+bundle install
+
+if [ ! -d $testDir ]; then
+    echo "Creating test dir..."
+    mkdir -p $testDir
+fi
+
+if [ ! -f $testDir/test.rb ]; then
+    echo "Creating test file..."
+    cd $testDir
+    echo -e "require \"rubygems\"" > test.rb
+    echo -e "require \"/usr/src/app/lib/plivo.rb\"" >> test.rb
+    echo -e "include Plivo\n" >> test.rb
+    echo -e "api = RestClient.new(ENV[\"PLIVO_AUTH_ID\"], ENV[\"PLIVO_AUTH_TOKEN\"])" >> test.rb
+    cd -
+fi
+
+echo -e "\n\nSDK setup complete!"
+echo "To test your changes:"
+echo -e "\t1. Add your test code in <path_to_cloned_sdk>/$testDir/test.rb on host (or /usr/src/app/$testDir/test.rb in the container)"
+echo -e "\t\tNote: To use sdk in test file, import using $GREEN require \"/usr/src/app/lib/plivo.rb\"$NC"
+echo -e "\t2. Run a terminal in the container using: $GREEN docker exec -it $HOSTNAME /bin/bash$NC"
+echo -e "\t3. Navigate to the test directory: $GREEN cd /usr/src/app/$testDir$NC"
+echo -e "\t4. Run your test file: $GREEN ruby test.rb$NC"
+echo -e "\t5. For running unit tests, run on host: $GREEN make test CONTAINER=$HOSTNAME$NC"
+
+# To keep the container running post setup
+/bin/bash

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: plivo
 version: !ruby/object:Gem::Version
-  version: 4.35.0
+  version: 4.37.0
 platform: ruby
 authors:
 - The Plivo SDKs Team
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-01-18 00:00:00.000000000 Z
+date: 2023-02-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -157,12 +157,15 @@ files:
 - ".rspec"
 - AUTHORS.md
 - CHANGELOG.md
+- Dockerfile
 - Gemfile
 - Jenkinsfile
 - LICENSE.txt
+- Makefile
 - README.md
 - Rakefile
 - ci/config.yml
+- docker-compose.yml
 - examples/conference_bridge.rb
 - examples/jwt.rb
 - examples/lookup.rb
@@ -238,6 +241,7 @@ files:
 - lib/plivo/xml/w.rb
 - lib/plivo/xml/wait.rb
 - plivo.gemspec
+- setup_sdk.sh
 homepage: https://github.com/plivo/plivo-ruby
 licenses:
 - MIT