Improve project quality and stability

[ashtanko]

Fixes a critical LRU ordering bug, adds new utility methods, and significantly enhances documentation and test coverage for the LruCache package.

The get() method's LRU ordering was incorrect, failing to move accessed items to the most recently used position. This PR corrects that behavior and introduces comprehensive improvements including new utility methods, extensive API and usage documentation, increased test coverage with benchmarks, and a CI/CD pipeline, transforming the package into a production-ready, high-quality caching solution.

---

[cursor]

Cursor Agent can help with this pull request. Just @cursor in comments and I'll start working on changes in this branch.
_{Learn more about Cursor Agents}

[codacy-production]

Coverage summary from Codacy

See diff coverage on Codacy

Coverage variation	Diff coverage
Report missing for 5ff50291	✅ 95.00%

Coverage variation details

	Coverable lines	Covered lines	Coverage
Common ancestor commit (5ff5029)	Report Missing	Report Missing	Report Missing
Head commit (7c4594f)	186	182	97.85%

Coverage variation is the difference between the coverage for the head and common ancestor commits of the pull request branch: <coverage of head commit> - <coverage of common ancestor commit>

Diff coverage details

	Coverable lines	Covered lines	Diff coverage
Pull request (#3)	40	38	95.00%

Diff coverage is the percentage of lines that are covered by tests out of the coverable lines that the pull request added or modified: <covered lines added or modified>/<coverable lines added or modified> * 100%

See your quality gate settings    Change summary preferences

Footnotes

1. Codacy didn't receive coverage data for the commit, or there was an error processing the received data. Check your integration for errors and validate that your coverage setup is correct. ↩

[codacy-production]

Coverage summary from Codacy

See diff coverage on Codacy

Coverage variation	Diff coverage
Report missing for 5ff50291	✅ 95.00%

Coverage variation details

	Coverable lines	Covered lines	Coverage
Common ancestor commit (5ff5029)	Report Missing	Report Missing	Report Missing
Head commit (8c750e5)	186	182	97.85%

Coverage variation is the difference between the coverage for the head and common ancestor commits of the pull request branch: <coverage of head commit> - <coverage of common ancestor commit>

Diff coverage details

	Coverable lines	Covered lines	Diff coverage
Pull request (#3)	40	38	95.00%

Diff coverage is the percentage of lines that are covered by tests out of the coverable lines that the pull request added or modified: <covered lines added or modified>/<coverable lines added or modified> * 100%

See your quality gate settings    Change summary preferences

Footnotes

1. Codacy didn't receive coverage data for the commit, or there was an error processing the received data. Check your integration for errors and validate that your coverage setup is correct. ↩

[codecov]

Welcome to Codecov 🎉

Once you merge this PR into your default branch, you're all set! Codecov will compare coverage reports and display results in all future pull requests.

Thanks for integrating Codecov - We've got you covered ☂️