https://github.com/djberg96/sys-filesystem

A Ruby library for getting filesystem information
https://github.com/djberg96/sys-filesystem

Keywords from Contributors

rubygems excon oauth2 authorization doorkeeper grape identity oauth oauth2-provider oauth2-server

Last synced: about 4 hours ago
JSON representation

Repository metadata

A Ruby library for getting filesystem information

Host: GitHub
URL: https://github.com/djberg96/sys-filesystem
Owner: djberg96
License: apache-2.0
Created: 2009-12-30T05:18:13.000Z (about 16 years ago)
Default Branch: main
Last Pushed: 2026-02-17T11:46:33.000Z (14 days ago)
Last Synced: 2026-02-24T14:18:10.497Z (7 days ago)
Language: Ruby
Homepage:
Size: 432 KB
Stars: 107
Watchers: 4
Forks: 24
Open Issues: 0
Releases: 0
Metadata Files:
- Readme: README.md
- Changelog: CHANGES.md
- Funding: .github/FUNDING.yml
- License: LICENSE

Description

A cross platform Ruby interface for getting file system information.

Installation

gem install sys-filesystem

Adding the trusted cert

gem cert --add <(curl -Ls https://raw.githubusercontent.com/djberg96/sys-filesystem/main/certs/djberg96_pub.pem)

Synopsis

require 'sys/filesystem'
include Sys
   
# Display information about a particular filesystem.
p Filesystem.stat('/')

# Sample output

#<Sys::Filesystem::Stat:0x517440
  @base_type = "ufs",
  @flags = 4,
  @files_available = 3817457,
  @block_size = 8192,
  @blocks_available = 19957633,
  @blocks = 34349612,
  @name_max = 255,
  @path = "/",
  @filesystem_id = 35651592,
  @files = 4135040,
  @fragment_size = 1024,
  @files_free = 3817457,
  @blocks_free = 20301129
>
   
# Describe all mount points on the system
Filesystem.mounts{ |mount| p mount }
   
# Find the mount point of any particular file
puts Filesystem.mount_point('/home/djberge/some_file.txt') => '/home'

Notes

This is a pure Ruby implementation that uses FFI. This means it should work
with JRuby, too.

Sample code

Run 'rake example' if you want to see a basic sample run. The actual code
is 'example_stat.rb' in the 'examples' directory. Modify it as you see fit.

Known Issues

Currently this may not work if you're running a 32-bit system with 64-bit offsets:

https://github.com/djberg96/sys-filesystem/issues/71

Please report any other issues on the project home page at:

https://github.com/djberg96/sys-filesystem

Future Plans

Suggestions welcome.

Acknowledgements

Mike Hall, for ideas and code that I borrowed from his 'filesystem' library.
Park Heesob, for implementation and API ideas for the MS Windows version.
Nobuyoshi Miyokawa, for adding the original FreeBSD and OS X support.

License

Apache-2.0

Copyright

Warranty

This library is provided "as is" and without any express or
implied warranties, including, without limitation, the implied
warranties of merchantability and fitness for a particular purpose.

Author

Daniel J. Berger

Owner metadata

Name: Daniel Berger
Login: djberg96
Email:
Kind: user
Description: Ruby and C, plus Perl back in the day. Wannabe Crystal and Elixir programmer. Currently doing Rails stuff.
Website: http://djberg96.livejournal.com
Location: Raleigh, NC
Twitter: djberg96
Company:
Icon url: https://avatars.githubusercontent.com/u/78529?v=4
Repositories: 118
Last ynced at: 2025-10-06T14:42:42.480Z
Profile URL: https://github.com/djberg96

GitHub Events

Total

Pull request event: 3
Fork event: 1
Issues event: 1
Watch event: 2
Issue comment event: 4
Push event: 6
Pull request review comment event: 4
Pull request review event: 2
Create event: 2

Last Year

Pull request event: 1
Issues event: 1
Watch event: 1
Issue comment event: 4
Push event: 5
Pull request review event: 1
Pull request review comment event: 4
Create event: 2

Committers metadata

Last synced: 3 days ago

Total Commits: 364
Total Committers: 17
Avg Commits per committer: 21.412
Development Distribution Score (DDS): 0.22

Commits in past year: 15
Committers in past year: 1
Avg Commits per committer in past year: 15.0
Development Distribution Score (DDS) in past year: 0.0

Name	Email	Commits
Daniel Berger	d**6@g**m	284
Daniel Berger	d**r@r**m	26
Daniel Berger	d**r@g**v	18
Daniel Berger	d**r@c**m	7
hirura	h**a@g**m	7
Alexei Khlebnikov	a**v@g**m	6
Igor Victor	g**a@y**u	4
Michael Pope	m**7@g**m	2
Tasos Sahanidis	t**s@t**m	2
Andrei Filipovici	a**i@p**m	1
Andrew L. Moore	s**s@g**m	1
Andrew Nesbitt	a**z@g**m	1
Josh Cooper	j****r	1
Mike Owens	m**s@l**g	1
Nick LaMuro	n**o@g**m	1
Praveen Arimbrathodiyil	p**n@d**g	1
Thomas Langé	t**s@g**m	1

Committer domains:

Issue and Pull Request metadata

Last synced: 9 days ago

Total issues: 33
Total pull requests: 61
Average time to close issues: 2 months
Average time to close pull requests: 10 days
Total issue authors: 29
Total pull request authors: 18
Average comments per issue: 4.52
Average comments per pull request: 1.3
Merged pull request: 54
Bot issues: 0
Bot pull requests: 0

Past year issues: 1
Past year pull requests: 4
Past year average time to close issues: N/A
Past year average time to close pull requests: about 19 hours
Past year issue authors: 1
Past year pull request authors: 1
Past year average comments per issue: 0.0
Past year average comments per pull request: 0.75
Past year merged pull request: 2
Past year bot issues: 0
Past year bot pull requests: 0

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/djberg96/sys-filesystem

Top Issue Authors

tetherit (3)
rgaufman (2)
matkoniecz (2)
MaxLap (1)
OpenCoderX (1)
zimbatm (1)
zarqman (1)
Daikamar (1)
rubycoder (1)
smoyte (1)
ayakael (1)
vihai (1)
mikeowens (1)
jeffshantz (1)
zeha (1)

Top Pull Request Authors

djberg96 (36)
tatokis (4)
Lqp1 (2)
nathan-nhm (2)
alexeikh (2)
andrew (2)
dunedain289 (2)
gogainda (1)
hirura (1)
mikeowens (1)
bbradbury (1)
ciprianbadescu (1)
map7 (1)
NickLaMuro (1)
pravi (1)

Top Issue Labels

Misc (2)
Bug (1)
Feature Request (1)

Top Pull Request Labels

Bug (3)
Misc (2)

Package metadata

Total packages: 12
Total downloads:
- rubygems: 125,622,273 total
Total docker downloads: 1,020,547,992
Total dependent packages: 50 (may contain duplicates)
Total dependent repositories: 1,563 (may contain duplicates)
Total versions: 100
Total maintainers: 2

gem.coop: sys-filesystem

The sys-filesystem library provides a cross-platform interface for gathering filesystem information, such as disk space and mount point data.

Homepage: https://github.com/djberg96/sys-filesystem
Documentation: http://www.rubydoc.info/gems/sys-filesystem/
Licenses: Apache-2.0
Latest release: 1.5.5 (published 3 months ago)
Last Synced: 2026-03-01T13:02:12.064Z (2 days ago)
Versions: 45
Dependent Packages: 0
Dependent Repositories: 0
Downloads: 62,812,839 Total
Docker Downloads: 510,273,996
Rankings:
- Dependent repos count: 0.0%
- Dependent packages count: 0.0%
- Average: 0.158%
- Docker downloads count: 0.194%
- Downloads: 0.44%
Maintainers (2)
- djberg96
- phurley
Funding:
- https://github.com/sponsors/djberg96

rubygems.org: sys-filesystem

The sys-filesystem library provides a cross-platform interface for gathering filesystem information, such as disk space and mount point data.

Homepage: https://github.com/djberg96/sys-filesystem
Documentation: http://www.rubydoc.info/gems/sys-filesystem/
Licenses: Apache-2.0
Latest release: 1.5.5 (published 3 months ago)
Last Synced: 2026-02-28T12:03:14.336Z (3 days ago)
Versions: 45
Dependent Packages: 50
Dependent Repositories: 1,563
Downloads: 62,809,434 Total
Docker Downloads: 510,273,996
Rankings:
- Docker downloads count: 0.24%
- Downloads: 0.454%
- Dependent packages count: 0.53%
- Dependent repos count: 0.783%
- Average: 2.167%
- Stargazers count: 5.375%
- Forks count: 5.622%
Maintainers (2)
- djberg96
- phurley
Funding:
- https://github.com/sponsors/djberg96

ubuntu-24.04: ruby-sys-filesystem

Homepage: https://github.com/djberg96/sys-filesystem
Licenses: apache-2.0
Latest release: 1.4.4-1 (published 19 days ago)
Last Synced: 2026-02-13T01:03:39.866Z (19 days ago)
Versions: 1
Dependent Packages: 0
Dependent Repositories: 0
Rankings:
- Dependent repos count: 0.0%
- Dependent packages count: 0.0%
- Average: 100%

debian-10: ruby-sys-filesystem

Homepage: https://github.com/djberg96/sys-filesystem
Documentation: https://packages.debian.org/buster/ruby-sys-filesystem
Licenses:
Latest release: 1.1.7-2 (published 20 days ago)
Last Synced: 2026-02-13T04:26:26.951Z (19 days ago)
Versions: 1
Dependent Packages: 0
Dependent Repositories: 0
Rankings:
- Dependent repos count: 0.0%
- Dependent packages count: 0.0%
- Average: 100%

ubuntu-23.04: ruby-sys-filesystem

Homepage: https://github.com/djberg96/sys-filesystem
Licenses:
Latest release: 1.4.3-1 (published 20 days ago)
Last Synced: 2026-02-11T06:50:49.030Z (20 days ago)
Versions: 1
Dependent Packages: 0
Dependent Repositories: 0
Rankings:
- Dependent repos count: 0.0%
- Dependent packages count: 0.0%
- Average: 100%

debian-11: ruby-sys-filesystem

Homepage: https://github.com/djberg96/sys-filesystem
Documentation: https://packages.debian.org/bullseye/ruby-sys-filesystem
Licenses:
Latest release: 1.1.7-2 (published 21 days ago)
Last Synced: 2026-02-13T08:25:33.999Z (18 days ago)
Versions: 1
Dependent Packages: 0
Dependent Repositories: 0
Rankings:
- Dependent repos count: 0.0%
- Dependent packages count: 0.0%
- Average: 100%

ubuntu-23.10: ruby-sys-filesystem

Homepage: https://github.com/djberg96/sys-filesystem
Licenses:
Latest release: 1.4.3-1 (published 18 days ago)
Last Synced: 2026-02-13T18:34:02.724Z (18 days ago)
Versions: 1
Dependent Packages: 0
Dependent Repositories: 0
Rankings:
- Dependent repos count: 0.0%
- Dependent packages count: 0.0%
- Average: 100%

ubuntu-24.10: ruby-sys-filesystem

Homepage: https://github.com/djberg96/sys-filesystem
Licenses:
Latest release: 1.4.4-1 (published 22 days ago)
Last Synced: 2026-02-09T17:23:00.332Z (22 days ago)
Versions: 1
Dependent Packages: 0
Dependent Repositories: 0
Rankings:

ubuntu-20.04: ruby-sys-filesystem

Homepage: https://github.com/djberg96/sys-filesystem
Licenses:
Latest release: 1.1.7-2 (published 18 days ago)
Last Synced: 2026-02-13T07:23:35.367Z (18 days ago)
Versions: 1
Dependent Packages: 0
Dependent Repositories: 0
Rankings:
- Dependent repos count: 0.0%
- Dependent packages count: 0.0%
- Average: 100%

ubuntu-22.04: ruby-sys-filesystem

Homepage: https://github.com/djberg96/sys-filesystem
Licenses:
Latest release: 1.4.3-1 (published 18 days ago)
Last Synced: 2026-02-13T13:26:57.663Z (18 days ago)
Versions: 1
Dependent Packages: 0
Dependent Repositories: 0
Rankings:
- Dependent repos count: 0.0%
- Dependent packages count: 0.0%
- Average: 100%

debian-12: ruby-sys-filesystem

Homepage: https://github.com/djberg96/sys-filesystem
Documentation: https://packages.debian.org/bookworm/ruby-sys-filesystem
Licenses:
Latest release: 1.4.3-1 (published 19 days ago)
Last Synced: 2026-02-12T23:42:28.273Z (19 days ago)
Versions: 1
Dependent Packages: 0
Dependent Repositories: 0
Rankings:
- Dependent repos count: 0.0%
- Dependent packages count: 0.0%
- Average: 100%

debian-13: ruby-sys-filesystem

Homepage: https://github.com/djberg96/sys-filesystem
Documentation: https://packages.debian.org/trixie/ruby-sys-filesystem
Licenses:
Latest release: 1.4.4-1+deb13u1 (published 19 days ago)
Last Synced: 2026-02-13T13:20:12.297Z (18 days ago)
Versions: 1
Dependent Packages: 0
Dependent Repositories: 0
Rankings:
- Dependent repos count: 0.0%
- Dependent packages count: 0.0%
- Average: 100%

Dependencies

sys-filesystem.gemspec rubygems

rake >= 0 development
rspec ~> 3.9 development
rubocop >= 0 development
rubocop-rspec >= 0 development
ffi ~> 1.1
jruby-win32ole >= 0

.github/workflows/ruby.yml actions

actions/checkout v3 composite
ruby/setup-ruby v1 composite

Gemfile rubygems

Score: 28.365735971495937

https://github.com/djberg96/sys-filesystem

Keywords from Contributors

Repository metadata

README.md

Description

Installation

Adding the trusted cert

Synopsis

Notes

Sample code

Known Issues

Future Plans

Acknowledgements

License

Copyright

Warranty

Author

Owner metadata

GitHub Events

Total

Last Year

Committers metadata

Committer domains:

Issue and Pull Request metadata

Top Issue Authors

Top Pull Request Authors

Top Issue Labels

Top Pull Request Labels

Package metadata

gem.coop: sys-filesystem

rubygems.org: sys-filesystem

ubuntu-24.04: ruby-sys-filesystem

debian-10: ruby-sys-filesystem

ubuntu-23.04: ruby-sys-filesystem

debian-11: ruby-sys-filesystem

ubuntu-23.10: ruby-sys-filesystem

ubuntu-24.10: ruby-sys-filesystem

ubuntu-20.04: ruby-sys-filesystem

ubuntu-22.04: ruby-sys-filesystem

debian-12: ruby-sys-filesystem

debian-13: ruby-sys-filesystem

Dependencies