github.com/NpoolPlatform/chain-middleware@v0.0.0-20240228100535-eb1bcf896eb9/pkg/db/ent/coinbase_query.go (about)

     1  // Code generated by ent, DO NOT EDIT.
     2  
     3  package ent
     4  
     5  import (
     6  	"context"
     7  	"errors"
     8  	"fmt"
     9  	"math"
    10  
    11  	"entgo.io/ent/dialect"
    12  	"entgo.io/ent/dialect/sql"
    13  	"entgo.io/ent/dialect/sql/sqlgraph"
    14  	"entgo.io/ent/schema/field"
    15  	"github.com/NpoolPlatform/chain-middleware/pkg/db/ent/coinbase"
    16  	"github.com/NpoolPlatform/chain-middleware/pkg/db/ent/predicate"
    17  )
    18  
    19  // CoinBaseQuery is the builder for querying CoinBase entities.
    20  type CoinBaseQuery struct {
    21  	config
    22  	limit      *int
    23  	offset     *int
    24  	unique     *bool
    25  	order      []OrderFunc
    26  	fields     []string
    27  	predicates []predicate.CoinBase
    28  	modifiers  []func(*sql.Selector)
    29  	// intermediate query (i.e. traversal path).
    30  	sql  *sql.Selector
    31  	path func(context.Context) (*sql.Selector, error)
    32  }
    33  
    34  // Where adds a new predicate for the CoinBaseQuery builder.
    35  func (cbq *CoinBaseQuery) Where(ps ...predicate.CoinBase) *CoinBaseQuery {
    36  	cbq.predicates = append(cbq.predicates, ps...)
    37  	return cbq
    38  }
    39  
    40  // Limit adds a limit step to the query.
    41  func (cbq *CoinBaseQuery) Limit(limit int) *CoinBaseQuery {
    42  	cbq.limit = &limit
    43  	return cbq
    44  }
    45  
    46  // Offset adds an offset step to the query.
    47  func (cbq *CoinBaseQuery) Offset(offset int) *CoinBaseQuery {
    48  	cbq.offset = &offset
    49  	return cbq
    50  }
    51  
    52  // Unique configures the query builder to filter duplicate records on query.
    53  // By default, unique is set to true, and can be disabled using this method.
    54  func (cbq *CoinBaseQuery) Unique(unique bool) *CoinBaseQuery {
    55  	cbq.unique = &unique
    56  	return cbq
    57  }
    58  
    59  // Order adds an order step to the query.
    60  func (cbq *CoinBaseQuery) Order(o ...OrderFunc) *CoinBaseQuery {
    61  	cbq.order = append(cbq.order, o...)
    62  	return cbq
    63  }
    64  
    65  // First returns the first CoinBase entity from the query.
    66  // Returns a *NotFoundError when no CoinBase was found.
    67  func (cbq *CoinBaseQuery) First(ctx context.Context) (*CoinBase, error) {
    68  	nodes, err := cbq.Limit(1).All(ctx)
    69  	if err != nil {
    70  		return nil, err
    71  	}
    72  	if len(nodes) == 0 {
    73  		return nil, &NotFoundError{coinbase.Label}
    74  	}
    75  	return nodes[0], nil
    76  }
    77  
    78  // FirstX is like First, but panics if an error occurs.
    79  func (cbq *CoinBaseQuery) FirstX(ctx context.Context) *CoinBase {
    80  	node, err := cbq.First(ctx)
    81  	if err != nil && !IsNotFound(err) {
    82  		panic(err)
    83  	}
    84  	return node
    85  }
    86  
    87  // FirstID returns the first CoinBase ID from the query.
    88  // Returns a *NotFoundError when no CoinBase ID was found.
    89  func (cbq *CoinBaseQuery) FirstID(ctx context.Context) (id uint32, err error) {
    90  	var ids []uint32
    91  	if ids, err = cbq.Limit(1).IDs(ctx); err != nil {
    92  		return
    93  	}
    94  	if len(ids) == 0 {
    95  		err = &NotFoundError{coinbase.Label}
    96  		return
    97  	}
    98  	return ids[0], nil
    99  }
   100  
   101  // FirstIDX is like FirstID, but panics if an error occurs.
   102  func (cbq *CoinBaseQuery) FirstIDX(ctx context.Context) uint32 {
   103  	id, err := cbq.FirstID(ctx)
   104  	if err != nil && !IsNotFound(err) {
   105  		panic(err)
   106  	}
   107  	return id
   108  }
   109  
   110  // Only returns a single CoinBase entity found by the query, ensuring it only returns one.
   111  // Returns a *NotSingularError when more than one CoinBase entity is found.
   112  // Returns a *NotFoundError when no CoinBase entities are found.
   113  func (cbq *CoinBaseQuery) Only(ctx context.Context) (*CoinBase, error) {
   114  	nodes, err := cbq.Limit(2).All(ctx)
   115  	if err != nil {
   116  		return nil, err
   117  	}
   118  	switch len(nodes) {
   119  	case 1:
   120  		return nodes[0], nil
   121  	case 0:
   122  		return nil, &NotFoundError{coinbase.Label}
   123  	default:
   124  		return nil, &NotSingularError{coinbase.Label}
   125  	}
   126  }
   127  
   128  // OnlyX is like Only, but panics if an error occurs.
   129  func (cbq *CoinBaseQuery) OnlyX(ctx context.Context) *CoinBase {
   130  	node, err := cbq.Only(ctx)
   131  	if err != nil {
   132  		panic(err)
   133  	}
   134  	return node
   135  }
   136  
   137  // OnlyID is like Only, but returns the only CoinBase ID in the query.
   138  // Returns a *NotSingularError when more than one CoinBase ID is found.
   139  // Returns a *NotFoundError when no entities are found.
   140  func (cbq *CoinBaseQuery) OnlyID(ctx context.Context) (id uint32, err error) {
   141  	var ids []uint32
   142  	if ids, err = cbq.Limit(2).IDs(ctx); err != nil {
   143  		return
   144  	}
   145  	switch len(ids) {
   146  	case 1:
   147  		id = ids[0]
   148  	case 0:
   149  		err = &NotFoundError{coinbase.Label}
   150  	default:
   151  		err = &NotSingularError{coinbase.Label}
   152  	}
   153  	return
   154  }
   155  
   156  // OnlyIDX is like OnlyID, but panics if an error occurs.
   157  func (cbq *CoinBaseQuery) OnlyIDX(ctx context.Context) uint32 {
   158  	id, err := cbq.OnlyID(ctx)
   159  	if err != nil {
   160  		panic(err)
   161  	}
   162  	return id
   163  }
   164  
   165  // All executes the query and returns a list of CoinBases.
   166  func (cbq *CoinBaseQuery) All(ctx context.Context) ([]*CoinBase, error) {
   167  	if err := cbq.prepareQuery(ctx); err != nil {
   168  		return nil, err
   169  	}
   170  	return cbq.sqlAll(ctx)
   171  }
   172  
   173  // AllX is like All, but panics if an error occurs.
   174  func (cbq *CoinBaseQuery) AllX(ctx context.Context) []*CoinBase {
   175  	nodes, err := cbq.All(ctx)
   176  	if err != nil {
   177  		panic(err)
   178  	}
   179  	return nodes
   180  }
   181  
   182  // IDs executes the query and returns a list of CoinBase IDs.
   183  func (cbq *CoinBaseQuery) IDs(ctx context.Context) ([]uint32, error) {
   184  	var ids []uint32
   185  	if err := cbq.Select(coinbase.FieldID).Scan(ctx, &ids); err != nil {
   186  		return nil, err
   187  	}
   188  	return ids, nil
   189  }
   190  
   191  // IDsX is like IDs, but panics if an error occurs.
   192  func (cbq *CoinBaseQuery) IDsX(ctx context.Context) []uint32 {
   193  	ids, err := cbq.IDs(ctx)
   194  	if err != nil {
   195  		panic(err)
   196  	}
   197  	return ids
   198  }
   199  
   200  // Count returns the count of the given query.
   201  func (cbq *CoinBaseQuery) Count(ctx context.Context) (int, error) {
   202  	if err := cbq.prepareQuery(ctx); err != nil {
   203  		return 0, err
   204  	}
   205  	return cbq.sqlCount(ctx)
   206  }
   207  
   208  // CountX is like Count, but panics if an error occurs.
   209  func (cbq *CoinBaseQuery) CountX(ctx context.Context) int {
   210  	count, err := cbq.Count(ctx)
   211  	if err != nil {
   212  		panic(err)
   213  	}
   214  	return count
   215  }
   216  
   217  // Exist returns true if the query has elements in the graph.
   218  func (cbq *CoinBaseQuery) Exist(ctx context.Context) (bool, error) {
   219  	if err := cbq.prepareQuery(ctx); err != nil {
   220  		return false, err
   221  	}
   222  	return cbq.sqlExist(ctx)
   223  }
   224  
   225  // ExistX is like Exist, but panics if an error occurs.
   226  func (cbq *CoinBaseQuery) ExistX(ctx context.Context) bool {
   227  	exist, err := cbq.Exist(ctx)
   228  	if err != nil {
   229  		panic(err)
   230  	}
   231  	return exist
   232  }
   233  
   234  // Clone returns a duplicate of the CoinBaseQuery builder, including all associated steps. It can be
   235  // used to prepare common query builders and use them differently after the clone is made.
   236  func (cbq *CoinBaseQuery) Clone() *CoinBaseQuery {
   237  	if cbq == nil {
   238  		return nil
   239  	}
   240  	return &CoinBaseQuery{
   241  		config:     cbq.config,
   242  		limit:      cbq.limit,
   243  		offset:     cbq.offset,
   244  		order:      append([]OrderFunc{}, cbq.order...),
   245  		predicates: append([]predicate.CoinBase{}, cbq.predicates...),
   246  		// clone intermediate query.
   247  		sql:    cbq.sql.Clone(),
   248  		path:   cbq.path,
   249  		unique: cbq.unique,
   250  	}
   251  }
   252  
   253  // GroupBy is used to group vertices by one or more fields/columns.
   254  // It is often used with aggregate functions, like: count, max, mean, min, sum.
   255  //
   256  // Example:
   257  //
   258  //	var v []struct {
   259  //		CreatedAt uint32 `json:"created_at,omitempty"`
   260  //		Count int `json:"count,omitempty"`
   261  //	}
   262  //
   263  //	client.CoinBase.Query().
   264  //		GroupBy(coinbase.FieldCreatedAt).
   265  //		Aggregate(ent.Count()).
   266  //		Scan(ctx, &v)
   267  //
   268  func (cbq *CoinBaseQuery) GroupBy(field string, fields ...string) *CoinBaseGroupBy {
   269  	grbuild := &CoinBaseGroupBy{config: cbq.config}
   270  	grbuild.fields = append([]string{field}, fields...)
   271  	grbuild.path = func(ctx context.Context) (prev *sql.Selector, err error) {
   272  		if err := cbq.prepareQuery(ctx); err != nil {
   273  			return nil, err
   274  		}
   275  		return cbq.sqlQuery(ctx), nil
   276  	}
   277  	grbuild.label = coinbase.Label
   278  	grbuild.flds, grbuild.scan = &grbuild.fields, grbuild.Scan
   279  	return grbuild
   280  }
   281  
   282  // Select allows the selection one or more fields/columns for the given query,
   283  // instead of selecting all fields in the entity.
   284  //
   285  // Example:
   286  //
   287  //	var v []struct {
   288  //		CreatedAt uint32 `json:"created_at,omitempty"`
   289  //	}
   290  //
   291  //	client.CoinBase.Query().
   292  //		Select(coinbase.FieldCreatedAt).
   293  //		Scan(ctx, &v)
   294  //
   295  func (cbq *CoinBaseQuery) Select(fields ...string) *CoinBaseSelect {
   296  	cbq.fields = append(cbq.fields, fields...)
   297  	selbuild := &CoinBaseSelect{CoinBaseQuery: cbq}
   298  	selbuild.label = coinbase.Label
   299  	selbuild.flds, selbuild.scan = &cbq.fields, selbuild.Scan
   300  	return selbuild
   301  }
   302  
   303  func (cbq *CoinBaseQuery) prepareQuery(ctx context.Context) error {
   304  	for _, f := range cbq.fields {
   305  		if !coinbase.ValidColumn(f) {
   306  			return &ValidationError{Name: f, err: fmt.Errorf("ent: invalid field %q for query", f)}
   307  		}
   308  	}
   309  	if cbq.path != nil {
   310  		prev, err := cbq.path(ctx)
   311  		if err != nil {
   312  			return err
   313  		}
   314  		cbq.sql = prev
   315  	}
   316  	if coinbase.Policy == nil {
   317  		return errors.New("ent: uninitialized coinbase.Policy (forgotten import ent/runtime?)")
   318  	}
   319  	if err := coinbase.Policy.EvalQuery(ctx, cbq); err != nil {
   320  		return err
   321  	}
   322  	return nil
   323  }
   324  
   325  func (cbq *CoinBaseQuery) sqlAll(ctx context.Context, hooks ...queryHook) ([]*CoinBase, error) {
   326  	var (
   327  		nodes = []*CoinBase{}
   328  		_spec = cbq.querySpec()
   329  	)
   330  	_spec.ScanValues = func(columns []string) ([]interface{}, error) {
   331  		return (*CoinBase).scanValues(nil, columns)
   332  	}
   333  	_spec.Assign = func(columns []string, values []interface{}) error {
   334  		node := &CoinBase{config: cbq.config}
   335  		nodes = append(nodes, node)
   336  		return node.assignValues(columns, values)
   337  	}
   338  	if len(cbq.modifiers) > 0 {
   339  		_spec.Modifiers = cbq.modifiers
   340  	}
   341  	for i := range hooks {
   342  		hooks[i](ctx, _spec)
   343  	}
   344  	if err := sqlgraph.QueryNodes(ctx, cbq.driver, _spec); err != nil {
   345  		return nil, err
   346  	}
   347  	if len(nodes) == 0 {
   348  		return nodes, nil
   349  	}
   350  	return nodes, nil
   351  }
   352  
   353  func (cbq *CoinBaseQuery) sqlCount(ctx context.Context) (int, error) {
   354  	_spec := cbq.querySpec()
   355  	if len(cbq.modifiers) > 0 {
   356  		_spec.Modifiers = cbq.modifiers
   357  	}
   358  	_spec.Node.Columns = cbq.fields
   359  	if len(cbq.fields) > 0 {
   360  		_spec.Unique = cbq.unique != nil && *cbq.unique
   361  	}
   362  	return sqlgraph.CountNodes(ctx, cbq.driver, _spec)
   363  }
   364  
   365  func (cbq *CoinBaseQuery) sqlExist(ctx context.Context) (bool, error) {
   366  	n, err := cbq.sqlCount(ctx)
   367  	if err != nil {
   368  		return false, fmt.Errorf("ent: check existence: %w", err)
   369  	}
   370  	return n > 0, nil
   371  }
   372  
   373  func (cbq *CoinBaseQuery) querySpec() *sqlgraph.QuerySpec {
   374  	_spec := &sqlgraph.QuerySpec{
   375  		Node: &sqlgraph.NodeSpec{
   376  			Table:   coinbase.Table,
   377  			Columns: coinbase.Columns,
   378  			ID: &sqlgraph.FieldSpec{
   379  				Type:   field.TypeUint32,
   380  				Column: coinbase.FieldID,
   381  			},
   382  		},
   383  		From:   cbq.sql,
   384  		Unique: true,
   385  	}
   386  	if unique := cbq.unique; unique != nil {
   387  		_spec.Unique = *unique
   388  	}
   389  	if fields := cbq.fields; len(fields) > 0 {
   390  		_spec.Node.Columns = make([]string, 0, len(fields))
   391  		_spec.Node.Columns = append(_spec.Node.Columns, coinbase.FieldID)
   392  		for i := range fields {
   393  			if fields[i] != coinbase.FieldID {
   394  				_spec.Node.Columns = append(_spec.Node.Columns, fields[i])
   395  			}
   396  		}
   397  	}
   398  	if ps := cbq.predicates; len(ps) > 0 {
   399  		_spec.Predicate = func(selector *sql.Selector) {
   400  			for i := range ps {
   401  				ps[i](selector)
   402  			}
   403  		}
   404  	}
   405  	if limit := cbq.limit; limit != nil {
   406  		_spec.Limit = *limit
   407  	}
   408  	if offset := cbq.offset; offset != nil {
   409  		_spec.Offset = *offset
   410  	}
   411  	if ps := cbq.order; len(ps) > 0 {
   412  		_spec.Order = func(selector *sql.Selector) {
   413  			for i := range ps {
   414  				ps[i](selector)
   415  			}
   416  		}
   417  	}
   418  	return _spec
   419  }
   420  
   421  func (cbq *CoinBaseQuery) sqlQuery(ctx context.Context) *sql.Selector {
   422  	builder := sql.Dialect(cbq.driver.Dialect())
   423  	t1 := builder.Table(coinbase.Table)
   424  	columns := cbq.fields
   425  	if len(columns) == 0 {
   426  		columns = coinbase.Columns
   427  	}
   428  	selector := builder.Select(t1.Columns(columns...)...).From(t1)
   429  	if cbq.sql != nil {
   430  		selector = cbq.sql
   431  		selector.Select(selector.Columns(columns...)...)
   432  	}
   433  	if cbq.unique != nil && *cbq.unique {
   434  		selector.Distinct()
   435  	}
   436  	for _, m := range cbq.modifiers {
   437  		m(selector)
   438  	}
   439  	for _, p := range cbq.predicates {
   440  		p(selector)
   441  	}
   442  	for _, p := range cbq.order {
   443  		p(selector)
   444  	}
   445  	if offset := cbq.offset; offset != nil {
   446  		// limit is mandatory for offset clause. We start
   447  		// with default value, and override it below if needed.
   448  		selector.Offset(*offset).Limit(math.MaxInt32)
   449  	}
   450  	if limit := cbq.limit; limit != nil {
   451  		selector.Limit(*limit)
   452  	}
   453  	return selector
   454  }
   455  
   456  // ForUpdate locks the selected rows against concurrent updates, and prevent them from being
   457  // updated, deleted or "selected ... for update" by other sessions, until the transaction is
   458  // either committed or rolled-back.
   459  func (cbq *CoinBaseQuery) ForUpdate(opts ...sql.LockOption) *CoinBaseQuery {
   460  	if cbq.driver.Dialect() == dialect.Postgres {
   461  		cbq.Unique(false)
   462  	}
   463  	cbq.modifiers = append(cbq.modifiers, func(s *sql.Selector) {
   464  		s.ForUpdate(opts...)
   465  	})
   466  	return cbq
   467  }
   468  
   469  // ForShare behaves similarly to ForUpdate, except that it acquires a shared mode lock
   470  // on any rows that are read. Other sessions can read the rows, but cannot modify them
   471  // until your transaction commits.
   472  func (cbq *CoinBaseQuery) ForShare(opts ...sql.LockOption) *CoinBaseQuery {
   473  	if cbq.driver.Dialect() == dialect.Postgres {
   474  		cbq.Unique(false)
   475  	}
   476  	cbq.modifiers = append(cbq.modifiers, func(s *sql.Selector) {
   477  		s.ForShare(opts...)
   478  	})
   479  	return cbq
   480  }
   481  
   482  // Modify adds a query modifier for attaching custom logic to queries.
   483  func (cbq *CoinBaseQuery) Modify(modifiers ...func(s *sql.Selector)) *CoinBaseSelect {
   484  	cbq.modifiers = append(cbq.modifiers, modifiers...)
   485  	return cbq.Select()
   486  }
   487  
   488  // CoinBaseGroupBy is the group-by builder for CoinBase entities.
   489  type CoinBaseGroupBy struct {
   490  	config
   491  	selector
   492  	fields []string
   493  	fns    []AggregateFunc
   494  	// intermediate query (i.e. traversal path).
   495  	sql  *sql.Selector
   496  	path func(context.Context) (*sql.Selector, error)
   497  }
   498  
   499  // Aggregate adds the given aggregation functions to the group-by query.
   500  func (cbgb *CoinBaseGroupBy) Aggregate(fns ...AggregateFunc) *CoinBaseGroupBy {
   501  	cbgb.fns = append(cbgb.fns, fns...)
   502  	return cbgb
   503  }
   504  
   505  // Scan applies the group-by query and scans the result into the given value.
   506  func (cbgb *CoinBaseGroupBy) Scan(ctx context.Context, v interface{}) error {
   507  	query, err := cbgb.path(ctx)
   508  	if err != nil {
   509  		return err
   510  	}
   511  	cbgb.sql = query
   512  	return cbgb.sqlScan(ctx, v)
   513  }
   514  
   515  func (cbgb *CoinBaseGroupBy) sqlScan(ctx context.Context, v interface{}) error {
   516  	for _, f := range cbgb.fields {
   517  		if !coinbase.ValidColumn(f) {
   518  			return &ValidationError{Name: f, err: fmt.Errorf("invalid field %q for group-by", f)}
   519  		}
   520  	}
   521  	selector := cbgb.sqlQuery()
   522  	if err := selector.Err(); err != nil {
   523  		return err
   524  	}
   525  	rows := &sql.Rows{}
   526  	query, args := selector.Query()
   527  	if err := cbgb.driver.Query(ctx, query, args, rows); err != nil {
   528  		return err
   529  	}
   530  	defer rows.Close()
   531  	return sql.ScanSlice(rows, v)
   532  }
   533  
   534  func (cbgb *CoinBaseGroupBy) sqlQuery() *sql.Selector {
   535  	selector := cbgb.sql.Select()
   536  	aggregation := make([]string, 0, len(cbgb.fns))
   537  	for _, fn := range cbgb.fns {
   538  		aggregation = append(aggregation, fn(selector))
   539  	}
   540  	// If no columns were selected in a custom aggregation function, the default
   541  	// selection is the fields used for "group-by", and the aggregation functions.
   542  	if len(selector.SelectedColumns()) == 0 {
   543  		columns := make([]string, 0, len(cbgb.fields)+len(cbgb.fns))
   544  		for _, f := range cbgb.fields {
   545  			columns = append(columns, selector.C(f))
   546  		}
   547  		columns = append(columns, aggregation...)
   548  		selector.Select(columns...)
   549  	}
   550  	return selector.GroupBy(selector.Columns(cbgb.fields...)...)
   551  }
   552  
   553  // CoinBaseSelect is the builder for selecting fields of CoinBase entities.
   554  type CoinBaseSelect struct {
   555  	*CoinBaseQuery
   556  	selector
   557  	// intermediate query (i.e. traversal path).
   558  	sql *sql.Selector
   559  }
   560  
   561  // Scan applies the selector query and scans the result into the given value.
   562  func (cbs *CoinBaseSelect) Scan(ctx context.Context, v interface{}) error {
   563  	if err := cbs.prepareQuery(ctx); err != nil {
   564  		return err
   565  	}
   566  	cbs.sql = cbs.CoinBaseQuery.sqlQuery(ctx)
   567  	return cbs.sqlScan(ctx, v)
   568  }
   569  
   570  func (cbs *CoinBaseSelect) sqlScan(ctx context.Context, v interface{}) error {
   571  	rows := &sql.Rows{}
   572  	query, args := cbs.sql.Query()
   573  	if err := cbs.driver.Query(ctx, query, args, rows); err != nil {
   574  		return err
   575  	}
   576  	defer rows.Close()
   577  	return sql.ScanSlice(rows, v)
   578  }
   579  
   580  // Modify adds a query modifier for attaching custom logic to queries.
   581  func (cbs *CoinBaseSelect) Modify(modifiers ...func(s *sql.Selector)) *CoinBaseSelect {
   582  	cbs.modifiers = append(cbs.modifiers, modifiers...)
   583  	return cbs
   584  }