mirror of
				https://github.com/NotAShelf/tinierfetch.git
				synced 2025-10-31 11:12:39 +00:00 
			
		
		
		
	move README contents to .github
This commit is contained in:
		
					parent
					
						
							
								8186f58371
							
						
					
				
			
			
				commit
				
					
						45f6cbb46a
					
				
			
		
					 4 changed files with 60 additions and 14 deletions
				
			
		
							
								
								
									
										60
									
								
								.github/README.md
									
										
									
									
										vendored
									
									
										Normal file
									
								
							
							
						
						
									
										60
									
								
								.github/README.md
									
										
									
									
										vendored
									
									
										Normal file
									
								
							|  | @ -0,0 +1,60 @@ | |||
| # tinierfetch | ||||
| 
 | ||||
| > a self-imposed code-golf challenge on following qualifiers | ||||
| 
 | ||||
| 1. speed | ||||
| 2. binary size | ||||
| 3. compilation duration | ||||
| 4. (optional) lines of code | ||||
| 
 | ||||
|  | ||||
| 
 | ||||
| ## depends | ||||
| 
 | ||||
| you will need `TERM`, `LANG`, `USER`, `SHELL` environmental variables to be set, they usually are. | ||||
| 
 | ||||
| - for C++, see the Makefile for available jobs. | ||||
| - for Rust, the `--release` profile handles the optimizations for you | ||||
| - for Go, you will want to pass `-ldflags="-s -w"` to `go build` | ||||
| 
 | ||||
| ## usage | ||||
| 
 | ||||
| a helper script is provided below. it will build each program and compare them using Hyperfine | ||||
| 
 | ||||
| _it fits in a [QR code](./assets/qr.png)_ | ||||
| 
 | ||||
| ## todo | ||||
| 
 | ||||
| - more languages: | ||||
|   - bash | ||||
|   - zig | ||||
|   - python | ||||
|   - ruby | ||||
|   - haskell | ||||
|   - asm | ||||
|   - node | ||||
| 
 | ||||
| ## results | ||||
| 
 | ||||
| | Command                     | Mean [ms] | Min [ms] | Max [ms] |    Relative | Compilation Duration [s] |                  Notes                   | | ||||
| | :-------------------------- | :-------: | -------: | -------: | ----------: | -----------------------: | :--------------------------------------: | | ||||
| | `bin/tinierfetch-go`        | 1.3 ± 0.1 |      1.1 |      1.6 | 1.23 ± 0.12 |                     0.15 |      `-s` and `-w` ldflags are used      | | ||||
| | `bin/tinierfetch-rs`        | 1.1 ± 0.1 |      0.9 |      1.3 |        1.00 |                     3.17 | see `Cargo.toml` for opitimization specs | | ||||
| | `bin/tinierfetch-cpp-size`  | 1.5 ± 0.1 |      1.3 |      1.8 | 1.43 ± 0.11 |                     0.24 |      g++ optimized for binary size       | | ||||
| | `bin/tinierfetch-cpp-speed` | 1.5 ± 0.1 |      1.3 |      1.8 | 1.43 ± 0.11 |                     0.10 |         g++ optimized for speed          | | ||||
| 
 | ||||
| _all programs take around `0.001` to `0.002s` to execute, have been tested on R5 3600x and R7 7730U CPUs_ | ||||
| 
 | ||||
| ## verdict | ||||
| 
 | ||||
| Use | ||||
| 
 | ||||
| - Rust, for speed | ||||
| - C++, for optimized size | ||||
| - Go, if you hate yourself (or can't tolerate Rust syntax) | ||||
| 
 | ||||
| ## contributing | ||||
| 
 | ||||
| You know something better? Do feel free to contribute additional languages, improvements or QoL changes to the repository. | ||||
| 
 | ||||
| Got different results? Open an issue, prove me wrong mathematically. | ||||
| Before Width: | Height: | Size: 36 KiB After Width: | Height: | Size: 36 KiB | 
							
								
								
									
										0
									
								
								assets/qr.png → .github/assets/qr.png
									
										
									
									
										vendored
									
									
								
							
							
						
						
									
										0
									
								
								assets/qr.png → .github/assets/qr.png
									
										
									
									
										vendored
									
									
								
							| Before Width: | Height: | Size: 1.1 KiB After Width: | Height: | Size: 1.1 KiB | 
							
								
								
									
										14
									
								
								README.md
									
										
									
									
									
								
							
							
						
						
									
										14
									
								
								README.md
									
										
									
									
									
								
							|  | @ -1,14 +0,0 @@ | |||
| # tinierfetch | ||||
| 
 | ||||
| it's tinyfetch but also tinier - you could probably fit this in a QR code | ||||
| takes `0.001` to `0.003s` to fetch | ||||
| 
 | ||||
| edit: it fits in a [QR code](./assets/qr.png) | ||||
| 
 | ||||
| ## depends | ||||
| 
 | ||||
| a compiler (I used g++) and `TERM`, `LANG`, `USER`, `SHELL` environmental variables to be set | ||||
| 
 | ||||
| ## preview | ||||
| 
 | ||||
|  | ||||
		Loading…
	
	Add table
		Add a link
		
	
		Reference in a new issue