prepare v0.12.0 release

[jswrenn]

UPDATE: Changelog complete!

Still need to write changelog. Is there any way to easily get all PRs merged after a date/tag? Running this:

git log v0.11.0.. --reverse --merges --oneline --grep='Merge #' | cut -d' ' -f3 | sort -n

Only turned up merge commits for:

• fix: take_while_inclusive takes iterator by value #709
• Add conversion into (Option<A>,Option<B>) to EitherOrBoth #713
• Add conversion from Either<A, B> to EitherOrBoth<A, B> #715
• Fix multiunzip documentation #718
• try_len method #723
• Fuse the iterator in LazyBuffer #727
• Powerset count #735
• Count combinations with replacement #737
• Complete Permutations::size_hint #739
• Do not sum options #745

But we have plenty more PRs that were merged without merge commits: https://github.com/rust-itertools/itertools/milestone/5?closed=1

I'm quite tempted to adopt a squash-before-merging approach before our next release to simplify this (so we could just list off all commits without too much noise).

[Philippe-Cholet]

git is an awesome command line tool but it can't have all the informations that github has. So I would look at the github API instead. ...Merged PRs since 2023-06-22 (date for v0.11.0):

• Web search: https://github.com/search?q=repo:rust-itertools/itertools+type:pr+merged:>2023-06-22
• The same in JSON: https://api.github.com/search/issues?q=repo:rust-itertools/itertools+type:pr+merged:>2023-06-22&per_page=100
• With curl and jq, assuming there are less than 100 results (there are 52 today), the entire list is:
  curl -H "Accept: application/vnd.github+json" https://api.github.com/search/issues?q=repo:rust-itertools/itertools+type:pr+merged:>2023-06-22&per_page=100 | jq ".items[].number"
  The json data holds way more informations such as jq ".items[].pull_request.merged_at" that could help sort them but I only knew about jq before this.

And after a quick search, an helpful git log --tags --simplify-by-decoration --pretty="format:%cs %d" | grep v0.11.0.
(Or with %cI) It could be used to merge this with the curl|jq command.

[jswrenn]

Thanks! Coming at this from a slightly different angle, running this:

git log v0.11.0.. --reverse --oneline \
  | cut -d' ' -f1 \
  | xargs -I {} gh pr list --search {} --state merged --json number \
  | jq '.[] | .number' \
  | sort -nu

...gives:

• Fix tuple_windows as lazy #602
• fix: take_while_inclusive takes iterator by value #709
• Add conversion into (Option<A>,Option<B>) to EitherOrBoth #713
• Add conversion from Either<A, B> to EitherOrBoth<A, B> #715
• Add peek_mut and peek_nth_mut to PeekNth #716
• Fix multiunzip documentation #718
• Allow to use EitherOrBoth<T> to mean the same as EitherOrBoth<T, T> #719
• Disallow compile warnings in CI #720
• try_len method #723
• docs: mention permute with replacement #724
• Fuse the iterator in LazyBuffer #727
• combinations: count and size_hint #729
• Lazybuffer::it private #732
• add next_if and next_if_eq to PeekNth, such that it matches the functionality found in std::iter::Peekable #734
• Powerset count #735
• Merge Merge/MergeBy/MergeJoinBy implementations (v2) #736
• Count combinations with replacement #737
• Update rust/itertools versions in the doc #738
• Complete Permutations::size_hint #739
• Bump actions/checkout from 3 to 4 #744
• Do not sum options #745
• Use try_fold instead of fold(Some(...), ) #746
• Permutations unnecessarily complex 1 #748
• build: enforce formatting #751
• Implement ExactSizeIterator for (Circular)TupleWindows #752
• Fix ignored doctests #753
• use 'cargo-hack' to run MSRV check without dev dependencies #754
• Minimize features #760
• Implement ExactSizeIterator for Tuples #761
• TupleCombinations: size_hint and count #763
• Powerset::fold specialization #765
• Fix "bench1" in debug mode #770
• Specialize WithPosition::fold #772
• Configure CI for merge_queue. #773
• Implement custom fold for zip longest #774
• Specialize TupleCombinations::fold #775
• Add Clone trait to Unique #777
• GroupMap: add fold_with #778
• Implement custom fold for WhileSome #780
• Test specializations #782
• GroupMap: add fold_with (2) more generic init #785
• Macro bench_specializations #786
• docs: fixup docs of tree_fold1 #787
• count_ident macro without any comma #789
• Simplify Permutations #790
• Make Permutations lazy #793
• Add missing must_use attributes on adaptors #794
• Make Combinations lazy #795
• Implement a free sorted_unstable #796
• Make Intersperse[With] lazy #797
• More specialization tests #799
• Make Product lazy #800

...which is also 52 PRs! That sounds about right. I'll start putting together the changelog.

[Philippe-Cholet]

I dived into jq to nicely sort merged PRs by the merged_at key and came with two git aliases:

pulls-after-date = "!f() { curl -H 'Accept: application/vnd.github+json' 'https://api.github.com/search/issues?per_page=100&q=repo:rust-itertools/itertools+type:pr+merged:>'$1 | jq '.items | sort_by(.pull_request.merged_at) | .[].number'; }; f"
pulls-after-tag = "!f() { git pulls-after-date $(git log -1 --format=%as $1); }; f"
# %aI would be more precise than %as but it contains a "+" that messes with the github url.

Usage: git pulls-after-date 2023-06-22 or simply git pulls-after-tag v0.11.0.

Aliases v2: any github repo ; use more precise date with %aI instead of %as but url-escape the contained + to %2B.

# e.g.  rust-itertools/itertools
get-repo = "!f() { url=$(git remote get-url upstream); url=${url#'https://github.com/'}; url=${url%'.git'}; echo ${url}; }; f"
# List (up to 100) merged PRs for the current GitHub repo.
pulls-after-date = "!f() { date_for_url=${1/+/%2B}; curl -H 'Accept: application/vnd.github+json' 'https://api.github.com/search/issues?per_page=100&q=repo:'$(git get-repo)'+type:pr+merged:>'$date_for_url | jq '.items | sort_by(.pull_request.merged_at) | .[].number'; }; f"
# Get the date for a given tag, then call the main alias.
pulls-after-tag = "!f() { git pulls-after-date $(git log -1 --format=%aI $1); }; f"

[phimuemue]

Thanks for this. Looks good to me.

[Philippe-Cholet]

@jswrenn There is #![doc(html_root_url = "https://docs.rs/itertools/0.11/")] in lib.rs.

[jswrenn]

Whoops, I thought we deleted that.