gator

RSS feed aggregator CLI.

Prerequisites

• Go 1.22+
• PostgreSQL
• goose — migration tool
• sqlc — SQL code generator (only needed for dev)

Setup

1. Create a PostgreSQL database

2. Create a .env file in the project root:

   DB_URL=postgres://user:password@localhost:5432/dbname
   

3. Create ~/.gatorconfig.json:

   {
     "db_url": "postgres://user:password@localhost:5432/dbname?sslmode=disable"
   }

4. Run migrations:

   make migrate

5. Build:

   make build

Usage

./gator register <username>       # create account and log in
./gator login <username>          # switch user
./gator addfeed <name> <url>      # add and follow a feed
./gator agg <interval>            # start aggregating (e.g. 30s, 1m)
./gator browse [limit]            # view latest posts (default: 2)
./gator feeds                     # list all feeds
./gator follow <url>              # follow a feed
./gator unfollow <url>            # unfollow a feed
./gator following                 # list followed feeds
./gator users                     # list all users