thallada/crawlnicle
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
My personalized news and blog aggregator
20 Commits 3 Branches 0 Tags 780 KiB
Rust 95.5%
PLpgSQL 1.7%
TypeScript 1.6%
Just 0.9%
JavaScript 0.2%
6713a7a440
Go to file
Tyler Hallada 6713a7a440 Complete log stream implementation 
Sets up a watch channel to send tracing lines from tracing-subscriber to
receivers in a axum handler which streams Server Sent Events to any
number of connected /log/stream clients.
2023-06-03 19:03:58 -04:00
migrations Make titles optional on feeds and entries 2023-05-17 23:10:23 -04:00
src Complete log stream implementation 2023-06-03 19:03:58 -04:00
.gitignore Add /log page that displays server log 2023-06-03 01:09:25 -04:00
build.rs Initial commit with basic axum and sqlx API 2023-05-07 17:41:45 -04:00
Cargo.lock Complete log stream implementation 2023-06-03 19:03:58 -04:00
Cargo.toml Complete log stream implementation 2023-06-03 19:03:58 -04:00
drop_all.psql Make titles optional on feeds and entries 2023-05-17 23:10:23 -04:00
README.md Add /log page that displays server log 2023-06-03 01:09:25 -04:00

README.md

crawlnicle

My personalized news and blog aggregator. Taking back control over the algorithm. Pining for the days of Google Reader. An excuse to write more Rust.

Development Install

  1. Install and run postgres.
  2. Create postgres user and database:
createuser crawlnicle
createdb crawlnicle
sudo -u postgres -i psql
postgres=# ALTER DATABASE crawlnicle OWNER TO crawlnicle;
\password crawlnicle

# Or, on Windows in PowerShell:

& 'C:\Program Files\PostgreSQL\13\bin\createuser.exe' -U postgres crawlnicle
& 'C:\Program Files\PostgreSQL\13\bin\createdb.exe' -U postgres crawlnicle
& 'C:\Program Files\PostgreSQL\13\bin\psql.exe' -U postgres
postgres=# ALTER DATABASE crawlnicle OWNER TO crawlnicle;
\password crawlnicle
  1. Save password somewhere safe and then and add a .env file to the project directory with the contents:
RUST_LOG=crawlnicle=debug,cli=debug,lib=debug,tower_http=debug,sqlx=debug
HOST=127.0.0.1
PORT=3000
DATABASE_URL=postgresql://crawlnicle:<password>@localhost/crawlnicle
DATABASE_MAX_CONNECTIONS=5
TITLE=crawlnicle
MAX_MEM_LOG_SIZE=1000000
  1. Install sqlx_cli with cargo install sqlx-cli --no-default-features --features native-tls,postgres
  2. Run sqlx migrate run which will run all the database migrations.
  3. Build the release binary by running cargo build --release.
  4. Run ./target/build/crawlnicle to start the server.

Using the CLI

This project also comes with a CLI binary which allows you to manipulate the database directly without needing to go through the REST API server. Run ./target/build/cli --help to see all of the available commands.

Running jobs

To periodically fetch new items from all of the feeds execute the cli crawl command in a cronjob.