mirror of
				https://github.com/superseriousbusiness/gotosocial.git
				synced 2025-11-02 16:52:25 -06:00 
			
		
		
		
	* [feature] Application creation + management via API + settings panel * fix docs links * add errnorows test * use known application as shorter * add comment about side effects
		
			
				
	
	
		
			268 lines
		
	
	
	
		
			9.4 KiB
		
	
	
	
		
			Go
		
	
	
	
	
	
			
		
		
	
	
			268 lines
		
	
	
	
		
			9.4 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 processing
 | 
						|
 | 
						|
import (
 | 
						|
	"github.com/superseriousbusiness/gotosocial/internal/cleaner"
 | 
						|
	"github.com/superseriousbusiness/gotosocial/internal/email"
 | 
						|
	"github.com/superseriousbusiness/gotosocial/internal/federation"
 | 
						|
	"github.com/superseriousbusiness/gotosocial/internal/filter/interaction"
 | 
						|
	"github.com/superseriousbusiness/gotosocial/internal/filter/visibility"
 | 
						|
	"github.com/superseriousbusiness/gotosocial/internal/gtsmodel"
 | 
						|
	mm "github.com/superseriousbusiness/gotosocial/internal/media"
 | 
						|
	"github.com/superseriousbusiness/gotosocial/internal/oauth"
 | 
						|
	"github.com/superseriousbusiness/gotosocial/internal/processing/account"
 | 
						|
	"github.com/superseriousbusiness/gotosocial/internal/processing/admin"
 | 
						|
	"github.com/superseriousbusiness/gotosocial/internal/processing/advancedmigrations"
 | 
						|
	"github.com/superseriousbusiness/gotosocial/internal/processing/application"
 | 
						|
	"github.com/superseriousbusiness/gotosocial/internal/processing/common"
 | 
						|
	"github.com/superseriousbusiness/gotosocial/internal/processing/conversations"
 | 
						|
	"github.com/superseriousbusiness/gotosocial/internal/processing/fedi"
 | 
						|
	filtersv1 "github.com/superseriousbusiness/gotosocial/internal/processing/filters/v1"
 | 
						|
	filtersv2 "github.com/superseriousbusiness/gotosocial/internal/processing/filters/v2"
 | 
						|
	"github.com/superseriousbusiness/gotosocial/internal/processing/interactionrequests"
 | 
						|
	"github.com/superseriousbusiness/gotosocial/internal/processing/list"
 | 
						|
	"github.com/superseriousbusiness/gotosocial/internal/processing/markers"
 | 
						|
	"github.com/superseriousbusiness/gotosocial/internal/processing/media"
 | 
						|
	"github.com/superseriousbusiness/gotosocial/internal/processing/polls"
 | 
						|
	"github.com/superseriousbusiness/gotosocial/internal/processing/push"
 | 
						|
	"github.com/superseriousbusiness/gotosocial/internal/processing/report"
 | 
						|
	"github.com/superseriousbusiness/gotosocial/internal/processing/search"
 | 
						|
	"github.com/superseriousbusiness/gotosocial/internal/processing/status"
 | 
						|
	"github.com/superseriousbusiness/gotosocial/internal/processing/stream"
 | 
						|
	"github.com/superseriousbusiness/gotosocial/internal/processing/tags"
 | 
						|
	"github.com/superseriousbusiness/gotosocial/internal/processing/timeline"
 | 
						|
	"github.com/superseriousbusiness/gotosocial/internal/processing/user"
 | 
						|
	"github.com/superseriousbusiness/gotosocial/internal/processing/workers"
 | 
						|
	"github.com/superseriousbusiness/gotosocial/internal/state"
 | 
						|
	"github.com/superseriousbusiness/gotosocial/internal/subscriptions"
 | 
						|
	"github.com/superseriousbusiness/gotosocial/internal/text"
 | 
						|
	"github.com/superseriousbusiness/gotosocial/internal/typeutils"
 | 
						|
	"github.com/superseriousbusiness/gotosocial/internal/webpush"
 | 
						|
)
 | 
						|
 | 
						|
// Processor groups together processing functions and
 | 
						|
// sub processors for handling actions + events coming
 | 
						|
// from either the client or federating APIs.
 | 
						|
//
 | 
						|
// Many of the functions available through this struct
 | 
						|
// or sub processors will trigger asynchronous processing
 | 
						|
// via the workers contained in state.
 | 
						|
type Processor struct {
 | 
						|
	converter   *typeutils.Converter
 | 
						|
	oauthServer oauth.Server
 | 
						|
	state       *state.State
 | 
						|
 | 
						|
	/*
 | 
						|
		Required for instance description / terms updating.
 | 
						|
	*/
 | 
						|
 | 
						|
	formatter        *text.Formatter
 | 
						|
	parseMentionFunc gtsmodel.ParseMentionFunc
 | 
						|
 | 
						|
	/*
 | 
						|
		SUB-PROCESSORS
 | 
						|
	*/
 | 
						|
 | 
						|
	account             account.Processor
 | 
						|
	admin               admin.Processor
 | 
						|
	advancedmigrations  advancedmigrations.Processor
 | 
						|
	application         application.Processor
 | 
						|
	conversations       conversations.Processor
 | 
						|
	fedi                fedi.Processor
 | 
						|
	filtersv1           filtersv1.Processor
 | 
						|
	filtersv2           filtersv2.Processor
 | 
						|
	interactionRequests interactionrequests.Processor
 | 
						|
	list                list.Processor
 | 
						|
	markers             markers.Processor
 | 
						|
	media               media.Processor
 | 
						|
	polls               polls.Processor
 | 
						|
	push                push.Processor
 | 
						|
	report              report.Processor
 | 
						|
	search              search.Processor
 | 
						|
	status              status.Processor
 | 
						|
	stream              stream.Processor
 | 
						|
	tags                tags.Processor
 | 
						|
	timeline            timeline.Processor
 | 
						|
	user                user.Processor
 | 
						|
	workers             workers.Processor
 | 
						|
}
 | 
						|
 | 
						|
func (p *Processor) Account() *account.Processor {
 | 
						|
	return &p.account
 | 
						|
}
 | 
						|
 | 
						|
func (p *Processor) Admin() *admin.Processor {
 | 
						|
	return &p.admin
 | 
						|
}
 | 
						|
 | 
						|
func (p *Processor) AdvancedMigrations() *advancedmigrations.Processor {
 | 
						|
	return &p.advancedmigrations
 | 
						|
}
 | 
						|
 | 
						|
func (p *Processor) Application() *application.Processor {
 | 
						|
	return &p.application
 | 
						|
}
 | 
						|
 | 
						|
func (p *Processor) Conversations() *conversations.Processor {
 | 
						|
	return &p.conversations
 | 
						|
}
 | 
						|
 | 
						|
func (p *Processor) Fedi() *fedi.Processor {
 | 
						|
	return &p.fedi
 | 
						|
}
 | 
						|
 | 
						|
func (p *Processor) FiltersV1() *filtersv1.Processor {
 | 
						|
	return &p.filtersv1
 | 
						|
}
 | 
						|
 | 
						|
func (p *Processor) FiltersV2() *filtersv2.Processor {
 | 
						|
	return &p.filtersv2
 | 
						|
}
 | 
						|
 | 
						|
func (p *Processor) InteractionRequests() *interactionrequests.Processor {
 | 
						|
	return &p.interactionRequests
 | 
						|
}
 | 
						|
 | 
						|
func (p *Processor) List() *list.Processor {
 | 
						|
	return &p.list
 | 
						|
}
 | 
						|
 | 
						|
func (p *Processor) Markers() *markers.Processor {
 | 
						|
	return &p.markers
 | 
						|
}
 | 
						|
 | 
						|
func (p *Processor) Media() *media.Processor {
 | 
						|
	return &p.media
 | 
						|
}
 | 
						|
 | 
						|
func (p *Processor) Polls() *polls.Processor {
 | 
						|
	return &p.polls
 | 
						|
}
 | 
						|
 | 
						|
func (p *Processor) Push() *push.Processor {
 | 
						|
	return &p.push
 | 
						|
}
 | 
						|
 | 
						|
func (p *Processor) Report() *report.Processor {
 | 
						|
	return &p.report
 | 
						|
}
 | 
						|
 | 
						|
func (p *Processor) Search() *search.Processor {
 | 
						|
	return &p.search
 | 
						|
}
 | 
						|
 | 
						|
func (p *Processor) Status() *status.Processor {
 | 
						|
	return &p.status
 | 
						|
}
 | 
						|
 | 
						|
func (p *Processor) Stream() *stream.Processor {
 | 
						|
	return &p.stream
 | 
						|
}
 | 
						|
 | 
						|
func (p *Processor) Tags() *tags.Processor {
 | 
						|
	return &p.tags
 | 
						|
}
 | 
						|
 | 
						|
func (p *Processor) Timeline() *timeline.Processor {
 | 
						|
	return &p.timeline
 | 
						|
}
 | 
						|
 | 
						|
func (p *Processor) User() *user.Processor {
 | 
						|
	return &p.user
 | 
						|
}
 | 
						|
 | 
						|
func (p *Processor) Workers() *workers.Processor {
 | 
						|
	return &p.workers
 | 
						|
}
 | 
						|
 | 
						|
// NewProcessor returns a new Processor.
 | 
						|
func NewProcessor(
 | 
						|
	cleaner *cleaner.Cleaner,
 | 
						|
	subscriptions *subscriptions.Subscriptions,
 | 
						|
	converter *typeutils.Converter,
 | 
						|
	federator *federation.Federator,
 | 
						|
	oauthServer oauth.Server,
 | 
						|
	mediaManager *mm.Manager,
 | 
						|
	state *state.State,
 | 
						|
	emailSender email.Sender,
 | 
						|
	webPushSender webpush.Sender,
 | 
						|
	visFilter *visibility.Filter,
 | 
						|
	intFilter *interaction.Filter,
 | 
						|
) *Processor {
 | 
						|
	parseMentionFunc := GetParseMentionFunc(state, federator)
 | 
						|
	processor := &Processor{
 | 
						|
		converter:        converter,
 | 
						|
		oauthServer:      oauthServer,
 | 
						|
		state:            state,
 | 
						|
		formatter:        text.NewFormatter(state.DB),
 | 
						|
		parseMentionFunc: parseMentionFunc,
 | 
						|
	}
 | 
						|
 | 
						|
	// Instantiate sub processors.
 | 
						|
	//
 | 
						|
	// Start with sub processors that will
 | 
						|
	// be required by the workers processor.
 | 
						|
	common := common.New(state, mediaManager, converter, federator, visFilter)
 | 
						|
	processor.account = account.New(&common, state, converter, mediaManager, federator, visFilter, parseMentionFunc)
 | 
						|
	processor.media = media.New(&common, state, converter, federator, mediaManager, federator.TransportController())
 | 
						|
	processor.stream = stream.New(state, oauthServer)
 | 
						|
 | 
						|
	// Instantiate the rest of the sub
 | 
						|
	// processors + pin them to this struct.
 | 
						|
	processor.account = account.New(&common, state, converter, mediaManager, federator, visFilter, parseMentionFunc)
 | 
						|
	processor.admin = admin.New(&common, state, cleaner, subscriptions, federator, converter, mediaManager, federator.TransportController(), emailSender)
 | 
						|
	processor.application = application.New(state, converter)
 | 
						|
	processor.conversations = conversations.New(state, converter, visFilter)
 | 
						|
	processor.fedi = fedi.New(state, &common, converter, federator, visFilter)
 | 
						|
	processor.filtersv1 = filtersv1.New(state, converter, &processor.stream)
 | 
						|
	processor.filtersv2 = filtersv2.New(state, converter, &processor.stream)
 | 
						|
	processor.interactionRequests = interactionrequests.New(&common, state, converter)
 | 
						|
	processor.list = list.New(state, converter)
 | 
						|
	processor.markers = markers.New(state, converter)
 | 
						|
	processor.polls = polls.New(&common, state, converter)
 | 
						|
	processor.push = push.New(state, converter)
 | 
						|
	processor.report = report.New(state, converter)
 | 
						|
	processor.tags = tags.New(state, converter)
 | 
						|
	processor.timeline = timeline.New(state, converter, visFilter)
 | 
						|
	processor.search = search.New(state, federator, converter, visFilter)
 | 
						|
	processor.status = status.New(state, &common, &processor.polls, &processor.interactionRequests, federator, converter, visFilter, intFilter, parseMentionFunc)
 | 
						|
	processor.user = user.New(state, converter, oauthServer, emailSender)
 | 
						|
 | 
						|
	// The advanced migrations processor sequences advanced migrations from all other processors.
 | 
						|
	processor.advancedmigrations = advancedmigrations.New(&processor.conversations)
 | 
						|
 | 
						|
	// Workers processor handles asynchronous
 | 
						|
	// worker jobs; instantiate it separately
 | 
						|
	// and pass subset of sub processors it needs.
 | 
						|
	processor.workers = workers.New(
 | 
						|
		state,
 | 
						|
		&common,
 | 
						|
		federator,
 | 
						|
		converter,
 | 
						|
		visFilter,
 | 
						|
		emailSender,
 | 
						|
		webPushSender,
 | 
						|
		&processor.account,
 | 
						|
		&processor.media,
 | 
						|
		&processor.stream,
 | 
						|
		&processor.conversations,
 | 
						|
	)
 | 
						|
 | 
						|
	return processor
 | 
						|
}
 |