latest_stock_price 1.0.1 → 1.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 778aa58d46b698c7ab1c11decce31b6f2689f452f020de2af52ffab4db1f84a4
-  data.tar.gz: 5db44299e9edc950fb50b47811b1a547245689335e52e2e5c92caa4af9402da8
+  metadata.gz: dac3a6f27080e915c85d5486a20dd7fcc92083d13af3af4c731db4d944ac17d0
+  data.tar.gz: a5b193c3cde9397bc3db7fd381e824b5cff5fcc4d62d5a8207203d76599e7c97
 SHA512:
-  metadata.gz: ed3f4a9ff4eb85af61610f104c1cb0b6e03f478fc5617e3b2e3f8be6a04544c322dd11dcfca2c7b16a37e45143e9ad55c5dad3c3638b296d7a085e0c40117fc4
-  data.tar.gz: 83a87189ae8f73ab38792d3eff836f38842ace39740d596402e47c78a0ce50d8b9c2513144fda955a4f047db3bd94a6306bc86c981db88ebfd4965068ce55f4c
+  metadata.gz: 8647a2d9f7717a3fd1be5d00c759b0b311341bfbe1f65ff970f551366fc71ad758902b369936d04b8012847501d5d26ebc08d4daa3e5a18be0ddf8e7f3e764c7
+  data.tar.gz: fccd038bcd0c10b8a4f78be09f89522a3cb42d9d3895c8c5e4a9d5369812ba38a04401096bcb80ada5385b3ac3236b8fe53cbacd7b49078c9ff719a6111c5834

data/CHANGELOG.md

@@ -6,4 +6,13 @@
 
 ## 1.0.1 (29-Oct-24)
 
-* Fix Folder structure
+* Fix Folder structure
+
+## 1.0.2 (29-Oct-24)
+
+* Fix README.md
+* Removed redundant `.env` file.
+
+## 1.0.3 (29-Oct-24)
+
+* Remove redundant gem `debug`

data/README.md

@@ -1,23 +1,108 @@
-## Read Me 
 
+### Setup
 
-## Setup
+If you don’t already have bundle, then run this in your project directory (where you’d like to use this gem): 
+
+#### 1. Add The Gem 
+
+``` 
+bundle init
+```
+
+This will add a **Gemfile** to your project directory.
+
+Inside the gem file, add the gem and dependencies like so:
+
+```
+gem 'latest_stock_price', ‘1.0.1’        # Ensure to use version 1.0.1 or above.
+gem 'dotenv', '~> 3.0.0'                 # Dependency required. 
+```
+
+To install the gems, run:
 
 ```
 bundle install
 ```
 
-#### Create Your Environment Variables File
-Copy the sample.env file to create your local .env file:
+#### 2. Configure Credentials
+
+This gem uses APIs from rapidapi.com. Ensure an account is created and gather your secret key after logging in.
+
+In your project directory, create a `.env` file using the following command:
+
+```
+touch .env
+```
+
+Open the newly created `.env` file and add:
+
+```
+# Rapid API credentials
+X_RAPIDAPI_KEY=‘Add_your_rapid_api_key_here’
+X_RAPIDAPI_HOST='latest-stock-price.p.rapidapi.com'
+```
+
+### Example Usage 
+
+As an example, create a new file in you project directory:
+
+```
+touch example.rb
+```
+
+There are 3 ways to interact with the gem:
+
+#### 1. Get all the latest stock prices:
+
+```ruby
+# example.rb
+require 'bundler/setup'
+require 'latest_stock_price'
+
+price_all = LatestStockPrice::PriceAll.fetch
+puts price_all
+```
+
+In your project repository, run the following command to get the prices of all the stocks:
+
+```ruby
+ruby example.rb # should return an object with many stock data
+```
+
+#### 2. Get the latest price of a specific stock:
+
+```ruby
+# example.rb
+require 'bundler/setup'
+require 'latest_stock_price'
+
+price = LatestStockPrice::Price.fetch("AAATECH.NS")
+puts price
+```
+
+In your project repository, run the following command to get the price of a specific stock:
+
+```
+ruby example.rb # should return an object with one stock.
+```
+
+#### 3. Get the latest prices for a specified list of stocks:
+
+```ruby
+# example.rb
+require 'bundler/setup'
+require 'latest_stock_price'
+
+prices = LatestStockPrice::Prices.fetch(['AAATECH.NS', 'AADHHOUS.NS'])
+puts prices
+```
+
+In your project repository, run the following command for a list of the stocks and their data.
 
 ```
-cp sample.env .env
+ruby example.rb # should return an object with the specified stocks.
 ```
 
-#### Set Your API Keys
-Open the .env file in your preferred text editor and add your API keys:
-# .env
-RAPIDAPI_KEY='your_actual_api_key'
-RAPIDAPI_HOST='latest-stock-price.p.rapidapi.com'
+### Warnings
 
-**Note:** To obtain a Rapid APi key, login to your Rapid Api account and find it in the account settings. 
+The `.env` file contains your secret key. Ensure the file does not get committed to remote repositories by adding it to your `.gitignore` file.

data/latest_stock_price.gemspec

@@ -1,6 +1,6 @@
 Gem::Specification.new do |s|
     s.name        = "latest_stock_price"
-    s.version     = "1.0.1"
+    s.version     = "1.0.3"
     s.summary     = "Latest stock price"
     s.authors     = ["Ciever Hassan"]
     s.description = "A gem for displaying the latest stock price."
@@ -19,8 +19,7 @@ Gem::Specification.new do |s|
                      "spec/price_all_spec.rb",
                      "spec/price_spec.rb",
                      "spec/prices_spec.rb",
-                     "spec/spec_helper.rb",
-                     "sample.env", 
+                     "spec/spec_helper.rb", 
                      "README.md",
                      "CHANGELOG.md",
                      "Gemfile",
@@ -33,5 +32,4 @@ Gem::Specification.new do |s|
 
     s.add_dependency 'net-http', '~> 0.4.1'
     s.add_dependency 'uri', '~> 0.10.0'
-    s.add_dependency 'debug', '~> 1.8'
 end

data/spec/http_client_spec.rb

@@ -1,4 +1,3 @@
-require 'debug'
 require 'spec_helper'
 require 'webmock/rspec'
 require './lib/latest_stock_price/http_client'

data/spec/price_all_spec.rb

@@ -1,4 +1,3 @@
-require 'debug'
 require 'spec_helper'
 require 'webmock/rspec'
 require './lib/latest_stock_price/price_all'

data/spec/price_spec.rb

@@ -1,4 +1,3 @@
-require 'debug'
 require 'spec_helper'
 require 'webmock/rspec'
 require './lib/latest_stock_price/price'

data/spec/prices_spec.rb

@@ -1,4 +1,3 @@
-require 'debug'
 require 'spec_helper'
 require 'webmock/rspec'
 require './lib/latest_stock_price/prices'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: latest_stock_price
 version: !ruby/object:Gem::Version
-  version: 1.0.1
+  version: 1.0.3
 platform: ruby
 authors:
 - Ciever Hassan
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-10-28 00:00:00.000000000 Z
+date: 2024-10-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: dotenv
@@ -80,20 +80,6 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 0.10.0
-- !ruby/object:Gem::Dependency
-  name: debug
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.8'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.8'
 description: A gem for displaying the latest stock price.
 email: ciever.a.h@hotmail.com
 executables: []
@@ -111,7 +97,6 @@ files:
 - lib/price_all.rb
 - lib/prices.rb
 - lib/version.rb
-- sample.env
 - spec/http_client_spec.rb
 - spec/price_all_spec.rb
 - spec/price_spec.rb

data/sample.env

@@ -1,3 +0,0 @@
-# Rapid APi credentials
-X_RAPIDAPI_KEY='your_rapidapi_key_here'
-X_RAPIDAPI_HOST='your_rapidpia_host'