yash-syntax-0.11.0

[0.11.0] - 2024-08-22

Added

• The following functions are now const:
  • parser::lex::is_portable_name_char
  • parser::lex::is_special_parameter_char
• The parser::lex::is_single_char_name const function is added.
• A new syntax::Param struct is introduced to represent a parameter in
  parameter expansions (syntax::TextUnit::RawParam and syntax::BracedParam).
  New enum types syntax::SpecialParam and syntax::ParamType are added to
  represent the details of the parameter. Note that the former syntax::Param
  struct is renamed to syntax::BracedParam.
• The parser::SyntaxError::InvalidParam variant is added, which is returned
  when a parameter expansion has an invalid name.
• The source::Source enum is extended with new variants VariableValue,
  InitFile, and Other.

Changed

• syntax::Param has been renamed to syntax::BracedParam.
• The syntax::TextUnit::RawParam variant now has a param: syntax::Param
  field instead of a name: String field.
• The syntax::BracedParam struct (formerly syntax::Param) now has a
  param: syntax::Param field instead of a name: String field.
• source::Source::label now returns "<arithmetic_expansion>" for
  Source::Arith. Previously, it returned "<arith>".
• The parser::lex::WordLexer::braced_param method now returns
  parser::SyntaxError::InvalidParam if the parameter starts with a digit but
  contains a non-digit character.
• External dependency versions:
  • Rust 1.77.0 → 1.79.0

yash-env-0.3.0

[0.3.0] - 2024-08-22

Added

• This crate now builds on non-Unix platforms. However,
  system::real::RealSystem is only available on Unix platforms.
• The OfdAccess, OpenFlag, FdFlag, Mode, RawMode, Uid, RawUid,
  Gid, RawGid, FileType, Stat, and SigmaskOp types in the system
  module
• The System trait now has the ofd_access, get_and_set_nonblocking,
  getuid, geteuid, getgid, and getegid methods.
• Mode has been moved from system::virtual to system and now has constants
  with more human-friendly names, e.g., USER_READ and GROUP_WRITE.
• The system::virtual::Inode struct now has the stat method.
• The system::virtual::FileBody struct now has the type and size methods.
• The system::virtual::Process struct now has the getters/setters for the
  real/effective user/group IDs: uid, set_uid, euid, set_euid, gid,
  set_gid, egid, and set_egid.
• system::virtual::VirtualSystem::open now applies the process's umask to the
  mode argument.
• The job::RawPid type has been added to represent the contents of job::Pid.
• The stack::Frame enum now has the InitFile variant.
• The crate now re-exports unix_path as path and unix_str as str.
• External dependencies:
  • enumset 1.1.2 (previously an internal dependency)
  • unix_path 1.0.1
  • unix_str 1.0.0
• Internal dependencies:
  • bitflags 2.6.0
  • nix 0.29.0 (with the "fs", "signal", and "user" features enabled)

Changed

• system::FdFlag is no longer a re-export of nix::fcntl::FdFlag.
• system::Mode is no longer a re-export of nix::sys::stat::Mode.
• All APIs that handle std::path::Path, std::path::PathBuf, std::ffi::OsStr,
  and std::ffi::OsString now use path::Path, path::PathBuf, str::OsStr,
  and str::OsString instead.
  • system::DirEntry::name
  • system::System::confstr_path
  • system::System::getcwd
  • system::System::getpwnam_dir
  • system::System::open_tmpfile
  • system::virtual::FileBody::Directory::files
  • system::virtual::FileBody::Symlink::target
  • system::virtual::FileSystem::get
  • system::virtual::FileSystem::save
  • system::virtual::Process::chdir
  • system::virtual::SystemState::home_dirs
  • system::virtual::SystemState::path
  • system::virtual::VirtualDir::new
• system::SignalHandling has been renamed to system::Disposition.
• In the system::virtual::Process struct, the following methods have been
  renamed:
  • signal_handling → disposition
  • set_signal_handling → set_disposition
• In the trap::SignalSystem trait, the set_signal_handling method has been
  renamed to set_disposition.
• In the trap::TrapSet struct, the following methods have been renamed:
  • enable_sigchld_handler → enable_internal_disposition_for_sigchld
  • enable_terminator_handlers → enable_internal_dispositions_for_terminators
  • enable_stopper_handlers → enable_internal_dispositions_for_stoppers
  • disable_terminator_handlers → disable_internal_dispositions_for_terminators
  • disable_stopper_handlers → disable_internal_dispositions_for_stoppers
  • disable_internal_handlers → disable_internal_dispositions
• The fstat and fstatat methods of system::System now return a Stat
  instead of a nix::sys::stat::FileStat.
• The system::System::fstatat method now takes a follow_symlinks: bool
  parameter instead of an AtFlags parameter.
• The system::System::open method has been redefined to take OfdAccess and
  OpenFlag parameters instead of nix::fcntl::OFlag.
• The system::System::isatty method now returns a bool instead of a
  system::Result<bool>.
• The system::System::umask method now takes and returns a value of the new
  system::Mode type.
• The system::System::sigmask method now takes a SigmaskOp parameter instead
  of a nix::sys::signal::SigmaskHow parameter.
• The system::System::select method now takes Vec<io::Fd> parameters instead
  of fd_set::FdSet parameters. It also takes a Duration instead of a
  nix::sys::time::TimeSpec for the optional timeout parameter.
• The dup, fcntl_getfl, and fcntl_setfl methods of system::System now
  operate on an EnumSet<FdFlag> parameter instead of an nix::fcntl::FdFlag
  parameter.
• The getrlimit and setrlimit methods of system::System now returns an
  error of type system::Errno instead of std::io::Error.
• In the system::resource module:
  • The rlim_t type has been renamed to Limit.
  • The RLIM_INFINITY constant has been renamed to INFINITY.
• The flags: enumset::EnumSet<FdFlag> field of
  yash_env::system::virtual::FdBody has replaced
  the flag: nix::fcntl::FdFlag field.
• The system::virtual::INode struct has been renamed to Inode.
• The system::virtual::OpenFileDescription::i_node method has been renamed to
  inode and now returns a reference to Rc<RefCell<Inode>> rather than a
  clone of it.
• The system::virtual::OpenFileDescription::seek method now takes a
  std::io::SeekFrom parameter instead of an offset and whence pair.
• The system::virtual::VirtualSystem::select method now treats as ready file
  descriptors that are contained in readers but not readable, or in writers
  but not writable. Previously, the method returned an EBADF error in these
  cases.
• External dependency versions:
  • Rust 1.77.0 → 1.79.0
  • yash-syntax 0.10.0 → 0.11.0

Deprecated

• system::virtual::Mode in favor of system::Mode

Removed

• The system module no longer reexports nix::fcntl::AtFlags,
  nix::fcntl::OFlag, nix::sys::stat::FileStat, nix::sys::stat::SFlag,
  nix::sys::signal::SigmaskHow, and nix::sys::time::TimeSpec.
• The fcntl_getfl and fcntl_setfl methods from the System trait
• The system::Errno struct's last and clear methods are no longer public.
• The system::resource::Resource::as_raw_type method is no longer public.
• All the fields of the system::virtual::OpenFileDescription struct are now
  private.
• The system::fd_set module
• impl TryFrom<semantics::ExitStatus> for nix::sys::signal::Signal
• impl From<job::Pid> for nix::unistd::Pid
• impl From<nix::unistd::Pid> for job::Pid
• impl From<system::resource::LimitPair> for nix::libc::rlimit
• impl From<nix::libc::rlimit> for system::resource::LimitPair
• External dependencies:
  • nix 0.27.0 (now an internal dependency with the "fs", "signal" and "user"
    features enabled)

yash-syntax-0.10.0

[0.10.0] - 2024-07-12

Added

• source::Code::line_number
  • This new method returns the line number of a particular character in the
    code.
• alias::Glossary
  • This new trait is now used as an interface to provide the parser with
    alias definitions.
• impl<T> input::Input for T where T: DerefMut<Target: input::Input>
  • This new trait implementation allows more types to be used as input
    sources, especially when it is used with a decorator that requires
    another input source.
• input::Context::is_first_line
  • This new method allows changing the behavior of the input function
    depending on whether the current line is the first line of the input.
  • The corresponding setter method set_is_first_line is also added.

Changed

• External dependency versions:
  • Rust 1.70.0 → 1.77.0
  • annotate-snippets 0.10.0 → 0.11.4
• source::Code::source is now Rc<Source> instead of Source.
  • This change is made to avoid cloning the Source object when the Lexer
    flushes its buffer and creates a new Code object sharing the same
    Source.
  • The lexer constructor Lexer::new now takes Rc<Source> instead of
    Source.
  • The lexer constructor Lexer::from_memory now takes a generic parameter
    that can be converted to Rc<Source>.
• The second argument of parser::Parser::new is now &dyn alias::Glossary
  instead of &alias::AliasSet.

Fixed

• Small performance improvements

yash-semantics-0.3.0

[0.3.0] - 2024-07-13

Added

• read_eval_loop
  • This function replaces the ReadEvalLoop struct and its methods.
    It supports the yash_env::input::Echo decorator by taking a
    &RefCell<&mut Env>.
• ReadEvalLoop now has the must_use attribute.

Changed

• External dependency versions:
  • Rust 1.75.0 → 1.77.0
  • yash-syntax 0.9.0 → 0.10.0

Deprecated

• ReadEvalLoop::set_verbose in favor of yash_env::input::Echo

Removed

• Internal dependencies:
  • futures-util 0.3.28

Fixed

• Small performance improvements

yash-prompt-0.1.0

[0.1.0] - 2024-07-13

Added

• Initial implementation of the yash-prompt crate

yash-env-test-helper-0.1.0

[0.1.0] - 2024-07-12

Added

• Initial implementation of the yash-env-test-helper crate

yash-env-0.2.1

[0.2.1] - 2024-07-12

Added

• Env::is_interactive
• impl yash_system::alias::Glossary for Env
• input::Echo
  • This is a decorator of Input that implements the behavior of the verbose shell option.
• input::FdReader is now marked #[must_use].
• variable::VariableSet::get_scalar
  • This is a convenience method that returns a scalar variable as a Cow<str>.
• Variable name constants in the variable module:
  CDPATH, ENV, HOME, IFS, LINENO, OLDPWD, OPTARG, OPTIND,
  PATH, PPID, PS1, PS2, PS4, PWD
• Variable initial value constants in the variable module:
  IFS_INITIAL_VALUE, OPTIND_INITIAL_VALUE, PS1_INITIAL_VALUE_NON_ROOT,
  PS1_INITIAL_VALUE_ROOT, PS2_INITIAL_VALUE, PS4_INITIAL_VALUE
• impl System for &SharedSystem and impl trap::SignalSystem for &SharedSystem
  • This allows SharedSystem to be used as a system behind a non-mutable reference.

Changed

• External dependency versions:
  • Rust 1.70.0 → 1.77.0
  • yash-syntax 0.9.0 → 0.10.0
• Internal dependency versions:
  • annotate-snippets 0.10.0 → 0.11.4
• All inherent methods of SharedSystem now take &self instead of &mut self:
  • SharedSystem::read_async
  • SharedSystem::write_all
  • SharedSystem::print_error

Deprecated

• input::FdReader::set_echo in favor of input::Echo

Fixed

• stack::Stack::loop_count no longer counts loops below a Frame::Trap(_) frame.
• Possible undefined behavior in RealSystem::times

yash-cli-0.1.0-beta.2

[0.1.0-beta.2] - 2024-07-13

Added

• Internal dependencies:
  • yash-prompt 0.1.0

Changed

• External dependency versions:
  • Rust 1.75.0 → 1.77.0
• Internal dependency versions:
  • yash-builtin 0.2.0 → 0.3.0
  • yash-semantics 0.2.0 → 0.3.0
  • yash-syntax 0.9.0 → 0.10.0
• The shell now shows the prompt before reading the input in the interactive mode.
  To achieve this, the startup::prepare_input function now applies the
  yash_prompt::Prompter decorator to the returned source input.
• The first argument to startup::prepare_input is now env: &'a RefCell<&mut Env>
  instead of system: &mut SharedSystem. This change is to allow the function to
  construct yash_env::input::Echo for the returned source input.

Removed

• startup::SourceInput::verbose
  • The caller of startup::prepare_input is no longer responsible for setting
    the verbose flag of the read-eval loop. The behavior of the verbose option
    is now implemented in yash_env::input::Echo, which is included in
    the startup::SourceInput::input field.

Fixed

• The break and continue built-ins no longer allow exiting a trap.
• The read built-in now shows a prompt when reading a continued line.
• The source built-in now echoes the input when the verbose shell option is set.
• The set built-in no longer sets the SIGTTIN, SIGTTOU, and SIGTSTP signals
  to be ignored when invoked with the -m option in a subshell of an
  interactive shell.

yash-builtin-0.3.0

[0.3.0] - 2024-07-13

Added

• Internal dependencies:
  • yash-prompt 0.1.0 (optional)

Changed

• External dependency versions:
  • Rust 1.75.0 → 1.77.0
  • yash-semantics 0.2.0 → 0.3.0
  • yash-syntax 0.9.0 → 0.10.0

Fixed

• The read built-in now shows a prompt when reading a continued line.
• The source built-in now echoes the input when the verbose shell option is set.
• The break and continue built-ins now return ExitStatus::ERROR for syntax
  errors and ExitStatus::FAILURE for semantic errors. Previously, they always
  returned ExitStatus::ERROR for both types of errors, while the documentation
  stated that they returned ExitStatus::FAILURE for semantic errors.
• The set built-in no longer enables stopper handlers (see
  yash_env::trap::TrapSet) when invoked with the -m option in a subshell of
  an interactive shell. Previously, it enabled stopper handlers in such cases,
  which was inconsistent with the job control behavior implemented in the
  yash-semantics crate.

yash-syntax-0.9.0

[0.9.0] - 2024-06-09

Added

• parser::SyntaxError::RedundantToken variant
• parser::lex::ParseOperatorError struct

Changed

• Implementations of FromStr for syntactic elements like Assign and
  SimpleCommand now fails with SyntaxError::RedundantToken if the input
  string contains a token that is not part of the element.
• Lexer::source_string is no longer generic. The argument type is now
  Range<usize> instead of a generic implementor of
  SliceIndex<[SourceChar], Output = [SourceChar]>.
• Word::parse_tilde_front no longer delimits the tilde expansion at an
  unquoted : character.
• WordLexer::braced_param now returns Err(SyntaxError::EmptyParam) if {
  is not followed by any name characters. Previously, it returned
  Err(SyntaxError::UnclosedParam{…}) if { was followed by a non-name
  character other than }.
• impl std::fmt::Display for SimpleCommand now prints the command words
  after the redirections if there are no assignments and the first word looks
  like a keyword.
• TryFromOperatorError is now a unit struct rather than an empty normal
  struct.

Fixed

• A newline after a bar in a pipeline was not parsed correctly if it appeared as
  a result of alias substitution.
• Alias substitution was not performed as expected for a token that follows a
  result of blank-ending alias substitution if there is a line continuation
  between them.
• Character location indexes were not calculated correctly after an alias
  substitution changed the length of the source code.