104 lines
4.2 KiB
Raw Permalink Normal View History

2023-07-11 22:57:08 +02:00
@name .
2020-05-16 01:10:11 +02:00
2023-07-11 22:57:08 +02:00
## Overview
2020-05-16 01:10:11 +02:00
This repository contains the source code to a pastebin clone. It was made after
concerns with taking down certain kinds of content. SMR aims to
be small, fast, and secure. It is built on top of [Kore](, using
[luajit]( to expose a Lua programming environment. It uses
2021-02-22 08:46:57 +01:00
[sqlite3]( as it's database. SMR is implemented in about
5k SLOC. Contributions welcome.
2022-11-21 01:32:49 +01:00
2023-07-11 22:57:08 +02:00
C/C++ Header|4|3|0|48
## Roadmap
* Accounts (complete)
* Comments (complete)
2020-10-12 02:01:03 +02:00
* Tags (complete)
2020-12-29 20:13:33 +01:00
* Search (complete)
2022-11-21 01:32:49 +01:00
* Archive (complete)
* Author biographies (complete)
* Kore 4.2.0 (complete)
* addon api
2021-01-11 04:35:25 +01:00
2022-11-21 01:32:49 +01:00
* Currently, people can post comments to unlisted stories even if they don't have
2021-01-11 04:35:25 +01:00
the correct link.
2022-11-21 01:32:49 +01:00
* Find a replacement preprocessor
* The archive is currently generated weekly from a cron job, and served
syncronously. We can generate a zip file on-the-fly instead, and if the client
disconnects, it's fine to drop the whole thing.
* We can simplify a lot of error handling logic by setting sql prepared statements to reset during error unwinding.
* We can simplify a lot of business logic by having requests parse their parameters eagerly.
2021-01-11 04:35:25 +01:00
## Hacking
If you want to contribute to this repository:
2020-12-23 08:14:56 +01:00
1. Install the [kore webserver]( -> installation)
2. Use a `kodev create smr` to create a blank kore application
3. Install Lua and Luarocks from your package manager
4. Use Luarocks to install the following dependencies (`luarocks install <package>`)
* etlua - Lua templating, comparable to Jinja for Python
* lpeg - Parsing Expression Grammers, used to build text parsers
* lsqlite3 - Sqlite3 for Lua, a lightweight database
* lua-zlib - Data compression
5. You may need to modify conf/build.conf, I use Lua 5.1 on my development machine,
but everything should still work with later versions.
2021-01-04 04:05:50 +01:00
6. Install [spp](
7. Clone this repository into the smr folder, cd into the root, and run `make`!
2022-02-20 01:21:50 +01:00
* You may need to modify the configuration in the Makefile, add `` to your `/etc/hosts`, modify command invocation, ect.
2023-07-11 22:57:08 +02:00
## Folder layout
While the core business logic of SMR is kept under 5k SLOC, tests, documentation,
and other resources exceed this limit. The following is an explanation of what
goes where:
assets/ - kore assets, compiled into the binary. Javascript and CSS are kept here.
cert/ - kore certificates. This is a default to get you started, but in production you should set certificates appropriately.
conf/ - kore configuration. See
doc/ - documentation for smr that doesn't belong to any particular file
kore_chroot/ - a chroot to get you started modifying smr. In production this should be a properly configured chroot
packaging/ - scripts for packaging smr for different systems
spec/ - unit and system tests for smr
src/ - all the business logic of smr
lua/ - Lua shared code between endpoints
endpoints/ - 1-per endpoint business logic
pages/ - Etlua templated html, exposed from src/lua/pages.lua
sql/ - Sqlite queries, exposed from src/lua/queries.lua
tools/ - command line tools for working with the smr database
accounts/ - tool for modifying author accounts
archive/ - tool for generating archives of the site (NOT the same as backups)
migrate/ - tool for migrating/upgrading the smr database
2022-02-20 01:21:50 +01:00
## Misc. notes
SMR requires a slightly modified version of Kore to run. See [my kore patches](
for the changes I needed to make to get the JIT compiler playing nice with
Kore's seccomp restrictions. There are a few other changes, like modified kore
to accept any text as input for things like file upload.
2021-01-04 04:05:50 +01:00
**UPDATE (12/18/2020)**
2021-01-04 04:05:50 +01:00
Kore 4.0 no longer needs the seccomp changes, as those have been exposed to
library users, and smr has been updated appropriately. It still needs the
allow-multiline-input patch though.