snapshot of https://github.com/casbin/casbin.git (master, 2026-09-15; blobs > 131072B omitted)

rbac/context_role_manager.go

@@ -0,0 +1,49 @@
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
+//
+//   http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
+
+package rbac
+
+import "context"
+
+// ContextRoleManager provides a context-aware interface to define the operations for managing roles.
+// Prefer this over RoleManager interface for context propagation, which is useful for things like handling
+// request timeouts.
+type ContextRoleManager interface {
+	RoleManager
+
+	// ClearCtx clears all stored data and resets the role manager to the initial state with context.
+	ClearCtx(ctx context.Context) error
+	// AddLinkCtx adds the inheritance link between two roles. role: name1 and role: name2 with context.
+	// domain is a prefix to the roles (can be used for other purposes).
+	AddLinkCtx(ctx context.Context, name1 string, name2 string, domain ...string) error
+	// DeleteLinkCtx deletes the inheritance link between two roles. role: name1 and role: name2 with context.
+	// domain is a prefix to the roles (can be used for other purposes).
+	DeleteLinkCtx(ctx context.Context, name1 string, name2 string, domain ...string) error
+	// HasLinkCtx determines whether a link exists between two roles. role: name1 inherits role: name2 with context.
+	// domain is a prefix to the roles (can be used for other purposes).
+	HasLinkCtx(ctx context.Context, name1 string, name2 string, domain ...string) (bool, error)
+	// GetRolesCtx gets the roles that a user inherits with context.
+	// domain is a prefix to the roles (can be used for other purposes).
+	GetRolesCtx(ctx context.Context, name string, domain ...string) ([]string, error)
+	// GetUsersCtx gets the users that inherits a role with context.
+	// domain is a prefix to the users (can be used for other purposes).
+	GetUsersCtx(ctx context.Context, name string, domain ...string) ([]string, error)
+	// GetDomainsCtx gets domains that a user has with context.
+	GetDomainsCtx(ctx context.Context, name string) ([]string, error)
+	// GetAllDomainsCtx gets all domains with context.
+	GetAllDomainsCtx(ctx context.Context) ([]string, error)
+}