context

package
v0.0.0-...-bb67ff0 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Nov 17, 2025 License: MIT Imports: 68 Imported by: 0

Documentation

Index

Constants

View Source 
const (
	CsrfHeaderName = "X-Csrf-Token"
	CsrfFormName   = "_csrf"
)
View Source 
const CookieNameFlash = "gitea_flash"
View Source 
const CsrfTokenTimeout = 24 * time.Hour

CsrfTokenTimeout represents the duration that XSRF tokens are valid. It is exported so clients may set cookie timeouts that match generated tokens.

Variables

View Source 
var CsrfTokenRegenerationInterval = 10 * time.Minute

CsrfTokenRegenerationInterval is the interval between token generations, old tokens are still valid before CsrfTokenTimeout

View Source 
var WebContextKey = webContextKeyType{}

Functions

func APIContexter 

func APIContexter() func(http.Handler) http.Handler

APIContexter returns APIContext middleware

func AccessLogger 

func AccessLogger() func(http.Handler) http.Handler

AccessLogger returns a middleware to log access logger

func CanWriteToBranch 

func CanWriteToBranch() func(ctx *Context)

CanWriteToBranch checks if the user is allowed to write to the branch of the repo

func CheckRepoScopedToken 

func CheckRepoScopedToken(ctx *Context, repo *repo_model.Repository, level auth_model.AccessTokenScopeLevel)

CheckRepoScopedToken check whether personal access token has repo scope

func ComposeGoGetImport 

func ComposeGoGetImport(ctx context.Context, owner, repo string) string

ComposeGoGetImport returns go-get-import meta content.

func Contexter 

func Contexter() func(next http.Handler) http.Handler

Contexter initializes a classic context for a request.

func EarlyResponseForGoGetMeta 

func EarlyResponseForGoGetMeta(ctx *Context)

EarlyResponseForGoGetMeta responses appropriate go-get meta with status 200 if user does not have actual access to the requested repository, or the owner or repository does not exist at all. This is particular a workaround for "go get" command which does not respect .netrc file.

func GenerateCsrfToken 

func GenerateCsrfToken(key, userID, actionID string, now time.Time) string

GenerateCsrfToken returns a URL-safe secure XSRF token that expires in CsrfTokenTimeout hours. key is a secret key for your application. userID is a unique identifier for the user. actionID is the action the user is taking (e.g. POSTing to a particular path).

func GetImageCaptcha 

func GetImageCaptcha() *captcha.Captcha

GetImageCaptcha returns global image captcha

func GetOrganizationByParams 

func GetOrganizationByParams(ctx *Context)

func GetQueryBeforeSince 

func GetQueryBeforeSince(ctx *Base) (before, since int64, err error)

GetQueryBeforeSince return parsed time (unix format) from URL query's before and since

func GitHookService 

func GitHookService() func(ctx *Context)

GitHookService checks if repository Git hooks service has been enabled.

func OrgAssignment 

func OrgAssignment(opts OrgAssignmentOptions) func(ctx *Context)

OrgAssignment returns a middleware to handle organization assignment

func OverrideContext 

func OverrideContext() func(http.Handler) http.Handler

OverrideContext overrides the underlying request context for Done() etc. This function should be used when there is a need for work to continue even if the request has been cancelled. Primarily this affects hook/post-receive and hook/proc-receive both of which need to continue working even if the underlying request has timed out from the ssh/http push

func PackageAssignment 

func PackageAssignment() func(ctx *Context)

PackageAssignment returns a middleware to handle Context.Package assignment

func PackageAssignmentAPI 

func PackageAssignmentAPI() func(ctx *APIContext)

PackageAssignmentAPI returns a middleware to handle Context.Package assignment

func PackageContexter 

func PackageContexter() func(next http.Handler) http.Handler

PackageContexter initializes a package context for a request.

func ParseCsrfToken 

func ParseCsrfToken(token string) (issueTime time.Time, ok bool)

func PrivateContexter 

func PrivateContexter() func(http.Handler) http.Handler

func RedirectToRepo 

func RedirectToRepo(ctx *Base, redirectRepoID int64)

RedirectToRepo redirect to a differently-named repository

func RedirectToUser 

func RedirectToUser(ctx *Base, userName string, redirectUserID int64)

RedirectToUser redirect to a differently-named user

func ReferencesGitRepo 

func ReferencesGitRepo(allowEmpty ...bool) func(ctx *APIContext)

ReferencesGitRepo injects the GitRepo into the Context you can optional skip the IsEmpty check

func RepoAssignment 

func RepoAssignment(ctx *Context)

RepoAssignment returns a middleware to handle repository assignment

func RepoMustNotBeArchived 

func RepoMustNotBeArchived() func(ctx *Context)

RepoMustNotBeArchived checks if a repo is archived

func RepoRefByDefaultBranch 

func RepoRefByDefaultBranch() func(*Context)

func RepoRefByType 

func RepoRefByType(detectRefType git.RefType) func(*Context)

RepoRefByType handles repository reference name for a specific type of repository reference

func RepoRefForAPI 

func RepoRefForAPI(next http.Handler) http.Handler

RepoRefForAPI handles repository reference names when the ref name is not explicitly given

func RequireRepoAdmin 

func RequireRepoAdmin() func(ctx *Context)

RequireRepoAdmin returns a middleware for requiring repository admin permission

func RequireUnitReader 

func RequireUnitReader(unitTypes ...unit.Type) func(ctx *Context)

RequireUnitReader returns a middleware for requiring repository write to one of the unit permission

func RequireUnitWriter 

func RequireUnitWriter(unitTypes ...unit.Type) func(ctx *Context)

RequireUnitWriter returns a middleware for requiring repository write to one of the unit permission

func RetrieveBaseRepo 

func RetrieveBaseRepo(ctx *Context, repo *repo_model.Repository)

RetrieveBaseRepo retrieves base repository

func RetrieveTemplateRepo 

func RetrieveTemplateRepo(ctx *Context, repo *repo_model.Repository)

RetrieveTemplateRepo retrieves template repository used to generate this repository

func SetCaptchaData 

func SetCaptchaData(ctx *Context)

SetCaptchaData sets common captcha data

func UserAssignmentAPI 

func UserAssignmentAPI() func(ctx *APIContext)

UserAssignmentAPI returns a middleware to handle context-user assignment for api routes

func UserAssignmentWeb 

func UserAssignmentWeb() func(ctx *Context)

UserAssignmentWeb returns a middleware to handle context-user assignment for web routes

func UserIDAssignmentAPI 

func UserIDAssignmentAPI() func(ctx *APIContext)

UserIDAssignmentAPI returns a middleware to handle context-user assignment for api routes

func ValidCsrfToken 

func ValidCsrfToken(token, key, userID, actionID string, now time.Time) bool

ValidCsrfToken returns true if token is a valid and unexpired token returned by Generate.

func VerifyCaptcha 

func VerifyCaptcha(ctx *Context, tpl templates.TplName, form any)

VerifyCaptcha verifies Captcha data No-op if captchas are not enabled

Types

type APIConflict 

type APIConflict struct{}

APIConflict is a conflict empty response swagger:response conflict

type APIContext 

type APIContext struct {
	*Base

	Cache cache.StringCache

	Doer        *user_model.User // current signed-in user
	IsSigned    bool
	IsBasicAuth bool

	ContextUser *user_model.User // the user which is being visited, in most cases it differs from Doer

	Repo       *Repository
	Org        *APIOrganization
	Package    *Package
	PublicOnly bool // Whether the request is for a public endpoint
}

APIContext is a specific context for API service ATTENTION: This struct should never be manually constructed in routes/services, it has many internal details which should be carefully prepared by the framework. If it is abused, it would cause strange bugs like panic/resource-leak.

func GetAPIContext 

func GetAPIContext(req *http.Request) *APIContext

GetAPIContext returns a context for API routes

func (*APIContext) APIError 

func (ctx *APIContext) APIError(status int, obj any)

APIError responds with an error message to client with given obj as the message. If status is 500, also it prints error to log.

func (*APIContext) APIErrorInternal 

func (ctx *APIContext) APIErrorInternal(err error)

APIErrorInternal responds with error message, status is 500

func (*APIContext) APIErrorNotFound 

func (ctx *APIContext) APIErrorNotFound(objs ...any)

APIErrorNotFound handles 404s for APIContext String will replace message, errors will be added to a slice

func (*APIContext) GetErrMsg 

func (ctx *APIContext) GetErrMsg() string

GetErrMsg returns error message in form validation.

func (*APIContext) HasAPIError 

func (ctx *APIContext) HasAPIError() bool

HasAPIError returns true if error occurs in form validation.

func (*APIContext) IsUserRepoAdmin 

func (ctx *APIContext) IsUserRepoAdmin() bool

IsUserRepoAdmin returns true if current user is admin in current repo

func (*APIContext) IsUserRepoWriter 

func (ctx *APIContext) IsUserRepoWriter(unitTypes []unit.Type) bool

IsUserRepoWriter returns true if current user has "write" privilege in current repo

func (*APIContext) IsUserSiteAdmin 

func (ctx *APIContext) IsUserSiteAdmin() bool

IsUserSiteAdmin returns true if current user is a site admin

func (*APIContext) NotFoundOrServerError 

func (ctx *APIContext) NotFoundOrServerError(err error)

NotFoundOrServerError use error check function to determine if the error is about not found. It responds with 404 status code for not found error, or error context description for logging purpose of 500 server error.

func (*APIContext) SetLinkHeader 

func (ctx *APIContext) SetLinkHeader(total, pageSize int)

SetLinkHeader sets pagination link header by given total number and page size.

type APIEmpty 

type APIEmpty struct{}

APIEmpty is an empty response swagger:response empty

type APIError 

type APIError struct {
	Message string `json:"message"`
	URL     string `json:"url"`
}

APIError is error format response swagger:response error

type APIForbiddenError 

type APIForbiddenError struct {
	APIError
}

APIForbiddenError is a forbidden error response swagger:response forbidden

type APIInvalidTopicsError 

type APIInvalidTopicsError struct {
	Message       string   `json:"message"`
	InvalidTopics []string `json:"invalidTopics"`
}

APIInvalidTopicsError is error format response to invalid topics swagger:response invalidTopicsError

type APINotFound 

type APINotFound struct{}

APINotFound is a not found empty response swagger:response notFound

type APIOrganization 

type APIOrganization struct {
	Organization *organization.Organization
	Team         *organization.Team
}

APIOrganization contains organization and team

type APIRedirect 

type APIRedirect struct{}

APIRedirect is a redirect response swagger:response redirect

type APIRepoArchivedError 

type APIRepoArchivedError struct {
	APIError
}

APIRepoArchivedError is an error that is raised when an archived repo should be modified swagger:response repoArchivedError

type APIString 

type APIString string

APIString is a string response swagger:response string

type APIValidationError 

type APIValidationError struct {
	Message string `json:"message"`
	URL     string `json:"url"`
}

APIValidationError is error format response related to input validation swagger:response validationError

type Base 

type Base struct {
	reqctx.RequestContext

	Resp ResponseWriter
	Req  *http.Request

	// Data is prepared by ContextDataStore middleware, this field only refers to the pre-created/prepared ContextData.
	// Although it's mainly used for MVC templates, sometimes it's also used to pass data between middlewares/handler
	Data reqctx.ContextData

	// Locale is mainly for Web context, although the API context also uses it in some cases: message response, form validation
	Locale translation.Locale
}

Base is the base context for all web handlers ATTENTION: This struct should never be manually constructed in routes/services, it has many internal details which should be carefully prepared by the framework. If it is abused, it would cause strange bugs like panic/resource-leak.

func NewBaseContext 

func NewBaseContext(resp http.ResponseWriter, req *http.Request) *Base

func NewBaseContextForTest 

func NewBaseContextForTest(resp http.ResponseWriter, req *http.Request) *Base

func (*Base) AppendAccessControlExposeHeaders 

func (b *Base) AppendAccessControlExposeHeaders(names ...string)

AppendAccessControlExposeHeaders append headers by name to "Access-Control-Expose-Headers" header

func (*Base) FormBool 

func (b *Base) FormBool(key string) bool

FormBool returns true if the value for the provided key in the form is "1", "true" or "on"

func (*Base) FormInt 

func (b *Base) FormInt(key string) int

FormInt returns the first value for the provided key in the form as an int

func (*Base) FormInt64 

func (b *Base) FormInt64(key string) int64

FormInt64 returns the first value for the provided key in the form as an int64

func (*Base) FormOptionalBool 

func (b *Base) FormOptionalBool(key string) optional.Option[bool]

FormOptionalBool returns an optional.Some(true) or optional.Some(false) if the value for the provided key exists in the form else it returns optional.None[bool]()

func (*Base) FormString 

func (b *Base) FormString(key string, def ...string) string

FormString returns the first value matching the provided key in the form as a string It works the same as http.Request.FormValue: try urlencoded request body first, then query string, then multipart form body

func (*Base) FormStrings 

func (b *Base) FormStrings(key string) []string

FormStrings returns a values for the key in the form (including query parameters), similar to FormString

func (*Base) FormTrim 

func (b *Base) FormTrim(key string) string

FormTrim returns the first value for the provided key in the form as a space trimmed string

func (*Base) HTTPError 

func (b *Base) HTTPError(status int, contents ...string)

HTTPError returned an error to web browser FIXME: many calls to this HTTPError are not right: it shouldn't expose err.Error() directly, it doesn't accept more than one content

func (*Base) JSON 

func (b *Base) JSON(status int, content any)

JSON render content as JSON

func (*Base) ParseMultipartForm 

func (b *Base) ParseMultipartForm() bool

func (*Base) PathParam 

func (b *Base) PathParam(name string) string

PathParam returns the param in request path, eg: "/{var}" => "/a%2fb", then `var == "a/b"`

func (*Base) PathParamInt64 

func (b *Base) PathParamInt64(p string) int64

PathParamInt64 returns the param in request path as int64

func (*Base) PathParamRaw 

func (b *Base) PathParamRaw(name string) string

PathParamRaw returns the raw param in request path, eg: "/{var}" => "/a%2fb", then `var == "a%2fb"`

func (*Base) PlainText 

func (b *Base) PlainText(status int, text string)

PlainText renders content as plain text

func (*Base) PlainTextBytes 

func (b *Base) PlainTextBytes(status int, bs []byte)

PlainTextBytes renders bytes as plain text

func (*Base) Redirect 

func (b *Base) Redirect(location string, status ...int)

Redirect redirects the request

func (*Base) RemoteAddr 

func (b *Base) RemoteAddr() string

RemoteAddr returns the client machine ip address

func (*Base) RespHeader 

func (b *Base) RespHeader() http.Header

RespHeader returns the response header

func (*Base) ServeContent 

func (b *Base) ServeContent(r io.ReadSeeker, opts *ServeHeaderOptions)

ServeContent serves content to http request

func (*Base) SetFormString 

func (b *Base) SetFormString(key, value string)

func (*Base) SetPathParam 

func (b *Base) SetPathParam(name, value string)

SetPathParam set request path params into routes

func (*Base) SetServeHeaders 

func (b *Base) SetServeHeaders(opt *ServeHeaderOptions)

func (*Base) SetTotalCountHeader 

func (b *Base) SetTotalCountHeader(total int64)

SetTotalCountHeader set "X-Total-Count" header

func (*Base) Status 

func (b *Base) Status(status int)

Status writes status code

func (*Base) Tr 

func (b *Base) Tr(msg string, args ...any) template.HTML

func (*Base) TrN 

func (b *Base) TrN(cnt any, key1, keyN string, args ...any) template.HTML

func (*Base) Write 

func (b *Base) Write(bs []byte) (int, error)

Write writes data to web browser

func (*Base) Written 

func (b *Base) Written() bool

Written returns true if there are something sent to web browser

func (*Base) WrittenStatus 

func (b *Base) WrittenStatus() int

type BaseContextKeyType 

type BaseContextKeyType struct{}
var BaseContextKey BaseContextKeyType

type CSRFProtector 

type CSRFProtector interface {
	// PrepareForSessionUser prepares the csrf protector for the current session user.
	PrepareForSessionUser(ctx *Context)
	// Validate validates the csrf token in http context.
	Validate(ctx *Context)
	// DeleteCookie deletes the csrf cookie
	DeleteCookie(ctx *Context)
}

CSRFProtector represents a CSRF protector and is used to get the current token and validate the token.

func NewCSRFProtector 

func NewCSRFProtector(opt CsrfOptions) CSRFProtector

type CommitFormOptions 

type CommitFormOptions struct {
	NeedFork bool

	TargetRepo               *repo_model.Repository
	TargetFormAction         string
	WillSubmitToFork         bool
	CanCommitToBranch        bool
	UserCanPush              bool
	RequireSigned            bool
	WillSign                 bool
	SigningKeyFormDisplay    string
	WontSignReason           string
	CanCreatePullRequest     bool
	CanCreateBasePullRequest bool
}

func PrepareCommitFormOptions 

func PrepareCommitFormOptions(ctx *Context, doer *user_model.User, targetRepo *repo_model.Repository, doerRepoPerm access_model.Permission, refName git.RefName) (*CommitFormOptions, error)

type Context 

type Context struct {
	*Base

	TemplateContext TemplateContext

	Render   Render
	PageData map[string]any // data used by JavaScript modules in one page, it's `window.config.pageData`

	Cache   cache.StringCache
	Csrf    CSRFProtector
	Flash   *middleware.Flash
	Session session.Store

	Link string // current request URL (without query string)

	Doer        *user_model.User // current signed-in user
	IsSigned    bool
	IsBasicAuth bool

	ContextUser *user_model.User // the user which is being visited, in most cases it differs from Doer

	Repo    *Repository
	Org     *Organization
	Package *Package
}

Context represents context of a web request. ATTENTION: This struct should never be manually constructed in routes/services, it has many internal details which should be carefully prepared by the framework. If it is abused, it would cause strange bugs like panic/resource-leak.

func GetWebContext 

func GetWebContext(ctx context.Context) *Context

func NewWebContext 

func NewWebContext(base *Base, render Render, session session.Store) *Context

func (*Context) DeleteSiteCookie 

func (ctx *Context) DeleteSiteCookie(name string)

DeleteSiteCookie convenience function to delete most cookies consistently CSRF and a few others are the exception here

func (*Context) DoerNeedTwoFactorAuth 

func (ctx *Context) DoerNeedTwoFactorAuth() bool

func (*Context) GetErrMsg 

func (ctx *Context) GetErrMsg() string

GetErrMsg returns error message in form validation.

func (*Context) GetSiteCookie 

func (ctx *Context) GetSiteCookie(name string) string

GetSiteCookie returns given cookie value from request header.

func (*Context) HTML 

func (ctx *Context) HTML(status int, name templates.TplName)

HTML calls Context.HTML and renders the template to HTTP response

func (*Context) HasError 

func (ctx *Context) HasError() bool

HasError returns true if error occurs in form validation. Attention: this function changes ctx.Data and ctx.Flash If HasError is called, then before Redirect, the error message should be stored by ctx.Flash.Error(ctx.GetErrMsg()) again.

func (*Context) IsUserSiteAdmin 

func (ctx *Context) IsUserSiteAdmin() bool

IsUserSiteAdmin returns true if current user is a site admin

func (*Context) JSONError 

func (ctx *Context) JSONError(msg any)

func (*Context) JSONErrorNotFound 

func (ctx *Context) JSONErrorNotFound(optMsg ...string)

func (*Context) JSONOK 

func (ctx *Context) JSONOK()

func (*Context) JSONRedirect 

func (ctx *Context) JSONRedirect(redirect string)

func (*Context) JSONTemplate 

func (ctx *Context) JSONTemplate(tmpl templates.TplName)

JSONTemplate renders the template as JSON response keep in mind that the template is processed in HTML context, so JSON things should be handled carefully, e.g.: use JSEscape

func (*Context) NotFound 

func (ctx *Context) NotFound(logErr error)

NotFound displays a 404 (Not Found) page and prints the given error, if any.

func (*Context) NotFoundOrServerError 

func (ctx *Context) NotFoundOrServerError(logMsg string, errCheck func(error) bool, logErr error)

NotFoundOrServerError use error check function to determine if the error is about not found. It responds with 404 status code for not found error, or error context description for logging purpose of 500 server error. TODO: remove the "errCheck" and use util.ErrNotFound to check

func (*Context) RedirectToCurrentSite 

func (ctx *Context) RedirectToCurrentSite(location ...string)

RedirectToCurrentSite redirects to first not empty URL which belongs to current site

func (*Context) RenderToHTML 

func (ctx *Context) RenderToHTML(name templates.TplName, data any) (template.HTML, error)

RenderToHTML renders the template content to a HTML string

func (*Context) RenderWithErr 

func (ctx *Context) RenderWithErr(msg any, tpl templates.TplName, form any)

RenderWithErr used for page has form validation but need to prompt error to users.

func (*Context) ServerError 

func (ctx *Context) ServerError(logMsg string, logErr error)

ServerError displays a 500 (Internal Server Error) page and prints the given error, if any.

func (*Context) SetSiteCookie 

func (ctx *Context) SetSiteCookie(name, value string, maxAge int)

SetSiteCookie convenience function to set most cookies consistently CSRF and a few others are the exception here

func (*Context) UploadStream 

func (ctx *Context) UploadStream() (rd io.ReadCloser, needToClose bool, err error)

UploadStream returns the request body or the first form file Only form files need to get closed.

type CsrfOptions 

type CsrfOptions struct {
	// The global secret value used to generate Tokens.
	Secret string
	// Cookie value used to set and get token.
	Cookie string
	// Cookie domain.
	CookieDomain string
	// Cookie path.
	CookiePath     string
	CookieHTTPOnly bool
	// SameSite set the cookie SameSite type
	SameSite http.SameSite
	// Set the Secure flag to true on the cookie.
	Secure bool
	// contains filtered or unexported fields
}

CsrfOptions maintains options to manage behavior of Generate.

type OrgAssignmentOptions 

type OrgAssignmentOptions struct {
	RequireMember     bool
	RequireOwner      bool
	RequireTeamMember bool
	RequireTeamAdmin  bool
}

type Organization 

type Organization struct {
	IsOwner          bool
	IsMember         bool
	IsTeamMember     bool // Is member of team.
	IsTeamAdmin      bool // In owner team or team that has admin permission level.
	Organization     *organization.Organization
	OrgLink          string
	CanCreateOrgRepo bool

	Team  *organization.Team
	Teams []*organization.Team
}

Organization contains organization context

func (*Organization) CanReadUnit 

func (org *Organization) CanReadUnit(ctx *Context, unitType unit.Type) bool

func (*Organization) CanWriteUnit 

func (org *Organization) CanWriteUnit(ctx *Context, unitType unit.Type) bool

type Package 

type Package struct {
	Owner      *user_model.User
	AccessMode perm.AccessMode
	Descriptor *packages_model.PackageDescriptor
}

Package contains owner, access mode and optional the package descriptor

type Pagination 

type Pagination struct {
	Paginater *paginator.Paginator
	// contains filtered or unexported fields
}

Pagination provides a pagination via paginator.Paginator and additional configurations for the link params used in rendering

func NewPagination 

func NewPagination(total, pagingNum, current, numPages int) *Pagination

NewPagination creates a new instance of the Pagination struct. "pagingNum" is "page size" or "limit", "current" is "page" total=-1 means only showing prev/next

func (*Pagination) AddParamFromQuery 

func (p *Pagination) AddParamFromQuery(q url.Values)

func (*Pagination) AddParamFromRequest 

func (p *Pagination) AddParamFromRequest(req *http.Request)

func (*Pagination) GetParams 

func (p *Pagination) GetParams() template.URL

GetParams returns the configured URL params

func (*Pagination) WithCurRows 

func (p *Pagination) WithCurRows(n int) *Pagination

type PrivateContext 

type PrivateContext struct {
	*Base
	Override context.Context

	Repo *Repository
}

PrivateContext represents a context for private routes

func GetPrivateContext 

func GetPrivateContext(req *http.Request) *PrivateContext

func (*PrivateContext) Deadline 

func (ctx *PrivateContext) Deadline() (deadline time.Time, ok bool)

func (*PrivateContext) Done 

func (ctx *PrivateContext) Done() <-chan struct{}

func (*PrivateContext) Err 

func (ctx *PrivateContext) Err() error

type PullRequest 

type PullRequest struct {
	BaseRepo *repo_model.Repository
	Allowed  bool // it only used by the web tmpl: "PullRequestCtx.Allowed"
	SameRepo bool // it only used by the web tmpl: "PullRequestCtx.SameRepo"
}

PullRequest contains information to make a pull request

type Render 

type Render interface {
	TemplateLookup(tmpl string, templateCtx context.Context) (templates.TemplateExecutor, error)
	HTML(w io.Writer, status int, name templates.TplName, data any, templateCtx context.Context) error
}

Render represents a template render

type Repository 

type Repository struct {
	access_model.Permission

	Repository *repo_model.Repository
	Owner      *user_model.User

	RepoLink string
	GitRepo  *git.Repository

	// RefFullName is the full ref name that the user is viewing
	RefFullName git.RefName
	BranchName  string // it is the RefFullName's short name if its type is "branch"
	TreePath    string

	// Commit it is always set to the commit for the branch or tag, or just the commit that the user is viewing
	Commit       *git.Commit
	CommitID     string
	CommitsCount int64

	PullRequest *PullRequest
}

Repository contains information to operate a repository

func (*Repository) CanCreateBranch 

func (r *Repository) CanCreateBranch() bool

CanCreateBranch returns true if repository is editable and user has proper access level.

func (*Repository) CanCreateIssueDependencies 

func (r *Repository) CanCreateIssueDependencies(ctx context.Context, user *user_model.User, isPull bool) bool

CanCreateIssueDependencies returns whether or not a user can create dependencies.

func (*Repository) CanUseTimetracker 

func (r *Repository) CanUseTimetracker(ctx context.Context, issue *issues_model.Issue, user *user_model.User) bool

CanUseTimetracker returns whether a user can use the timetracker.

func (*Repository) CanWriteToBranch 

func (r *Repository) CanWriteToBranch(ctx context.Context, user *user_model.User, branch string) bool

CanWriteToBranch checks if the branch is writable by the user

func (*Repository) GetCommitGraphsCount 

func (r *Repository) GetCommitGraphsCount(ctx context.Context, hidePRRefs bool, branches, files []string) (int64, error)

GetCommitGraphsCount returns cached commit count for current view

func (*Repository) GetCommitsCount 

func (r *Repository) GetCommitsCount() (int64, error)

GetCommitsCount returns cached commit count for current view

func (*Repository) GetEditorconfig 

func (r *Repository) GetEditorconfig(optCommit ...*git.Commit) (cfg *editorconfig.Editorconfig, warning, err error)

GetEditorconfig returns the .editorconfig definition if found in the HEAD of the default repo branch.

func (*Repository) GetObjectFormat 

func (r *Repository) GetObjectFormat() git.ObjectFormat

func (*Repository) RefTypeNameSubURL 

func (r *Repository) RefTypeNameSubURL() string

RefTypeNameSubURL makes a sub-url for the current ref (branch/tag/commit) field, for example: * "branch/master" * "tag/v1.0.0" * "commit/123456" It is usually used to construct a link like ".../src/{{RefTypeNameSubURL}}/{{PathEscapeSegments TreePath}}"

type Response 

type Response struct {
	http.ResponseWriter
	// contains filtered or unexported fields
}

Response represents a response

func WrapResponseWriter 

func WrapResponseWriter(resp http.ResponseWriter) *Response

func (*Response) Before 

func (r *Response) Before(fn func(ResponseWriter))

Before allows for a function to be called before the ResponseWriter has been written to. This is useful for setting headers or any other operations that must happen before a response has been written.

func (*Response) Flush 

func (r *Response) Flush()

Flush flushes cached data

func (*Response) Write 

func (r *Response) Write(bs []byte) (int, error)

Write writes bytes to HTTP endpoint

func (*Response) WriteHeader 

func (r *Response) WriteHeader(statusCode int)

WriteHeader write status code

func (*Response) WrittenSize 

func (r *Response) WrittenSize() int

func (*Response) WrittenStatus 

func (r *Response) WrittenStatus() int

WrittenStatus returned status code written

type ResponseWriter 

type ResponseWriter interface {
	http.ResponseWriter              // provides Header/Write/WriteHeader
	http.Flusher                     // provides Flush
	web_types.ResponseStatusProvider // provides WrittenStatus

	Before(fn func(ResponseWriter))
	WrittenSize() int
}

ResponseWriter represents a response writer for HTTP

type ServeHeaderOptions 

type ServeHeaderOptions httplib.ServeHeaderOptions

type TemplateContext 

type TemplateContext map[string]any

func NewTemplateContext 

func NewTemplateContext(ctx context.Context) TemplateContext

func NewTemplateContextForWeb 

func NewTemplateContextForWeb(ctx *Context) TemplateContext

func (TemplateContext) Deadline 

func (c TemplateContext) Deadline() (deadline time.Time, ok bool)

func (TemplateContext) Done 

func (c TemplateContext) Done() <-chan struct{}

func (TemplateContext) Err 

func (c TemplateContext) Err() error

func (TemplateContext) Value 

func (c TemplateContext) Value(key any) any

type ValidateContext 

type ValidateContext struct {
	*Base
}

ValidateContext is a special context for form validation middleware. It may be different from other contexts.

func GetValidateContext 

func GetValidateContext(req *http.Request) (ctx *ValidateContext)

GetValidateContext gets a context for middleware form validation

Source Files

View all Source files

Directories

Path Synopsis

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.