Merge pull request #4 from vlymar1/release/v1.0.0

Release v1.0.0 — core refactor, docs and packaging

Author: vlymar1

.github/workflows/ci.yaml

@@ -20,18 +20,16 @@ jobs:
         with:
           python-version: ${{ matrix.python-version }}
 
-      - name: Install dependencies
+      - name: Install hatch and create env
         run: |
           python -m pip install --upgrade pip
-          pip install poetry
-          poetry config virtualenvs.create false
-          poetry install --no-interaction --no-ansi --no-root
+          pip install hatch
 
       - name: Run linting
-        run: poetry run ruff check . --output-format=github
+        run: hatch run lint
 
       - name: Run type check
-        run: poetry run mypy vinted_api_kit/
+        run: hatch run type-check
 
       - name: Run tests (no coverage)
-        run: poetry run pytest -v --tb=short
+        run: hatch run test

.github/workflows/coverage.yaml

@@ -20,12 +20,10 @@ jobs:
       - name: Install dependencies
         run: |
           python -m pip install --upgrade pip
-          pip install poetry
-          poetry config virtualenvs.create false
-          poetry install --no-interaction --no-ansi --no-root
+          pip install hatch
 
       - name: Run tests with coverage
-        run: poetry run pytest --cov=vinted_api_kit --cov-branch --cov-report=xml
+        run: hatch run pytest --cov=vinted --cov-branch --cov-report=xml
 
       - name: Upload results to Codecov
         uses: codecov/codecov-action@v5

.gitignore

@@ -212,4 +212,7 @@ __marimo__/
 dev/
 reports/
 
-cookies*.pk
+cookies*.*
+
+# MacOS
+.DS_Store

.pre-commit-config.yaml

@@ -19,3 +19,9 @@ repos:
         - --fix
     - id: ruff-format
       types: [python]
+
+- repo: https://github.com/pre-commit/mirrors-mypy
+  rev: v1.13.0
+  hooks:
+    - id: mypy
+      additional_dependencies: [curl-cffi]

CHANGELOG.md

@@ -8,9 +8,37 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [Unreleased]
 
 ### Added
-- User profile retrieval functionality
-- Support for fetching user's own items
-- Enhanced error handling for network timeouts
+
+
+### Changed
+
+
+### Fixed
+
+
+
+## [1.0.0] - 2026-01-05
+
+### Added
+- Multiple cookie storage backends: `json`, `mozilla`, and `pickle`
+- Dataclass-based models (`CatalogItem`, `DetailedItem`) for performance and clarity
+- Custom exception hierarchy to surface network, auth, and validation errors distinctly
+- Automatic locale detection from target Vinted URLs
+- `SortOrder` and `StorageFormat` type literals for improved typing
+
+### Changed
+- Refactored architecture: separated `api/`, `storage/`, and `models/` layers for better maintainability
+- Default cookie storage format changed to `json` for security hardening
+- SSL verification enabled by default for all HTTP requests
+- Proxy configuration simplified to a single string parameter (`proxy="user:pass@host:port"`)
+- Cookie persistence now uses strategy pattern
+
+### Fixed
+- JWT token expiration parsing (base64url padding handling)
+- Retry/logging behavior for authentication failures
+- Cookie persistence reliability
+- Proxy handling edge cases
+- Token expiration detection accuracy
 
 ## [0.1.0.post1] - 2025-08-07
 
@@ -35,6 +63,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - CI/CD pipeline with GitHub Actions
 - 80%+ test coverage
 
-[Unreleased]: https://github.com/vlymar-dev/vinted-api-kit/compare/v0.1.0...HEAD
-[0.1.0.post1]: https://github.com/vlymar-dev/vinted-api-kit/compare/v0.1.0...v0.1.0.post1
-[0.1.0]: https://github.com/vlymar-dev/vinted-api-kit/releases/tag/v0.1.0
+[Unreleased]: https://github.com/vlymar1/vinted-api-kit/compare/v1.0.0...HEAD
+[1.0.0]: https://github.com/vlymar1/vinted-api-kit/compare/v0.1.0...v1.0.0
+[0.1.0.post1]: https://github.com/vlymar1/vinted-api-kit/compare/v0.1.0...v0.1.0.post1
+[0.1.0]: https://github.com/vlymar1/vinted-api-kit/releases/tag/v0.1.0

LICENSE

@@ -19,3 +19,9 @@ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
+
+DISCLAIMER:
+This software is intended for personal and lawful use only.
+The authors and copyright holders are not responsible for any misuse of the
+software, including but not limited to violations of applicable laws,
+regulations, or terms of service of third-party platforms.

Makefile

@@ -1,47 +1,91 @@
-package_dir := vinted_api_kit
+package_dir := vinted
 tests_dir := tests
 reports_dir := reports
 
 # ===========
 # Environment
 # ===========
-
 .PHONY: clean
 clean:
 	rm -rf `find . -name __pycache__`
-	rm -f `find . -type f -name '*.py[co]' `
-	rm -f `find . -type f -name '*~' `
-	rm -f `find . -type f -name '.*~' `
+	rm -f `find . -type f -name '*.py[co]'`
+	rm -f `find . -type f -name '*~'`
+	rm -f `find . -type f -name '.*~'`
 	rm -rf `find . -name .pytest_cache`
 	rm -rf *.egg-info
 	rm -f report.html
 	rm -f .coverage
-	rm -rf {build,dist,.cache,.mypy_cache,.ruff_cache,reports,.tox}
+	rm -rf {build,dist,.cache,.mypy_cache,.ruff_cache,.hatch,reports,.tox}
+	rm -rf htmlcov/
+
+
+# ===========
+# Development
+# ===========
+.PHONY: install
+install:
+	pip install hatch
+
+.PHONY: install-dev
+install-dev:
+	hatch env create
+
 
 # ============
 # Code quality
 # ============
+.PHONY: lint
+lint:
+	hatch run lint
 
 .PHONY: lint-check
 lint-check:
-	ruff check $(package_dir)
-	mypy $(package_dir)
+	hatch run ruff check $(package_dir)
+	hatch run mypy $(package_dir)
 
-.PHONY: lint-reformat
-lint-reformat:
-	ruff check --fix $(package_dir)
-	ruff format $(package_dir)
+.PHONY: format
+format:
+	hatch run format
+
+.PHONY: type-check
+type-check:
+	hatch run type-check
 
 # ======
 # Tests
 # ======
-.PHONY: test-coverage
+.PHONY: test
+test:
+	hatch run test
+
+.PHONY: test-cov
 test-coverage:
 	mkdir -p $(reports_dir)/tests/
-	pytest --cov=vinted_api_kit --cov-config .coveragerc --html=$(reports_dir)/tests/index.html tests/
-	coverage html -d $(reports_dir)/coverage
+	hatch run pytest --cov=$(package_dir) --cov-report=html:$(reports_dir)/coverage --cov-report=term-missing --html=$(reports_dir)/tests/index.html $(tests_dir)
 
 .PHONY: test-coverage-view
-test-coverage-view:
-	coverage html -d $(reports_dir)/coverage
-	python -c "import webbrowser; webbrowser.open('file://$(shell pwd)/reports/coverage/index.html')"
+test-coverage-view: test-coverage
+	python -c "import webbrowser; webbrowser.open('file://$(shell pwd)/$(reports_dir)/coverage/index.html')"
+
+
+# =====
+# Build
+# =====
+.PHONY: build
+build: clean
+	hatch build
+
+.PHONY: publish
+publish: build
+	hatch publish
+
+.PHONY: publish-test
+publish-test: build
+	hatch publish -r test
+
+# ===
+# All
+# ===
+.PHONY: all
+all:
+	hatch run all