sys-admin 1.7.2 → 1.7.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 9cd8a632a7bc840cae58cdd7785e2501581b43c41630937f5a63ae5469564eb3
4
- data.tar.gz: 5b60547b6032b02f07e44681f2c0ff4a3235baa3183a91f8a58388c82211c31e
3
+ metadata.gz: ed8265d7faf748f05d74e14aeef599e1e9101d5480d10c282f5c731b56281f2b
4
+ data.tar.gz: eaca7073f23fc715de53c8a0fc6487390add8f05253f1834f1df9be7b0b0126c
5
5
  SHA512:
6
- metadata.gz: 1102939c04babc0b7dfacd9c4e6dea17206d0407b432dd8dd8cae377663dfc3ecd2f1a48933bbc2b9c78516656e9e2fc7cb7e46a2e970b35396ff118ebf8b1fe
7
- data.tar.gz: c8574438594e1ea2096fce59cafcce9319652ac43e22a98e5d47692109d0ed0fde1e0a2e4706843dd61c048a9913348307c531cce0d84c4a11da70e4d1980a22
6
+ metadata.gz: 3a49546596e70769a87c1d9833605959e2a3652ae06bc62349feddb56a1e7d6925f2abfab9bb8d122c8cbe4086b83ba27d65bb438583841e8dea52a72af4ac21
7
+ data.tar.gz: 85f6523a0390542e60d0c63c3954961c4218487db29ca40a9b4c2f35bf3be228d2eec5969f5bc1df091a6d263249caa271484b26dceb4ff39684c5c566df98d8
Binary file
data.tar.gz.sig CHANGED
Binary file
@@ -1,3 +1,8 @@
1
+ == 1.7.3 - 16-Jan-2020
2
+ * Add explicit .rdoc extension to various rdoc files so that they show up
3
+ better in github.
4
+ * Some formatting adjustments to the rdoc files.
5
+
1
6
  == 1.7.2 - 28-Jan-2019
2
7
  * Fixed the license name, was missing a hyphen.
3
8
  * Fixed the homepage in the gemspec.
@@ -1,8 +1,8 @@
1
1
  * sys-admin.gemspec
2
- * CHANGES
3
- * MANIFEST
2
+ * CHANGES.rdoc
3
+ * MANIFEST.rdoc
4
4
  * Rakefile
5
- * README
5
+ * README.rdoc
6
6
  * certs/djberg96_pub.pem
7
7
  * examples/groups.rb
8
8
  * examples/users.rb
@@ -0,0 +1,153 @@
1
+ == Description
2
+ The sys-admin library is a unified, cross platform replacement for the Etc module.
3
+
4
+ == Installation
5
+ gem install sys-admin
6
+
7
+ == Synopsis
8
+ require 'sys/admin' # or sys-admin
9
+ include Sys
10
+
11
+ # Returns an Array of User objects
12
+ a = Admin.users
13
+
14
+ # Returns an Array of Group objects
15
+ g = Admin.groups
16
+
17
+ # Get information about a particular user
18
+ p Admin.get_user("nobody")
19
+ p Admin.get_user("nobody", :localaccount => true)
20
+
21
+ # Get information about a particular group
22
+ p Admin.get_group("adm")
23
+ p Admin.get_group("adm", :localaccount => true)
24
+
25
+ == Admin
26
+ Admin.get_login
27
+
28
+ Returns the user name (only) of the current login.
29
+
30
+ Admin.get_user(name, options = {})
31
+ Admin.get_user(uid, options = {})
32
+
33
+ Returns a User object based on +name+ or +uid+. The +options+ hash is
34
+ for MS Windows only, and allows you to restrict the search based on the
35
+ options you provide, e.g. 'domain' or 'localaccount'.
36
+
37
+ Admin.get_group(name, options = {})
38
+ Admin.get_group(gid, options = {})
39
+
40
+ Returns a Group object based on +name+ or +uid+. The +options+ hash is
41
+ for MS Windows only, and allows you to restrict the search based on the
42
+ options you provide, e.g. 'domain' or 'localaccount'.
43
+
44
+ Admin.groups(options = {})
45
+
46
+ Returns an Array of Group objects.
47
+
48
+ The +options+ hash is for MS Windows only, and allows you to restrict the
49
+ search based on the options you provide, e.g. 'domain' or 'localaccount'.
50
+
51
+ Admin.users(options = {})
52
+
53
+ Returns an Array of User objects.
54
+
55
+ The +options+ hash is for MS Windows only, and allows you to restrict the
56
+ search based on the options you provide, e.g. 'domain' or 'localaccount'.
57
+
58
+ == User class
59
+ === User (Windows)
60
+ The User class has the following attributes on MS Windows systems:
61
+
62
+ * account_type
63
+ * caption
64
+ * description
65
+ * domain
66
+ * password
67
+ * full_name
68
+ * gid
69
+ * install_date
70
+ * name
71
+ * sid
72
+ * status
73
+ * disabled?
74
+ * local?
75
+ * lockout?
76
+ * password_changeable?
77
+ * password_expires?
78
+ * password_required?
79
+ * uid
80
+
81
+ === User (Unix)
82
+ The User class has the following attributes on Unix systems:
83
+
84
+ * name
85
+ * passwd
86
+ * uid
87
+ * gid
88
+ * dir
89
+ * shell
90
+ * gecos
91
+ * quota
92
+ * age
93
+ * class
94
+ * comment
95
+ * change
96
+ * expire
97
+
98
+ == Group Classes
99
+ === Group (Windows)
100
+ The Group class has the following attributes on MS Windows systems:
101
+
102
+ * caption
103
+ * description
104
+ * domain
105
+ * install_date
106
+ * name
107
+ * sid
108
+ * status
109
+ * gid
110
+ * local?
111
+
112
+ === Group (Unix)
113
+ The Group class has the following attributes on Unix systems:
114
+
115
+ * name
116
+ * gid
117
+ * members
118
+ * passwd
119
+
120
+ == Error Classes
121
+ Admin::Error < StandardError
122
+
123
+ Raised if anything goes wrong with any of the above methods.
124
+
125
+ == Developer's Notes
126
+ === MS Windows
127
+ The Windows version now uses a win32ole + WMI approach to getting
128
+ information. This means that the WMI service must be running on the
129
+ target machine in order to work (which it is, by default).
130
+
131
+ === UNIX
132
+ The underlying implementation is similar to core Ruby's Etc implementation.
133
+ But, in addition to the different interface, I use the re-entrant version
134
+ of the appropriate functions when available.
135
+
136
+ == Future Plans
137
+ * Make the User and Group objects comparable.
138
+ * Add ability to add, configure and delete users on Unix platforms.
139
+
140
+ == Known Bugs
141
+ None that I'm aware of. If you find any, please log them on the project page at:
142
+
143
+ https://github.com/djberg96/sys-admin
144
+
145
+ == License
146
+ Apache-2.0
147
+
148
+ == Copyright
149
+ (C) 2005-2020, Daniel J. Berger
150
+ All Rights Reserved
151
+
152
+ == Author
153
+ Daniel J. Berger
@@ -1,7 +1,7 @@
1
1
  module Sys
2
2
  class Admin
3
3
  # The version of the sys-admin library.
4
- VERSION = '1.7.2'.freeze
4
+ VERSION = '1.7.3'.freeze
5
5
  end
6
6
  end
7
7
 
@@ -3,7 +3,7 @@ require 'rubygems'
3
3
 
4
4
  Gem::Specification.new do |spec|
5
5
  spec.name = 'sys-admin'
6
- spec.version = '1.7.2'
6
+ spec.version = '1.7.3'
7
7
  spec.author = 'Daniel J. Berger'
8
8
  spec.license = 'Apache-2.0'
9
9
  spec.email = 'djberg96@gmail.com'
@@ -13,7 +13,7 @@ Gem::Specification.new do |spec|
13
13
  spec.files = Dir['**/*'].reject{ |f| f.include?('git') }
14
14
  spec.cert_chain = ['certs/djberg96_pub.pem']
15
15
 
16
- spec.extra_rdoc_files = ['CHANGES', 'README', 'MANIFEST']
16
+ spec.extra_rdoc_files = Dir['*.rdoc']
17
17
 
18
18
  spec.add_dependency('ffi', '>= 1.1.0')
19
19
 
@@ -14,7 +14,7 @@ end
14
14
 
15
15
  class TC_Sys_Admin_All < Test::Unit::TestCase
16
16
  test "version is set to expected value" do
17
- assert_equal('1.7.2', Sys::Admin::VERSION)
17
+ assert_equal('1.7.3', Sys::Admin::VERSION)
18
18
  end
19
19
 
20
20
  test "version constant is frozen" do
metadata CHANGED
@@ -1,7 +1,7 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: sys-admin
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.7.2
4
+ version: 1.7.3
5
5
  platform: ruby
6
6
  authors:
7
7
  - Daniel J. Berger
@@ -89,25 +89,21 @@ email: djberg96@gmail.com
89
89
  executables: []
90
90
  extensions: []
91
91
  extra_rdoc_files:
92
- - CHANGES
93
- - README
94
- - MANIFEST
92
+ - CHANGES.rdoc
93
+ - MANIFEST.rdoc
94
+ - README.rdoc
95
95
  files:
96
- - CHANGES
97
96
  - test
98
97
  - test/test_sys_admin_unix.rb
99
- - test/test_sys_admin.rb
100
98
  - test/test_sys_admin_windows.rb
101
- - sys-admin.gemspec
99
+ - test/test_sys_admin.rb
102
100
  - examples
103
101
  - examples/example_groups.rb
104
102
  - examples/example_users.rb
105
103
  - doc
106
104
  - doc/sys-admin-windows.txt
107
105
  - doc/sys-admin-unix.txt
108
- - README
109
106
  - Rakefile
110
- - MANIFEST
111
107
  - lib
112
108
  - lib/windows
113
109
  - lib/windows/sys
@@ -129,12 +125,16 @@ files:
129
125
  - lib/unix/sys
130
126
  - lib/unix/sys/admin.rb
131
127
  - lib/sys
132
- - lib/sys/admin.rb
133
128
  - lib/sys/admin
134
129
  - lib/sys/admin/custom.rb
135
130
  - lib/sys/admin/common.rb
131
+ - lib/sys/admin.rb
136
132
  - certs
137
133
  - certs/djberg96_pub.pem
134
+ - CHANGES.rdoc
135
+ - MANIFEST.rdoc
136
+ - README.rdoc
137
+ - sys-admin.gemspec
138
138
  homepage: http://www.github.com/djberg96/sys-admin
139
139
  licenses:
140
140
  - Apache-2.0
@@ -160,7 +160,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
160
160
  - !ruby/object:Gem::Version
161
161
  version: '0'
162
162
  requirements: []
163
- rubygems_version: 3.0.2
163
+ rubygems_version: 3.0.6
164
164
  signing_key:
165
165
  specification_version: 4
166
166
  summary: A unified, cross platform replacement for the "etc" library.
metadata.gz.sig CHANGED
Binary file
data/README DELETED
@@ -1,148 +0,0 @@
1
- == Description
2
- The sys-admin library is a unified, cross platform replacement for the Etc module.
3
-
4
- == Installation
5
- gem install sys-admin
6
-
7
- == Synopsis
8
- require 'sys/admin' # or sys-admin
9
- include Sys
10
-
11
- # Returns an Array of User objects
12
- a = Admin.users
13
-
14
- # Returns an Array of Group objects
15
- g = Admin.groups
16
-
17
- # Get information about a particular user
18
- p Admin.get_user("nobody")
19
- p Admin.get_user("nobody", :localaccount => true)
20
-
21
- # Get information about a particular group
22
- p Admin.get_group("adm")
23
- p Admin.get_group("adm", :localaccount => true)
24
-
25
- == Admin
26
- Admin.get_login
27
- Returns the user name (only) of the current login.
28
-
29
- Admin.get_user(name, options = {})
30
- Admin.get_user(uid, options = {})
31
- Returns a User object based on +name+ or +uid+. The +options+ hash is
32
- for MS Windows only, and allows you to restrict the search based on the
33
- options you provide, e.g. 'domain' or 'localaccount'.
34
-
35
- Admin.get_group(name, options = {})
36
- Admin.get_group(gid, options = {})
37
- Returns a Group object based on +name+ or +uid+. The +options+ hash is
38
- for MS Windows only, and allows you to restrict the search based on the
39
- options you provide, e.g. 'domain' or 'localaccount'.
40
-
41
- Admin.groups(options = {})
42
- Returns an Array of Group objects.
43
-
44
- The +options+ hash is for MS Windows only, and allows you to restrict the
45
- search based on the options you provide, e.g. 'domain' or 'localaccount'.
46
-
47
- Admin.users(options = {})
48
- Returns an Array of User objects.
49
-
50
- The +options+ hash is for MS Windows only, and allows you to restrict the
51
- search based on the options you provide, e.g. 'domain' or 'localaccount'.
52
-
53
- == User class
54
- === User (Windows)
55
- The User class has the following attributes on MS Windows systems:
56
-
57
- * account_type
58
- * caption
59
- * description
60
- * domain
61
- * password
62
- * full_name
63
- * gid
64
- * install_date
65
- * name
66
- * sid
67
- * status
68
- * disabled?
69
- * local?
70
- * lockout?
71
- * password_changeable?
72
- * password_expires?
73
- * password_required?
74
- * uid
75
-
76
- === User (Unix)
77
- The User class has the following attributes on Unix systems:
78
-
79
- * name
80
- * passwd
81
- * uid
82
- * gid
83
- * dir
84
- * shell
85
- * gecos
86
- * quota
87
- * age
88
- * class
89
- * comment
90
- * change
91
- * expire
92
-
93
- == Group Classes
94
- === Group (Windows)
95
- The Group class has the following attributes on MS Windows systems:
96
-
97
- * caption
98
- * description
99
- * domain
100
- * install_date
101
- * name
102
- * sid
103
- * status
104
- * gid
105
- * local?
106
-
107
- === Group (Unix)
108
- The Group class has the following attributes on Unix systems:
109
-
110
- * name
111
- * gid
112
- * members
113
- * passwd
114
-
115
- == Error Classes
116
- Admin::Error < StandardError
117
- Raised if anything goes wrong with any of the above methods.
118
-
119
- == Developer's Notes
120
- === MS Windows
121
- The Windows version now uses a win32ole + WMI approach to getting
122
- information. This means that the WMI service must be running on the
123
- target machine in order to work (which it is, by default).
124
-
125
- === UNIX
126
- The underlying implementation is similar to core Ruby's Etc implementation.
127
- But, in addition to the different interface, I use the re-entrant version
128
- of the appropriate functions when available.
129
-
130
- == Future Plans
131
- Make the User and Group objects comparable.
132
- Add ability to add, configure and delete users on Unix platforms.
133
-
134
- == Known Bugs
135
- None that I'm aware of. If you find any, please log them on the project
136
- page at:
137
-
138
- https://github.com/djberg96/sys-admin
139
-
140
- == License
141
- Apache-2.0
142
-
143
- == Copyright
144
- (C) 2005-2019, Daniel J. Berger
145
- All Rights Reserved
146
-
147
- == Author
148
- Daniel J. Berger