Add schema.graphql

Author: zsl-abyss

README.md

@@ -29,3 +29,14 @@ Here is the list of commits in chronological order:
 [`f9a4d26`](https://github.com/zdzislaw-s/howtographql/commit/f9a4d269abd92fe9bd389fc640c34edfdad15540)` Filter Links`  
 [`8d8a278`](https://github.com/zdzislaw-s/howtographql/commit/8d8a2788d5752bf9e842a70d9da775e5aac2dc54)` Paginate Links`  
 [`662d31f`](https://github.com/zdzislaw-s/howtographql/commit/662d31fd237320edc1bde7fd9c7499857008a8cd)` Fix missed s/Vote/VoteModel/`  
+
+## schema.graphql
+
+The [`schema.graphql`](hackernews/schema.graphql) file was created with the following procedure:
+
+```python
+>>> import hackernews.wsgi
+>>> from hackernews.schema import schema
+>>> with open("schema.graphql", "w") as fo:
+...   fo.write(str(schema))
+```

hackernews/hackernews/schema.py

@@ -1,9 +1,12 @@
+from graphql import GraphQLError
 import graphene
-import graphql_jwt
+
+from graphql_jwt import ObtainJSONWebToken as ObtainToken
+from graphql_jwt import Verify as VerifyToken
+from graphql_jwt import Refresh as RefreshToken
 from graphene_django import DjangoObjectType
 from django.contrib.auth import get_user_model
 from django.db.models import Q
-from graphql import GraphQLError
 
 from links.models import Link as LinkModel
 from links.models import Vote as VoteModel
@@ -34,7 +37,7 @@ class Arguments:
         url = graphene.String()
         description = graphene.String()
 
-    def mutate(self, info, url, description):
+    def mutate(parent, info, url, description):
         user = info.context.user
         if user.is_anonymous:
             raise GraphQLError("Anonymous users can't create links!")
@@ -56,7 +59,7 @@ class CreateVote(graphene.Mutation):
     class Arguments:
         linkId = graphene.Int()
 
-    def mutate(self, info, linkId):
+    def mutate(parent, info, linkId):
         user = info.context.user
         if user.is_anonymous:
             raise GraphQLError("You must be logged in to vote!")
@@ -77,7 +80,7 @@ class Arguments:
         password = graphene.String(required=True)
         email = graphene.String(required=True)
 
-    def mutate(self, info, username, password, email):
+    def mutate(parent, info, username, password, email):
         user = get_user_model()(
             username=username,
             email=email,
@@ -89,9 +92,9 @@ def mutate(self, info, username, password, email):
 
 
 class Mutation(graphene.ObjectType):
-    obtainToken = graphql_jwt.ObtainJSONWebToken.Field()
-    verifyToken = graphql_jwt.Verify.Field()
-    refreshToken = graphql_jwt.Refresh.Field()
+    obtainToken = ObtainToken.Field()
+    verifyToken = VerifyToken.Field()
+    refreshToken = RefreshToken.Field()
     createLink = CreateLink.Field()
     createVote = CreateVote.Field()
     createUser = CreateUser.Field()
@@ -105,7 +108,7 @@ class Query(graphene.ObjectType):
     users = graphene.List(User)
     whoami = graphene.Field(User)
 
-    def resolve_links(self, info, search=None, first=None, skip=None, **kwargs):
+    def resolve_links(parent, info, search=None, first=None, skip=None, **kwargs):
         objects = LinkModel.objects
         qs = []
         if search is None:
@@ -122,13 +125,13 @@ def resolve_links(self, info, search=None, first=None, skip=None, **kwargs):
 
         return qs
 
-    def resolve_votes(self, info, **kwargs):
+    def resolve_votes(parent, info, **kwargs):
         return VoteModel.objects.all()
 
-    def resolve_users(self, info):
+    def resolve_users(parent, info):
         return get_user_model().objects.all()
 
-    def resolve_whoami(self, info):
+    def resolve_whoami(parent, info):
         user = info.context.user
         if user.is_anonymous:
             raise GraphQLError("Not logged in!")

hackernews/schema.graphql

@@ -0,0 +1,83 @@
+schema {
+  query: Query
+  mutation: Mutation
+}
+
+type CreateLink {
+  id: Int
+  url: String
+  description: String
+  postedBy: User
+}
+
+type CreateUser {
+  user: User
+}
+
+type CreateVote {
+  user: User
+  link: Link
+}
+
+scalar DateTime
+
+scalar GenericScalar
+
+type Link {
+  id: ID!
+  url: String!
+  description: String!
+  postedBy: User
+  votes: [Vote]
+}
+
+type Mutation {
+  obtainToken(username: String!, password: String!): ObtainJSONWebToken
+  verifyToken(token: String): Verify
+  refreshToken(token: String): Refresh
+  createLink(description: String, url: String): CreateLink
+  createVote(linkId: Int): CreateVote
+  createUser(email: String!, password: String!, username: String!): CreateUser
+}
+
+type ObtainJSONWebToken {
+  token: String
+}
+
+type Query {
+  links(search: String, first: Int, skip: Int): [Link]
+  votes: [Vote]
+  users: [User]
+  whoami: User
+}
+
+type Refresh {
+  token: String
+  payload: GenericScalar
+}
+
+type User {
+  id: ID!
+  password: String!
+  lastLogin: DateTime
+  isSuperuser: Boolean!
+  username: String!
+  firstName: String!
+  lastName: String!
+  email: String!
+  isStaff: Boolean!
+  isActive: Boolean!
+  dateJoined: DateTime!
+  linkSet: [Link]
+  voteSet: [Vote]
+}
+
+type Verify {
+  payload: GenericScalar
+}
+
+type Vote {
+  id: ID!
+  user: User!
+  link: Link!
+}