aboutsummaryrefslogtreecommitdiff
path: root/vendor/clap_builder/src/builder/styled_str.rs
diff options
context:
space:
mode:
authorValentin Popov <valentin@popov.link>2024-07-19 15:37:58 +0300
committerValentin Popov <valentin@popov.link>2024-07-19 15:37:58 +0300
commita990de90fe41456a23e58bd087d2f107d321f3a1 (patch)
tree15afc392522a9e85dc3332235e311b7d39352ea9 /vendor/clap_builder/src/builder/styled_str.rs
parent3d48cd3f81164bbfc1a755dc1d4a9a02f98c8ddd (diff)
downloadfparkan-a990de90fe41456a23e58bd087d2f107d321f3a1.tar.xz
fparkan-a990de90fe41456a23e58bd087d2f107d321f3a1.zip
Deleted vendor folder
Diffstat (limited to 'vendor/clap_builder/src/builder/styled_str.rs')
-rw-r--r--vendor/clap_builder/src/builder/styled_str.rs210
1 files changed, 0 insertions, 210 deletions
diff --git a/vendor/clap_builder/src/builder/styled_str.rs b/vendor/clap_builder/src/builder/styled_str.rs
deleted file mode 100644
index e06ddbc..0000000
--- a/vendor/clap_builder/src/builder/styled_str.rs
+++ /dev/null
@@ -1,210 +0,0 @@
-#![cfg_attr(not(feature = "usage"), allow(dead_code))]
-
-/// Terminal-styling container
-///
-/// Styling may be encoded as [ANSI Escape Code](https://en.wikipedia.org/wiki/ANSI_escape_code)
-///
-/// # Examples
-///
-/// ```rust
-/// # use clap_builder as clap;
-/// // `cstr!` converts tags to ANSI codes
-/// let after_help: &'static str = color_print::cstr!(
-/// r#"<bold><underline>Examples</underline></bold>
-///
-/// <dim>$</dim> <bold>mybin --input file.toml</bold>
-/// "#);
-///
-/// let cmd = clap::Command::new("mybin")
-/// .after_help(after_help) // The `&str` gets converted into a `StyledStr`
-/// // ...
-/// # ;
-/// ```
-#[derive(Clone, Default, Debug, PartialEq, Eq, PartialOrd, Ord)]
-pub struct StyledStr(String);
-
-impl StyledStr {
- /// Create an empty buffer
- pub const fn new() -> Self {
- Self(String::new())
- }
-
- /// Display using [ANSI Escape Code](https://en.wikipedia.org/wiki/ANSI_escape_code) styling
- #[cfg(feature = "color")]
- pub fn ansi(&self) -> impl std::fmt::Display + '_ {
- self.0.as_str()
- }
-
- /// May allow the compiler to consolidate the `Drop`s for `msg`, reducing code size compared to
- /// `styled.push_str(&msg)`
- pub(crate) fn push_string(&mut self, msg: String) {
- self.0.push_str(&msg);
- }
-
- pub(crate) fn push_str(&mut self, msg: &str) {
- self.0.push_str(msg);
- }
-
- pub(crate) fn trim_start_lines(&mut self) {
- if let Some(pos) = self.0.find('\n') {
- let (leading, help) = self.0.split_at(pos + 1);
- if leading.trim().is_empty() {
- self.0 = help.to_owned()
- }
- }
- }
-
- pub(crate) fn trim_end(&mut self) {
- self.0 = self.0.trim_end().to_owned()
- }
-
- #[cfg(feature = "help")]
- pub(crate) fn replace_newline_var(&mut self) {
- self.0 = self.0.replace("{n}", "\n");
- }
-
- #[cfg(feature = "help")]
- pub(crate) fn indent(&mut self, initial: &str, trailing: &str) {
- self.0.insert_str(0, initial);
-
- let mut line_sep = "\n".to_owned();
- line_sep.push_str(trailing);
- self.0 = self.0.replace('\n', &line_sep);
- }
-
- #[cfg(all(not(feature = "wrap_help"), feature = "help"))]
- pub(crate) fn wrap(&mut self, _hard_width: usize) {}
-
- #[cfg(feature = "wrap_help")]
- pub(crate) fn wrap(&mut self, hard_width: usize) {
- let mut new = String::with_capacity(self.0.len());
-
- let mut last = 0;
- let mut wrapper = crate::output::textwrap::wrap_algorithms::LineWrapper::new(hard_width);
- for content in self.iter_text() {
- // Preserve styling
- let current = content.as_ptr() as usize - self.0.as_str().as_ptr() as usize;
- if last != current {
- new.push_str(&self.0.as_str()[last..current]);
- }
- last = current + content.len();
-
- for (i, line) in content.split_inclusive('\n').enumerate() {
- if 0 < i {
- // reset char count on newline, skipping the start as we might have carried
- // over from a prior block of styled text
- wrapper.reset();
- }
- let line = crate::output::textwrap::word_separators::find_words_ascii_space(line)
- .collect::<Vec<_>>();
- new.extend(wrapper.wrap(line));
- }
- }
- if last != self.0.len() {
- new.push_str(&self.0.as_str()[last..]);
- }
- new = new.trim_end().to_owned();
-
- self.0 = new;
- }
-
- #[inline(never)]
- #[cfg(feature = "help")]
- pub(crate) fn display_width(&self) -> usize {
- let mut width = 0;
- for c in self.iter_text() {
- width += crate::output::display_width(c);
- }
- width
- }
-
- #[cfg(feature = "help")]
- pub(crate) fn is_empty(&self) -> bool {
- self.0.is_empty()
- }
-
- #[cfg(feature = "help")]
- pub(crate) fn as_styled_str(&self) -> &str {
- &self.0
- }
-
- #[cfg(feature = "color")]
- pub(crate) fn iter_text(&self) -> impl Iterator<Item = &str> {
- anstream::adapter::strip_str(&self.0)
- }
-
- #[cfg(not(feature = "color"))]
- pub(crate) fn iter_text(&self) -> impl Iterator<Item = &str> {
- [self.0.as_str()].into_iter()
- }
-
- pub(crate) fn push_styled(&mut self, other: &Self) {
- self.0.push_str(&other.0);
- }
-
- pub(crate) fn write_to(&self, buffer: &mut dyn std::io::Write) -> std::io::Result<()> {
- ok!(buffer.write_all(self.0.as_bytes()));
-
- Ok(())
- }
-}
-
-impl Default for &'_ StyledStr {
- fn default() -> Self {
- static DEFAULT: StyledStr = StyledStr::new();
- &DEFAULT
- }
-}
-
-impl From<std::string::String> for StyledStr {
- fn from(name: std::string::String) -> Self {
- StyledStr(name)
- }
-}
-
-impl From<&'_ std::string::String> for StyledStr {
- fn from(name: &'_ std::string::String) -> Self {
- let mut styled = StyledStr::new();
- styled.push_str(name);
- styled
- }
-}
-
-impl From<&'static str> for StyledStr {
- fn from(name: &'static str) -> Self {
- let mut styled = StyledStr::new();
- styled.push_str(name);
- styled
- }
-}
-
-impl From<&'_ &'static str> for StyledStr {
- fn from(name: &'_ &'static str) -> Self {
- StyledStr::from(*name)
- }
-}
-
-impl std::fmt::Write for StyledStr {
- #[inline]
- fn write_str(&mut self, s: &str) -> Result<(), std::fmt::Error> {
- self.0.push_str(s);
- Ok(())
- }
-
- #[inline]
- fn write_char(&mut self, c: char) -> Result<(), std::fmt::Error> {
- self.0.push(c);
- Ok(())
- }
-}
-
-/// Color-unaware printing. Never uses coloring.
-impl std::fmt::Display for StyledStr {
- fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result {
- for part in self.iter_text() {
- part.fmt(f)?;
- }
-
- Ok(())
- }
-}