errors now write to stderr instead of stdout

.gitignore

@@ -1,2 +1,3 @@
 Cargo.lock
 /target
+/packages

Cargo.toml

@@ -1,13 +1,26 @@
 [package]
 name = "pride"
-version = "0.2.0"
+version = "0.4.1"
 edition = "2021"
+authors = [ "Valerie Wolfe <sleeplessval@gmail.com>" ]
+description = "Pride flags in the terminal."
+homepage = "https://git.vwolfe.io/valerie/pride"
+repository = "https://git.vwolfe.io/valerie/pride"
+license = "MIT"
+categories = [ "command-line-utilities" ]
+keywords = [ "lgbt", "pride", "cli" ]
 
-# See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html
+[package.metadata.aur]
+name = "pride"
+source = "archive/v$pkgver.tar.gz"
+
+[[bin]]
+name = "pride"
+path = "src/main.rs"
 
 [dependencies]
 pico-args = "0.5.0"
-termion = "2.0.1"
+termion = "3.0.0"
 
 [profile.release]
 opt-level = 's'
@@ -15,5 +28,5 @@ codegen-units = 1
 debug = false
 lto = true
 panic = "abort"
-strip = "debuginfo"
+strip = "symbols"
 

LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2024 Valerie Wolfe
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -10,8 +10,51 @@ A list of currently implemented flags is available on the [project wiki](https:/
 Some Complex renderers utilize [Powerline's](https://github.com/ryanoasis/powerline-extra-symbols)
 slant symbols, and therefore require use of a Powerline font, such as [Fira Code](https://github.com/tonsky/FiraCode).
 
+## Installation
+
+### Manual Install
+
+<details>
+<summary>Release Binary</summary>
+Copy the compiled binary from the <a href="https://git.vwolfe.io/valerie/pride/releases/">releases page</a>
+to a directory in <code>$PATH</code>, such as <code>/usr/bin/</code>.
+</details>
+
+<details>
+<summary>Compile from Source</summary>
+Compile using cargo with the command <code>cargo build --release</code> and
+copy the file from <code>target/release/</code> to a directory in
+<code>$PATH</code>, such as <code>/usr/bin/</code>.
+</details>
+
+<details>
+<summary>makepkg (AUR)</summary>
+Clone the <a href="https://aur.archlinux.org/pride.git">AUR Repository</a> and
+run the command <code>makepkg --install</code>.
+</details>
+
+### Package Managers
+
+<details>
+<summary>Arch Linux (AUR): <code>pride</code></summary>
+Install the package from the <a href="https://aur.archlinux.org/packages/pride"><code>pride</code> AUR Package</a>
+using an AUR package manager such as <a href="https://github.com/Morganamilo/paru"><code>paru</code></a>.
+</details>
+
+<details>
+<summary>Cargo: <code>pride-term</code></summary>
+Install the package using Cargo with the command <code>cargo install pride-term</code>.
+</details>
+
+### Man Page
+
+<details>
+<summary>Section 6</summary>
+Copy <code>man/pride.6</code> into <code>/usr/share/man/man6/</code>.
+</details>
+
 ## Libraries
 
-- [pico-args](https://crates.io/crates/pico-args)
+- [pico-args](https://crates.io/crates/pico-args) — argument parsing
-- [termion](https://crates.io/crates/termion)
+- [termion](https://crates.io/crates/termion) — ANSI formatting
 

deny.toml

@@ -0,0 +1,4 @@
+[licenses]
+allow = [ "MIT" ]
+
+

man/pride.6

@@ -0,0 +1,106 @@
+.Dd $Mdocdate$
+.Dt PRIDE 6
+.Os
+.Sh NAME
+.Nm pride
+.Nd shows pride flags in the terminal
+.Sh SYNOPSIS
+.Nm
+.Op Fl hlv
+.Op Fl s Op Ar size
+.Op Ar flag
+.Sh DESCRIPTION
+.Nm
+displays pride flags in the terminal using ANSI truecolor sequences.
+.Ss OPTIONS
+.Bl -tag -width Ds
+.It Fl h , Fl -help
+Shows a brief help text.
+.It Fl l , Fl -list
+Shows a list of available pride flags.
+.It Fl s , Fl -size Op Ar size
+Scales the flag to the given size: no value or 'small' will produce the minimum size; one number sets the width; and two numbers separated by 'x' sets width and height respectively.
+.It Fl v , Fl -version
+Shows version information.
+.It Ar flag
+The name of the flag to display. Defaults to 'rainbow'.
+.El
+.Sh FLAGS
+.Bl -tag -width Ds
+.It Ic agender
+.It Ic aromantic, aro
+.It Ic aroace, aromantic-asexual
+The aromantic-asexual pride flag by @aroaesflags@tumblr.com.
+.Pp
+VARIANTS
+.Bl -tag -width Ds -compact
+.It Ic halves, side-by-side, sbs
+.El
+.It Ic bigender
+.It Ic bisexual, bi
+The bisexual pride flag designed by Michael Page in 1998.
+.It Ic demiboy
+.It Ic demigender
+.It Ic demigirl
+.It Ic demiromantic
+.It Ic demisexual
+.It Ic gay, mlm
+The gay men pride flag designed by @gayflagblog@tumblr.com in 2019.
+.It Ic genderfluid
+.It Ic gender-nonconforming, gendernonconforming, gnc
+.It Ic genderqueer
+.It Ic gendervoid
+.It Ic lesbian, wlw
+The 5-stripe lesbian pride flag designed by Emily Gwen in 2018.
+.Pp
+VARIANTS
+.Bl -tag -width Ds -compact
+.It Ic 7-color
+The 7-stripe lesbian pride flag designed by Emily Gwen in 2018.
+.El
+.It Ic multisexual, m-spec, mspec
+.It Ic multigender
+.It Ic neutrois
+.It Ic nonbinary, nb
+The nonbinary pride flag designed by Kyle Rowan in 2014.
+.It Ic pansexual, pan
+The pansexual pride flag designed by Jasper V circa 2010.
+.It Ic polysexual
+.It Ic progress
+The progress rainbow pride flag designed by Daniel Quasar in 2018.
+.It Ic rainbow, pride
+The 1979 6-stripe revision of Gilbert Baker's rainbow pride flag.
+.Pp
+VARIANTS
+.Bl -tag -width Ds -compact
+.It Ic 8-color, gilbert-baker, sex-and-magic
+Gilbert Baker's original 8-stripe rainbow pride flag from 1978.
+.It Ic philadelphia
+The rainbow flag designed for 2017 Philadelphia Pride.
+.It Ic progress
+.El
+.It Ic transgender, trans
+The transgender pride flag designed by Monica Helms in 1999.
+.El
+.Sh EXIT STATUS
+.Bl -tag -width Ds
+.It 1
+Unmatched
+.Ar flag
+name.
+.It 2
+Failed to parse
+.Ar size .
+.It 3
+The provided
+.Ar size
+is too small to render.
+.El
+.Sh EXAMPLES
+Create a full-width banner flag using tput:
+.Pp
+.Dl $ pride -s `tput cols`
+.Pp
+.Sh AUTHORS
+.An -nosplit
+.An Valerie Wolfe Aq Mt sleeplessval@gmail.com

sbom.xml

@@ -0,0 +1,239 @@
+{
+  "SPDXID": "SPDXRef-DOCUMENT",
+  "creationInfo": {
+    "created": "2024-07-05T20:16:51.403Z",
+    "creators": [
+      "Tool: cargo-sbom-v0.8.4"
+    ]
+  },
+  "dataLicense": "CC0-1.0",
+  "documentNamespace": "https://spdx.org/spdxdocs/pride-6150510e-b518-43f0-aa53-3e2795909cc2",
+  "files": [
+    {
+      "SPDXID": "SPDXRef-File-pride",
+      "checksums": [],
+      "fileName": "pride",
+      "fileTypes": [
+        "BINARY"
+      ]
+    }
+  ],
+  "name": "pride",
+  "packages": [
+    {
+      "SPDXID": "SPDXRef-Package-redox_syscall-0.4.1",
+      "description": "A Rust library to access raw Redox system calls",
+      "downloadLocation": "registry+https://github.com/rust-lang/crates.io-index",
+      "externalRefs": [
+        {
+          "referenceCategory": "PACKAGE-MANAGER",
+          "referenceLocator": "pkg:cargo/redox_syscall@0.4.1",
+          "referenceType": "purl"
+        }
+      ],
+      "licenseConcluded": "MIT",
+      "licenseDeclared": "MIT",
+      "name": "redox_syscall",
+      "versionInfo": "0.4.1"
+    },
+    {
+      "SPDXID": "SPDXRef-Package-libredox-0.0.2",
+      "description": "Redox stable ABI",
+      "downloadLocation": "registry+https://github.com/rust-lang/crates.io-index",
+      "externalRefs": [
+        {
+          "referenceCategory": "PACKAGE-MANAGER",
+          "referenceLocator": "pkg:cargo/libredox@0.0.2",
+          "referenceType": "purl"
+        }
+      ],
+      "licenseConcluded": "MIT",
+      "licenseDeclared": "MIT",
+      "name": "libredox",
+      "versionInfo": "0.0.2"
+    },
+    {
+      "SPDXID": "SPDXRef-Package-libc-0.2.155",
+      "description": "Raw FFI bindings to platform libraries like libc.\n",
+      "downloadLocation": "registry+https://github.com/rust-lang/crates.io-index",
+      "externalRefs": [
+        {
+          "referenceCategory": "PACKAGE-MANAGER",
+          "referenceLocator": "pkg:cargo/libc@0.2.155",
+          "referenceType": "purl"
+        }
+      ],
+      "homepage": "https://github.com/rust-lang/libc",
+      "licenseConcluded": "MIT OR Apache-2.0",
+      "licenseDeclared": "MIT OR Apache-2.0",
+      "name": "libc",
+      "versionInfo": "0.2.155"
+    },
+    {
+      "SPDXID": "SPDXRef-Package-bitflags-1.3.2",
+      "description": "A macro to generate structures which behave like bitflags.\n",
+      "downloadLocation": "registry+https://github.com/rust-lang/crates.io-index",
+      "externalRefs": [
+        {
+          "referenceCategory": "PACKAGE-MANAGER",
+          "referenceLocator": "pkg:cargo/bitflags@1.3.2",
+          "referenceType": "purl"
+        }
+      ],
+      "homepage": "https://github.com/bitflags/bitflags",
+      "licenseConcluded": "MIT OR Apache-2.0",
+      "licenseDeclared": "MIT/Apache-2.0",
+      "name": "bitflags",
+      "versionInfo": "1.3.2"
+    },
+    {
+      "SPDXID": "SPDXRef-Package-redox_termios-0.1.3",
+      "description": "A Rust library to access Redox termios functions",
+      "downloadLocation": "registry+https://github.com/rust-lang/crates.io-index",
+      "externalRefs": [
+        {
+          "referenceCategory": "PACKAGE-MANAGER",
+          "referenceLocator": "pkg:cargo/redox_termios@0.1.3",
+          "referenceType": "purl"
+        }
+      ],
+      "licenseConcluded": "MIT",
+      "licenseDeclared": "MIT",
+      "name": "redox_termios",
+      "versionInfo": "0.1.3"
+    },
+    {
+      "SPDXID": "SPDXRef-Package-numtoa-0.1.0",
+      "description": "Convert numbers into stack-allocated byte arrays",
+      "downloadLocation": "registry+https://github.com/rust-lang/crates.io-index",
+      "externalRefs": [
+        {
+          "referenceCategory": "PACKAGE-MANAGER",
+          "referenceLocator": "pkg:cargo/numtoa@0.1.0",
+          "referenceType": "purl"
+        }
+      ],
+      "licenseConcluded": "MIT OR Apache-2.0",
+      "licenseDeclared": "MIT OR Apache-2.0",
+      "name": "numtoa",
+      "versionInfo": "0.1.0"
+    },
+    {
+      "SPDXID": "SPDXRef-Package-termion-3.0.0",
+      "description": "A bindless library for manipulating terminals.",
+      "downloadLocation": "registry+https://github.com/rust-lang/crates.io-index",
+      "externalRefs": [
+        {
+          "referenceCategory": "PACKAGE-MANAGER",
+          "referenceLocator": "pkg:cargo/termion@3.0.0",
+          "referenceType": "purl"
+        }
+      ],
+      "licenseConcluded": "MIT",
+      "licenseDeclared": "MIT",
+      "name": "termion",
+      "versionInfo": "3.0.0"
+    },
+    {
+      "SPDXID": "SPDXRef-Package-bitflags-2.5.0",
+      "description": "A macro to generate structures which behave like bitflags.\n",
+      "downloadLocation": "registry+https://github.com/rust-lang/crates.io-index",
+      "externalRefs": [
+        {
+          "referenceCategory": "PACKAGE-MANAGER",
+          "referenceLocator": "pkg:cargo/bitflags@2.5.0",
+          "referenceType": "purl"
+        }
+      ],
+      "homepage": "https://github.com/bitflags/bitflags",
+      "licenseConcluded": "MIT OR Apache-2.0",
+      "licenseDeclared": "MIT OR Apache-2.0",
+      "name": "bitflags",
+      "versionInfo": "2.5.0"
+    },
+    {
+      "SPDXID": "SPDXRef-Package-pride-0.4.1",
+      "description": "Pride flags in the terminal.",
+      "downloadLocation": "NONE",
+      "homepage": "https://git.vwolfe.io/valerie/pride",
+      "licenseConcluded": "MIT",
+      "licenseDeclared": "MIT",
+      "name": "pride",
+      "versionInfo": "0.4.1"
+    },
+    {
+      "SPDXID": "SPDXRef-Package-pico-args-0.5.0",
+      "description": "An ultra simple CLI arguments parser.",
+      "downloadLocation": "registry+https://github.com/rust-lang/crates.io-index",
+      "externalRefs": [
+        {
+          "referenceCategory": "PACKAGE-MANAGER",
+          "referenceLocator": "pkg:cargo/pico-args@0.5.0",
+          "referenceType": "purl"
+        }
+      ],
+      "licenseConcluded": "MIT",
+      "licenseDeclared": "MIT",
+      "name": "pico-args",
+      "versionInfo": "0.5.0"
+    }
+  ],
+  "relationships": [
+    {
+      "relatedSpdxElement": "SPDXRef-Package-numtoa-0.1.0",
+      "relationshipType": "DEPENDS_ON",
+      "spdxElementId": "SPDXRef-Package-termion-3.0.0"
+    },
+    {
+      "relatedSpdxElement": "SPDXRef-Package-pico-args-0.5.0",
+      "relationshipType": "DEPENDS_ON",
+      "spdxElementId": "SPDXRef-Package-pride-0.4.1"
+    },
+    {
+      "relatedSpdxElement": "SPDXRef-Package-libc-0.2.155",
+      "relationshipType": "DEPENDS_ON",
+      "spdxElementId": "SPDXRef-Package-termion-3.0.0"
+    },
+    {
+      "relatedSpdxElement": "SPDXRef-Package-termion-3.0.0",
+      "relationshipType": "DEPENDS_ON",
+      "spdxElementId": "SPDXRef-Package-pride-0.4.1"
+    },
+    {
+      "relatedSpdxElement": "SPDXRef-Package-bitflags-1.3.2",
+      "relationshipType": "DEPENDS_ON",
+      "spdxElementId": "SPDXRef-Package-redox_syscall-0.4.1"
+    },
+    {
+      "relatedSpdxElement": "SPDXRef-Package-pride-0.4.1",
+      "relationshipType": "GENERATED_FROM",
+      "spdxElementId": "SPDXRef-File-pride"
+    },
+    {
+      "relatedSpdxElement": "SPDXRef-Package-libredox-0.0.2",
+      "relationshipType": "DEPENDS_ON",
+      "spdxElementId": "SPDXRef-Package-termion-3.0.0"
+    },
+    {
+      "relatedSpdxElement": "SPDXRef-Package-redox_syscall-0.4.1",
+      "relationshipType": "DEPENDS_ON",
+      "spdxElementId": "SPDXRef-Package-libredox-0.0.2"
+    },
+    {
+      "relatedSpdxElement": "SPDXRef-Package-redox_termios-0.1.3",
+      "relationshipType": "DEPENDS_ON",
+      "spdxElementId": "SPDXRef-Package-termion-3.0.0"
+    },
+    {
+      "relatedSpdxElement": "SPDXRef-Package-libc-0.2.155",
+      "relationshipType": "DEPENDS_ON",
+      "spdxElementId": "SPDXRef-Package-libredox-0.0.2"
+    },
+    {
+      "relatedSpdxElement": "SPDXRef-Package-bitflags-2.5.0",
+      "relationshipType": "DEPENDS_ON",
+      "spdxElementId": "SPDXRef-Package-libredox-0.0.2"
+    }
+  ],
+  "spdxVersion": "SPDX-2.3"
+}

src/color.rs

@@ -1,3 +1,4 @@
+//!	utility types and functions for color operations
 
 use termion::color::{ Bg, Fg, Rgb, Reset };
 

src/complex.rs

@@ -1,15 +1,13 @@
 //!	flags that require more complex rendering than just scaling colored stripes
 
-use termion::{
+use termion::color::{ Bg, Rgb };
-	terminal_size,
-
-	color::{ Bg, Rgb }
-};
 
 use crate::{
 	color::*,
 	draw,
+	error,
 	flag::{ self, Flag },
+	state::State,
 	util::{ ansi_len, ansi_substr }
 };
 
@@ -27,7 +25,7 @@ pub static TRIANGLE_21: [char; 3] = ['', '🭬', ''];
 ///	2/3 slope slant
 pub static SLANT_23: [char; 2] = ['🭒', '🭏'];
 
-pub fn progress(small: bool) -> Flag {
+pub fn progress(state: &State) -> Flag {
 	let red		= bg(0xE50000);
 	let orange	= bg(0xFF8D00);
 	let yellow	= bg(0xFFEE00);
@@ -42,7 +40,8 @@ pub fn progress(small: bool) -> Flag {
 	let pink:	u32 = 0x7ACBF5;
 	let white:	u32 = 0xFFFFFF;
 
-	let (width, height) = if small { (18, 6) } else { terminal_size().unwrap() };
+	let (width, height) = state.size.get(18, 6);
+	if height < 6 || width < 6 { error::too_small(width, height); }
 
 	//	create color slices and line buffer
 	let stripes = [red, orange, yellow, green, blue, purple];
@@ -52,20 +51,10 @@ pub fn progress(small: bool) -> Flag {
 	//	set up stripe index
 	let mut index = 0;
 
-	/*	ok, coming up with procedure:
-	 *	- can't rely on bg_stripes; line count, threshold, etc., will need to happen here
-	 *	- line count will always be the largest multiple of 6 smaller than height; c = h - (h % 6)
-	 *	- chevrons may have larger widths: TODO calc
-	 *	- depth will be funky; line depth will need to use "full" depth; (Df - Dl) / Wc = Ic (TODO verify?)
-	 *	- switch stripe index on *absolute* line number rather than n
-	 *	- chevron building will be BLOCK.repeat(width) + TRIANGLE_21[0] (fg Ic, bg Ic + 1)
-	 *		- chevrons[len - 1] will need unique handling to draw stripes
-	 */
-
 	//	set up constraints
 	let linecount = height - (height % 6);	//	largest multiple of 6 smaller than height
 	let full_depth = width / 3;
-	let chevron_width = (full_depth / 6) - 1;
+	let chevron_width = if full_depth > 6 { (full_depth / 6) - 1 } else { 0 };
 	let direction_thresh = linecount / 2;
 	let corner = linecount % 2 == 1;
 	
@@ -106,17 +95,14 @@ pub fn progress(small: bool) -> Flag {
 
 		//	grab our substring constraints
 		let start = (direction_thresh - n) as usize - 1;
-		let diff = display_length - start;
+		let diff = if display_length >= start { display_length - start } else { 0 };
 
 		//	take substring of chevron line...
 		let mut line = ansi_substr(&base, start as usize, base_length);
+		line += &stripes[index].to_string();
+		if diff > 0 { line.push(TRIANGLE_21[0]); }
 		//	... and add the colored stripe
-		line += &format!(
+		line += &" ".repeat(width as usize - diff);
-			"{stripe}{separator}{line}",
-			stripe = stripes[index],
-			separator = TRIANGLE_21[0],
-			line = " ".repeat(width as usize - diff)
-		);
 
 		lines.push(line);
 		line_no += 1;
@@ -142,15 +128,12 @@ pub fn progress(small: bool) -> Flag {
 		if index > 5 { break; }
 
 		let start = n as usize;
-		let diff = display_length - start;
+		let diff = if display_length >= start { display_length - start } else { 0 };
 
 		let mut line = ansi_substr(&base, start, base_length);
-		line += &format!(
+		line += &stripes[index].to_string();
-			"{stripe}{separator}{line}",
+		if diff > 0 { line.push(TRIANGLE_21[2]); }
-			stripe = stripes[index],
+		line += &" ".repeat(width as usize - diff);
-			separator = TRIANGLE_21[2],
-			line = " ".repeat(width as usize - diff)
-		);
 
 		lines.push(line);
 		line_no += 1;
@@ -161,12 +144,13 @@ pub fn progress(small: bool) -> Flag {
 
 //	everything below this point is in alphabetical order
 
-pub fn aroace(small: bool) -> Flag {
+pub fn aroace_halves(state: &State) -> Flag {
 	//	pull colors from aro & ace stripe flags
 	let Flag::Stripes(aro) = flag::aromantic() else { panic!() };
 	let Flag::Stripes(ace) = flag::asexual() else { panic!() };
 
-	let (width, height) = if small { (60, 20) } else { terminal_size().unwrap() };
+	let (width, height) = state.size.get(60, 20);
+	if height < 20 { error::too_small(width, height); }
 
 	let mut lines: Vec<String> = Vec::new();
 
@@ -191,9 +175,12 @@ pub fn aroace(small: bool) -> Flag {
 	Flag::Lines(lines)
 }
 
+
 fn demi_orientation_render(middle: Bg<Rgb>, bottom: Bg<Rgb>, width: u16, height: u16) -> Vec<String> {
 	let white	= bg(0xFFFFFF);
 
+	if height < 5 { error::too_small(width, height); }
+
 	let stripes = vec![white, white, middle, bottom, bottom];
 
 	//	initial stripe output buffer
@@ -228,26 +215,27 @@ fn demi_orientation_render(middle: Bg<Rgb>, bottom: Bg<Rgb>, width: u16, height:
 	lines
 }
 
-pub fn demiromantic(small: bool) -> Flag {
+pub fn demiromantic(state: &State) -> Flag {
 	let green	= bg(0x3DA542);
 	let gray	= bg(0xD2D2D2);
 
-	let (width, height) = if small { (15, 5) } else { terminal_size().unwrap() };
+	let (width, height) = state.size.get(15, 5);
 	let lines = demi_orientation_render(green, gray, width, height);
 
 	Flag::Lines(lines)
 }
 
-pub fn demisexual(small: bool) -> Flag {
+pub fn demisexual(state: &State) -> Flag {
 	let purple	= bg(0x832FA8);
 	let grey	= bg(0x7B868C);
 
-	let (width, height) = if small { (15, 5) } else { terminal_size().unwrap() };
+	let (width, height) = state.size.get(15, 5);
 	let lines = demi_orientation_render(purple, grey, width, height);
 
 	Flag::Lines(lines)
 }
 
+
 pub fn disability() {
 	let gray	= bg(0x575757);
 
@@ -263,6 +251,7 @@ pub fn disability() {
 	
 }
 
+
 pub fn intersex() -> Flag {
 	let yellow	= bg(0xFFDA00);
 	let purple	= rgb(0x7A00AC);
@@ -280,13 +269,63 @@ pub fn intersex() -> Flag {
 	Flag::Lines(lines)
 }
 
-pub fn polyamorous() {
+
+pub fn polyamory(state: &State) -> Flag {
 	let blue	= rgb(0x019FE3);
 	let magenta	= rgb(0xE50051);
 	let purple	= rgb(0x340C46);
-	let yellow	= rgb(0x00FCBF);
+	let yellow	= rgb(0xFCBF00);
+	let white	= bg(0xFFFFFF);
 
-	//	blue / magenta / purple vert
+	//	special characters
-	//	WHITE isosceles cutin with yellow heart pointed right
+	let semicircle = '\u{E0B6}';
+	let separators = ['\u{E0BE}', '\u{E0BA}'];
+
+	let (width, height) = state.size.get(18, 6);
+	if height < 6 { error::too_small(width, height); }
+
+	//	create stripe array and line buffer
+	let stripes = [magenta, purple];		//	only stripes 2 and 3 need tracked
+	let mut lines: Vec<String> = Vec::new();
+
+	//	constraints
+	let linecount = height - (height % 3);	//	largest multiple of 3 smaller than height
+	let full_depth = linecount;
+	let thresh = linecount / 3;				//	stripe & direction thresh
+	let start = 2 * full_depth / 3;
+
+	//	piecewise function: ascent -> descent
+	let mut separator = separators[0];
+	for n in 0..thresh {
+		let size = start + n;
+
+		let line = format!(
+			"{white}{yellow}{cutin}{blue}{separator}{stripe}",
+			cutin = " ".repeat(size as usize),
+			stripe = draw::BLOCK.repeat((width - (size + 1)) as usize)
+		);
+
+		lines.push(line);
+	}
+	//	first piece goes until the end of stripes[0]
+	let mut index = 0;						//	stripe index
+	separator = separators[1];
+	for n in thresh..linecount {
+		//	advance index at threshold
+		if n == (thresh * 2) { index = 1; }
+
+		let size = (2 * start) - n - 1;
+		let color = stripes[index];
+
+		let line = format!(
+			"{white}{yellow}{cutin}{color}{separator}{stripe}",
+			cutin = " ".repeat(size as usize),
+			stripe = draw::BLOCK.repeat((width - (size + 1)) as usize)
+		);
+
+		lines.push(line);
+	}
+
+	Flag::Lines(lines)
 }
 

src/draw.rs

@@ -1,8 +1,11 @@
-use std::io::{ self, Write };
+//!	render handling code
+
+use std::io::{
+	self,
+	Write
+};
 
 use termion::{
-	terminal_size,
-
 	clear,
 	color::{ Bg, Fg, Rgb },
 	cursor,
@@ -12,38 +15,54 @@ use termion::{
 
 use crate::{
 	color::{ RESET, RESET_BG },
-	flag::Flag
+	error,
+	flag::Flag,
+	state::{ Size, State }
 };
 
 pub static BLOCK: &str = "█";
 pub static UHALF: &str = "▀";
 
-pub fn draw_lines(lines: Vec<String>, hold: bool) {
+///	prints a provided vec of lines to stdout
+pub fn draw_full(lines: Vec<String>) {
 	let mut stdout = io::stdout().into_raw_mode().unwrap();
 
+	//	get in position for draw
 	let count = lines.len() as u16;
 	for _ in 0..count { write!(stdout, "\n").ok(); }
 	write!(stdout, "{}", cursor::Up(count)).ok();
 
-	if hold { write!(stdout, "{}{}", cursor::Hide, clear::All).ok(); }
+	//	clear screen and hide cursor
+	write!(stdout, "{}{}", cursor::Hide, clear::All).ok();
 
+	//	write lines
 	let down = cursor::Down(1);
 	for line in lines {
 		let left = cursor::Left(line.len() as u16);
 		write!(stdout, "{line}{left}{down}").ok();
 	}
 
+	//	clear formatting and flush buffer
 	write!(stdout, "{RESET}{RESET_BG}").ok();
 	stdout.flush().ok();
-	if hold {
+
-		let stdin = io::stdin();
+	//	hold for input
-		for _ in stdin.keys() { break; }
+	let stdin = io::stdin();
-		write!(stdout, "{}", clear::All).ok();
+	for _ in stdin.keys() { break; }
-	}
+
-	write!(stdout, "{}", cursor::Show).ok();
+	//	clear and show cursor
+	write!(stdout, "{}{}", clear::All, cursor::Show).ok();
 	stdout.flush().ok();
 }
 
+pub fn draw_lines(lines: Vec<String>, state: &State) {
+	match state.size {
+		Size::Full => draw_full(lines),
+		_ => for line in lines { println!("{line}{RESET}{RESET_BG}") }
+	}
+}
+
+///	generates lines for foreground colors provided as a vec of strings for the draw_lines method
 pub fn fg_stripes(colors: Vec<Fg<Rgb>>, width: u16, height: u16) -> Vec<String> {
 	let width = width as usize;
 	let height = height as usize;
@@ -68,6 +87,7 @@ pub fn fg_stripes(colors: Vec<Fg<Rgb>>, width: u16, height: u16) -> Vec<String>
 
 	output
 }
+///	generates lines for background colors provided as a vec of strings for the draw_lines method
 pub fn bg_stripes(colors: Vec<Bg<Rgb>>, width: u16, height: u16) -> Vec<String> {
 	let width = width as usize;
 	let height = height as usize;
@@ -92,22 +112,20 @@ pub fn bg_stripes(colors: Vec<Bg<Rgb>>, width: u16, height: u16) -> Vec<String>
 }
 
 impl Flag {
-	pub fn draw(self, hold: bool) {
+	///	renders a flag to stdout
+	pub fn draw(self, state: &State) {
 		let lines = match self {
 			Flag::Stripes(colors)
 				=> {
-					let (width, height);
+					let count = colors.len() as u16;
-					if hold { (width, height) = terminal_size().unwrap(); }
+					let (width, height) = state.size.get(count * 3, count);
-					else {
+					if height < count { error::too_small(width, height); }
-						height = colors.len() as u16;
-						width = height * 3;
-					}
 					fg_stripes(colors, width, height)
 				},
 			Flag::Lines(lines)
 				=>	lines
 		};
-		draw_lines(lines, hold);
+		draw_lines(lines, &state);
 	}
 }
 

src/error.rs

@@ -0,0 +1,24 @@
+use std::process::exit;
+
+pub fn unmatched_flag(target: String) {
+	eprintln!("pride: no flag {target}");
+	exit(1);
+}
+
+
+pub fn size_missing() {
+	eprintln!("pride: size flag requires a value");
+	exit(2);
+}
+
+pub fn size_error(value: &str) {
+	eprintln!("pride: size '{value}' is invalid");
+	exit(2);
+}
+
+
+pub fn too_small(width: u16, height: u16) {
+	eprintln!("pride: this flag must be bigger than {width}x{height}");
+	exit(3);
+}
+

src/flag.rs

@@ -20,13 +20,6 @@ pub fn pride() -> Flag {
 	Flag::Stripes(vec![red, orange, yellow, green, blue, purple])
 }
 
-pub fn transgender() -> Flag {
-	let pink	= rgb(0x7ACBF5);
-	let blue	= rgb(0xEAACB8);
-
-	Flag::Stripes(vec![pink, blue, WHITE, blue, pink])
-}
-
 //	everything below here is alphabetical
 
 pub fn agender() -> Flag {
@@ -51,6 +44,16 @@ pub fn asexual() -> Flag {
 	Flag::Stripes(vec![BLACK, grey, WHITE, purple])
 }
 
+pub fn aroace() -> Flag {
+	let orange	= rgb(0xE28D00);
+	let yellow	= rgb(0xEBE200);
+	let blue	= rgb(0x67B7E8);
+	let navy	= rgb(0x203756);
+
+	Flag::Stripes(vec![orange, yellow, WHITE, blue, navy])
+}
+
+
 pub fn bigender() -> Flag {
 	let pink	= rgb(0xE676A6);
 	let yellow	= rgb(0xF9F04C);
@@ -68,6 +71,31 @@ pub fn bisexual() -> Flag {
 	Flag::Stripes(vec![magenta, magenta, purple, blue, blue])
 }
 
+
+fn demigender_base(color: Color) -> Colors {
+	let grey	= rgb(0x7F7F7F);
+	let gray	= rgb(0xC3C3C3);
+	
+
+	vec![grey, gray, color, WHITE, color, gray, grey]
+}
+
+pub fn demiboy() -> Flag {
+	let blue	= rgb(0x7ACBF5);
+	Flag::Stripes(demigender_base(blue))
+}
+
+pub fn demigender() -> Flag {
+	let yellow	= rgb(0xFBFF74);
+	Flag::Stripes(demigender_base(yellow))
+}
+
+pub fn demigirl() -> Flag {
+	let pink	= rgb(0xEAACB8);
+	Flag::Stripes(demigender_base(pink))
+}
+
+
 pub fn gay() -> Flag {
 	let green1	= rgb(0x00906D);
 	let green2	= rgb(0x00D1A7);
@@ -109,6 +137,7 @@ pub fn gendervoid() -> Flag {
 	Flag::Stripes(vec![navy, gray, BLACK, gray, navy])
 }
 
+
 pub fn lesbian() -> Flag {
 	let red		= rgb(0xD62800);
 	let orange	= rgb(0xFF9B56);
@@ -118,6 +147,7 @@ pub fn lesbian() -> Flag {
 	Flag::Stripes(vec![red, orange, WHITE, pink, magenta])
 }
 
+
 pub fn multigender() -> Flag {
 	let blue	= rgb(0x3F47CC);
 	let ltblue	= rgb(0x01A4E9);
@@ -126,6 +156,21 @@ pub fn multigender() -> Flag {
 	Flag::Stripes(vec![blue, ltblue, orange, ltblue, blue])
 }
 
+pub fn multisexual() -> Flag {
+	let purple	= rgb(0x724DC9);
+	let blue	= rgb(0xA0EFFE);
+	let pink	= rgb(0xFF3D9B);
+
+	Flag::Stripes(vec![purple, WHITE, blue, pink])
+}
+
+
+pub fn neutrois() -> Flag {
+	let green	= rgb(0x2D9A1B);
+
+	Flag::Stripes(vec![WHITE, green, BLACK])
+}
+
 pub fn nonbinary() -> Flag {
 	let yellow	= rgb(0xFFF433);
 	let purple	= rgb(0x9B59D0);
@@ -133,6 +178,7 @@ pub fn nonbinary() -> Flag {
 	Flag::Stripes(vec![yellow, WHITE, purple, BLACK])
 }
 
+
 pub fn pansexual() -> Flag {
 	let magenta	= rgb(0xFF1B8D);
 	let yellow	= rgb(0xFFDA00);
@@ -141,3 +187,20 @@ pub fn pansexual() -> Flag {
 	Flag::Stripes(vec![magenta, yellow, cyan])
 }
 
+pub fn polysexual() -> Flag {
+	let pink	= rgb(0xF61CB9);
+	let green	= rgb(0x07D569);
+	let blue	= rgb(0x1C92F6);
+
+	Flag::Stripes(vec![pink, green, blue])
+}
+
+
+pub fn transgender() -> Flag {
+	let pink	= rgb(0x7ACBF5);
+	let blue	= rgb(0xEAACB8);
+
+	Flag::Stripes(vec![pink, blue, WHITE, blue, pink])
+}
+
+

src/help.rs

@@ -0,0 +1,171 @@
+//!	help and list text
+
+use std::process::exit;
+
+use crate::VERSION;
+
+///	displays the program's help text
+pub fn help_text() {
+	println!("pride v{VERSION}
+Valerie Wolfe <sleeplessval@gmail.com>
+Display pride flags in the terminal.
+
+usage: pride [flags] [name]
+
+args:
+   <name>               The pride flag to display
+
+flags:
+   -h, --help           Shows this help text
+   --version            Show version information
+   -l, --list           Prints a list of printable flags
+   -s, --size [size]    Sets the size of the output flag.
+
+Use 'pride --list' to see a list of printable flags
+
+~ You're loved and you matter ♥");
+}
+
+///	shows a list of all flags
+pub fn list_text() {
+	println!("pride v{VERSION}
+
+flag list:
+   agender                agender pride flag
+   aromantic              aromantic pride flag
+   aroace                 aromantic-asexual pride flag
+   asexual                asexual pride flag
+   bigender               bigender pride flag
+   bisexual               bisexual pride flag
+   demiboy                demiboy pride flag
+   demigender             demigender pride flag
+   demigirl               demigirl pride flag
+   demiromantic           demiromantic pride flag
+   demisexual             demisexual pride flag
+   gay                    gay men pride flag
+   genderfluid            genderfluid pride flag
+   gender-nonconforming   gender nonconforming pride flag
+   genderqueer            genderqueer pride flag
+   gendervoid             gendervoid pride flag
+   lesbian                lesbian pride flag
+   multigender            multigender pride flag
+   multisexual            multisexual pride flag
+   neutrois               neutrois pride flag
+   nonbinary              nonbinary pride flag
+   pansexual              pansexual pride flag
+   polysexual             polysexual pride flag
+   rainbow                six-color rainbow flag
+   progress               progress arrow rainbow flag
+   transgender            transgender pride flag");
+}
+
+///	handle help details by flag
+pub fn flag_help(flag: &str) {
+	match flag {
+		"pride" | "rainbow" | "-"
+			=> {
+			println!("The ubiquitous 1979 6-color rainbow pride flag, representing the larger queer community.
+
+names:
+   'pride', 'rainbow', '-'
+
+variants:
+   8-color            Gilbert Baker's original 1978 flag with 8 stripes
+   gilbert-baker
+   sex-and-magic
+   philadelphia       The 2017 Philadelphia Pride flag with black and brown stripes
+   progress           The 2018 Progess rainbow pride flag designed by Daniel Quasar");
+			},
+		"progress"
+			=> { println!("Daniel Quasar's 2018 Progress rainbow pride flag.\n\nnames:\n   'progress'"); }
+
+		"transgender" | "trans"
+			=> {
+				println!("The transgender pride flag designed by Monica Helms in 1999.
+
+names:
+   'transgender', 'trans'");
+			},
+
+		//	alphabetical below this point
+
+		"aromantic" | "aro"
+			=> { println!("The aromantic pride flag.\n\nnames:\n   'aromantic', 'aro'"); }
+		"asexual" | "ace"
+			=> { println!("The asexual pride flag.\n\nnames:\n   'asexual', 'ace'"); }
+		"aroace" | "aromantic-asexual"
+			=> {
+				println!("The aromantic-asexual pride flag designed by aroaesflags on tumblr.
+
+names:
+   'aroace', 'aromantic-asexual'
+
+variants:
+   halves            The side-by-side aromantic and asexual aroace flag
+   side-by-side
+   sbs
+
+notes:
+   Side-by-side flag currently only displays in terminals 20 lines or taller.");
+			},
+
+		"bisexual" | "bi"
+			=> {
+				println!("The bisexual flag designed by Michael Page in 1998.
+
+names:
+   'bisexual', 'bi'");
+			},
+
+
+		"gay" | "mlm"
+			=> {
+				println!("The 7-stripe gay men pride flag designed by @gayflagblog on tumblr in 2019.
+
+names:
+   'gay', 'mlm'");
+			},
+
+		"gender-nonconforming" | "gendernonconforming" | "gnc"
+			=> { println!("The gender-nonconforming pride flag.\n\nnames:\n   'gender-nonconforming', 'gendernonconforming', 'gnc'"); },
+
+
+		"lesbian"
+			=> {
+				println!("The 5-stripe lesbian flag designed by Emily Gwen in 2018.
+
+names:
+   'lesbian', 'wlw'
+
+variants:
+   7-color            7-stripe flag, also designed in 2018 by Emily Gwen");
+			},
+
+
+		"nonbinary" | "nb"
+			=> {
+				println!("The nonbinary pride flag designed by Kyle Rowan in 2014.
+
+names:
+   'nonbinary', 'nb'");
+			},
+
+
+		"pansexual" | "pan"
+			=> {
+				println!("The pansexual pride flag designed by Jasper V around 2010
+
+names:
+   'pansexual', 'pan'");
+			},
+
+
+		_
+			=> {
+				println!("pride: no help found for {flag}!\n");
+				help_text();
+				exit(1);
+			}
+	}
+}
+

src/main.rs

@@ -1,65 +1,77 @@
-use std::process::exit;
+//!	main method module
 
 use pico_args::Arguments;
 
 mod color;
 mod complex;
 mod draw;
+mod error;
 mod flag;
+mod help;
+mod state;
 mod util;
 mod variant;
 
-use crate::flag::Flag;
+use crate::{
+	flag::Flag,
+	state::State
+};
 
 static VERSION: &str = env!("CARGO_PKG_VERSION");
 
+pub const FLAG_HELP:	[&str;2]	= [ "-h", "--help" ];
+pub const FLAG_LIST:	[&str;2]	= [ "-l", "--list" ];
+pub const FLAG_SIZE:	[&str;2]	= [ "-s", "--size"];
+pub const FLAG_VERSION:	[&str;2]	= [ "-v", "--version" ];
+
 fn main() {
 	//	collect args
 	let mut args = Arguments::from_env();
 
 	//	handle help flag
-	if args.contains(["-h", "--help"]) {
+	if args.contains(FLAG_HELP) {
-		help_text();
+		let target = args.subcommand().unwrap();
+		if target.is_some() { help::flag_help(&target.unwrap()); }
+		else { help::help_text(); }
 		return;
 	}
 
 	//	handle list flag
-	if args.contains(["-l", "--list"]) {
+	if args.contains(FLAG_LIST) {
-		list_text();
+		help::list_text();
 		return;
 	}
 
 	//	handle version flag
-	if args.contains("--version") {
+	if args.contains(FLAG_VERSION) {
 		println!("pride v{VERSION}");
 		return;
 	}
 
-	//	get small flag
+	let state = State::new(&mut args);
-	let small = args.contains(["-s", "--small"]);
 
 	let subcommand = args.subcommand().unwrap();
+	let variant = args.subcommand().unwrap();
 
 	//	get color vec from matched flag
 	let flag: Flag = match subcommand.as_deref() {
 		Some("pride" | "rainbow")
 		| None
 			=>	{
-				let variant = args.subcommand().unwrap_or(None);
 				match variant.as_deref() {
 					Some("8-color" | "gilbert-baker" | "sex-and-magic")
 						=>	variant::gilbert_baker(),
 					Some("philadelphia")
 						=>	variant::philadelphia(),
 					Some("progress")
-						=>	complex::progress(small),
+						=>	complex::progress(&state),
 					_
 						=>	flag::pride()
 				}
 			},
 
-		Some("transgender" | "trans")
+		Some("progress")
-			=>	flag::transgender(),
+			=>	complex::progress(&state),
 
 
 		Some("agender")
@@ -72,7 +84,14 @@ fn main() {
 			=>	flag::asexual(),
 
 		Some("aroace" | "aromantic-asexual")
-			=>	complex::aroace(small),
+			=>	{
+				match variant.as_deref() {
+					Some("halves" | "side-by-side" | "sbs")
+						=>	complex::aroace_halves(&state),
+					_
+						=>	flag::aroace()
+				}
+			},
 
 		Some("bigender")
 			=>	flag::bigender(),
@@ -80,15 +99,24 @@ fn main() {
 		Some("bisexual" | "bi")
 			=>	flag::bisexual(),
 
+
+		Some("demiboy")
+			=>	flag::demiboy(),
+		Some("demigender")
+			=>	flag::demigender(),
+		Some("demigirl")
+			=>	flag::demigirl(),
+
 		Some("demiromantic")
-			=>	complex::demiromantic(small),
+			=>	complex::demiromantic(&state),
 
 		Some("demisexual")
-			=>	complex::demisexual(small),
+			=>	complex::demisexual(&state),
 
 //		Some("disability")
 //			=>	complex::disability();
 
+
 		Some("gay" | "mlm")
 			=>	flag::gay(),
 
@@ -104,76 +132,56 @@ fn main() {
 		Some("gendervoid")
 			=>	flag::gendervoid(),
 
-		Some("intersex")
-			=>	complex::intersex(),
 
-		Some("lesbian")
+//		Some("intersex")
-			=>	flag::lesbian(),
+//			=>	complex::intersex(),
+
+
+		Some("lesbian" | "wlw")
+			=>	{
+				match variant.as_deref() {
+					Some("7-color")
+						=>	variant::lesbian_7(),
+					_
+						=>	flag::lesbian()
+				}
+			}
+
+
+		Some("multisexual" | "m-spec" | "mspec")
+			=>	flag::multisexual(),
 
 		Some("multigender")
 			=>	flag::multigender(),
 
+
+		Some("neutrois")
+			=>	flag::neutrois(),
+
 		Some("nonbinary" | "nb")
 			=>	flag::nonbinary(),
 
+
 		Some("pansexual" | "pan")
 			=>	flag::pansexual(),
 
-//		Some("poly" | "polyamorous" | "polyamory")
+//		Some("polyamory" | "polyamorous" | "poly")
-//			=>	complex::polyamorous(),
+//			=>	complex::polyamory(small),
 
-		_ => { help_text(); exit(1) }
+		Some("polysexual")
+			=>	flag::polysexual(),
+
+
+		Some("transgender" | "trans")
+			=>	flag::transgender(),
+
+
+		_
+			=>	{ error::unmatched_flag(subcommand.unwrap()); panic!() }
 	};
 
-	flag.draw(!small);
+	//	draw flag
+	flag.draw(&state);
 
 }
 
-fn help_text() {
-	println!("pride v{VERSION}");
-	println!("Valerie Wolfe <sleeplessval@gmail.com>");
-	println!("Show pride flags in the terminal.\n");
-
-	println!("usage: pride [flags] [name]\n");
-
-	println!("args:");
-	println!("   <name>         The pride flag to display\n");
-
-	println!("flags:");
-	println!("   -h, --help     Shows this help text");
-	println!("   --version      Show version information");
-	println!("   -l, --list     Prints a list of printable flags");
-	println!("   -s, --small    Prints a small version without holding");
-
-	println!("\nUse 'pride --list' to see a list of printable flags");
-	println!("\n~ You're loved and you matter ♥");
-}
-
-fn list_text() {
-	println!("pride v{}", env!("CARGO_PKG_VERSION"));
-	println!("\nFlag list:");
-	println!("   agender                agender pride flag");
-	println!("   aro, aromantic         aromantic pride flag");
-	println!("   ace, asexual           asexual pride flag");
-	println!("   aroace                 aromantic/asexual pride flag");
-	println!("   bigender               bigender pride flag");
-	println!("   bi, bisexual           bisexual pride flag");
-	println!("   demiromantic           demiromantic pride flag");
-	println!("   demisexual             demisexual pride flag");
-//	println!("   disability             disability pride flag");
-	println!("   gay, mlm               gay men pride flag");
-	println!("   genderfluid            genderfluid pride flag");
-	println!("   gender-nonconforming   gender nonconforming pride flag");
-	println!("   genderqueer            genderqueer pride flag");
-	println!("   gendervoid             gendervoid pride flag");
-//	println!("   intersex               intersex pride flag");
-	println!("   lesbian                lesbian pride flag");
-	println!("   multigender            multigender pride flag");
-	println!("   nb, nonbinary          nonbinary pride flag");
-	println!("   pan, pansexual         pansexual pride flag");
-//	println!("   poly, polyamorous      polyamorous pride flag");
-	println!("   pride, rainbow         six-color rainbow flag");
-	println!("   progress               progress arrow flag");
-	println!("   trans, transgender     transgender pride flag");
-}
-

src/state.rs

@@ -0,0 +1,66 @@
+use std::io::{ stdout, IsTerminal };
+
+use pico_args::{ Arguments, Error };
+use termion::terminal_size;
+
+use crate::{ FLAG_SIZE, error };
+
+#[derive(PartialEq)]
+pub enum Size {
+	Full,
+	Small,
+	Set(u16, u16),
+	Wide(u16)
+}
+
+impl Size {
+	pub fn from(value: &str) -> Size {
+		if value == "small" { return Size::Small; }
+		let split: Vec<&str> = value.split('x').collect();
+		let len = split.len();
+		if len == 2 {
+			if let (Ok(width), Ok(height)) = (str::parse::<u16>(split.get(0).unwrap()), str::parse::<u16>(split.get(1).unwrap())) {
+				return Size::Set(width, height);
+			}
+		} else if len == 1 {
+			if let Ok(width) = str::parse::<u16>(split.get(0).unwrap()) {
+				return Size::Wide(width);
+			}
+		}
+		error::size_error(value);
+		panic!();
+	}
+	pub fn get(&self, width: u16, height: u16) -> (u16, u16) {
+		match self {
+			Size::Full					=> terminal_size().unwrap(),
+			Size::Set(width, height)	=> (width.clone(), height.clone()),
+			Size::Small					=> (width, height),
+			Size::Wide(width)			=> (width.clone(), height)
+		}
+	}
+}
+
+pub struct State {
+	pub size: Size,
+	pub is_terminal: bool,
+}
+
+impl State {
+	pub fn new(args: &mut Arguments) -> State {
+		let is_terminal = stdout().is_terminal();
+
+		let size = match args.value_from_str::<[&str;2], String>(FLAG_SIZE).as_deref() {
+			Ok(value)							=>	Size::from(value),
+
+			Err(Error::MissingOption(_))		|
+			Err(Error::MissingArgument)			=>	if is_terminal { Size::Full } else { Size::Small },
+
+			Err(Error::OptionWithoutAValue(_))	=>	Size::Small,
+
+			_									=>	{ error::size_missing(); panic!() }
+		};
+
+		State { size, is_terminal }
+	}
+}
+

src/util.rs

@@ -1,3 +1,4 @@
+//!	utility functions for working with ansi strings
 
 ///	gets the substring of displayed characters of an ANSI formatted string
 pub fn ansi_substr(source: &str, start: usize, end: usize) -> String {

src/variant.rs

@@ -27,7 +27,7 @@ pub fn philadelphia() -> Flag {
 		Flag::Stripes(inner)
 			=>	inner,
 		_
-			=>	{ panic!("impossible enum variant"); }
+			=>	panic!("impossible enum variant")
 	};
 	colors.insert(0, BLACK);
 	colors.insert(1, brown);
@@ -35,3 +35,15 @@ pub fn philadelphia() -> Flag {
 	Flag::Stripes(colors)
 }
 
+pub fn lesbian_7() -> Flag {
+	let orange1	= rgb(0xD52D00);	//	gender non-conformity
+	let orange2	= rgb(0xEF7627);	//	independence
+	let orange3	= rgb(0xFF9A56);	//	community
+	//	white						//	unique relationships with womanhood
+	let pink1	= rgb(0xD162A4);	//	serenity and peace
+	let pink2	= rgb(0xB55690);	//	love and sex
+	let pink3	= rgb(0xA30262);	//	femininity
+
+	Flag::Stripes(vec![orange1, orange2, orange3, WHITE, pink1, pink2, pink3])
+}
+