Fix Makefiles and add README

The http/ and hashtable/ Makefiles named sources that do not exist
(test.c, net.c, net.h in http/; http.h in hashtable/) and had no way to
find the sibling hashtable/llist sources they link against, so neither
directory built at all. Both now compile those sources with explicit
recipes.

VPATH would be the terser fix but is deliberately avoided: it searches
for targets as well as sources, so a stale ../llist/test.o gets linked
in place of a freshly compiled one, and hashtable/test silently runs the
linked-list suite instead of its own.

llist/Makefile built fine; its .PHONY read "all," with a comma, making
that the literal target name, and test.o was missing its llist.h
dependency.

README covers layout, build, run, the use()/Handler routing API, and the
library tests.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
adgundersen 2026-08-10 20:53:09 +00:00
commit 1b54b78416
4 changed files with 108 additions and 28 deletions

View file

@ -1 +1,71 @@
Addon Libraries to C Programming Language # pico-http
A minimal HTTP server in C, with the hashtable and linked-list libraries it is built on.
## Layout
```
http/ server and routing framework
hashtable/ route table
llist/ bucket chaining for the hashtable
```
## Build
Needs `gcc` and `make`.
```sh
cd http && make
```
## Run
```sh
./pico-http
```
Listens on port 3000, set by `PORT` in `http/http.h`.
```sh
$ curl localhost:3000/login
Login works!
$ curl localhost:3000/signup
Sign Up works!
```
Unregistered paths return `400 Bad request`.
## Adding a route
A handler fills in `Res`:
```c
void hello(Req* req, Res* res)
{
char* content = "Hello\n";
res->status = 200;
res->content_type = "text/html";
res->content_length = strlen(content);
res->body = content;
}
```
Register it before starting the server, in `main.c`:
```c
use("/hello", &hello);
http_start(PORT);
```
Paths match exactly — `/hello` will not match `/hello/`.
## Library tests
```sh
cd llist && make && ./test
cd hashtable && make && ./test
```
`make clean` in any of the three directories removes its objects and binary.

View file

@ -1,21 +1,25 @@
CC=gcc CC=gcc
CFLAGS=-Wall -Wextra CFLAGS=-Wall -Wextra -I. -I../llist
OBJS=test.o hashtable.o llist.o OBJS=test.o hashtable.o llist.o
all: test all: test
test: $(OBJS) test: $(OBJS)
gcc -o $@ $^ $(CC) -o $@ $^
test.o: test.c http.h # Explicit recipes rather than VPATH: VPATH also searches for *targets*, so a
# stale ../llist/test.o would get linked in place of this directory's own.
test.o: test.c hashtable.h
$(CC) $(CFLAGS) -c -o $@ $<
hashtable.o: hashtable.c hashtable.h hashtable.o: hashtable.c hashtable.h ../llist/llist.h
$(CC) $(CFLAGS) -c -o $@ $<
llist.o: llist.c llist.h llist.o: ../llist/llist.c ../llist/llist.h
$(CC) $(CFLAGS) -c -o $@ $<
clean: clean:
rm -f $(OBJS) rm -f $(OBJS) test
rm -f test
.PHONY: all, clean .PHONY: all clean

View file

@ -1,25 +1,33 @@
CC=gcc CC=gcc
CFLAGS=-Wall -Wextra CFLAGS=-Wall -Wextra -I. -I../hashtable -I../llist
OBJS=test.o http.o net.o hashtable.o llist.o BIN=pico-http
OBJS=main.o http.o listen.o hashtable.o llist.o
all: test all: $(BIN)
test: $(OBJS) $(BIN): $(OBJS)
gcc -o $@ $^ $(CC) -o $@ $^
test.o: test.c http.h # hashtable.c and llist.c live in sibling directories and are compiled into
# this one. Explicit recipes rather than VPATH: VPATH also searches for
# *targets*, so a stale sibling .o would get linked in place of a fresh build.
main.o: main.c http.h
$(CC) $(CFLAGS) -c -o $@ $<
http.o: http.c http.h http.o: http.c http.h listen.h ../hashtable/hashtable.h
$(CC) $(CFLAGS) -c -o $@ $<
net.o: net.c net.h listen.o: listen.c listen.h
$(CC) $(CFLAGS) -c -o $@ $<
hashtable.o: hashtable.c hashtable.h hashtable.o: ../hashtable/hashtable.c ../hashtable/hashtable.h ../llist/llist.h
$(CC) $(CFLAGS) -c -o $@ $<
llist.o: llist.c llist.h llist.o: ../llist/llist.c ../llist/llist.h
$(CC) $(CFLAGS) -c -o $@ $<
clean: clean:
rm -f $(OBJS) rm -f $(OBJS) $(BIN)
rm -f test
.PHONY: all, clean .PHONY: all clean

View file

@ -6,14 +6,12 @@ OBJS=test.o llist.o
all: test all: test
test: $(OBJS) test: $(OBJS)
gcc -o $@ $^ $(CC) -o $@ $^
test.o: test.c
test.o: test.c llist.h
llist.o: llist.c llist.h llist.o: llist.c llist.h
clean: clean:
rm -f $(OBJS) rm -f $(OBJS) test
rm -f test
.PHONY: all, clean .PHONY: all clean