+
+
{children}
diff --git a/website/lib/posts.js b/website/lib/posts.js
index 408bbe03..0cc6bf00 100644
--- a/website/lib/posts.js
+++ b/website/lib/posts.js
@@ -1,45 +1,53 @@
-import fs from 'fs'
-import { join } from 'path'
-import matter from 'gray-matter'
+import fs from "fs";
+import { join } from "path";
+import matter from "gray-matter";
-const postsDirectory = join(process.cwd(), './posts')
+const postsDirectory = join(process.cwd(), "./posts");
export function getPostSlugs() {
- return fs.readdirSync(postsDirectory)
+ return [
+ "start",
+ "query",
+ "insert",
+ "update",
+ "subscribe",
+ "specials",
+ "cheatsheet",
+ "nodejs",
+ "go",
+ "service",
+ "faq",
+ ];
}
export function getPostBySlug(slug, fields = []) {
- const realSlug = slug.replace(/\.md$/, '')
- const fullPath = join(postsDirectory, `${realSlug}.md`)
- const fileContents = fs.readFileSync(fullPath, 'utf8')
- const { data, content, chapter } = matter(fileContents)
+ const fullPath = join(postsDirectory, `${slug}.md`);
+ const fileContents = fs.readFileSync(fullPath, "utf8");
+ const { data, content, chapter } = matter(fileContents);
- const items = new Map()
+ const items = new Map();
// Ensure only the minimal needed data is exposed
fields.forEach((field) => {
- if (field === 'slug') {
- items.set(field, realSlug)
+ if (field === "slug") {
+ items.set(field, slug);
+ } else if (field === "content") {
+ items.set(field, content);
+ } else if (typeof data[field] !== "undefined") {
+ items.set(field, data[field]);
}
- else if (field === 'content') {
- items.set(field, content)
- }
- else if (typeof data[field] !== 'undefined') {
- items.set(field, data[field])
- }
- })
- return Object.fromEntries(items)
+ });
+ return Object.fromEntries(items);
}
export function getAllPosts(fields = []) {
- const slugs = getPostSlugs()
+ const slugs = getPostSlugs();
- return slugs
- .map((slug) => getPostBySlug(slug, ['chapter', ...fields]))
- // sort posts by date in descending order
- .sort(sortPosts)
+ return slugs.map((slug) => getPostBySlug(slug, ["chapter", ...fields]));
+ // sort posts by date in descending order
+ // .sort(sortPosts)
}
-function sortPosts(a, b) {
- return a.chapter > b.chapter ? 1 : -1
-}
\ No newline at end of file
+// function sortPosts(a, b) {
+// return a.chapter > b.chapter ? 1 : -1;
+// }
diff --git a/website/package.json b/website/package.json
index 24c32ccd..7927f197 100644
--- a/website/package.json
+++ b/website/package.json
@@ -13,9 +13,9 @@
"@remark-embedder/transformer-oembed": "^3.0.0",
"gray-matter": "^4.0.3",
"hastscript": "^7.1.0",
- "next": "12.3.1",
- "react": "18.2.0",
- "react-dom": "18.2.0",
+ "next": "^13.1.6",
+ "react": "^18.2.0",
+ "react-dom": "^18.2.0",
"react-icons": "^4.6.0",
"react-twitter-embed": "^4.0.4",
"rehype-autolink-headings": "^6.1.1",
@@ -38,7 +38,7 @@
"@tailwindcss/typography": "^0.5.8",
"autoprefixer": "^10.4.12",
"eslint": "8.25.0",
- "eslint-config-next": "12.3.1",
+ "eslint-config-next": "^13.1.6",
"postcss": "^8.4.18",
"tailwindcss": "^3.2.1"
}
diff --git a/website/pages/posts/[slug].js b/website/pages/posts/[slug].js
index 8ac9abc6..903a6987 100644
--- a/website/pages/posts/[slug].js
+++ b/website/pages/posts/[slug].js
@@ -30,8 +30,8 @@ const Nav = ({ post }) => (
const NavButton = ({ post, label }) => (
-
-
{label}
+
diff --git a/website/posts/7-cheatsheet.md b/website/posts/cheatsheet.md
similarity index 100%
rename from website/posts/7-cheatsheet.md
rename to website/posts/cheatsheet.md
diff --git a/website/posts/11-faq.md b/website/posts/faq.md
similarity index 94%
rename from website/posts/11-faq.md
rename to website/posts/faq.md
index 5afb4d0c..8c9da16d 100644
--- a/website/posts/11-faq.md
+++ b/website/posts/faq.md
@@ -8,7 +8,7 @@ description: Frequently asked questions
### Is it production ready?
-Yes, before its release into the NodeJS ecosystem it has been a popular library in the GO ecosystem used in several projects. GraphJin has a large library of integration tests that covers all its usecases with Postgres and MySQL and detection of data races. This test framework is run on every commit to ensure high code quality. It also earns an A+ in the GO [code quality report](https://goreportcard.com/report/github.com/dosco/graphjin/v2). It has minimum dependencies on other GO libraries and is Fuzz tests.
+Yes, before its release into the NodeJS ecosystem it has been a popular library in the GO ecosystem used in several projects. GraphJin has a large library of integration tests that covers all its usecases with Postgres and MySQL and detection of data races. This test framework is run on every commit to ensure high code quality. It also earns an A+ in the GO [code quality report](https://goreportcard.com/report/github.com/dosco/graphjin/core/v3). It has minimum dependencies on other GO libraries and is Fuzz tests.
### Why not just use SQL?
diff --git a/website/posts/10-go.md b/website/posts/go.md
similarity index 74%
rename from website/posts/10-go.md
rename to website/posts/go.md
index 0745b71b..6fcc14cc 100644
--- a/website/posts/10-go.md
+++ b/website/posts/go.md
@@ -57,7 +57,7 @@ func main() {
Add Graphjin to your GO application.
```shell
-go get github.com/dosco/graphjin/v2
+go get github.com/dosco/graphjin/core/v3
```
@@ -77,7 +77,7 @@ config := core.Config{ Production: true, DefaultLimit: 50 }
### Using GraphJin
```go
-import "github.com/dosco/graphjin/core/v2"
+import "github.com/dosco/graphjin/core/v3"
// config can be read in from a file
config, err := NewConfig("./config", "dev.yml")
@@ -246,3 +246,65 @@ for {
}
}
```
+
+### Using the service
+
+GraphJin has two packages `core` whih contains the core compiler and `serv` which contains the standalone service. One way to not have to build your own service and get the flexibility of using your own app is to use the `serv` package with your own code. This also means that you get cache headers (etags), compression, rate limiting all of this good stuff for free. The following http and websocket handlers are exposed for you to use:
+
+```go title="GraphQL HTTP/Websocket Handler"
+gjs.GraphQL(nil)
+```
+
+```go title="REST HTTP/Websocket Handler"
+ gjs.REST(nil)
+```
+
+```go title="Embed the Web UI"
+gjs.WebUI("/webui/", "/graphql")
+```
+
+Below is an example app to see how all this comes together.
+
+```go
+import (
+ "log"
+ "net/http"
+ "path/filepath"
+
+ "github.com/dosco/graphjin/serv/v3"
+ "github.com/go-chi/chi/v5"
+)
+
+func main() {
+ // create the router
+ r := chi.NewRouter()
+
+ // readin graphjin config
+ conf, err := serv.ReadInConfig(filepath.Join("./config", "dev.yml"))
+ if err != nil {
+ panic(err)
+ }
+
+ // create the graphjin service
+ gjs, err := serv.NewGraphJinService(conf)
+ if err != nil {
+ log.Fatal(err)
+ }
+
+ // attach the graphql http handler
+ r.Handle("/graphql", gjs.GraphQL(nil))
+
+ // attach the rest http handler
+ r.Handle("/rest/*", gjs.REST(nil))
+
+ // attach the webui http handler
+ r.Handle("/webui/*", gjs.WebUI("/webui/", "/graphql"))
+
+ // add your own http handlers
+ r.Get("/", func(w http.ResponseWriter, r *http.Request) {
+ w.Write([]byte("Welcome to the webshop!"))
+ })
+
+ http.ListenAndServe(":8080", r)
+}
+```
diff --git a/website/posts/3-insert.md b/website/posts/insert.md
similarity index 100%
rename from website/posts/3-insert.md
rename to website/posts/insert.md
diff --git a/website/posts/9-nodejs.md b/website/posts/nodejs.md
similarity index 100%
rename from website/posts/9-nodejs.md
rename to website/posts/nodejs.md
diff --git a/website/posts/2-query.md b/website/posts/query.md
similarity index 100%
rename from website/posts/2-query.md
rename to website/posts/query.md
diff --git a/website/posts/8-service.md b/website/posts/service.md
similarity index 100%
rename from website/posts/8-service.md
rename to website/posts/service.md
diff --git a/website/posts/6-specials.md b/website/posts/specials.md
similarity index 100%
rename from website/posts/6-specials.md
rename to website/posts/specials.md
diff --git a/website/posts/1-start.md b/website/posts/start.md
similarity index 100%
rename from website/posts/1-start.md
rename to website/posts/start.md
diff --git a/website/posts/5-subscribe.md b/website/posts/subscribe.md
similarity index 100%
rename from website/posts/5-subscribe.md
rename to website/posts/subscribe.md
diff --git a/website/posts/4-update.md b/website/posts/update.md
similarity index 100%
rename from website/posts/4-update.md
rename to website/posts/update.md