#size #terminal #dimension #term #width

unmaintained term_size

functions for determining terminal sizes and dimensions

9 releases

Uses old Rust 2015

1.0.0-beta1 Dec 8, 2017
1.0.0-beta.2 May 3, 2020
0.3.2 May 2, 2020
0.3.1 Nov 7, 2017
0.1.0 Jun 30, 2016

#788 in Command-line interface

Download history 41781/week @ 2023-11-21 44138/week @ 2023-11-28 39941/week @ 2023-12-05 36997/week @ 2023-12-12 31810/week @ 2023-12-19 19431/week @ 2023-12-26 38361/week @ 2024-01-02 39612/week @ 2024-01-09 54086/week @ 2024-01-16 43509/week @ 2024-01-23 43736/week @ 2024-01-30 45424/week @ 2024-02-06 41642/week @ 2024-02-13 40620/week @ 2024-02-20 40994/week @ 2024-02-27 33183/week @ 2024-03-05

163,085 downloads per month
Used in 474 crates (139 directly)

MIT/Apache

21KB
191 lines

term_size

Crates.io Crates.io license license Coverage Status Join the chat at https://gitter.im/kbknapp/term_size-rs

Linux: Build Status Windows: Build status

A Rust library to enable getting terminal sizes and dimensions

Documentation

Usage

First, add the following to your Cargo.toml:

[dependencies]
term_size = "1"

Next, add this to your crate root:

extern crate term_size;

To get the dimensions of your terminal window, simply use the following:

fn main() {
  if let Some((w, h)) = term_size::dimensions() {
    println!("Width: {}\nHeight: {}", w, h);
  } else {
    println!("Unable to get term size :(")
  }
}

License

Copyright Benjamin Sago, Kevin Knapp, and term_size contributors.

Licensed under either of

at your option. Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Contributing

  1. Fork it!
  2. Create your feature branch: git checkout -b my-new-feature
  3. Commit your changes: git commit -am 'Add some feature'
  4. Push to the branch: git push origin my-new-feature
  5. Submit a pull request :D

Minimum Version of Rust

term_size will officially support current stable Rust, minus two releases, but may work with prior releases as well. For example, current stable Rust at the time of this writing is 1.22.1, meaning term_size is guaranteed to compile with 1.20.0 and newer.

At the 1.23.0 stable release, term_size will be guaranteed to compile with 1.21.0 and newer, etc.

Upon bumping the minimum version of Rust (assuming it's within the stable-2 range), it must be clearly annotated in the CHANGELOG.md

Breaking Changes

term_size takes a similar policy to Rust and will bump the major version number upon breaking changes with only the following exceptions:

  • The breaking change is to fix a security concern
  • The breaking change is to be fixing a bug (i.e. relying on a bug as a feature)
  • The breaking change is a feature isn't used in the wild, or all users of said feature have given approval prior to the change

Dependencies

~0–1.5MB
~35K SLoC