aioqzone 1.9.3.dev3__tar.gz → 1.9.4.dev2__tar.gz

aioqzone-1.9.4.dev2/.github/dependabot.yml

@@ -0,0 +1,13 @@
+version: 2
+updates:
+  # Maintain dependencies for GitHub Actions
+  - package-ecosystem: github-actions
+    directory: "/"
+    schedule:
+      interval: weekly
+      day: saturday
+
+  - package-ecosystem: pip
+    directory: "/"
+    schedule:
+      interval: daily

aioqzone-1.9.4.dev2/.github/workflows/auto-pr.yml

@@ -0,0 +1,37 @@
+name: Auto PR
+
+on:
+  push:
+    branches:
+      - dev
+      - dev/**
+
+concurrency:
+  group: ci-${{ github.ref_name }}
+  cancel-in-progress: true
+
+env:
+  target: beta
+
+jobs:
+  pr:
+    name: Open or Edit PR
+    runs-on: ubuntu-latest
+    if: "!startsWith(github.event.head_commit.message, '@no-pr')"
+    permissions:
+      pull-requests: write
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - uses: JamzumSum/actions/pr-changelog@master
+        id: git-cliff
+        with:
+          start: ${{ env.target }}
+
+      - name: Push Changelog to PR
+        uses: JamzumSum/actions/push-pr-body@master
+        with:
+          base-branch: ${{ env.target }}
+          body: ${{ steps.git-cliff.outputs.changelog }}

aioqzone-1.9.4.dev2/.github/workflows/build.yml

@@ -0,0 +1,36 @@
+# This workflow will install Python dependencies, build and publish this repo to PyPI.
+
+name: Publish to PyPI
+
+on:
+  workflow_dispatch:
+  pull_request:
+    types:
+      - closed
+    branches:
+      - "release"
+      - "release/**"
+      - "beta"
+      - "beta/**"
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    if: |
+      github.event_name == 'workflow_dispatch' ||
+      contains(github.event.pull_request.labels.*.name, 'release')
+    steps:
+      #----------------------------------------------
+      #       check-out repo and set-up python
+      #----------------------------------------------
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v6
+      #----------------------------------------------
+      #  --------    Build and release   ---------
+      #----------------------------------------------
+      - name: Build dist and Publish to PyPI
+        env:
+          UV_PUBLISH_PASSWORD: ${{ secrets.PYPI_TOKEN }}
+        run: |
+          uv build
+          uv publish --username __token__

aioqzone-1.9.4.dev2/.github/workflows/codeql-analysis.yml

@@ -0,0 +1,59 @@
+# For most projects, this workflow file will not need changing; you simply need
+# to commit it to your repository.
+#
+# You may wish to alter this file to override the set of languages analyzed,
+# or to provide custom queries or build logic.
+#
+# ******** NOTE ********
+# We have attempted to detect the languages in your repository. Please check
+# the `language` matrix defined below to confirm you have the correct set of
+# supported CodeQL languages.
+#
+name: "CodeQL"
+
+on:
+  pull_request:
+    # The branches below must be a subset of the branches above
+    branches: [ beta ]
+    paths:
+      - "*.py"
+  schedule:
+    - cron: '31 23 * * 0/2'
+
+jobs:
+  analyze:
+    name: Analyze
+    runs-on: ubuntu-latest
+    permissions:
+      actions: read
+      contents: read
+      security-events: write
+
+    strategy:
+      fail-fast: false
+      matrix:
+        language: [ 'python' ]
+        # CodeQL supports [ 'cpp', 'csharp', 'go', 'java', 'javascript', 'python', 'ruby' ]
+        # Learn more about CodeQL language support at https://git.io/codeql-language-support
+
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v4
+
+    # Initializes the CodeQL tools for scanning.
+    - name: Initialize CodeQL
+      uses: github/codeql-action/init@v3
+      with:
+        languages: ${{ matrix.language }}
+        # If you wish to specify custom queries, you can do so here or in a config file.
+        # By default, queries listed here will override any specified in a config file.
+        # Prefix the list here with "+" to use these queries and those in the config file.
+        # queries: ./path/to/local/query, your-org/your-repo/queries@main
+
+    - name: Perform CodeQL Analysis
+      uses: github/codeql-action/analyze@v3
+
+
+concurrency:
+  group: codeql-${{ github.ref_name }}
+  cancel-in-progress: true

aioqzone-1.9.4.dev2/.github/workflows/sphinx.yml

@@ -0,0 +1,67 @@
+name: Sphinx Build and Deploy
+
+on:
+  pull_request:
+    types:
+      - review_requested
+    branches:
+      - beta
+  push:
+    branches:
+      - beta
+    paths:
+      - doc/**
+      - .github/workflows/sphinx.yml
+
+concurrency:
+  group: pages
+  cancel-in-progress: true
+
+jobs:
+  sphinx-build:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/configure-pages@v5
+      - uses: astral-sh/setup-uv@v6
+
+      - name: Install Library and Build HTML
+        run: |
+          echo "::group::Install Library"
+          uv sync --group doc
+          echo "::endgroup::"
+
+          echo "::group::Build HTML"
+          uv run sphinx-build doc/source doc/build/html -D release=$(uv version --short)
+          echo "::endgroup::"
+
+      - name: Fix permissions
+        run: |
+          chmod -c -R +rX "doc/build/html/" | while read line; do
+            echo "::warning title=Invalid file permissions automatically fixed::$line"
+          done
+
+      - name: Upload artifact
+        if: github.event_name == 'push'
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: doc/build/html
+
+  deploy:
+    if: github.event_name == 'push'
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    permissions:
+      pages: write
+      id-token: write
+    runs-on: ubuntu-latest
+    needs: sphinx-build
+    outputs:
+      page_url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

aioqzone-1.9.4.dev2/.github/workflows/test.yml

@@ -0,0 +1,51 @@
+# install dependency and current package
+name: Test Poetry Project
+
+on:
+  pull_request:
+    types:
+      - review_requested
+    branches:
+      - beta
+      - release
+
+concurrency:
+  group: test-${{ github.ref_name }}
+  cancel-in-progress: true
+
+jobs:
+  install-test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.13", "3.11", "3.10", "3.9"]
+    steps:
+      #----------------------------------------------
+      #       check-out repo and set-up python
+      #----------------------------------------------
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v6
+        with:
+          python-version: ${{ matrix.python-version }}
+          enable-cache: true
+
+      - name: Install and Test
+        env:
+          TEST_UIN: ${{ secrets.TEST_UIN }}
+          TEST_PASSWORD: ${{ secrets.TEST_PASSWORD }}
+        run: |
+          echo "::group::Install Basic Dependencies"
+          uv sync --group test
+          echo "::endgroup::"
+
+          echo "::group::pytest outputs"
+          uv run pytest test --log-cli-level=WARNING
+          echo "::endgroup::"
+
+      - name: Request Changes
+        env:
+          GH_TOKEN: ${{ secrets.COMMENT_PAT }} # the reviewer PAT
+        run: |
+          if [[ $GH_TOKEN != "" ]]; then
+              gh pr review ${{ github.event.pull_request.number }} -r -b "Some test(s) failed."
+          fi

aioqzone-1.9.4.dev2/.gitignore

@@ -0,0 +1,28 @@
+# local config
+.vscode
+.env
+uv.toml
+package-lock.json
+
+# venv
+.venv
+.tox
+/venv
+node_modules
+
+# cache and tempfiles
+__pycache__
+*.pyc
+tmp
+/data
+
+# build, metadata and distributions
+/dist
+/build
+/doc/source/locale/**/*.mo
+*.egg-info
+
+# useless documents
+/archive
+/doc/*
+!/doc/source

aioqzone-1.9.4.dev2/.pre-commit-config.yaml

@@ -0,0 +1,37 @@
+# See https://pre-commit.com for more information
+# See https://pre-commit.com/hooks.html for more hooks
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v5.0.0
+    hooks:
+      - id: check-case-conflict
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+      - id: check-added-large-files
+  - repo: https://github.com/astral-sh/uv-pre-commit
+    rev: 0.7.2
+    hooks:
+      - id: uv-lock
+  - repo: local
+    hooks:
+      - id: isort
+        name: sort imports
+        entry: uv run ruff check --select I --fix
+        pass_filenames: false
+        language: system
+        types: [python]
+      - id: black
+        name: format
+        entry: uv run ruff format
+        pass_filenames: false
+        language: system
+        types: [python]
+      - id: pytest
+        name: pytest-check
+        entry: uv run pytest test
+        language: system
+        pass_filenames: false
+        types: [python, toml]
+default_language_version:
+  python: python3

aioqzone-1.9.4.dev2/CONTRIBUTING.md

@@ -0,0 +1,9 @@
+# Contributing
+
+Welcome to aioqzone community.
+
+## Add Test
+
+Our tests are not fully coveraged. New unittests are needed.
+
+No special rules for tests. Just create a pull request if you've done your work.

{aioqzone-1.9.3.dev3 → aioqzone-1.9.4.dev2}/PKG-INFO

@@ -1,39 +1,32 @@
-Metadata-Version: 2.3
+Metadata-Version: 2.4
 Name: aioqzone
-Version: 1.9.3.dev3
+Version: 1.9.4.dev2
 Summary: A Python wrapper for Qzone login and H5 APIs.
-License: AGPL-3.0
-Keywords: qzone-api,autologin,asyncio-spider
+Project-URL: Homepage, https://github.com/aioqzone/aioqzone
+Project-URL: Repository, https://github.com/aioqzone/aioqzone
+Project-URL: Documentation, https://aioqzone.github.io/aioqzone
+Project-URL: Bug Tracker, https://github.com/aioqzone/aioqzone/issues
+Project-URL: Discussion, https://t.me/aioqzone_chatroom
 Author: aioqzone
-Author-email: 22952836+JamzumSum@users.noreply.github.com
-Requires-Python: >=3.9,<4.0
+Maintainer-email: JamzumSum <22952836+JamzumSum@users.noreply.github.com>
+License-Expression: AGPL-3.0
+License-File: LICENSE
+Keywords: asyncio-spider,autologin,qzone-api
 Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: GNU Affero General Public License v3
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Typing :: Typed
+Requires-Python: >=3.9
+Requires-Dist: aiohttp>=3.9.0
+Requires-Dist: pillow>=10.1.0
+Requires-Dist: pychaosvm~=0.4.3
+Requires-Dist: pydantic-settings>=2.9.0
+Requires-Dist: pydantic>=2.11.4
+Requires-Dist: rsa>=4.9.1
+Requires-Dist: tenacity<10.0.0,>=8.2.3
+Requires-Dist: tylisten>=2.2.1
 Provides-Extra: slide-captcha
-Requires-Dist: aiohttp (>=3.9.0,<4.0.0)
-Requires-Dist: exceptiongroup (>=1.1.1,<2.0.0)
-Requires-Dist: pillow (>=10.1.0,<11.0.0)
-Requires-Dist: pychaosvm (>=0.4.3,<0.5.0)
-Requires-Dist: pydantic (>=2.11.3,<3.0.0)
-Requires-Dist: pydantic-settings (>=2.2.0,<3.0.0)
-Requires-Dist: rsa (>=4.8,<5.0)
-Requires-Dist: slide-tc (>=0.1.1,<0.2.0) ; extra == "slide-captcha"
-Requires-Dist: tenacity (>=8.2.3,<10.0.0)
-Requires-Dist: tylisten (>=2.1.4,<3.0.0)
-Project-URL: Bug Tracker, https://github.com/aioqzone/aioqzone/issues
-Project-URL: Documentation, https://aioqzone.github.io/aioqzone
-Project-URL: Discussion, https://t.me/aioqzone_chatroom
-Project-URL: Homepage, https://github.com/aioqzone/aioqzone
-Project-URL: Repository, https://github.com/aioqzone/aioqzone
+Requires-Dist: slide-tc~=0.1.1; extra == 'slide-captcha'
 Description-Content-Type: text/markdown
 
 # aioqzone
@@ -123,4 +116,3 @@ along with this program.  If not, see <https://www.gnu.org/licenses/>.
 [pychaosvm]: https://github.com/aioqzone/pychaosvm "A Python envirionment for Tencent ChaosVM."
 [pypi]: https://pypi.org/project/aioqzone
 [org]: https://github.com/aioqzone
-

aioqzone-1.9.4.dev2/README_en.md

@@ -0,0 +1,84 @@
+# aioqzone
+
+aioqzone is a python package handling Qzone web login and wrapping some common Qzone Http apis.
+
+[![python](https://img.shields.io/pypi/pyversions/aioqzone?logo=python&logoColor=white)][home]
+[![version](https://img.shields.io/pypi/v/aioqzone?logo=python)][pypi]
+[![style](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
+[![discuss](https://img.shields.io/endpoint?label=Discuss&style=social&url=https%3A%2F%2Ftg.sumanjay.workers.dev%2Faioqzone_chatroom)](https://t.me/aioqzone_chatroom)
+
+English | [简体中文](README.md)
+
+> [!WARNING]
+> aioqzone is under active development. Any functionality and interface may be changed.
+
+## Features
+
+### Qzone Feature
+
+- [x] [QR login](src/qqqr/qr/)
+- [x] [password login](src/qqqr/up/) (limited)
+- [x] [solve slide captcha](src/qqqr/up/captcha/slide)
+- [x] [parse select captcha](src/qqqr/up/captcha/select)
+- [ ] [pass network environment verification][pychaosvm]
+- [x] get complete html feeds
+- [x] get feed details
+- [x] like/unlike app
+- [x] publish/update/delete text feeds
+- [x] add comment
+
+### Why using this package?
+
+- [x] full ide typing support (typing)
+- [x] api validation (pydantic)
+- [x] async design
+- [x] complete infrastructure to ease your own develop
+- [x] [doc support](https://aioqzone.github.io/aioqzone)
+
+__Working On:__
+
+- [ ] test coverage
+
+## Description
+
+|package    |brief description  |
+|-----------|-------------------|
+|aioqzone   |qzone api          |
+|qqqr       |qzone login        |
+
+## Examples
+
+You can look for these repos for examples in practice.
+
+### aioqzone plugins
+
+- [aioqzone-feed][aioqzone-feed]: aioqzone plugin providing higher level api for processing feed
+
+
+## License
+
+```
+Copyright (C) 2022-2025 aioqzone.
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU Affero General Public License as published
+by the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU Affero General Public License for more details.
+
+You should have received a copy of the GNU Affero General Public License
+along with this program.  If not, see <https://www.gnu.org/licenses/>.
+```
+
+- [AGPL-3.0](LICENSE)
+- [Disclaimers](https://aioqzone.github.io/aioqzone/disclaimers.html)
+
+
+[home]: https://github.com/aioqzone/aioqzone "Python wrapper for Qzone web login and Qzone http api"
+[aioqzone-feed]: https://github.com/aioqzone/aioqzone-feed "aioqzone plugin providing higher level api for processing feed"
+[pychaosvm]: https://github.com/aioqzone/pychaosvm "A Python envirionment for Tencent ChaosVM."
+[pypi]: https://pypi.org/project/aioqzone

aioqzone-1.9.4.dev2/cliff.toml

@@ -0,0 +1,59 @@
+# configuration file for git-cliff (0.1.0)
+
+[changelog]
+# changelog header
+header = """
+# Changelog
+
+All notable changes to this project will be documented in this file.\n
+"""
+# template for the changelog body
+# https://tera.netlify.app/docs/#introduction
+body = """
+{% if version %}\
+    ## [{{ version | trim_start_matches(pat="v") }}] - {{ timestamp | date(format="%Y-%m-%d") }}
+{% else %}\
+    ## [unreleased]
+{% endif %}\
+{% for group, commits in commits | group_by(attribute="group") %}
+    ### {{ group | upper_first }}
+    {% for commit in commits %}
+        {% raw -%} - {% endraw %}\
+        {%- if commit.breaking -%} 💥 **{% endif -%}\
+        {%- if commit.scope -%} ({{ commit.scope }}) {% endif -%}\
+        {{ commit.message | upper_first }} ({{ commit.id | truncate(length=7, end="") }})\
+        {%- if commit.breaking -%} ** {%- endif -%}\
+    {% endfor %}
+{% endfor %}\n
+"""
+# remove the leading and trailing whitespaces from the template
+trim = true
+# changelog footer
+footer = """
+<!-- generated by git-cliff -->
+"""
+
+[git]
+# allow only conventional commits
+# https://www.conventionalcommits.org
+conventional_commits = true
+# regex for parsing and grouping commits
+commit_parsers = [
+    { message = "^build", group = "Build"},
+    { message = "^ci", group = "CI/CD"},
+    { message = "^feat", group = "Features"},
+    { message = "^fix", group = "Bug Fixes"},
+    { message = "^doc", group = "Documentation"},
+    { message = "^fmt", group = "Styling"},
+    { message = "^perf", group = "Performance"},
+    { message = "^proj", group = "Project"},
+    { message = "^chore", group = "Miscellaneous"},
+    { message = "^refactor", group = "Refactor"},
+    { message = "^style", group = "Styling"},
+    { message = "^test", group = "Testing"},
+    { body = ".*security", group = "Security"},
+]
+# filter out the commits that are not matched by commit parsers
+filter_commits = false
+# glob pattern for matching git tags
+tag_pattern = "v[0-9]*"