vk-scripts 1.2.0__tar.gz → 1.3.1__tar.gz

{vk_scripts-1.2.0 → vk_scripts-1.3.1}/.github/workflows/ci.yml

@@ -22,8 +22,6 @@ jobs:
     steps:
       - name: Checkout
         uses: actions/checkout@v7
-        with:
-          fetch-depth: 0
       - name: Set up Python
         uses: actions/setup-python@v7
         with:
@@ -31,10 +29,14 @@ jobs:
       - name: Run black
         uses: psf/black@stable
 
-  test:
+  test_python:
     strategy:
       matrix:
-        python-version: ['3.9', '3.10', '3.11', '3.12', '3.13', '3.14']
+        python-version:
+          - '3.11'
+          - '3.12'
+          - '3.13'
+          - '3.14'
       # Random number to prevent exceeding the request frequency limit.
       max-parallel: 3
     runs-on: ubuntu-latest
@@ -42,8 +44,6 @@ jobs:
     steps:
       - name: Checkout
         uses: actions/checkout@v7
-        with:
-          fetch-depth: 0
       - name: Set up Python
         uses: actions/setup-python@v7
         with:
@@ -58,15 +58,39 @@ jobs:
       - name: Run tests
         run: ./test/main.sh
 
+  test_ubuntu:
+    strategy:
+      matrix:
+        codename:
+          - noble
+          - resolute
+    runs-on: ubuntu-latest
+    container:
+      image: 'ubuntu:${{ matrix.codename }}'
+    name: 'Ubuntu: ${{ matrix.codename }}'
+    steps:
+      - name: Install dependencies
+        run: |
+          apt update
+          DEBIAN_FRONTEND=noninteractive apt install -y --no-install-recommends \
+              ca-certificates \
+              python3 \
+              python3-matplotlib
+      - name: Checkout
+        uses: actions/checkout@v7
+      - name: Run tests
+        run: ./test/main.sh
+
   publish_pypi:
-    needs: [lint, test]
+    needs:
+      - lint
+      - test_python
+      - test_ubuntu
     runs-on: ubuntu-latest
     name: Publish
     steps:
       - name: Checkout
         uses: actions/checkout@v7
-        with:
-          fetch-depth: 0
       - name: Set up Python
         uses: actions/setup-python@v7
         with:

{vk_scripts-1.2.0/vk_scripts.egg-info → vk_scripts-1.3.1}/PKG-INFO

@@ -1,13 +1,13 @@
 Metadata-Version: 2.4
 Name: vk_scripts
-Version: 1.2.0
+Version: 1.3.1
 Summary: Scripts to stalk people on VK
 Author-email: Egor Tensin <egor@tensin.name>
 License-Expression: MIT
 Project-URL: Homepage, https://github.com/egor-tensin/vk-scripts
 Project-URL: Bug Tracker, https://github.com/egor-tensin/vk-scripts/issues
 Classifier: Development Status :: 5 - Production/Stable
-Requires-Python: >=3.6
+Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE.txt
 Requires-Dist: importlib-metadata~=4.0; python_version < "3.8"
@@ -42,25 +42,6 @@ with.
 [vk-status]: docs/status.md
 [vk-sessions]: docs/sessions.md
 
-Development
------------
-
-### Linting
-
-Requires [Pylint].
-
-    pylint vk
-
-[Pylint]: https://www.pylint.org/
-
-### Releases
-
-Make a git tag:
-
-    git tag "v$( python -m setuptools_scm --strip-dev )"
-
-You can then review that the tag is fine and push w/ `git push --tags`.
-
 License
 -------
 

{vk_scripts-1.2.0 → vk_scripts-1.3.1}/README.md

@@ -26,25 +26,6 @@ with.
 [vk-status]: docs/status.md
 [vk-sessions]: docs/sessions.md
 
-Development
------------
-
-### Linting
-
-Requires [Pylint].
-
-    pylint vk
-
-[Pylint]: https://www.pylint.org/
-
-### Releases
-
-Make a git tag:
-
-    git tag "v$( python -m setuptools_scm --strip-dev )"
-
-You can then review that the tag is fine and push w/ `git push --tags`.
-
 License
 -------
 

{vk_scripts-1.2.0 → vk_scripts-1.3.1}/docs/mutuals.md

@@ -7,7 +7,8 @@ Usage
 -----
 
     > vk-mutuals -h
-    usage: vk-mutuals [-h] [-f {csv,json}] [-o PATH] UID [UID ...]
+    usage: vk-mutuals [-h] [--version] [-f {csv,json}] [-o PATH]
+                      UID [UID ...]
     ...
 
 For example (using made up user IDs/"screen names"),

{vk_scripts-1.2.0 → vk_scripts-1.3.1}/docs/sessions.md

@@ -8,8 +8,9 @@ Usage
 
 ```
 > vk-sessions -h
-usage: vk-sessions [-h] [-g {user,date,weekday,hour}] [-i {csv,log,null}]
-                   [-o {csv,json,plot}] [-a TIME_FROM] [-b TIME_TO]
+usage: vk-sessions [-h] [--version] [-g {user,date,weekday,hour}]
+                   [-i {csv,log,null}] [-o {csv,json,plot}]
+                   [-a TIME_FROM] [-b TIME_TO]
                    [input] [output]
 ```
 

{vk_scripts-1.2.0 → vk_scripts-1.3.1}/docs/status.md

@@ -7,8 +7,8 @@ Usage
 -----
 
     > vk-status -h
-    usage: vk-status [-h] [-t SECONDS] [-O] [-l PATH] [-f {csv,log,null}]
-                     [-o PATH]
+    usage: vk-status [-h] [--version] [-t SECONDS] [-O] [-l PATH]
+                     [-f {csv,log,null}] [-o PATH]
                      UID [UID ...]
     ...
 

{vk_scripts-1.2.0 → vk_scripts-1.3.1}/pyproject.toml

@@ -12,7 +12,8 @@ license-files = ["LICENSE.txt"]
 dynamic = ["version"]
 authors = [{name = "Egor Tensin", email = "egor@tensin.name"}]
 readme = "README.md"
-requires-python = ">=3.6"
+requires-python = ">=3.11"
+# ^^^ For enum.StrEnum, at least?
 
 dependencies = [
     'importlib-metadata ~= 4.0 ; python_version < "3.8"',
@@ -33,3 +34,8 @@ vk-status = "vk.tracking.status:main"
 vk-mutuals = "vk.mutuals:main"
 
 [tool.setuptools_scm]
+
+[tool.pylint."messages control"]
+disable = [
+    "missing-docstring",
+]

{vk_scripts-1.2.0 → vk_scripts-1.3.1}/test/lib/test.sh

@@ -20,6 +20,7 @@ test_cleanup_default() {
 }
 
 test_run_module() {
-    log_run python -m "$@"
-    PYTHONPATH="$script_dir/.." python -m "$@"
+    local cmd=(python3 -m "$@")
+    log_run "${cmd[@]}"
+    PYTHONPATH="$script_dir/.." "${cmd[@]}"
 }

{vk_scripts-1.2.0 → vk_scripts-1.3.1}/test/tst-sessions.sh

@@ -37,15 +37,7 @@ _test_main() {
     _test_group_by weekday
 }
 
-_fix_matplotlib() {
-    # Get rid of:
-    # tkinter.TclError: no display name and no $DISPLAY environment variable
-    mkdir -p -- ~/.config/matplotlib
-    echo 'backend: Agg' > ~/.config/matplotlib/matplotlibrc
-}
-
 test_run() {
     test_setup
-    _fix_matplotlib
     _test_main
 }

{vk_scripts-1.2.0 → vk_scripts-1.3.1}/vk/api.py

@@ -4,7 +4,7 @@
 # Distributed under the MIT License.
 
 from collections.abc import Iterable, Mapping
-from enum import Enum
+from enum import auto, StrEnum
 import json
 from urllib.error import URLError
 import urllib.parse
@@ -69,39 +69,27 @@ def _join_path(base, url):
 ACCESS_TOKEN = "3d242bac3d242bac3d242bacd03e66eae033d243d242bac5755894cf6163d769859232d"
 
 
-class Version(Enum):
+class Version(StrEnum):
     # https://dev.vk.com/en/reference/versions
     V5_199 = "5.199"
     DEFAULT = V5_199
 
-    def __str__(self):
-        return self.value
 
-
-class Language(Enum):
-    EN = "en"
+class Language(StrEnum):
+    EN = auto()
     DEFAULT = EN
 
-    def __str__(self):
-        return self.value
-
 
-class Method(Enum):
+class Method(StrEnum):
     USERS_GET = "users.get"
     FRIENDS_GET = "friends.get"
 
-    def __str__(self):
-        return self.value
 
-
-class CommonParameters(Enum):
+class CommonParameters(StrEnum):
     ACCESS_TOKEN = "access_token"
     VERSION = "v"
     LANGUAGE = "lang"
 
-    def __str__(self):
-        return self.value
-
 
 class API:
     _ROOT_URL = "https://api.vk.com/method/"

{vk_scripts-1.2.0 → vk_scripts-1.3.1}/vk/last_seen.py

@@ -6,7 +6,7 @@
 from collections import OrderedDict
 from collections.abc import MutableMapping
 from datetime import datetime, timezone
-from enum import Enum
+from enum import auto, StrEnum
 from numbers import Integral, Real
 
 from .platform import Platform
@@ -30,12 +30,9 @@ def _parse_platform(x):
     return Platform(x)
 
 
-class LastSeenField(Enum):
-    TIME = "time"
-    PLATFORM = "platform"
-
-    def __str__(self):
-        return self.value
+class LastSeenField(StrEnum):
+    TIME = auto()
+    PLATFORM = auto()
 
 
 class LastSeen(MutableMapping):

{vk_scripts-1.2.0 → vk_scripts-1.3.1}/vk/mutuals.py

@@ -6,7 +6,7 @@
 import abc
 import argparse
 from collections import OrderedDict
-from enum import Enum
+from enum import auto, StrEnum
 import sys
 
 from vk.api import API
@@ -56,12 +56,9 @@ class OutputSinkJSON(OutputSinkMutualFriends):
         self._writer.write(friend_list)
 
 
-class OutputFormat(Enum):
-    CSV = "csv"
-    JSON = "json"
-
-    def __str__(self):
-        return self.value
+class OutputFormat(StrEnum):
+    CSV = auto()
+    JSON = auto()
 
     @staticmethod
     def open_file(path=None):
@@ -93,7 +90,10 @@ def _parse_args(args=None):
     vk.version.add_to_arg_parser(parser)
 
     parser.add_argument(
-        "uids", metavar="UID", nargs="+", help='user IDs or "screen names"'
+        "uids",
+        metavar="UID",
+        nargs="+",
+        help='user IDs or "screen names"',
     )
     parser.add_argument(
         "-f",

{vk_scripts-1.2.0 → vk_scripts-1.3.1}/vk/platform.py

@@ -3,10 +3,10 @@
 # For details, see https://github.com/egor-tensin/vk-scripts
 # Distributed under the MIT License.
 
-from enum import Enum
+from enum import IntEnum
 
 
-class Platform(Enum):
+class Platform(IntEnum):
     # https://dev.vk.com/en/reference/objects/user#last_seen
     MOBILE = 1
     IPHONE = 2
@@ -20,9 +20,6 @@ class Platform(Enum):
     def from_string(s):
         return Platform(int(s))
 
-    def __str__(self):
-        return str(self.value)
-
     @property
     def descr(self):
         return f"the {_PLATFORM_DESCRIPTIONS[self]}"

{vk_scripts-1.2.0 → vk_scripts-1.3.1}/vk/tracking/db/format.py

@@ -3,7 +3,7 @@
 # For details, see https://github.com/egor-tensin/vk-scripts
 # Distributed under the MIT License.
 
-from enum import Enum
+from enum import auto, StrEnum
 import sys
 
 from vk.utils import io
@@ -11,13 +11,10 @@ from vk.utils import io
 from . import backend
 
 
-class Format(Enum):
-    CSV = "csv"
-    LOG = "log"
-    NULL = "null"
-
-    def __str__(self):
-        return self.value
+class Format(StrEnum):
+    CSV = auto()
+    LOG = auto()
+    NULL = auto()
 
     def create_writer(self, fd=sys.stdout):
         if self is Format.CSV:

{vk_scripts-1.2.0 → vk_scripts-1.3.1}/vk/tracking/sessions.py

@@ -8,7 +8,7 @@ import argparse
 from collections import OrderedDict
 from collections.abc import MutableMapping
 from datetime import datetime, timedelta, timezone
-from enum import Enum
+from enum import auto, IntEnum, StrEnum
 import sys
 
 from vk.tracking.db import Format as DatabaseFormat
@@ -18,14 +18,14 @@ from vk.utils import io
 import vk.version
 
 
-class Weekday(Enum):
+class Weekday(IntEnum):
     MONDAY = 0
-    TUESDAY = 1
-    WEDNESDAY = 2
-    THURSDAY = 3
-    FRIDAY = 4
-    SATURDAY = 5
-    SUNDAY = 6
+    TUESDAY = auto()
+    WEDNESDAY = auto()
+    THURSDAY = auto()
+    FRIDAY = auto()
+    SATURDAY = auto()
+    SUNDAY = auto()
 
     def __str__(self):
         return self.name[0] + self.name[1:].lower()
@@ -143,14 +143,11 @@ class OnlineSessionEnumerator(MutableMapping):
         return session
 
 
-class GroupBy(Enum):
-    USER = "user"
-    DATE = "date"
-    WEEKDAY = "weekday"
-    HOUR = "hour"
-
-    def __str__(self):
-        return self.value
+class GroupBy(StrEnum):
+    USER = auto()
+    DATE = auto()
+    WEEKDAY = auto()
+    HOUR = auto()
 
     def group(self, db_reader, time_from=None, time_to=None):
         online_streaks = OnlineSessionEnumerator(time_from, time_to)
@@ -373,13 +370,10 @@ class OutputSinkPlot(OutputSinkOnlineSessions):
             bar_chart.save(self._fd)
 
 
-class OutputFormat(Enum):
-    CSV = "csv"
-    JSON = "json"
-    PLOT = "plot"
-
-    def __str__(self):
-        return self.value
+class OutputFormat(StrEnum):
+    CSV = auto()
+    JSON = auto()
+    PLOT = auto()
 
     def create_sink(self, fd=sys.stdout):
         if self is OutputFormat.CSV:

{vk_scripts-1.2.0 → vk_scripts-1.3.1}/vk/tracking/status.py

@@ -177,7 +177,10 @@ def _parse_args(args=None):
     vk.version.add_to_arg_parser(parser)
 
     parser.add_argument(
-        "uids", metavar="UID", nargs="+", help='user IDs or "screen names"'
+        "uids",
+        metavar="UID",
+        nargs="+",
+        help='user IDs or "screen names"',
     )
     parser.add_argument(
         "-t",
@@ -210,7 +213,11 @@ def _parse_args(args=None):
         help="specify database format",
     )
     parser.add_argument(
-        "-o", "--output", metavar="PATH", dest="db_path", help="set database file path"
+        "-o",
+        "--output",
+        metavar="PATH",
+        dest="db_path",
+        help="set database file path",
     )
 
     return parser.parse_args(args)

{vk_scripts-1.2.0 → vk_scripts-1.3.1}/vk/user.py

@@ -5,7 +5,7 @@
 
 from collections import OrderedDict
 from collections.abc import Hashable, Mapping, MutableMapping
-from enum import Enum
+from enum import auto, StrEnum
 
 from .last_seen import LastSeen
 
@@ -36,27 +36,21 @@ def _parse_online_flag(x):
     return _parse_bool(x)
 
 
-class UserField(Enum):
+class UserField(StrEnum):
     UID = "id"
-    FIRST_NAME = "first_name"
-    LAST_NAME = "last_name"
-    DEACTIVATED = "deactivated"
-    HIDDEN = "hidden"
+    FIRST_NAME = auto()
+    LAST_NAME = auto()
+    DEACTIVATED = auto()
+    HIDDEN = auto()
 
-    DOMAIN = "domain"
-    ONLINE = "online"
-    LAST_SEEN = "last_seen"
+    DOMAIN = auto()
+    ONLINE = auto()
+    LAST_SEEN = auto()
 
-    def __str__(self):
-        return self.value
 
-
-class DeactivationReason(Enum):
-    DELETED = "deleted"
-    BANNED = "banned"
-
-    def __str__(self):
-        return self.value
+class DeactivationReason(StrEnum):
+    DELETED = auto()
+    BANNED = auto()
 
 
 def _parse_deactivated(s):

{vk_scripts-1.2.0 → vk_scripts-1.3.1}/vk/utils/bar_chart.py

@@ -3,6 +3,9 @@
 # For details, see https://github.com/egor-tensin/vk-scripts
 # Distributed under the MIT License.
 
+import argparse
+import sys
+
 import matplotlib.pyplot as plt
 from matplotlib import ticker
 import numpy as np
@@ -131,30 +134,46 @@ class BarChartBuilder:
         self._fig.savefig(path, bbox_inches="tight")
 
 
-if __name__ == "__main__":
-    import argparse
+def _parse_args(argv=None):
+    if argv is None:
+        argv = sys.argv[1:]
 
     parser = argparse.ArgumentParser()
 
-    parser.add_argument("--categories", nargs="*", metavar="LABEL", default=[])
-    parser.add_argument("--values", nargs="*", metavar="N", default=[], type=float)
-
-    parser.add_argument("--output", "-o", help="set output file path")
-
+    parser.add_argument(
+        "--categories",
+        nargs="*",
+        metavar="LABEL",
+        default=[],
+    )
+    parser.add_argument(
+        "--values",
+        nargs="*",
+        metavar="N",
+        default=[],
+        type=float,
+    )
+    parser.add_argument(
+        "--output",
+        "-o",
+        help="set output file path",
+    )
     parser.add_argument(
         "--align-middle",
         action="store_true",
         dest="labels_align_middle",
         help="align labels to the middle of the bars",
     )
-
     parser.add_argument(
-        "--integer-values", action="store_true", dest="only_integer_values"
+        "--integer-values",
+        action="store_true",
+        dest="only_integer_values",
     )
     parser.add_argument(
-        "--any-values", action="store_false", dest="only_integer_values"
+        "--any-values",
+        action="store_false",
+        dest="only_integer_values",
     )
-
     parser.add_argument("--grid-categories", action="store_true")
     parser.add_argument("--grid-values", action="store_true")
 
@@ -165,6 +184,11 @@ if __name__ == "__main__":
     if len(args.categories) > len(args.values):
         args.values.extend([0.0] * (len(args.categories) - len(args.values)))
 
+    return args
+
+
+def _main(argv=None):
+    args = _parse_args(argv)
     builder = BarChartBuilder(labels_align_middle=args.labels_align_middle)
 
     if args.only_integer_values:
@@ -183,3 +207,7 @@ if __name__ == "__main__":
         builder.show()
     else:
         builder.save(args.output)
+
+
+if __name__ == "__main__":
+    _main()

{vk_scripts-1.2.0 → vk_scripts-1.3.1}/vk/version.py

@@ -12,5 +12,8 @@ except Exception:
 
 def add_to_arg_parser(parser):
     parser.add_argument(
-        "--version", "-V", action="version", version=f"%(prog)s {__version__}"
+        "--version",
+        "-V",
+        action="version",
+        version=f"%(prog)s {__version__}",
     )

{vk_scripts-1.2.0 → vk_scripts-1.3.1/vk_scripts.egg-info}/PKG-INFO

@@ -1,13 +1,13 @@
 Metadata-Version: 2.4
 Name: vk_scripts
-Version: 1.2.0
+Version: 1.3.1
 Summary: Scripts to stalk people on VK
 Author-email: Egor Tensin <egor@tensin.name>
 License-Expression: MIT
 Project-URL: Homepage, https://github.com/egor-tensin/vk-scripts
 Project-URL: Bug Tracker, https://github.com/egor-tensin/vk-scripts/issues
 Classifier: Development Status :: 5 - Production/Stable
-Requires-Python: >=3.6
+Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE.txt
 Requires-Dist: importlib-metadata~=4.0; python_version < "3.8"
@@ -42,25 +42,6 @@ with.
 [vk-status]: docs/status.md
 [vk-sessions]: docs/sessions.md
 
-Development
------------
-
-### Linting
-
-Requires [Pylint].
-
-    pylint vk
-
-[Pylint]: https://www.pylint.org/
-
-### Releases
-
-Make a git tag:
-
-    git tag "v$( python -m setuptools_scm --strip-dev )"
-
-You can then review that the tag is fine and push w/ `git push --tags`.
-
 License
 -------
 

{vk_scripts-1.2.0 → vk_scripts-1.3.1}/vk_scripts.egg-info/SOURCES.txt

@@ -1,7 +1,6 @@
 .git-blame-ignore-revs
 .gitattributes
 .gitignore
-.pylintrc
 LICENSE.txt
 README.md
 pyproject.toml

{vk_scripts-1.2.0 → vk_scripts-1.3.1}/vk_scripts.egg-info/scm_file_list.json

@@ -5,7 +5,6 @@
     ".github/dependabot.yml",
     ".github/workflows/ci.yml",
     ".gitignore",
-    ".pylintrc",
     "LICENSE.txt",
     "README.md",
     "docs/images/date.png",

vk_scripts-1.3.1/vk_scripts.egg-info/scm_version.json

@@ -0,0 +1,8 @@
+{
+  "tag": "1.3.1",
+  "distance": 0,
+  "node": "ga1687194ed78d3c98b589e94553c3d9ef68f4ecf",
+  "dirty": false,
+  "branch": "HEAD",
+  "node_date": "2026-10-12"
+}

vk_scripts-1.2.0/.pylintrc

@@ -1,8 +0,0 @@
-[MESSAGES CONTROL]
-
-disable=
-    invalid-name,
-    missing-docstring,
-    multiple-imports,
-    too-few-public-methods,
-    too-many-public-methods,

vk_scripts-1.2.0/vk_scripts.egg-info/scm_version.json

@@ -1,8 +0,0 @@
-{
-  "tag": "1.2.0",
-  "distance": 0,
-  "node": "geec673b5c0122e359bf00b0136783a32e8a77df9",
-  "dirty": false,
-  "branch": "HEAD",
-  "node_date": "2026-09-29"
-}