libmagic_rb 0.1.1 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8ac744f446c39849d74275d6f3fd08a40222b3b40894a4ec0c419573c44d819e
-  data.tar.gz: 7fb5c5bbec7cc46fe1a1e2833d50e75d0212b528b9c70d34c0b3bebd8c71bc88
+  metadata.gz: add88dc48d3eda81cd55f1eafd163822b50452852b1f0ae0121b3de36e2f5588
+  data.tar.gz: 60b7af94ac6e809f16ae22b1c7aac8eb3eab68b4be76c2437217bc6da32be58a
 SHA512:
-  metadata.gz: 639b9571220fe58e27d7b67a48d942232cccdaf7c3e8b66089f27a9bb274d419a73df81b343aaa016ffb5e20193d2b000733d472ea0a6d463bc3a1e05be4f0ba
-  data.tar.gz: 03aba90d37ecca84e1129634f4fbcde15c5c432092e16e1e2b44be4779a1797580fda46acb024eb058eb374dc86e2afed9819ad22f6b669f269774e65f2660d8
+  metadata.gz: d694f12d7d3211dc40e0e1eedbac222bb232a529f5ac9a27fdc3a7f58f2c0238cebacff4ed4490931abc0fd46baee72aa84402863809b938fe9d65f9bf781c61
+  data.tar.gz: 8a2f6b16efe5644f66cbe45dab50b0ef671592fd0d586cd2a51edc09bdd0b993c903eed617f748567e50b1db4c6c02a36577af98b653fa9a1b5466f5c615ead2

data/README.md

@@ -1,4 +1,5 @@
-# LibmagicRb
+# LibmagicRb [![Gem Version](https://badge.fury.io/rb/libmagic_rb.svg)](https://rubygems.org/gems/libmagic_rb) ![Workflow Status](https://github.com/cybergizer-hq/libmagicrb/workflows/LibmagicRb%20Test/badge.svg)
+
 Adds ability to check mime-type of a file using the libmagic ([magic(4)](https://man7.org/linux/man-pages/man4/magic.4.html)).
 It uses native extensions and it's quite performant.
 
@@ -17,31 +18,62 @@ You also need Ruby > 1.9.0 in order to run this gem.
 
 With that info in mind, let's continue to the installation part for your Linux distributions...
 
-#### Arch / Manjaro / Archlabs & other Arch based Linux
+#### Arch / Manjaro / Archlabs / Garuda Linux / Hefftor Linux & other Arch Based Linux
 
 ```
-# pacman -S file gcc make
+# pacman -S ruby file gcc make --needed
 ```
 
-#### Debian / Ubuntu / Linux Mint / RaspberryPi OS & other Debian based Linux
+#### Debian / Ubuntu / Linux Mint / Deepin / Pop!_OS / RaspberryPi OS & other Debian Based Linux
 
 ```
-# apt install libmagic-dev ruby-dev gcc make
+# apt install ruby libmagic-dev ruby-dev gcc make
 ```
 
-#### Fedora / Amazon Linux / CentOS & Other RedHat based Linux
+#### Fedora / Amazon Linux / CentOS & Other RedHat Based Linux
 
 ```
-# yum install file-devel ruby-devel gcc make
+# yum install ruby file-devel ruby-devel gcc make
 ```
 
 #### OpenSUSE
 
 ```
-zypper in ruby ruby-devel file-devel gcc make
+# zypper in ruby ruby-devel file-devel gcc make
+```
+
+#### Gentoo
+
+There are already make, and magic.h available for Gentoo. You just need Ruby:
+
+```
+# emerge --ask dev-lang/ruby
+```
+
+#### DragonflyBSD / FreeBSD
+
+Versions upto 0.1.2 is tested on DragonflyBSD (Version 6.0-SYNTH).
+
 ```
+# pkg install ruby devel/ruby-gems gcc gmake
+```
+
+#### MacOS
+
+You can install libmagic with homebrew:
+
+```
+$ brew install libmagic
+
+# if the link is already created is going to fail, don't worry about that
+$ brew link libmagic
+```
+
+[ Source: [ eparreno/gist:1845561 ](https://gist.github.com/eparreno/1845561) ]
+
+#### Windows
 
-Mac is currently not supported but may support in the future.
+Windows is currently not tested, hence the support is unknown.
 
 ## Installation
 

data/ext/libmagic/func.h

@@ -1,3 +1,15 @@
+/*
+	Closes a magic cookie. For example:
+
+		> cookie = LibmagicRb.new(file: '/usr/share/dict/words')
+		# => #<LibmagicRb:0x00005581019fa7e0 @closed=false, @db=nil, @file="/usr/share/dict/words", @mode=1106>
+
+		> cookie.close
+		# => #<LibmagicRb:0x00005581019fa7e0 @closed=true, @db=nil, @file="/usr/share/dict/words", @mode=1106>
+
+	Returns self.
+*/
+
 VALUE _closeGlobal_(volatile VALUE self) {
 	RB_UNWRAP(cookie) ;
 
@@ -7,6 +19,23 @@ VALUE _closeGlobal_(volatile VALUE self) {
 	return self ;
 }
 
+/*
+	Changes the database path. For example:
+		> cookie = LibmagicRb.new(file: '/usr/share/dict/words')
+		# => #<LibmagicRb:0x00005581019181b0 @closed=false, @db=nil, @file="/usr/share/dict/words", @mode=1106>
+
+		> cookie.db = '/usr/share/file/misc/magic.mgc'
+		# => "/usr/share/file/misc/magic.mgc"
+
+		> cookie.check
+		# => "text/plain; charset=utf-8"
+
+		> cookie.close
+		# => #<LibmagicRb:0x00005581019181b0 @closed=true, @db="/usr/share/file/misc/magic.mgc", @file="/usr/share/dict/words", @mode=1106>
+
+	Returns self.
+*/
+
 VALUE _loadGlobal_(volatile VALUE self, volatile VALUE dbPath) {
 	char *databasePath = NULL ;
 
@@ -27,6 +56,20 @@ VALUE _loadGlobal_(volatile VALUE self, volatile VALUE dbPath) {
 	return self ;
 }
 
+/*
+	Check a file with the magic database. For example:
+		> cookie = LibmagicRb.new(file: '/usr/share/dict/words')
+		# => #<LibmagicRb:0x00005581019181b0 @closed=false, @db=nil, @file="/usr/share/dict/words", @mode=1106>
+
+		> cookie.check
+		# => "text/plain; charset=utf-8"
+
+		> cookie.close
+		# => #<LibmagicRb:0x00005581019181b0 @closed=true, @db="/usr/share/file/misc/magic.mgc", @file="/usr/share/dict/words", @mode=1106>
+
+		Returns String or nil.
+*/
+
 VALUE _checkGlobal_(volatile VALUE self) {
 	RB_UNWRAP(cookie) ;
 
@@ -51,6 +94,18 @@ VALUE _checkGlobal_(volatile VALUE self) {
 	return mt ? rb_str_new_cstr(mt) : Qnil ;
 }
 
+/*
+	Get parameters for a cookie. For example:
+		cookie = LibmagicRb.new(file: '/usr/share/dict/words')
+		# => #<LibmagicRb:0x00005581018f35e0 @closed=false, @db=nil, @file="/usr/share/dict/words", @mode=1106>
+
+		> cookie.getparam(LibmagicRb::MAGIC_PARAM_NAME_MAX)
+		# => 50
+
+		> cookie.close
+		# => #<LibmagicRb:0x00005581018f35e0 @closed=true, @db=nil, @file="/usr/share/dict/words", @mode=1106>
+*/
+
 VALUE _getParamGlobal_(volatile VALUE self, volatile VALUE param) {
 	#if MAGIC_VERSION > 525
 		RB_UNWRAP(cookie) ;
@@ -66,6 +121,27 @@ VALUE _getParamGlobal_(volatile VALUE self, volatile VALUE param) {
 	#endif
 }
 
+/*
+	Sets parameter for a cookie. For example:
+
+		> cookie = LibmagicRb.new(file: '/usr/share/dict/words')
+		# => #<LibmagicRb:0x00005581019f9840 @closed=false, @db=nil, @file="/usr/share/dict/words", @mode=1106>
+
+		> cookie.getparam(LibmagicRb::MAGIC_PARAM_NAME_MAX)
+		=> 50
+
+		> cookie.setparam(LibmagicRb::MAGIC_PARAM_NAME_MAX, 101)
+		# => 101
+
+		> cookie.getparam(LibmagicRb::MAGIC_PARAM_NAME_MAX)
+		# => 101
+
+		> cookie.close
+		# => #<LibmagicRb:0x00005581019f9840 @closed=true, @db=nil, @file="/usr/share/dict/words", @mode=1106>
+
+	Returns Integer or nil on failure.
+*/
+
 VALUE _setParamGlobal_(volatile VALUE self, volatile VALUE param, volatile VALUE paramVal) {
 	#if MAGIC_VERSION > 525
 		unsigned int _param = NUM2UINT(param) ;
@@ -85,25 +161,121 @@ VALUE _setParamGlobal_(volatile VALUE self, volatile VALUE param, volatile VALUE
 	#endif
 }
 
+/*
+	Returns a textual description of the contents of the buffer argument with length bytes size.
+
+	For example:
+
+		> cookie = LibmagicRb.new(file: '.')
+		# => #<LibmagicRb:0x00005582de0d1bf8 @closed=false, @db=nil, @file=".", @mode=1106>
+
+		> cookie.magic_buffer("%PDF-1.3\r\n")
+		# => "application/pdf; charset=us-ascii"
+
+		> cookie.close
+		# => #<LibmagicRb:0x00005582de0d1bf8 @closed=true, @db=nil, @file=".", @mode=1106>
+
+	Note that it automatically loads the database.
+
+	Returns either String or nil.
+*/
+
 VALUE _bufferGlobal_(volatile VALUE self, volatile VALUE string) {
 	RB_UNWRAP(cookie) ;
 
+	VALUE db = rb_iv_get(self, "@db") ;
+
+	char *database = NULL ;
+	if(RB_TYPE_P(db, T_STRING)) {
+		database = StringValuePtr(db) ;
+	}
+
+	if(database) magic_validate_db(*cookie, database) ;
+	magic_load(*cookie, database) ;
+
 	char *buffer = StringValuePtr(string) ;
-	const char *buf = magic_buffer(*cookie, buffer, sizeof(buffer)) ;
+	const char *buf = magic_buffer(*cookie, buffer, strlen(buffer)) ;
 
-	return rb_str_new_cstr(buf) ;
+	return buf ? rb_str_new_cstr(buf) : Qnil ;
 }
 
+/*
+	Dumps all magic entries in a human
+	readable format, dumping first the entries that are matched against
+	binary files and then the ones that match text files.
+
+	For example:
+
+
+		> cookie = LibmagicRb.new(file: '.')
+		# => #<LibmagicRb:0x000055cf280a9b30 @closed=false, @db=nil, @file=".", @mode=1106>
+
+		> cookie.magic_list
+		Set 0:
+		Binary patterns:
+		Strength = 500@47: Biosig/Brainvision Marker file [biosig/brainvision]
+		Strength = 490@122: Biosig/TMSiLOG [biosig/tmsilog]
+		Strength = 461@127: Biosig/SYNERGY [biosig/synergy]
+		Strength = 460@46: Biosig/Brainvision V-Amp file []
+		Strength = 410@45: Biosig/Brainvision data file []
+		Strength = 380@6: OpenSSH private key []
+		Strength = 370@1266: Novell message librarian data []
+		.
+		.
+		.
+		# => 0
+
+		> cookie.close
+		=> #<LibmagicRb:0x000055cf280a9b30 @closed=true, @db=nil, @file=".", @mode=1106>
+*/
+
 VALUE _listGlobal_(volatile VALUE self) {
 	RB_UNWRAP(cookie) ;
 
 	VALUE db = rb_iv_get(self, "@db") ;
-	char *database = StringValuePtr(db) ;
 
+	char *database = NULL ;
+	if (RB_TYPE_P(db, T_STRING)) {
+		database = StringValuePtr(db) ;
+	}
+
+	if(database) magic_validate_db(*cookie, database) ;
 	int status = magic_list(*cookie, database) ;
+
 	return INT2FIX(status) ;
 }
 
+/*
+	Set flags/modes for a cookie (not to be confused with params).
+	It's same setting mode through the setter cookie.mode = mode.
+
+	For example:
+
+		> cookie = LibmagicRb.new(file: '.')
+		# => #<LibmagicRb:0x00005583732e1070 @closed=false, @db=nil, @file=".", @mode=1106>
+
+		> cookie.check
+		# => "inode/directory; charset=binary"
+
+		> cookie.setflags(LibmagicRb::MAGIC_RAW)
+		# => 256
+
+		> cookie.check
+		# => "directory"
+
+		#### Similarly you can also do this ####
+
+		> cookie.mode = LibmagicRb::MAGIC_MIME
+		# => 1040
+
+		> cookie.check
+		# => "inode/directory; charset=binary"
+
+		#### Close the cookie when done ####
+		> cookie.close
+		# => #<LibmagicRb:0x00005583732e1070 @closed=true, @db=nil, @file=".", @mode=256>
+*/
+
 VALUE _setflagsGlobal_(volatile VALUE self, volatile VALUE flags) {
 	unsigned int flag = NUM2UINT(flags) ;
 

data/ext/libmagic/magic.c

@@ -1,6 +1,7 @@
 #include <magic.h>
 #include <stdio.h>
 #include <unistd.h>
+#include <sys/stat.h>
 #include "ruby.h"
 
 /*
@@ -43,13 +44,30 @@ static rb_data_type_t fileType = {
 	},
 
 	.data = NULL,
-	.flags = RUBY_TYPED_FREE_IMMEDIATELY,
+
+	#ifdef RUBY_TYPED_FREE_IMMEDIATELY
+	.flags = RUBY_TYPED_FREE_IMMEDIATELY
+	#endif
 } ;
 
 #include "validations.h"
 #include "func.h"
 
-VALUE _check_(volatile VALUE obj, volatile VALUE args) {
+/*
+	Directly check a file with LibmagicRb, without creating any sort of cookies:
+
+		LibmagicRb.check(file: '/tmp/', db: '/usr/share/file/misc/magic.mgc', mode: LibmagicRb::MAGIC_CHECK) # => "sticky, directory"
+
+	[file] The key `file:` is the filename to check. Should be a string
+
+	[db] The key `db:` can be left as nil. Or you can give it the path of the current magic database.
+
+	[mode] The key `mode` can be any of the LibmagicRb.lsmodes().
+	To combine modes you can use `|`. For example:
+	`mode: LibmagicRb::MAGIC_CHECK | LibmagicRb::MAGIC_SYMLINK | Libmagic_MAGIC_MIME`
+	If `mode` key is nil, it will default to `MAGIC_MIME | MAGIC_CHECK | MAGIC_SYMLINK`
+*/
+static VALUE _check_(volatile VALUE obj, volatile VALUE args) {
 	if(!RB_TYPE_P(args, T_HASH)) {
 		rb_raise(rb_eArgError, "Expected hash as argument.") ;
 	}
@@ -107,6 +125,43 @@ VALUE _check_(volatile VALUE obj, volatile VALUE args) {
 	return retVal ;
 }
 
+/*
+	Intializes a magic cookie that can be used multiple times.
+	The benefit of this is to assgign various cookies and change flags of each cookie.
+
+	For example:
+
+		> cookie = LibmagicRb.new(file: '/tmp')
+		# => #<LibmagicRb:0x000055810139f738 @closed=false, @db=nil, @file="/tmp", @mode=1106>
+
+		> cookie.check
+		# => "inode/directory; charset=binary"
+
+		> cookie.setflags(LibmagicRb::MAGIC_RAW)
+		# => 256
+
+		> cookie.check
+		# => "sticky, directory"
+
+		> cookie2 = LibmagicRb.new(file: '/usr/share/dict/words')
+		# => #<LibmagicRb:0x000055810190a060 @closed=false, @db=nil, @file="/usr/share/dict/words", @mode=1106>
+
+		> cookie2.check
+		# => "text/plain; charset=utf-8"
+
+		> cookie.close
+		# => #<LibmagicRb:0x000055810139f738 @closed=true, @db=nil, @file="/tmp", @mode=256>
+
+		> cookie.closed?
+		# => true
+
+		> cookie2.closed?
+		# => false
+
+	Here in this example, we can't use cookie, but cookie2 is a different magic_t wrapper, so we can continue using that.
+	Flags/modes applied to cookie, will not affect cookie2 as well. Think of them as totally different containers.
+	Of course, you must close cookies when you don't need them. Otherwise it can use memories unless GC is triggered.
+*/
 VALUE rb_libmagicRb_initialize(volatile VALUE self, volatile VALUE args) {
 	// Database Path
 	if(!RB_TYPE_P(args, T_HASH)) {
@@ -170,6 +225,10 @@ void Init_main() {
 	/*
 	* Libmagic Errors
 	*/
+
+	/*
+		Adds ability to check mime-type of a file using the libmagic (magic(4)). It uses native extensions and it's quite performant.
+	*/
 	VALUE cLibmagicRb = rb_define_class("LibmagicRb", rb_cObject) ;
 
 	rb_eFileNotFoundError = rb_define_class_under(cLibmagicRb, "FileNotFound", rb_eRuntimeError) ;
@@ -184,9 +243,15 @@ void Init_main() {
 	modes(cLibmagicRb) ;
 	params(cLibmagicRb) ;
 
+
 	#if MAGIC_VERSION > 525
 		char version[6] ;
 		sprintf(version, "%0.2f", magic_version() / 100.0) ;
+
+		/*
+			LibmagicRb::MAGIC_VERSION returns the magic version of the library.
+			For older libmagic version, this can be undefined, so this method will return "0" instead.
+		*/
 		rb_define_const(cLibmagicRb, "MAGIC_VERSION", rb_str_new_cstr(version)) ;
 	#else
 		rb_define_const(cLibmagicRb, "MAGIC_VERSION", rb_str_new_cstr("0")) ;

data/lib/libmagic_rb/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 class LibmagicRb
-  VERSION = "0.1.1"
+	VERSION = "0.1.2"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: libmagic_rb
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.2
 platform: ruby
 authors:
 - Cybergizer
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2021-08-19 00:00:00.000000000 Z
+date: 2021-09-06 00:00:00.000000000 Z
 dependencies: []
 description: Check filetype with libmagic
 email: