mirror of
				https://github.com/superseriousbusiness/gotosocial.git
				synced 2025-10-31 04:12:25 -05:00 
			
		
		
		
	
		
			
				
	
	
		
			82 lines
		
	
	
	
		
			2.7 KiB
		
	
	
	
		
			Go
		
	
	
	
	
	
			
		
		
	
	
			82 lines
		
	
	
	
		
			2.7 KiB
		
	
	
	
		
			Go
		
	
	
	
	
	
| // GoToSocial
 | |
| // Copyright (C) GoToSocial Authors admin@gotosocial.org
 | |
| // SPDX-License-Identifier: AGPL-3.0-or-later
 | |
| //
 | |
| // This program is free software: you can redistribute it and/or modify
 | |
| // it under the terms of the GNU Affero General Public License as published by
 | |
| // the Free Software Foundation, either version 3 of the License, or
 | |
| // (at your option) any later version.
 | |
| //
 | |
| // This program is distributed in the hope that it will be useful,
 | |
| // but WITHOUT ANY WARRANTY; without even the implied warranty of
 | |
| // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 | |
| // GNU Affero General Public License for more details.
 | |
| //
 | |
| // You should have received a copy of the GNU Affero General Public License
 | |
| // along with this program.  If not, see <http://www.gnu.org/licenses/>.
 | |
| 
 | |
| package state
 | |
| 
 | |
| import (
 | |
| 	"code.superseriousbusiness.org/gotosocial/internal/admin"
 | |
| 	"code.superseriousbusiness.org/gotosocial/internal/cache"
 | |
| 	"code.superseriousbusiness.org/gotosocial/internal/db"
 | |
| 	"code.superseriousbusiness.org/gotosocial/internal/storage"
 | |
| 	"code.superseriousbusiness.org/gotosocial/internal/workers"
 | |
| 	"codeberg.org/gruf/go-mutexes"
 | |
| )
 | |
| 
 | |
| // State provides a means of dependency injection and sharing of resources
 | |
| // across different subpackages of the GoToSocial codebase. DO NOT assume
 | |
| // that any particular field will be initialized if you are accessing this
 | |
| // during initialization. A pointer to a State{} is often passed during
 | |
| // subpackage initialization, while the returned subpackage type will later
 | |
| // then be set and stored within the State{} itself.
 | |
| type State struct {
 | |
| 
 | |
| 	// Caches provides access to this
 | |
| 	// state's collection of caches.
 | |
| 	Caches cache.Caches
 | |
| 
 | |
| 	// DB provides access to the database.
 | |
| 	DB db.DB
 | |
| 
 | |
| 	// FedLocks provides access to this state's mutex
 | |
| 	// map of per URI federation locks, intended for
 | |
| 	// use in internal/federation functions.
 | |
| 	//
 | |
| 	// Used during account and status dereferencing,
 | |
| 	// and by the go-fed/activity library.
 | |
| 	FedLocks mutexes.MutexMap
 | |
| 
 | |
| 	// ProcessingLocks provides access to this state's
 | |
| 	// mutex map of per URI locks, intended for use
 | |
| 	// in internal/processing functions, for example
 | |
| 	// when updating accounts, migrating, approving
 | |
| 	// or rejecting an account, changing stats or
 | |
| 	// pinned statuses, creating notifs, etc.
 | |
| 	ProcessingLocks mutexes.MutexMap
 | |
| 
 | |
| 	// Storage provides access
 | |
| 	// to the storage driver.
 | |
| 	Storage *storage.Driver
 | |
| 
 | |
| 	// Workers provides access to this
 | |
| 	// state's collection of worker pools.
 | |
| 	Workers workers.Workers
 | |
| 
 | |
| 	// Struct to manage running admin
 | |
| 	// actions (and locks thereupon).
 | |
| 	AdminActions *admin.Actions
 | |
| 
 | |
| 	// prevent pass-by-value.
 | |
| 	_ nocopy
 | |
| }
 | |
| 
 | |
| // nocopy when embedded will signal linter to
 | |
| // error on pass-by-value of parent struct.
 | |
| type nocopy struct{}
 | |
| 
 | |
| func (*nocopy) Lock() {}
 | |
| 
 | |
| func (*nocopy) Unlock() {}
 |