// Copyright 2019-present Facebook Inc. All rights reserved. // This source code is licensed under the Apache 2.0 license found // in the LICENSE file in the root directory of this source tree. // Code generated by ent, DO NOT EDIT. package ent import ( "context" "fmt" "math" "entgo.io/ent" "entgo.io/ent/dialect/gremlin" "entgo.io/ent/dialect/gremlin/graph/dsl" "entgo.io/ent/dialect/gremlin/graph/dsl/__" "entgo.io/ent/dialect/gremlin/graph/dsl/g" "entgo.io/ent/entc/integration/gremlin/ent/predicate" "entgo.io/ent/entc/integration/gremlin/ent/user" ) // UserQuery is the builder for querying User entities. type UserQuery struct { config ctx *QueryContext order []user.OrderOption inters []Interceptor predicates []predicate.User withCard *CardQuery withPets *PetQuery withFiles *FileQuery withGroups *GroupQuery withFriends *UserQuery withFollowers *UserQuery withFollowing *UserQuery withTeam *PetQuery withSpouse *UserQuery withChildren *UserQuery withParent *UserQuery // intermediate query (i.e. traversal path). gremlin *dsl.Traversal path func(context.Context) (*dsl.Traversal, error) } // Where adds a new predicate for the UserQuery builder. func (_q *UserQuery) Where(ps ...predicate.User) *UserQuery { _q.predicates = append(_q.predicates, ps...) return _q } // Limit the number of records to be returned by this query. func (_q *UserQuery) Limit(limit int) *UserQuery { _q.ctx.Limit = &limit return _q } // Offset to start from. func (_q *UserQuery) Offset(offset int) *UserQuery { _q.ctx.Offset = &offset return _q } // Unique configures the query builder to filter duplicate records on query. // By default, unique is set to true, and can be disabled using this method. func (_q *UserQuery) Unique(unique bool) *UserQuery { _q.ctx.Unique = &unique return _q } // Order specifies how the records should be ordered. func (_q *UserQuery) Order(o ...user.OrderOption) *UserQuery { _q.order = append(_q.order, o...) return _q } // QueryCard chains the current query on the "card" edge. func (_q *UserQuery) QueryCard() *CardQuery { query := (&CardClient{config: _q.config}).Query() query.path = func(ctx context.Context) (fromU *dsl.Traversal, err error) { if err := _q.prepareQuery(ctx); err != nil { return nil, err } gremlin := _q.gremlinQuery(ctx) fromU = gremlin.OutE(user.CardLabel).InV() return fromU, nil } return query } // QueryPets chains the current query on the "pets" edge. func (_q *UserQuery) QueryPets() *PetQuery { query := (&PetClient{config: _q.config}).Query() query.path = func(ctx context.Context) (fromU *dsl.Traversal, err error) { if err := _q.prepareQuery(ctx); err != nil { return nil, err } gremlin := _q.gremlinQuery(ctx) fromU = gremlin.OutE(user.PetsLabel).InV() return fromU, nil } return query } // QueryFiles chains the current query on the "files" edge. func (_q *UserQuery) QueryFiles() *FileQuery { query := (&FileClient{config: _q.config}).Query() query.path = func(ctx context.Context) (fromU *dsl.Traversal, err error) { if err := _q.prepareQuery(ctx); err != nil { return nil, err } gremlin := _q.gremlinQuery(ctx) fromU = gremlin.OutE(user.FilesLabel).InV() return fromU, nil } return query } // QueryGroups chains the current query on the "groups" edge. func (_q *UserQuery) QueryGroups() *GroupQuery { query := (&GroupClient{config: _q.config}).Query() query.path = func(ctx context.Context) (fromU *dsl.Traversal, err error) { if err := _q.prepareQuery(ctx); err != nil { return nil, err } gremlin := _q.gremlinQuery(ctx) fromU = gremlin.OutE(user.GroupsLabel).InV() return fromU, nil } return query } // QueryFriends chains the current query on the "friends" edge. func (_q *UserQuery) QueryFriends() *UserQuery { query := (&UserClient{config: _q.config}).Query() query.path = func(ctx context.Context) (fromU *dsl.Traversal, err error) { if err := _q.prepareQuery(ctx); err != nil { return nil, err } gremlin := _q.gremlinQuery(ctx) fromU = gremlin.Both(user.FriendsLabel) return fromU, nil } return query } // QueryFollowers chains the current query on the "followers" edge. func (_q *UserQuery) QueryFollowers() *UserQuery { query := (&UserClient{config: _q.config}).Query() query.path = func(ctx context.Context) (fromU *dsl.Traversal, err error) { if err := _q.prepareQuery(ctx); err != nil { return nil, err } gremlin := _q.gremlinQuery(ctx) fromU = gremlin.InE(user.FollowingLabel).OutV() return fromU, nil } return query } // QueryFollowing chains the current query on the "following" edge. func (_q *UserQuery) QueryFollowing() *UserQuery { query := (&UserClient{config: _q.config}).Query() query.path = func(ctx context.Context) (fromU *dsl.Traversal, err error) { if err := _q.prepareQuery(ctx); err != nil { return nil, err } gremlin := _q.gremlinQuery(ctx) fromU = gremlin.OutE(user.FollowingLabel).InV() return fromU, nil } return query } // QueryTeam chains the current query on the "team" edge. func (_q *UserQuery) QueryTeam() *PetQuery { query := (&PetClient{config: _q.config}).Query() query.path = func(ctx context.Context) (fromU *dsl.Traversal, err error) { if err := _q.prepareQuery(ctx); err != nil { return nil, err } gremlin := _q.gremlinQuery(ctx) fromU = gremlin.OutE(user.TeamLabel).InV() return fromU, nil } return query } // QuerySpouse chains the current query on the "spouse" edge. func (_q *UserQuery) QuerySpouse() *UserQuery { query := (&UserClient{config: _q.config}).Query() query.path = func(ctx context.Context) (fromU *dsl.Traversal, err error) { if err := _q.prepareQuery(ctx); err != nil { return nil, err } gremlin := _q.gremlinQuery(ctx) fromU = gremlin.Both(user.SpouseLabel) return fromU, nil } return query } // QueryChildren chains the current query on the "children" edge. func (_q *UserQuery) QueryChildren() *UserQuery { query := (&UserClient{config: _q.config}).Query() query.path = func(ctx context.Context) (fromU *dsl.Traversal, err error) { if err := _q.prepareQuery(ctx); err != nil { return nil, err } gremlin := _q.gremlinQuery(ctx) fromU = gremlin.InE(user.ParentLabel).OutV() return fromU, nil } return query } // QueryParent chains the current query on the "parent" edge. func (_q *UserQuery) QueryParent() *UserQuery { query := (&UserClient{config: _q.config}).Query() query.path = func(ctx context.Context) (fromU *dsl.Traversal, err error) { if err := _q.prepareQuery(ctx); err != nil { return nil, err } gremlin := _q.gremlinQuery(ctx) fromU = gremlin.OutE(user.ParentLabel).InV() return fromU, nil } return query } // First returns the first User entity from the query. // Returns a *NotFoundError when no User was found. func (_q *UserQuery) First(ctx context.Context) (*User, error) { nodes, err := _q.Limit(1).All(setContextOp(ctx, _q.ctx, ent.OpQueryFirst)) if err != nil { return nil, err } if len(nodes) == 0 { return nil, &NotFoundError{user.Label} } return nodes[0], nil } // FirstX is like First, but panics if an error occurs. func (_q *UserQuery) FirstX(ctx context.Context) *User { node, err := _q.First(ctx) if err != nil && !IsNotFound(err) { panic(err) } return node } // FirstID returns the first User ID from the query. // Returns a *NotFoundError when no User ID was found. func (_q *UserQuery) FirstID(ctx context.Context) (id string, err error) { var ids []string if ids, err = _q.Limit(1).IDs(setContextOp(ctx, _q.ctx, ent.OpQueryFirstID)); err != nil { return } if len(ids) == 0 { err = &NotFoundError{user.Label} return } return ids[0], nil } // FirstIDX is like FirstID, but panics if an error occurs. func (_q *UserQuery) FirstIDX(ctx context.Context) string { id, err := _q.FirstID(ctx) if err != nil && !IsNotFound(err) { panic(err) } return id } // Only returns a single User entity found by the query, ensuring it only returns one. // Returns a *NotSingularError when more than one User entity is found. // Returns a *NotFoundError when no User entities are found. func (_q *UserQuery) Only(ctx context.Context) (*User, error) { nodes, err := _q.Limit(2).All(setContextOp(ctx, _q.ctx, ent.OpQueryOnly)) if err != nil { return nil, err } switch len(nodes) { case 1: return nodes[0], nil case 0: return nil, &NotFoundError{user.Label} default: return nil, &NotSingularError{user.Label} } } // OnlyX is like Only, but panics if an error occurs. func (_q *UserQuery) OnlyX(ctx context.Context) *User { node, err := _q.Only(ctx) if err != nil { panic(err) } return node } // OnlyID is like Only, but returns the only User ID in the query. // Returns a *NotSingularError when more than one User ID is found. // Returns a *NotFoundError when no entities are found. func (_q *UserQuery) OnlyID(ctx context.Context) (id string, err error) { var ids []string if ids, err = _q.Limit(2).IDs(setContextOp(ctx, _q.ctx, ent.OpQueryOnlyID)); err != nil { return } switch len(ids) { case 1: id = ids[0] case 0: err = &NotFoundError{user.Label} default: err = &NotSingularError{user.Label} } return } // OnlyIDX is like OnlyID, but panics if an error occurs. func (_q *UserQuery) OnlyIDX(ctx context.Context) string { id, err := _q.OnlyID(ctx) if err != nil { panic(err) } return id } // All executes the query and returns a list of Users. func (_q *UserQuery) All(ctx context.Context) ([]*User, error) { ctx = setContextOp(ctx, _q.ctx, ent.OpQueryAll) if err := _q.prepareQuery(ctx); err != nil { return nil, err } qr := querierAll[[]*User, *UserQuery]() return withInterceptors[[]*User](ctx, _q, qr, _q.inters) } // AllX is like All, but panics if an error occurs. func (_q *UserQuery) AllX(ctx context.Context) []*User { nodes, err := _q.All(ctx) if err != nil { panic(err) } return nodes } // IDs executes the query and returns a list of User IDs. func (_q *UserQuery) IDs(ctx context.Context) (ids []string, err error) { if _q.ctx.Unique == nil && _q.path != nil { _q.Unique(true) } ctx = setContextOp(ctx, _q.ctx, ent.OpQueryIDs) if err = _q.Select(user.FieldID).Scan(ctx, &ids); err != nil { return nil, err } return ids, nil } // IDsX is like IDs, but panics if an error occurs. func (_q *UserQuery) IDsX(ctx context.Context) []string { ids, err := _q.IDs(ctx) if err != nil { panic(err) } return ids } // Count returns the count of the given query. func (_q *UserQuery) Count(ctx context.Context) (int, error) { ctx = setContextOp(ctx, _q.ctx, ent.OpQueryCount) if err := _q.prepareQuery(ctx); err != nil { return 0, err } return withInterceptors[int](ctx, _q, querierCount[*UserQuery](), _q.inters) } // CountX is like Count, but panics if an error occurs. func (_q *UserQuery) CountX(ctx context.Context) int { count, err := _q.Count(ctx) if err != nil { panic(err) } return count } // Exist returns true if the query has elements in the graph. func (_q *UserQuery) Exist(ctx context.Context) (bool, error) { ctx = setContextOp(ctx, _q.ctx, ent.OpQueryExist) switch _, err := _q.FirstID(ctx); { case IsNotFound(err): return false, nil case err != nil: return false, fmt.Errorf("ent: check existence: %w", err) default: return true, nil } } // ExistX is like Exist, but panics if an error occurs. func (_q *UserQuery) ExistX(ctx context.Context) bool { exist, err := _q.Exist(ctx) if err != nil { panic(err) } return exist } // Clone returns a duplicate of the UserQuery builder, including all associated steps. It can be // used to prepare common query builders and use them differently after the clone is made. func (_q *UserQuery) Clone() *UserQuery { if _q == nil { return nil } return &UserQuery{ config: _q.config, ctx: _q.ctx.Clone(), order: append([]user.OrderOption{}, _q.order...), inters: append([]Interceptor{}, _q.inters...), predicates: append([]predicate.User{}, _q.predicates...), withCard: _q.withCard.Clone(), withPets: _q.withPets.Clone(), withFiles: _q.withFiles.Clone(), withGroups: _q.withGroups.Clone(), withFriends: _q.withFriends.Clone(), withFollowers: _q.withFollowers.Clone(), withFollowing: _q.withFollowing.Clone(), withTeam: _q.withTeam.Clone(), withSpouse: _q.withSpouse.Clone(), withChildren: _q.withChildren.Clone(), withParent: _q.withParent.Clone(), // clone intermediate query. gremlin: _q.gremlin.Clone(), path: _q.path, } } // WithCard tells the query-builder to eager-load the nodes that are connected to // the "card" edge. The optional arguments are used to configure the query builder of the edge. func (_q *UserQuery) WithCard(opts ...func(*CardQuery)) *UserQuery { query := (&CardClient{config: _q.config}).Query() for _, opt := range opts { opt(query) } _q.withCard = query return _q } // WithPets tells the query-builder to eager-load the nodes that are connected to // the "pets" edge. The optional arguments are used to configure the query builder of the edge. func (_q *UserQuery) WithPets(opts ...func(*PetQuery)) *UserQuery { query := (&PetClient{config: _q.config}).Query() for _, opt := range opts { opt(query) } _q.withPets = query return _q } // WithFiles tells the query-builder to eager-load the nodes that are connected to // the "files" edge. The optional arguments are used to configure the query builder of the edge. func (_q *UserQuery) WithFiles(opts ...func(*FileQuery)) *UserQuery { query := (&FileClient{config: _q.config}).Query() for _, opt := range opts { opt(query) } _q.withFiles = query return _q } // WithGroups tells the query-builder to eager-load the nodes that are connected to // the "groups" edge. The optional arguments are used to configure the query builder of the edge. func (_q *UserQuery) WithGroups(opts ...func(*GroupQuery)) *UserQuery { query := (&GroupClient{config: _q.config}).Query() for _, opt := range opts { opt(query) } _q.withGroups = query return _q } // WithFriends tells the query-builder to eager-load the nodes that are connected to // the "friends" edge. The optional arguments are used to configure the query builder of the edge. func (_q *UserQuery) WithFriends(opts ...func(*UserQuery)) *UserQuery { query := (&UserClient{config: _q.config}).Query() for _, opt := range opts { opt(query) } _q.withFriends = query return _q } // WithFollowers tells the query-builder to eager-load the nodes that are connected to // the "followers" edge. The optional arguments are used to configure the query builder of the edge. func (_q *UserQuery) WithFollowers(opts ...func(*UserQuery)) *UserQuery { query := (&UserClient{config: _q.config}).Query() for _, opt := range opts { opt(query) } _q.withFollowers = query return _q } // WithFollowing tells the query-builder to eager-load the nodes that are connected to // the "following" edge. The optional arguments are used to configure the query builder of the edge. func (_q *UserQuery) WithFollowing(opts ...func(*UserQuery)) *UserQuery { query := (&UserClient{config: _q.config}).Query() for _, opt := range opts { opt(query) } _q.withFollowing = query return _q } // WithTeam tells the query-builder to eager-load the nodes that are connected to // the "team" edge. The optional arguments are used to configure the query builder of the edge. func (_q *UserQuery) WithTeam(opts ...func(*PetQuery)) *UserQuery { query := (&PetClient{config: _q.config}).Query() for _, opt := range opts { opt(query) } _q.withTeam = query return _q } // WithSpouse tells the query-builder to eager-load the nodes that are connected to // the "spouse" edge. The optional arguments are used to configure the query builder of the edge. func (_q *UserQuery) WithSpouse(opts ...func(*UserQuery)) *UserQuery { query := (&UserClient{config: _q.config}).Query() for _, opt := range opts { opt(query) } _q.withSpouse = query return _q } // WithChildren tells the query-builder to eager-load the nodes that are connected to // the "children" edge. The optional arguments are used to configure the query builder of the edge. func (_q *UserQuery) WithChildren(opts ...func(*UserQuery)) *UserQuery { query := (&UserClient{config: _q.config}).Query() for _, opt := range opts { opt(query) } _q.withChildren = query return _q } // WithParent tells the query-builder to eager-load the nodes that are connected to // the "parent" edge. The optional arguments are used to configure the query builder of the edge. func (_q *UserQuery) WithParent(opts ...func(*UserQuery)) *UserQuery { query := (&UserClient{config: _q.config}).Query() for _, opt := range opts { opt(query) } _q.withParent = query return _q } // GroupBy is used to group vertices by one or more fields/columns. // It is often used with aggregate functions, like: count, max, mean, min, sum. // // Example: // // var v []struct { // OptionalInt int `json:"optional_int,omitempty"` // Count int `json:"count,omitempty"` // } // // client.User.Query(). // GroupBy(user.FieldOptionalInt). // Aggregate(ent.Count()). // Scan(ctx, &v) func (_q *UserQuery) GroupBy(field string, fields ...string) *UserGroupBy { _q.ctx.Fields = append([]string{field}, fields...) grbuild := &UserGroupBy{build: _q} grbuild.flds = &_q.ctx.Fields grbuild.label = user.Label grbuild.scan = grbuild.Scan return grbuild } // Select allows the selection one or more fields/columns for the given query, // instead of selecting all fields in the entity. // // Example: // // var v []struct { // OptionalInt int `json:"optional_int,omitempty"` // } // // client.User.Query(). // Select(user.FieldOptionalInt). // Scan(ctx, &v) func (_q *UserQuery) Select(fields ...string) *UserSelect { _q.ctx.Fields = append(_q.ctx.Fields, fields...) sbuild := &UserSelect{UserQuery: _q} sbuild.label = user.Label sbuild.flds, sbuild.scan = &_q.ctx.Fields, sbuild.Scan return sbuild } // Aggregate returns a UserSelect configured with the given aggregations. func (_q *UserQuery) Aggregate(fns ...AggregateFunc) *UserSelect { return _q.Select().Aggregate(fns...) } func (_q *UserQuery) prepareQuery(ctx context.Context) error { for _, inter := range _q.inters { if inter == nil { return fmt.Errorf("ent: uninitialized interceptor (forgotten import ent/runtime?)") } if trv, ok := inter.(Traverser); ok { if err := trv.Traverse(ctx, _q); err != nil { return err } } } if _q.path != nil { prev, err := _q.path(ctx) if err != nil { return err } _q.gremlin = prev } return nil } func (_q *UserQuery) gremlinAll(ctx context.Context, hooks ...queryHook) ([]*User, error) { res := &gremlin.Response{} traversal := _q.gremlinQuery(ctx) if len(_q.ctx.Fields) > 0 { fields := make([]any, len(_q.ctx.Fields)) for i, f := range _q.ctx.Fields { fields[i] = f } traversal.ValueMap(fields...) } else { traversal.ValueMap(true) } query, bindings := traversal.Query() if err := _q.driver.Exec(ctx, query, bindings, res); err != nil { return nil, err } var _ms Users if err := _ms.FromResponse(res); err != nil { return nil, err } for i := range _ms { _ms[i].config = _q.config } return _ms, nil } func (_q *UserQuery) gremlinCount(ctx context.Context) (int, error) { res := &gremlin.Response{} query, bindings := _q.gremlinQuery(ctx).Count().Query() if err := _q.driver.Exec(ctx, query, bindings, res); err != nil { return 0, err } return res.ReadInt() } func (_q *UserQuery) gremlinQuery(context.Context) *dsl.Traversal { v := g.V().HasLabel(user.Label) if _q.gremlin != nil { v = _q.gremlin.Clone() } for _, p := range _q.predicates { p(v) } if len(_q.order) > 0 { v.Order() for _, p := range _q.order { p(v) } } switch limit, offset := _q.ctx.Limit, _q.ctx.Offset; { case limit != nil && offset != nil: v.Range(*offset, *offset+*limit) case offset != nil: v.Range(*offset, math.MaxInt32) case limit != nil: v.Limit(*limit) } if unique := _q.ctx.Unique; unique == nil || *unique { v.Dedup() } return v } // UserGroupBy is the group-by builder for User entities. type UserGroupBy struct { selector build *UserQuery } // Aggregate adds the given aggregation functions to the group-by query. func (_g *UserGroupBy) Aggregate(fns ...AggregateFunc) *UserGroupBy { _g.fns = append(_g.fns, fns...) return _g } // Scan applies the selector query and scans the result into the given value. func (_g *UserGroupBy) Scan(ctx context.Context, v any) error { ctx = setContextOp(ctx, _g.build.ctx, ent.OpQueryGroupBy) if err := _g.build.prepareQuery(ctx); err != nil { return err } return scanWithInterceptors[*UserQuery, *UserGroupBy](ctx, _g.build, _g, _g.build.inters, v) } func (_g *UserGroupBy) gremlinScan(ctx context.Context, root *UserQuery, v any) error { var ( trs []any names []any ) for _, fn := range _g.fns { name, tr := fn("p", "") trs = append(trs, tr) names = append(names, name) } for _, f := range *_g.flds { names = append(names, f) trs = append(trs, __.As("p").Unfold().Values(f).As(f)) } query, bindings := root.gremlinQuery(ctx).Group(). By(__.Values(*_g.flds...).Fold()). By(__.Fold().Match(trs...).Select(names...)). Select(dsl.Values). Next(). Query() res := &gremlin.Response{} if err := _g.build.driver.Exec(ctx, query, bindings, res); err != nil { return err } if len(*_g.flds)+len(_g.fns) == 1 { return res.ReadVal(v) } vm, err := res.ReadValueMap() if err != nil { return err } return vm.Decode(v) } // UserSelect is the builder for selecting fields of User entities. type UserSelect struct { *UserQuery selector } // Aggregate adds the given aggregation functions to the selector query. func (_s *UserSelect) Aggregate(fns ...AggregateFunc) *UserSelect { _s.fns = append(_s.fns, fns...) return _s } // Scan applies the selector query and scans the result into the given value. func (_s *UserSelect) Scan(ctx context.Context, v any) error { ctx = setContextOp(ctx, _s.ctx, ent.OpQuerySelect) if err := _s.prepareQuery(ctx); err != nil { return err } return scanWithInterceptors[*UserQuery, *UserSelect](ctx, _s.UserQuery, _s, _s.inters, v) } func (_s *UserSelect) gremlinScan(ctx context.Context, root *UserQuery, v any) error { var ( res = &gremlin.Response{} traversal = root.gremlinQuery(ctx) ) if fields := _s.ctx.Fields; len(fields) == 1 { if fields[0] != user.FieldID { traversal = traversal.Values(fields...) } else { traversal = traversal.ID() } } else { fields := make([]any, len(_s.ctx.Fields)) for i, f := range _s.ctx.Fields { fields[i] = f } traversal = traversal.ValueMap(fields...) } query, bindings := traversal.Query() if err := _s.driver.Exec(ctx, query, bindings, res); err != nil { return err } if len(root.ctx.Fields) == 1 { return res.ReadVal(v) } vm, err := res.ReadValueMap() if err != nil { return err } return vm.Decode(v) }