lighterpack-parser 1.0.0 → 1.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 85fed15af6ad0ccfbba49c9960cf80e47fee71cbdce5166746e5788df489127d
-  data.tar.gz: dbf4da779516e9ba651846a1457fcdfa52142313643235f5cbc7500778d9baec
+  metadata.gz: 7aad45ab474c77260d595b41456b949ab8d3ad658bd5a13d32cfd48728323def
+  data.tar.gz: '09ecbf0c0036256a9cf0cfd6657150775ba0b94b08144431e54a536465592695'
 SHA512:
-  metadata.gz: 1e35ae9d5211815cef892b469d26e4e79163698465e2b213e8f394a0d2f9546ddc007e7a182684513aff24579281fe719581d3156c3fc6323134f48af2d6067f
-  data.tar.gz: c90687504af99ace152a1bf2749362d70d004e37e3cd9baf50aee6adbe0fbce4869ba57ea7b6b7b74b617a6bac7ece5954dc4fe1c2e365377ffc110711efb8bb
+  metadata.gz: e632d196be2456197d2081a5de0ddc10b9bff3efbba3d34920a0795027cdc6b0e8a4869e7a827e4b41069a5d98c943a466266409af1c6916a65ded252ebd9fcb
+  data.tar.gz: 40633982fd1e80c6e34145b1c4d0dab8cfdfc83475d67f442404242a087db9ed6ebdb7346a87a54394d0f9f24af3c111f89171e9e589478eee2346011e1efa05

data/README.md

@@ -2,41 +2,81 @@
 
 A Ruby gem for parsing Lighterpack lists from HTML or URLs.
 
+Used by [Goulight](https://goulight.com). Source: [github.com/goulight/lighterpack-parser](https://github.com/goulight/lighterpack-parser).
+
 ## Installation
 
-This gem is used as a local dependency in the Packlista project. It's referenced in the backend `Gemfile`:
+Add to your `Gemfile`:
 
 ```ruby
-gem 'lighterpack_parser', path: '../lighterpack-parser'
+gem 'lighterpack-parser', '~> 1.0'
+```
+
+Then:
+
+```bash
+bundle install
+```
+
+Or install directly:
+
+```bash
+gem install lighterpack-parser
 ```
 
 ## Usage
 
+`LighterpackParser::Parser#parse` (and `LighterpackParser.parse_url`) return a **`LighterpackParser::List`** object with readers `name`, `description`, and `categories`. Each category is a **`LighterpackParser::Category`**; each item is a **`LighterpackParser::Item`**.
+
+Call **`#to_h`** on the list (or on categories/items) if you need nested hashes (for example JSON APIs).
+
 ### Parse from HTML string
 
 ```ruby
 require 'lighterpack_parser'
 
 html = File.read('path/to/lighterpack.html')
-result = LighterpackParser::Parser.new(html: html).parse
-
-# Result structure:
-# {
+list = LighterpackParser::Parser.new(html: html).parse
+
+list.name                    # => "List Name"
+list.description             # => "List description" or nil
+list.categories.first.name   # => "Category Name"
+
+item = list.categories.first.items.first
+item.name                    # => "Item Name"
+item.description             # => "Item description" or nil
+item.weight                  # => 476.0   # grams per unit
+item.total_weight            # => 476.0   # weight * quantity (grams)
+item.quantity                # => 1
+item.image_url               # => "https://..." or nil
+item.consumable              # => false
+item.total_consumable_weight # => nil (or total grams if consumable)
+item.worn                    # => false
+item.worn_quantity           # => nil (or 1 if worn)
+item.total_worn_weight       # => nil (or grams worn, weight × 1)
+
+# Hash shape (matches nested #to_h):
+list.to_h
+# => {
 #   name: "List Name",
-#   description: "List description (optional)",
+#   description: nil,
 #   categories: [
 #     {
 #       name: "Category Name",
-#       description: "Category description (optional)",
+#       description: nil,
 #       items: [
 #         {
 #           name: "Item Name",
 #           description: "Item description",
-#           weight: 476.0,  # in grams
+#           weight: 476.0,
+#           total_weight: 476.0,
 #           quantity: 1,
 #           image_url: "https://...",
 #           consumable: false,
-#           worn: false
+#           total_consumable_weight: nil,
+#           worn: false,
+#           worn_quantity: nil,
+#           total_worn_weight: nil
 #         }
 #       ]
 #     }
@@ -49,11 +89,10 @@ result = LighterpackParser::Parser.new(html: html).parse
 ```ruby
 require 'lighterpack_parser'
 
-# Using the parser directly
-result = LighterpackParser::Parser.new(url: 'https://lighterpack.com/r/b6q1kr').parse
+list = LighterpackParser::Parser.new(url: 'https://lighterpack.com/r/b6q1kr').parse
 
 # Or using the convenience method
-result = LighterpackParser.parse_url('https://lighterpack.com/r/b6q1kr')
+list = LighterpackParser.parse_url('https://lighterpack.com/r/b6q1kr')
 ```
 
 ## Running Tests
@@ -66,7 +105,8 @@ rspec
 
 ## Test Fixtures
 
-Test fixtures are stored in `test/fixtures/` and contain HTML from example Lighterpack lists:
+Test fixtures are stored in `spec/fixtures/` and contain HTML from example Lighterpack lists:
+
 - `b6q1kr.html` - Ultimate Hike 2025
 - `adbf7c.html` - Example list 2
 - `h23rxt.html` - Example list 3
@@ -74,7 +114,7 @@ Test fixtures are stored in `test/fixtures/` and contain HTML from example Light
 To update fixtures, download fresh HTML:
 
 ```bash
-curl -s "https://lighterpack.com/r/b6q1kr" > test/fixtures/b6q1kr.html
+curl -s "https://lighterpack.com/r/b6q1kr" > spec/fixtures/b6q1kr.html
 ```
 
 ## Features
@@ -83,17 +123,18 @@ curl -s "https://lighterpack.com/r/b6q1kr" > test/fixtures/b6q1kr.html
 - Extracts categories with descriptions
 - Extracts items with:
   - Name and description
-  - Weight (automatically converted to grams)
+  - Weight per unit and total weight (automatically converted to grams)
   - Quantity
   - Image URLs
-  - Consumable flag
-  - Worn flag
+  - Consumable flag and total consumable weight when applicable
+  - Worn flag, worn quantity, and total worn weight when applicable
 - Supports weight units: oz, lb, g, kg (all converted to grams)
 - Handles both HTML strings and URLs
 
 ## Weight Conversion
 
 The parser automatically converts all weights to grams:
+
 - `oz` → multiply by 28.3495
 - `lb` → multiply by 453.592
 - `g` → use as-is

data/lib/lighterpack_parser/item.rb

@@ -69,24 +69,5 @@ module LighterpackParser
         total_worn_weight: total_worn_weight
       }
     end
-    alias worn? worn
-    alias consumable? consumable
-
-    # Convert to hash
-    #
-    # @return [Hash] Hash representation of the item
-    def to_h
-      {
-        name: name, description: description,
-        weight: weight, total_weight: total_weight,
-
-        quantity: quantity,
-        image_url: image_url,
-        consumable: consumable,
-        total_consumable_weight: total_consumable_weight,
-        worn: worn, worn_quantity: worn_quantity,
-        total_worn_weight: total_worn_weight
-      }
-    end
   end
 end

data/lib/lighterpack_parser/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module LighterpackParser
-  VERSION = '1.0.0'
+  VERSION = '1.0.2'
 end

data/lighterpack-parser.gemspec

@@ -10,9 +10,13 @@ Gem::Specification.new do |spec|
 
   spec.summary       = 'Parser for Lighterpack lists'
   spec.description   = 'Parse Lighterpack HTML to extract list data including categories, items, weights, and metadata'
-  spec.homepage      = 'https://github.com/alex-ross/lighterpack-parser'
+  spec.homepage      = 'https://github.com/goulight/lighterpack-parser'
   spec.license       = 'MIT'
 
+  spec.metadata = {
+    'source_code_uri' => 'https://github.com/goulight/lighterpack-parser'
+  }
+
   spec.required_ruby_version = '>= 3.0'
 
   spec.files         = Dir['lib/**/*', 'spec/**/*', '*.md', '*.gemspec']

data/spec/item_spec.rb

@@ -0,0 +1,67 @@
+# frozen_string_literal: true
+
+require 'open3'
+require 'rbconfig'
+require 'spec_helper'
+
+RSpec.describe LighterpackParser::Item do
+  subject(:item) do
+    described_class.new(
+      name: 'Trail runners',
+      description: 'Worn on approach',
+      weight: 320.5,
+      total_weight: 641.0,
+      quantity: 2,
+      image_url: 'https://example.com/item.png',
+      consumable: true,
+      total_consumable_weight: 641.0,
+      worn: true,
+      worn_quantity: 1,
+      total_worn_weight: 320.5
+    )
+  end
+
+  describe 'predicate helpers' do
+    it 'keeps the boolean reader methods available as predicates' do
+      expect(item.worn?).to be(true)
+      expect(item.consumable?).to be(true)
+    end
+  end
+
+  describe '#to_h' do
+    it 'returns the same public hash representation' do
+      expect(item.to_h).to eq(
+        name: 'Trail runners',
+        description: 'Worn on approach',
+        weight: 320.5,
+        total_weight: 641.0,
+        quantity: 2,
+        image_url: 'https://example.com/item.png',
+        consumable: true,
+        total_consumable_weight: 641.0,
+        worn: true,
+        worn_quantity: 1,
+        total_worn_weight: 320.5
+      )
+    end
+  end
+
+  describe 'loading the file' do
+    it 'does not emit method redefinition warnings' do
+      stdout, stderr, status = Open3.capture3(
+        RbConfig.ruby,
+        '-w',
+        '-I',
+        File.expand_path('../lib', __dir__),
+        '-e',
+        'require "lighterpack_parser/item"'
+      )
+
+      aggregate_failures do
+        expect(status.success?).to be(true), stdout + stderr
+        expect(stderr).not_to include('method redefined')
+        expect(stderr).not_to include('previous definition of')
+      end
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: lighterpack-parser
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.0.2
 platform: ruby
 authors:
 - Packlista Team
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-01-02 00:00:00.000000000 Z
+date: 2026-04-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: httparty
@@ -75,12 +75,14 @@ files:
 - spec/fixtures/adbf7c.html
 - spec/fixtures/b6q1kr.html
 - spec/fixtures/h23rxt.html
+- spec/item_spec.rb
 - spec/parser_spec.rb
 - spec/spec_helper.rb
-homepage: https://github.com/alex-ross/lighterpack-parser
+homepage: https://github.com/goulight/lighterpack-parser
 licenses:
 - MIT
-metadata: {}
+metadata:
+  source_code_uri: https://github.com/goulight/lighterpack-parser
 post_install_message:
 rdoc_options: []
 require_paths: