New Nuget package release for PDF Pig

[davebrokit]

It's been almost a year since the last release.

Anything I can do to help get out a new release?

[Numpsy]

There are nightly build published to nuget.org if you need something urgently?

[davebrokit]

No nothing needed urgently.

It's for a major release. The package that most people will get from nuget is the last major release. As it's a year old they don't get any of the amazing fixes and features that have been released in the last year.

[EliotJones]

Unfortunately the major version release is still a couple of hours manual work for me. I'd dearly like to make it possible from GitHub actions, but the only thing I hate more than manual work is YAML.

The steps are currently:

• Create a commit that sets the version number to the release version 5597a8f
• Build the package locally in release mode
• Upload it to NuGet using the PdfPig user account
• Manually copy the readme stuff to the NuGet site for documentation and edit it to be below the word-count
• Add release notes, backwards incompatibility documentation etc and publish the release
• Create a commit that sets the version number to the next nightly build version, e.g. if releasing 0.0.20 then set the version to 0.0.21-alpha001, this is the version the nightly build script reads and updates.

I don't have a good idea about the current stability of the nightly version at the moment which gives me pause. I'm guessing it is fine but there are so many changes it is hard to know.

[davebrokit]

Ah totally understand. I can't help with the YAML.

I can help with:

• Edit the readme stuff to the NuGet site for documentation and edit it to be below the word-count
• Release notes, backwards incompatibility documentation etc

Would that help you get out a release?

And stabilty of nightly builds people are currently been recommended to use the nightly builds because it's been a year since the last release. I guess that's stable enough...

[svengeance]

@EliotJones Any recent thoughts on releasing a new major version? Happy to use stable, but also keen on all the improvements made since then. Much like Dave's offer above, if there's anything I or another hopeful can do to help, let us know.

We're currently using PdfPig for manual document creation (which it does better than many other solutions!), text/image extraction, and PDF page manipulation. So far the nightly build has been working well, but some folks are anxious about something tagged alpha even if it's working stably.

[BobLd]

Same here @EliotJones, more than happy to help

[cremor]

I'd like to add two notes for a possible next release:

• I think it should be mentioned somewhere that the new version has new dependencies (which bring in their own dependencies).
  This is important to know for everyone who distributes their application in a way which doesn't include all NuGet dependencies by default.
• There is at least one known regression: PdfDocumentBuilder creates broken annotation elements when copying pages from specific source PDFs #878

[EliotJones]

@cremor Are the additional dependencies mentioned the SkiaSharp dependency or something else? I've forgotten most of what has transpired since the last version. Afaict this is only a test project dependency.

@BobLd I'm assuming one of the last 5 PRs addresses the issue mentioned. Are there other regressions reported we might need to address before a release?

[cremor]

You can see the new dependencies if you compare those two pages:
https://www.nuget.org/packages/PdfPig/0.1.8#dependencies-body-tab
https://www.nuget.org/packages/PdfPig/0.1.9-alpha-20240910-4845f#dependencies-body-tab

Since #878 is now fixed (thanks @BobLd!) I don't know of any more regressions. But I'd like to test the latested nightly build (which should then include this fix) tomorrow before you create a release.

[BobLd]

@cremor @EliotJones I fixed another regression in #883 and I'm not aware of any other

[cremor]

But I'd like to test the latested nightly build (which should then include this fix) tomorrow before you create a release.

The current nightly build (0.1.9-alpha-20240930-eb9a1) works fine for my use cases, thanks!

[davebrokit]

Thanks for moving this along. Please let me know if I can help