LAN-Orangutan is a self-hosted network discovery tool. Find every device on your LAN, label and group them, snapshot your network and compare it later, and get flagged when something unexpected shows up. Single binary, no setup, Tailscale built in. Built by 291 Group.
Go clidevice-discoverygolanghomelabinternet-of-thingslannetwork-discoverynetwork-monitoringnetwork-monitoring-toolnetwork-scannernetworkingnmapsecurityself-hostedselfhostedtailscaletailscale-networkweb-dashboard
package api
import (
"bytes"
"encoding/json"
"net/http"
"net/http/httptest"
"path/filepath"
"testing"
"github.com/291-Group/LAN-Orangutan/internal/config"
"github.com/291-Group/LAN-Orangutan/internal/storage"
"github.com/291-Group/LAN-Orangutan/internal/types"
)
func newTestAPI(t *testing.T) (*Handler, *storage.Storage) {
t.Helper()
dir := t.TempDir()
store, err := storage.New(filepath.Join(dir, "devices.json"), filepath.Join(dir, "state.json"))
if err != nil {
t.Fatalf("storage.New: %v", err)
}
cfg := config.Default()
h := NewHandler(store, cfg)
return h, store
}
func TestAPIGetDevice(t *testing.T) {
h, store := newTestAPI(t)
if err := store.MergeDevices([]types.Device{
{IP: "192.168.1.100", Hostname: "test-dev", Type: "Computer"},
}); err != nil {
t.Fatal(err)
}
req := httptest.NewRequest(http.MethodGet, "/api/device?ip=192.168.1.100", nil)
rec := httptest.NewRecorder()
h.ServeHTTP(rec, req)
if rec.Code != http.StatusOK {
t.Fatalf("expected 200, got %d", rec.Code)
}
var resp types.APIResponse
if err := json.Unmarshal(rec.Body.Bytes(), &resp); err != nil {
t.Fatal(err)
}
if !resp.Success {
t.Fatalf("expected success, got %v", resp.Error)
}
}
func TestAPIPostDevice_CustomType(t *testing.T) {
h, store := newTestAPI(t)
if err := store.MergeDevices([]types.Device{
{IP: "192.168.1.101", Hostname: "plug", Type: "Router"},
}); err != nil {
t.Fatal(err)
}
// Update device with custom type from supported taxonomy
body := []byte(`{"ip":"192.168.1.101","label":"Smart Plug 1","type":"IoT","custom_type":true}`)
req := httptest.NewRequest(http.MethodPost, "/api/device", bytes.NewReader(body))
req.Header.Set("Content-Type", "application/json")
rec := httptest.NewRecorder()
h.ServeHTTP(rec, req)
if rec.Code != http.StatusOK {
t.Fatalf("expected 200, got %d: %s", rec.Code, rec.Body.String())
}
dev := store.GetDevice("192.168.1.101")
if dev == nil {
t.Fatal("device missing")
}
if dev.Label != "Smart Plug 1" {
t.Errorf("expected label 'Smart Plug 1', got %q", dev.Label)
}
if dev.Type != "IoT" {
t.Errorf("expected Type 'IoT', got %q", dev.Type)
}
if !dev.CustomType {
t.Errorf("expected CustomType true, got %v", dev.CustomType)
}
// Rescan should not overwrite custom type
if err := store.MergeDevices([]types.Device{
{IP: "192.168.1.101", Hostname: "plug", Type: "Router"},
}); err != nil {
t.Fatal(err)
}
dev = store.GetDevice("192.168.1.101")
if dev.Type != "IoT" {
t.Errorf("rescan overwrote custom type; got %q", dev.Type)
}
}
func TestAPIPostDevice_InvalidType_Rejected(t *testing.T) {
h, store := newTestAPI(t)
if err := store.MergeDevices([]types.Device{
{IP: "192.168.1.102", Hostname: "outlet"},
}); err != nil {
t.Fatal(err)
}
// Unsupported arbitrary type should be rejected with HTTP 400
body := []byte(`{"ip":"192.168.1.102","type":"Smart Outlet","custom_type":true}`)
req := httptest.NewRequest(http.MethodPost, "/api/device", bytes.NewReader(body))
req.Header.Set("Content-Type", "application/json")
rec := httptest.NewRecorder()
h.ServeHTTP(rec, req)
if rec.Code != http.StatusBadRequest {
t.Fatalf("expected 400 Bad Request, got %d: %s", rec.Code, rec.Body.String())
}
dev := store.GetDevice("192.168.1.102")
if dev.Type != "" || dev.CustomType {
t.Errorf("expected type to remain untouched, got type=%q custom=%v", dev.Type, dev.CustomType)
}
}
func TestAPIPostDevice_TypeTooLong_Rejected(t *testing.T) {
h, store := newTestAPI(t)
if err := store.MergeDevices([]types.Device{
{IP: "192.168.1.104", Hostname: "device"},
}); err != nil {
t.Fatal(err)
}
tooLong := "ThisDeviceTypeStringIsWayTooLongToBeValid"
body := []byte(`{"ip":"192.168.1.104","type":"` + tooLong + `"}`)
req := httptest.NewRequest(http.MethodPost, "/api/device", bytes.NewReader(body))
req.Header.Set("Content-Type", "application/json")
rec := httptest.NewRecorder()
h.ServeHTTP(rec, req)
if rec.Code != http.StatusBadRequest {
t.Fatalf("expected 400 Bad Request, got %d: %s", rec.Code, rec.Body.String())
}
}
func TestAPIPostDevice_ResetType(t *testing.T) {
h, store := newTestAPI(t)
if err := store.MergeDevices([]types.Device{
{IP: "192.168.1.103", Hostname: "mybox", Type: "Computer"},
}); err != nil {
t.Fatal(err)
}
// Mark as custom first
customType := "Server"
if err := store.UpdateDeviceFields("192.168.1.103", nil, nil, nil, nil, &customType, nil); err != nil {
t.Fatal(err)
}
// Reset via API
body := []byte(`{"ip":"192.168.1.103","type":"","custom_type":false}`)
req := httptest.NewRequest(http.MethodPost, "/api/device", bytes.NewReader(body))
req.Header.Set("Content-Type", "application/json")
rec := httptest.NewRecorder()
h.ServeHTTP(rec, req)
if rec.Code != http.StatusOK {
t.Fatalf("expected 200, got %d: %s", rec.Code, rec.Body.String())
}
dev := store.GetDevice("192.168.1.103")
if dev.Type != "" || dev.CustomType {
t.Errorf("expected cleared type and custom_type false, got type=%q custom=%v", dev.Type, dev.CustomType)
}
}