Merge pull request stacktower-io#5 from ric2b/main

feat: add ruby support

Author: matzehuels

README.md

@@ -40,6 +40,9 @@ stacktower parse javascript yup -o yup.json
 
 # PHP (Packagist/Composer)
 stacktower parse php monolog/monolog -o monolog.json
+
+# Ruby (RubyGems)
+stacktower parse ruby rspec -o rspec.json
 ```
 
 Add `--enrich` with a `GITHUB_TOKEN` to pull repository metadata (stars, maintainers, last commit) for richer visualizations.
@@ -162,7 +165,7 @@ The `--detailed` flag (node-link only) displays **all** meta keys in the node la
 
 ## How It Works
 
-1. **Parse** — Fetch package metadata from registries (PyPI, crates.io, npm)
+1. **Parse** — Fetch package metadata from registries (PyPI, crates.io, npm, Packagist, RubyGems)
 2. **Reduce** — Remove transitive edges to show only direct dependencies
 3. **Layer** — Assign each package to a row based on its depth
 4. **Order** — Minimize edge crossings using branch-and-bound with PQ-tree pruning
@@ -184,16 +187,16 @@ HTTP responses are cached in `~/.cache/stacktower/` with a 24-hour TTL. Use `--r
 
 ## Adding New Languages
 
-To add support for a new package manager (e.g., Ruby/RubyGems):
+To add support for a new package manager (e.g., Go/pkg.go.dev):
 
-1. **Create a registry client** in `pkg/integrations/rubygems/client.go` — parse the registry API, extract dependencies, use `integrations.BaseClient` for HTTP + caching
+1. **Create a registry client** in `pkg/integrations/<registry>/client.go` — parse the registry API, extract dependencies, use `integrations.BaseClient` for HTTP + caching
 
-2. **Create a source parser** in `pkg/source/ruby/ruby.go` — implement the `source.PackageInfo` interface (`GetName`, `GetVersion`, `GetDependencies`, `ToMetadata`, `ToRepoInfo`)
+2. **Create a source parser** in `pkg/source/<lang>/<lang>.go` — implement the `source.PackageInfo` interface (`GetName`, `GetVersion`, `GetDependencies`, `ToMetadata`, `ToRepoInfo`)
 
 3. **Wire into CLI** in `internal/cli/parse.go`:
    ```go
-   cmd.AddCommand(newParserCmd("ruby <gem>", "Parse Ruby dependencies",
-       func() (source.Parser, error) { return ruby.NewParser(source.DefaultCacheTTL) }, &opts))
+   cmd.AddCommand(newParserCmd("<lang> <package>", "Parse <Lang> dependencies",
+       func() (source.Parser, error) { return <lang>.NewParser(source.DefaultCacheTTL) }, &opts))
    ```
 
 The generic `source.Parse()` handles concurrent fetching, depth limits, and graph construction automatically.

examples/real/rspec.json

@@ -0,0 +1,98 @@
+{
+  "nodes": [
+    {
+      "id": "rspec",
+      "meta": {
+        "author": "Steven Baker, David Chelimsky, Myron Marston",
+        "description": "BDD for Ruby",
+        "downloads": 933712525,
+        "license": "MIT",
+        "version": "3.13.2"
+      }
+    },
+    {
+      "id": "rspec-core",
+      "meta": {
+        "author": "Steven Baker, David Chelimsky, Chad Humphries, Myron Marston",
+        "description": "BDD for Ruby. RSpec runner and example groups.",
+        "downloads": 1086232437,
+        "license": "MIT",
+        "version": "3.13.6"
+      }
+    },
+    {
+      "id": "rspec-expectations",
+      "meta": {
+        "author": "Steven Baker, David Chelimsky, Myron Marston",
+        "description": "rspec-expectations provides a simple, readable API to express expected outcomes of a code example.",
+        "downloads": 1087466323,
+        "license": "MIT",
+        "version": "3.13.5"
+      }
+    },
+    {
+      "id": "rspec-mocks",
+      "meta": {
+        "author": "Steven Baker, David Chelimsky, Myron Marston",
+        "description": "RSpec's 'test double' framework, with support for stubbing and mocking",
+        "downloads": 1080564537,
+        "license": "MIT",
+        "version": "3.13.7"
+      }
+    },
+    {
+      "id": "diff-lcs",
+      "meta": {
+        "author": "Austin Ziegler",
+        "description": "Diff::LCS computes the difference between two Enumerable sequences using the\nMcIlroy-Hunt longest common subsequence (LCS) algorithm. It includes utilities\nto create a simple HTML diff output format and a standard diff-like tool.\n\nThis is release 1.6.1, providing a simple extension that allows for\nDiff::LCS::Change objects to be treated implicitly as arrays and fixes a number\nof formatting issues.\n\nRuby versions below 2.5 are soft-deprecated, which means that older versions are\nno longer part of the CI test suite. If any changes have been introduced that\nbreak those versions, bug reports and patches will be accepted, but it will be\nup to the reporter to verify any fixes prior to release. The next major release\nwill completely break compatibility.",
+        "downloads": 1109763549,
+        "license": "MIT, Artistic-1.0-Perl, GPL-2.0-or-later",
+        "version": "1.6.2"
+      }
+    },
+    {
+      "id": "rspec-support",
+      "meta": {
+        "author": "David Chelimsky, Myron Marson, Jon Rowe, Sam Phippen, Xaviery Shay, Bradley Schaefer",
+        "description": "Support utilities for RSpec gems",
+        "downloads": 1070970150,
+        "license": "MIT",
+        "version": "3.13.6"
+      }
+    }
+  ],
+  "edges": [
+    {
+      "from": "rspec",
+      "to": "rspec-core"
+    },
+    {
+      "from": "rspec",
+      "to": "rspec-expectations"
+    },
+    {
+      "from": "rspec",
+      "to": "rspec-mocks"
+    },
+    {
+      "from": "rspec-expectations",
+      "to": "diff-lcs"
+    },
+    {
+      "from": "rspec-expectations",
+      "to": "rspec-support"
+    },
+    {
+      "from": "rspec-core",
+      "to": "rspec-support"
+    },
+    {
+      "from": "rspec-mocks",
+      "to": "diff-lcs"
+    },
+    {
+      "from": "rspec-mocks",
+      "to": "rspec-support"
+    }
+  ]
+}

internal/cli/parse.go

@@ -14,6 +14,7 @@ import (
 	"github.com/matzehuels/stacktower/pkg/source/metadata"
 	"github.com/matzehuels/stacktower/pkg/source/php"
 	"github.com/matzehuels/stacktower/pkg/source/python"
+	"github.com/matzehuels/stacktower/pkg/source/ruby"
 	"github.com/matzehuels/stacktower/pkg/source/rust"
 )
 
@@ -48,6 +49,8 @@ func newParseCmd() *cobra.Command {
 		func() (source.Parser, error) { return rust.NewParser(source.DefaultCacheTTL) }, &opts))
 	cmd.AddCommand(newParserCmd("javascript <package>", "Parse JavaScript package dependencies from npm",
 		func() (source.Parser, error) { return javascript.NewParser(source.DefaultCacheTTL) }, &opts))
+	cmd.AddCommand(newParserCmd("ruby <gem>", "Parse Ruby gem dependencies from RubyGems",
+		func() (source.Parser, error) { return ruby.NewParser(source.DefaultCacheTTL) }, &opts))
 	cmd.AddCommand(newParserCmd("php <package>", "Parse PHP (Composer) package dependencies from Packagist",
 		func() (source.Parser, error) { return php.NewParser(source.DefaultCacheTTL) }, &opts))
 

pkg/integrations/rubygems/client.go

@@ -0,0 +1,129 @@
+package rubygems
+
+import (
+	"context"
+	"errors"
+	"fmt"
+	"strings"
+	"time"
+
+	"github.com/matzehuels/stacktower/pkg/integrations"
+)
+
+type GemInfo struct {
+	Name          string
+	Version       string
+	Dependencies  []string
+	SourceCodeURI string
+	HomepageURI   string
+	Description   string
+	License       string
+	Downloads     int
+	Authors       string
+}
+
+type Client struct {
+	integrations.BaseClient
+	baseURL string
+}
+
+func NewClient(cacheTTL time.Duration) (*Client, error) {
+	cache, err := integrations.NewCache(cacheTTL)
+	if err != nil {
+		return nil, err
+	}
+	return &Client{
+		BaseClient: integrations.BaseClient{
+			HTTP:  integrations.NewHTTPClient(),
+			Cache: cache,
+		},
+		baseURL: "https://rubygems.org/api/v1",
+	}, nil
+}
+
+func (c *Client) FetchGem(ctx context.Context, gem string, refresh bool) (*GemInfo, error) {
+	gem = normalizeName(gem)
+	cacheKey := "rubygems:" + gem
+
+	var info GemInfo
+	err := c.FetchWithCache(ctx, cacheKey, refresh, func() error {
+		return c.fetchGem(ctx, gem, &info)
+	}, &info)
+	if err != nil {
+		return nil, err
+	}
+	return &info, nil
+}
+
+func (c *Client) fetchGem(ctx context.Context, gem string, info *GemInfo) error {
+	url := fmt.Sprintf("%s/gems/%s.json", c.baseURL, gem)
+
+	var data gemResponse
+	if err := c.DoRequest(ctx, url, nil, &data); err != nil {
+		if errors.Is(err, integrations.ErrNotFound) {
+			return fmt.Errorf("%w: rubygems gem %s", err, gem)
+		}
+		return err
+	}
+
+	*info = GemInfo{
+		Name:          data.Name,
+		Version:       data.Version,
+		Description:   data.Info,
+		License:       joinLicenses(data.Licenses),
+		SourceCodeURI: data.SourceCodeURI,
+		HomepageURI:   data.HomepageURI,
+		Downloads:     data.Downloads,
+		Authors:       data.Authors,
+		Dependencies:  extractDeps(data.Dependencies),
+	}
+	return nil
+}
+
+func extractDeps(deps dependenciesResponse) []string {
+	seen := make(map[string]bool)
+	var result []string
+
+	// Only include runtime dependencies, skip development dependencies
+	for _, dep := range deps.Runtime {
+		name := normalizeName(dep.Name)
+		if !seen[name] {
+			seen[name] = true
+			result = append(result, name)
+		}
+	}
+	return result
+}
+
+func joinLicenses(licenses []string) string {
+	if len(licenses) == 0 {
+		return ""
+	}
+	return strings.Join(licenses, ", ")
+}
+
+func normalizeName(name string) string {
+	return strings.ToLower(strings.TrimSpace(name))
+}
+
+type gemResponse struct {
+	Name          string               `json:"name"`
+	Version       string               `json:"version"`
+	Info          string               `json:"info"`
+	Licenses      []string             `json:"licenses"`
+	SourceCodeURI string               `json:"source_code_uri"`
+	HomepageURI   string               `json:"homepage_uri"`
+	Downloads     int                  `json:"downloads"`
+	Authors       string               `json:"authors"`
+	Dependencies  dependenciesResponse `json:"dependencies"`
+}
+
+type dependenciesResponse struct {
+	Development []dependencyInfo `json:"development"`
+	Runtime     []dependencyInfo `json:"runtime"`
+}
+
+type dependencyInfo struct {
+	Name         string `json:"name"`
+	Requirements string `json:"requirements"`
+}