Skip to content

YiNNx/plainly-rusty

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

48 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

plainly-rusty

It originally started as a straightforward, almost boring backend rewrite project, for my old blog backend. However, as I delved into learning Rust and explored Rust crates associated with web development, it turned to an exploratory venture.

Features

  • The whole project is based on the Seaography and the code framework generated from its cli, with dynamic-schema async-graphql as the GraghQL library, Actix as the web framework, and SeaORM & Postgres as the ORM & database, providing rich and flexible GraphQL query (nested relation, pagination, filtering, ordering, etc.)
  • Implement permission control through a custom guard system and a custom resolver registration system.
  • Use GitHub OAuth2 for authentication, and avoid the burden of building any user system while designing data schema, just using stateless JWT.

How to Run

  1. Set the postgres and import the schema with scripts/plainly_rusty_create.sql

    psql -q {postgres_url} < scripts/plainly-rusty-schema.sql
  2. Modify or replace the default configuration file, configs/default.toml.

  3. Run with env variables:

    RUST_LOG={log_level} CONFIG_FILE={file_path} cargo run

    Or use Docker:

    export POSTGRES_PASSWORD={pwd} RUST_LOG={level} CONFIG_FILE={file_path} IMAGE_VERSION={version} 
    
    cargo build --release --target x86_64-unknown-linux-musl
    
    docker build -f deploy/build/Dockerfile . -t plainlyrusty:${IMAGE_VERSION} 
    docker compose -f deploy/docker-compose.yml up

Query Sample

query Posts {
  posts(
    filters: { status: { eq: PUBLIC } }
    orderBy: { time: ASC }
    pagination: { offset: { limit: 10, offset: 0 } }
  ) {
    nodes {
      id
      title
      time
      content
      summary
      comments(
        orderBy: { time: ASC }
        pagination: { offset: { limit: 2, offset: 0 } }
      ) {
        nodes {
          parentId
          githubId
          time
          content
        }
      }
      tags(orderBy: { name: ASC }) {
        nodes {
          name
        }
      }
    }
  }
}

On the GraphQL Playground:

screenshot

About

Plainly a blog back-end with dynamic GraphQL

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages