all: rename functions, deprecate old ones

Rename get_by_* to user_by_* and get_all to users. users() now can return errors.
This commit is contained in:
ge
2026-03-18 15:46:31 +03:00
parent 326d93714a
commit bdaaaaae58
3 changed files with 32 additions and 8 deletions

26
pwd.c.v
View File

@@ -76,7 +76,14 @@ fn make_error(name string, uid int) IError {
// get_by_uid returns the passwd database entry by user ID.
// If the entry is not found, the EntryNotFoundError error will be returned.
@[deprecated: 'use user_by_uid() instead']
pub fn get_by_uid(uid int) !Passwd {
return user_by_uid(uid)!
}
// user_by_uid returns the passwd database entry by user ID.
// If the entry is not found, the EntryNotFoundError error will be returned.
pub fn user_by_uid(uid int) !Passwd {
pwd_mutex.lock()
defer {
pwd_mutex.unlock()
@@ -88,9 +95,16 @@ pub fn get_by_uid(uid int) !Passwd {
return make_passwd(pw)
}
// get_by_uid returns the passwd database entry by user name.
// get_by_name returns the passwd database entry by user name.
// If the entry is not found, the EntryNotFoundError error will be returned.
@[deprecated: 'use user_by_name() instead']
pub fn get_by_name(name string) !Passwd {
return user_by_name(name)!
}
// user_by_name returns the passwd database entry by user name.
// If the entry is not found, the EntryNotFoundError error will be returned.
pub fn user_by_name(name string) !Passwd {
pwd_mutex.lock()
defer {
pwd_mutex.unlock()
@@ -103,7 +117,13 @@ pub fn get_by_name(name string) !Passwd {
}
// get_all returns all entries from passwd database in arbitrary order.
@[deprecated: 'use users() instead']
pub fn get_all() []Passwd {
return users() or { []Passwd{} }
}
// users returns all entries from passwd database in arbitrary order.
pub fn users() ![]Passwd {
mut pwds := []Passwd{}
pwd_mutex.lock()
C.setpwent()
@@ -113,6 +133,10 @@ pub fn get_all() []Passwd {
}
for {
pw := C.getpwent()
err := make_error('', -1)
if err.code() != 0 {
return err
}
if isnil(pw) {
break
}