truth_serum_academic 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 61567f2d575ced3d37904bc6c64d1c4087b44a545082d13a7ba4dff40bb8a30c
+  data.tar.gz: c2a4782c0349682575993feaea7de717409ce8cbbea7baf348b629d9e9d8a097
+SHA512:
+  metadata.gz: 00ebb740e006b66f5b83c25fea94333e06a2dcb155bb46736bbebd18fbda4df786c3792acc36709812240d5df7cff48e3ad7e721f5795c4cc83c6a6866a95076
+  data.tar.gz: c25c9d9db9092e94db7725e82ec6379196814b6e3fceaf8dccc79756b1c51be51ab9a84223280fa0f21864a5272d419621b21dc79ff74f97026c34ab5cdf70f7

data/bin/console

@@ -0,0 +1,11 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "bundler/setup"
+require "truth_serum"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+require "irb"
+IRB.start(__FILE__)

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/bin/truth_serum

@@ -0,0 +1,37 @@
+#!/usr/bin/env ruby
+
+# 1. SETUP LOAD PATH
+# This line is crucial for development. It tells Ruby to look in your local 'lib'
+# folder for the code, so you don't have to install the gem to test it.
+$LOAD_PATH.unshift File.expand_path('../lib', __dir__)
+
+require 'truth_serum'
+
+# 2. CAPTURE INPUT
+# ARGV is an array containing the arguments passed in the command line.
+input_text = ARGV[0]
+
+# Check if the user actually typed something
+if input_text.nil? || input_text.strip.empty?
+  puts "Usage: truth_serum \"<citation text>\""
+  exit
+end
+
+puts "🔍 Analyzing citation..."
+
+
+# 3. RUN VERIFICATION
+# We wrap the input in brackets [] because your Verifier expects a list.
+results = TruthSerum::Verifier.check_list([input_text])
+result = results.first
+
+# 4. PRINT OUTPUT
+# This uses the nice helper methods from your new Result object.
+puts "---------------------------------------------------"
+if result.verified?
+  puts "✅ REAL (#{result.score})"
+else
+  puts "❌ FAKE (#{result.score})"
+end
+puts "   #{result.text}"
+puts "---------------------------------------------------"

data/lib/truth_serum/result.rb

@@ -0,0 +1,28 @@
+module TruthSerum
+  class Result
+    attr_reader :text, :score, :status, :metadata
+
+    def initialize(text:, score:, status:, metadata: {})
+      @text = text
+      @score = score
+      @status = status
+      @metadata = metadata
+    end
+
+    # Helper method: Returns true if the status is :real
+    # This is much cleaner than checking `if hash[:status] == :real`
+    def verified?
+      @status == :real
+    end
+
+    # Helper method: Returns true if the status is :fake
+    def fake?
+      @status == :fake
+    end
+
+    # A friendly string representation for debugging
+    def to_s
+      "[#{@status.upcase}] Score: #{@score} | #{@text[0..30]}..."
+    end
+  end
+end

data/lib/truth_serum/verifier.rb

@@ -0,0 +1,59 @@
+require 'httparty'
+require_relative 'result'
+
+module TruthSerum
+  class Verifier
+    BASE_URL = "https://api.crossref.org/works"
+
+    def self.check_list(list)
+      results = []
+
+      list.each do |citation|
+        response = HTTParty.get(BASE_URL, query: { 
+          "query.bibliographic" => citation, 
+          "rows" => 1 
+        })
+
+        data = response.parsed_response
+        items = data.dig("message", "items")
+
+        status = :fake
+        score = 0.0
+        
+        # LOGIC: Check if we found a match AND if it looks similar
+        if items && items.any?
+          top_match = items.first
+          found_title = top_match["title"]&.first || ""
+          
+          # 1. Normalize strings (lowercase, find words 4+ letters long)
+          # We ignore small words like "the", "of", "and".
+          input_words = citation.downcase.scan(/[a-z]{4,}/)
+          found_words = found_title.downcase.scan(/[a-z]{4,}/)
+          
+          # 2. Count common words
+          common_words = input_words & found_words
+          
+          # 3. Decision Threshold
+          # If they share at least 2 significant words, we assume it's the same paper.
+          if common_words.size >= 2
+            status = :real
+            score = top_match["score"]
+          else
+            # We found a paper, but the title was too different.
+            # (e.g. You searched "Musk Mars" and got "Geology of Mars")
+            status = :fake 
+            score = 0.1 # Low score for mismatch
+          end
+        end
+
+        results << TruthSerum::Result.new(
+          text: citation,
+          score: score,
+          status: status
+        )
+      end
+
+      results
+    end
+  end
+end

data/lib/truth_serum/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module TruthSerum
+  VERSION = "0.1.0"
+end

data/lib/truth_serum.rb

@@ -0,0 +1,8 @@
+require_relative "truth_serum/version"
+require_relative "truth_serum/result"
+require_relative "truth_serum/verifier"
+
+module TruthSerum
+  class Error < StandardError; end
+  # That is it! No Verifier class definition here anymore.
+end

data/truth_serum.gemspec

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+require_relative "lib/truth_serum/version"
+
+Gem::Specification.new do |spec|
+  spec.name          = "truth_serum_academic"
+  spec.version       = TruthSerum::VERSION
+  spec.authors       = ["Nathalie Tasler"]
+  spec.email         = ["drntasler@gmail.com"]
+
+  spec.summary       = "A citation checker gem"
+  spec.description   = "A Ruby gem that checks citations against Crossref API."
+  spec.license       = "MIT"
+  spec.required_ruby_version = ">= 3.2.0"
+
+
+spec.files = Dir.glob("{bin,lib}/**/*") + ["truth_serum.gemspec"]
+
+  spec.bindir        = "bin"
+  spec.executables   = ["truth_serum"]
+  spec.require_paths = ["lib"]
+
+  # This is the dependency for the API calls
+  spec.add_dependency "httparty"
+# Development dependency (You need this to run tests)
+  spec.add_development_dependency "rspec", "~> 3.0"
+end

metadata

@@ -0,0 +1,76 @@
+--- !ruby/object:Gem::Specification
+name: truth_serum_academic
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Nathalie Tasler
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: httparty
+  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: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+description: A Ruby gem that checks citations against Crossref API.
+email:
+- drntasler@gmail.com
+executables:
+- truth_serum
+extensions: []
+extra_rdoc_files: []
+files:
+- bin/console
+- bin/setup
+- bin/truth_serum
+- lib/truth_serum.rb
+- lib/truth_serum/result.rb
+- lib/truth_serum/verifier.rb
+- lib/truth_serum/version.rb
+- truth_serum.gemspec
+licenses:
+- MIT
+metadata: {}
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.2.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.3
+specification_version: 4
+summary: A citation checker gem
+test_files: []