tarta-api 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 544d926902d26f0880f580084088c77be0a20396024b9f4b0454c3468c23d29b
+  data.tar.gz: fa92b7580d5333e6b3d1bcc2f8cf2cdb6878c14e10e5d1b552181ba595df277f
+SHA512:
+  metadata.gz: dd739b07fd31aeff73535a3a1b10f252fb5ee228df272ecc7a7f2201ce601bee9c5206c846a30e0d776b7bf964afb6fc1ac2419d75900fcb2d5a7bd290228779
+  data.tar.gz: fa3f7020b70d038dbb915c00a992374ba6d05a0dc3d4f9e90bd0364ed7649d2764b762c6419f8f799a39c83af5055badf8420ae051206730eaf70c1eea6885ec

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2025 JoPilot
+
+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.

data/README.md

@@ -0,0 +1,90 @@
+# TartaAPI-Ruby
+
+## Overview
+TartaAPI-Ruby is a Ruby wrapper for the Tarta API, designed to seamlessly integrate AI-powered job search functionality into your applications.
+
+## API Documentation
+For detailed API documentation, visit:  
+[Tarta API Documentation](https://api.tarta.ai/swagger/index.html)
+
+## What is Tarta?
+Tarta.ai is a sophisticated AI platform that consolidates job listings from a wide range of sources, including job boards and social media. The platform streamlines the job search experience, matching users with suitable vacancies and even facilitating interview scheduling.
+
+To learn more, visit:  
+[Tarta Official Website](https://tarta.ai/)
+
+## ChatGPT Integration
+Tarta is also available as a ChatGPT plugin to enhance your job search experience:  
+[Tarta ChatGPT Plugin](https://chat.openai.com/g/g-Gkf9YM4sR-job-search-in-the-us)
+
+## Installation
+To install TartaAPI-Ruby, add this line to your Gemfile:
+```ruby
+gem 'tarta-api'
+```
+Then, execute:
+```sh
+bundle install
+```
+Or install it yourself with:
+```sh
+gem install tarta-api
+```
+
+## Usage Example
+Here's a simple example demonstrating how to use the library to execute a job search:
+
+```ruby
+require 'tarta_api'
+
+def search_jobs(title, size = 5)
+  request = TartaAPI::JobSearchRequest.new(title: title, size: size)
+  
+  begin
+    results = TartaAPI::JobSearchService.search_jobs(request)
+    jobs = results.fetch("jobs", [])
+
+    if jobs.empty?
+      puts "No job results found."
+      return
+    end
+
+    puts "Job Search Results:"
+    jobs.each do |job|
+      job_name = job.fetch("name", "N/A")
+      company = job.fetch("companyName", "N/A")
+      location = job.fetch("location", {})
+      city = location.fetch("city", "Unknown")
+      state = location.fetch("state", "Unknown")
+      country = location.fetch("country", "Unknown")
+      source = job.fetch("feed", "N/A")
+      posted_date = job.fetch("created", "N/A")
+
+      puts "Job: #{job_name} at #{company}"
+      puts "Location: #{city}, #{state}, #{country}"
+      puts "Source: #{source}"
+      puts "Posted: #{posted_date}\n"
+    end
+
+  rescue => e
+    puts "Error fetching job results: #{e}"
+  end
+end
+
+search_jobs("ruby", size: 2)
+
+```
+
+## Key Features
+- **Effortless API Integration**: Interact with Tarta's API using straightforward Ruby methods.
+- **AI Matching**: Utilize AI algorithms to find jobs that align with user profiles and preferences.
+- **Interview Scheduling**: Automate interview scheduling to streamline the application process.
+
+## Contributions
+Contributions are welcome! Feel free to open issues or submit pull requests to enhance the library.
+
+## License
+This project is under the MIT License.
+
+---
+Experience the efficiency of Tarta and integrate AI-powered job search into your Ruby applications today!

data/tarta_api.rb

@@ -0,0 +1,52 @@
+require 'net/http'
+require 'json'
+
+module TartaAPI
+  API_BASE_URL = 'https://api.tarta.ai'
+
+  class JobSearchRequest
+    attr_reader :title, :company_name, :city, :state, :country, :is_remote, :size
+
+    def initialize(title:, size:, company_name: nil, city: nil, state: nil, country: nil, is_remote: nil)
+      @title = title
+      @company_name = company_name
+      @city = city
+      @state = state
+      @country = country
+      @is_remote = is_remote
+      @size = size
+    end
+
+    def to_h
+      {
+        title: title,
+        companyName: company_name,
+        city: city,
+        state: state,
+        country: country,
+        isRemote: is_remote,
+        size: size
+      }.compact
+    end
+  end
+
+  class JobSearchService
+    def self.search_jobs(request)
+      uri = URI.join(API_BASE_URL, '/api/v1/search')
+      http = Net::HTTP.new(uri.host, uri.port)
+      http.use_ssl = true
+      
+      req = Net::HTTP::Post.new(uri, { 'Content-Type' => 'application/json' })
+      req.body = request.to_h.to_json
+
+      response = http.request(req)
+      
+      raise "Error: #{response.message}" unless response.is_a?(Net::HTTPSuccess)
+      
+      JSON.parse(response.body, symbolize_names: true)
+    rescue StandardError => e
+      warn "Job search request failed: #{e.message}"
+      raise 'Unable to complete the job search request.'
+    end
+  end
+end

metadata

@@ -0,0 +1,80 @@
+--- !ruby/object:Gem::Specification
+name: tarta-api
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- tarta.ai
+bindir: bin
+cert_chain: []
+date: 2025-03-11 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: net-http
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: TartaAPI enables seamless integration of AI-driven job search capabilities
+  into Ruby applications. Access a vast database of job listings, utilize AI matching
+  algorithms, and automate interview scheduling, all through an easy-to-use interface
+  with the Tarta API.
+email:
+- taras@tarta.ai
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE.txt
+- README.md
+- tarta_api.rb
+homepage: https://tarta.ai
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://tarta.ai
+  source_code_uri: https://github.com/tarta-ai/TartaAPI-ruby
+  api_uri: https://api.tarta.net/swagger/index.html
+  github_repo: https://api.tarta.net/swagger/index.html
+  allowed_push_host: https://rubygems.org
+rdoc_options: []
+require_paths:
+- "."
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.5
+specification_version: 4
+summary: A Ruby wrapper for the Tarta API, enabling seamless integration of AI-powered
+  job search functionality.
+test_files: []