stolid 2022.3.6.2__tar.gz

stolid-2022.3.6.2/PKG-INFO

@@ -0,0 +1,273 @@
+Metadata-Version: 2.4
+Name: stolid
+Version: 2022.3.6.2
+Summary: Linter enforcing the conventions of the Python standard template
+Author-email: Moshe Zadka <moshez@zadka.club>
+License: Permission is hereby granted, free of charge, to any person obtaining a
+        copy of this software and associated documentation files (the "Software"),
+        to deal in the Software without restriction, including without limitation the
+        rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is furnished
+        to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
+        INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
+        PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE 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.
+        
+Project-URL: Homepage, https://github.com/moshez/stolid
+Description-Content-Type: text/x-rst
+Provides-Extra: tests
+Requires-Dist: virtue; extra == "tests"
+Requires-Dist: pyhamcrest; extra == "tests"
+Requires-Dist: coverage; extra == "tests"
+Provides-Extra: mypy
+Requires-Dist: mypy; extra == "mypy"
+Provides-Extra: lint
+Requires-Dist: flake8; extra == "lint"
+Requires-Dist: black; extra == "lint"
+Provides-Extra: docs
+Requires-Dist: sphinx; extra == "docs"
+
+stolid
+======
+
+A flake8 plugin that enforces opinionated Python coding conventions for clean,
+maintainable code.
+
+Stolid encourages:
+
+- **Composition over inheritance**
+- **Dependency injection over mocking**
+- **Protocol-based typing over abstract base classes**
+- **Immutable dataclasses**
+- **Small, focused functions and classes**
+
+Installation
+------------
+
+.. code-block:: bash
+
+    pip install stolid
+
+Usage
+-----
+
+Stolid integrates directly with flake8:
+
+.. code-block:: bash
+
+    flake8 your_code.py
+
+Error Codes
+-----------
+
+SLD1xx - Testing
+~~~~~~~~~~~~~~~~
+
+**SLD102**: Prohibits use of ``patch`` and ``patch.object`` from ``unittest.mock``.
+
+Use dependency injection instead of mocking:
+
+.. code-block:: python
+
+    # Bad
+    from unittest.mock import patch
+
+    @patch("mymodule.requests.get")
+    def test_fetch(mock_get):
+        ...
+
+    # Good
+    class TestFetch(unittest.TestCase):
+        def test_fetch(self) -> None:
+            fake_client = FakeHTTPClient(response={"data": 1})
+            fetcher = DataFetcher(client=fake_client)
+            result = fetcher.fetch()
+            assert_that(result, equal_to(1))
+
+SLD2xx - Abstract Base Classes
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+**SLD201**: Prohibits importing ``ABC`` from the ``abc`` module.
+
+**SLD202**: Prohibits using ``@abstractmethod`` decorator.
+
+Use ``typing.Protocol`` for interfaces instead:
+
+.. code-block:: python
+
+    # Bad
+    from abc import ABC, abstractmethod
+
+    class HTTPClient(ABC):
+        @abstractmethod
+        def get(self, url: str) -> Response:
+            ...
+
+    # Good
+    from typing import Protocol
+
+    class HTTPClient(Protocol):
+        def get(self, url: str) -> Response:
+            ...
+
+SLD3xx - Object-Oriented Design
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+**SLD301**: Prohibits ``__init__`` methods.
+
+Use ``@dataclass`` with ``default_factory`` for attributes, or ``@classmethod``
+for parameter computation:
+
+.. code-block:: python
+
+    # Bad
+    class Processor:
+        def __init__(self, client, config):
+            self.client = client
+            self.config = config
+
+    # Good
+    from dataclasses import dataclass
+
+    @dataclass(frozen=True, slots=True, kw_only=True)
+    class Processor:
+        client: HTTPClient
+        config: Config
+
+**SLD302**: Prohibits private methods (starting with ``_``).
+
+Extract private methods into separate classes:
+
+.. code-block:: python
+
+    # Bad
+    class Processor:
+        def _validate(self, data):
+            ...
+
+    # Good
+    class Validator:
+        def validate(self, data):
+            ...
+
+**SLD303**: Flags methods that only access public members of ``self``.
+
+Convert to module-level functions or use ``functools.singledispatch``:
+
+.. code-block:: python
+
+    # Bad
+    class User:
+        name: str
+
+        def display_name(self) -> str:
+            return self.name.title()
+
+    # Good
+    def display_name(user: User) -> str:
+        return user.name.title()
+
+SLD4xx - Inheritance
+~~~~~~~~~~~~~~~~~~~~
+
+**SLD401**: Prohibits inheritance from concrete classes.
+
+Allowed base classes:
+
+- Typing: ``Protocol``, ``Generic``
+- Exceptions: ``Exception``, ``BaseException``
+- Testing: ``TestCase``
+- Enums: ``Enum``, ``IntEnum``, ``StrEnum``, ``Flag``, ``IntFlag``
+- Other: ``TypedDict``, ``NamedTuple``
+
+.. code-block:: python
+
+    # Bad
+    class MyHandler(BaseHandler):
+        ...
+
+    # Good
+    @dataclass(frozen=True, slots=True, kw_only=True)
+    class MyHandler:
+        validator: Validator
+        processor: Processor
+
+SLD5xx - Dataclass Configuration
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+All dataclasses must have:
+
+**SLD501**: ``frozen=True`` (immutability)
+
+**SLD502**: ``slots=True`` (memory efficiency)
+
+**SLD503**: ``kw_only=True`` (keyword-only arguments)
+
+.. code-block:: python
+
+    # Bad
+    @dataclass
+    class Settings:
+        timeout: int
+
+    # Good
+    @dataclass(frozen=True, slots=True, kw_only=True)
+    class Settings:
+        timeout: int
+
+SLD6xx - Code Complexity
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+**SLD601**: Functions limited to 30 lines
+
+**SLD602**: Functions limited to 4 arguments (excludes ``self``/``cls``)
+
+**SLD603**: Classes limited to 15 methods (excludes dunder methods)
+
+**SLD604**: Modules limited to 400 lines
+
+Configuration
+-------------
+
+Stolid follows standard flake8 configuration. Add to your ``setup.cfg`` or
+``.flake8``:
+
+.. code-block:: ini
+
+    [flake8]
+    extend-ignore = SLD301,SLD302
+
+Or use per-file ignores:
+
+.. code-block:: ini
+
+    [flake8]
+    per-file-ignores =
+        tests/*:SLD301,SLD302
+
+Development
+-----------
+
+.. code-block:: bash
+
+    pip install nox
+
+    # Run all checks
+    nox
+
+    # Run specific sessions
+    nox -s tests    # Run tests with coverage
+    nox -s lint     # Run black and flake8
+    nox -s mypy     # Run type checking
+
+License
+-------
+
+MIT License. See LICENSE for details.

stolid-2022.3.6.2/README.rst

@@ -0,0 +1,237 @@
+stolid
+======
+
+A flake8 plugin that enforces opinionated Python coding conventions for clean,
+maintainable code.
+
+Stolid encourages:
+
+- **Composition over inheritance**
+- **Dependency injection over mocking**
+- **Protocol-based typing over abstract base classes**
+- **Immutable dataclasses**
+- **Small, focused functions and classes**
+
+Installation
+------------
+
+.. code-block:: bash
+
+    pip install stolid
+
+Usage
+-----
+
+Stolid integrates directly with flake8:
+
+.. code-block:: bash
+
+    flake8 your_code.py
+
+Error Codes
+-----------
+
+SLD1xx - Testing
+~~~~~~~~~~~~~~~~
+
+**SLD102**: Prohibits use of ``patch`` and ``patch.object`` from ``unittest.mock``.
+
+Use dependency injection instead of mocking:
+
+.. code-block:: python
+
+    # Bad
+    from unittest.mock import patch
+
+    @patch("mymodule.requests.get")
+    def test_fetch(mock_get):
+        ...
+
+    # Good
+    class TestFetch(unittest.TestCase):
+        def test_fetch(self) -> None:
+            fake_client = FakeHTTPClient(response={"data": 1})
+            fetcher = DataFetcher(client=fake_client)
+            result = fetcher.fetch()
+            assert_that(result, equal_to(1))
+
+SLD2xx - Abstract Base Classes
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+**SLD201**: Prohibits importing ``ABC`` from the ``abc`` module.
+
+**SLD202**: Prohibits using ``@abstractmethod`` decorator.
+
+Use ``typing.Protocol`` for interfaces instead:
+
+.. code-block:: python
+
+    # Bad
+    from abc import ABC, abstractmethod
+
+    class HTTPClient(ABC):
+        @abstractmethod
+        def get(self, url: str) -> Response:
+            ...
+
+    # Good
+    from typing import Protocol
+
+    class HTTPClient(Protocol):
+        def get(self, url: str) -> Response:
+            ...
+
+SLD3xx - Object-Oriented Design
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+**SLD301**: Prohibits ``__init__`` methods.
+
+Use ``@dataclass`` with ``default_factory`` for attributes, or ``@classmethod``
+for parameter computation:
+
+.. code-block:: python
+
+    # Bad
+    class Processor:
+        def __init__(self, client, config):
+            self.client = client
+            self.config = config
+
+    # Good
+    from dataclasses import dataclass
+
+    @dataclass(frozen=True, slots=True, kw_only=True)
+    class Processor:
+        client: HTTPClient
+        config: Config
+
+**SLD302**: Prohibits private methods (starting with ``_``).
+
+Extract private methods into separate classes:
+
+.. code-block:: python
+
+    # Bad
+    class Processor:
+        def _validate(self, data):
+            ...
+
+    # Good
+    class Validator:
+        def validate(self, data):
+            ...
+
+**SLD303**: Flags methods that only access public members of ``self``.
+
+Convert to module-level functions or use ``functools.singledispatch``:
+
+.. code-block:: python
+
+    # Bad
+    class User:
+        name: str
+
+        def display_name(self) -> str:
+            return self.name.title()
+
+    # Good
+    def display_name(user: User) -> str:
+        return user.name.title()
+
+SLD4xx - Inheritance
+~~~~~~~~~~~~~~~~~~~~
+
+**SLD401**: Prohibits inheritance from concrete classes.
+
+Allowed base classes:
+
+- Typing: ``Protocol``, ``Generic``
+- Exceptions: ``Exception``, ``BaseException``
+- Testing: ``TestCase``
+- Enums: ``Enum``, ``IntEnum``, ``StrEnum``, ``Flag``, ``IntFlag``
+- Other: ``TypedDict``, ``NamedTuple``
+
+.. code-block:: python
+
+    # Bad
+    class MyHandler(BaseHandler):
+        ...
+
+    # Good
+    @dataclass(frozen=True, slots=True, kw_only=True)
+    class MyHandler:
+        validator: Validator
+        processor: Processor
+
+SLD5xx - Dataclass Configuration
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+All dataclasses must have:
+
+**SLD501**: ``frozen=True`` (immutability)
+
+**SLD502**: ``slots=True`` (memory efficiency)
+
+**SLD503**: ``kw_only=True`` (keyword-only arguments)
+
+.. code-block:: python
+
+    # Bad
+    @dataclass
+    class Settings:
+        timeout: int
+
+    # Good
+    @dataclass(frozen=True, slots=True, kw_only=True)
+    class Settings:
+        timeout: int
+
+SLD6xx - Code Complexity
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+**SLD601**: Functions limited to 30 lines
+
+**SLD602**: Functions limited to 4 arguments (excludes ``self``/``cls``)
+
+**SLD603**: Classes limited to 15 methods (excludes dunder methods)
+
+**SLD604**: Modules limited to 400 lines
+
+Configuration
+-------------
+
+Stolid follows standard flake8 configuration. Add to your ``setup.cfg`` or
+``.flake8``:
+
+.. code-block:: ini
+
+    [flake8]
+    extend-ignore = SLD301,SLD302
+
+Or use per-file ignores:
+
+.. code-block:: ini
+
+    [flake8]
+    per-file-ignores =
+        tests/*:SLD301,SLD302
+
+Development
+-----------
+
+.. code-block:: bash
+
+    pip install nox
+
+    # Run all checks
+    nox
+
+    # Run specific sessions
+    nox -s tests    # Run tests with coverage
+    nox -s lint     # Run black and flake8
+    nox -s mypy     # Run type checking
+
+License
+-------
+
+MIT License. See LICENSE for details.

stolid-2022.3.6.2/git-log-head

@@ -0,0 +1,8 @@
+commit 21b60f6e2a900d1ac9b4b568031db8a284bcfd19
+Merge: 5cf3234 64e5d18
+Author: Moshe Zadka <moshez@users.noreply.github.com>
+Date:   2026-01-24 12:51:21 -0800
+
+    Merge pull request #10 from moshez/claude/add-readme-docs-config-aiMeg
+    
+    Add comprehensive README and Read the Docs configuration

stolid-2022.3.6.2/pyproject.toml

@@ -0,0 +1,55 @@
+[build-system]
+requires = [
+    "setuptools",
+    "autocalver",
+]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "stolid"
+version = "2022.3.6.2"
+description = "Linter enforcing the conventions of the Python standard template"
+readme = "README.rst"
+authors = [{name = "Moshe Zadka", email = "moshez@zadka.club"}]
+
+[project.optional-dependencies]
+tests = ["virtue", "pyhamcrest", "coverage"]
+mypy = ["mypy"]
+lint = ["flake8", "black"]
+docs = ["sphinx"]
+
+[project.license]
+text = """
+Permission is hereby granted, free of charge, to any person obtaining a
+copy of this software and associated documentation files (the "Software"),
+to deal in the Software without restriction, including without limitation the
+rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is furnished
+to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
+INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
+PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE 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.
+"""
+
+[project.urls]
+Homepage = "https://github.com/moshez/stolid"
+
+[tool.autocalver]
+use = true
+log = "git-log-head"
+log_command = "git log -n 1 --date=iso"
+is_main_var = "GITHUB_REF"
+is_main_match = ".*/trunk$"
+
+[project.entry-points.gather]
+placeholder = "stolid:__version__"
+
+[project.entry-points."flake8.extension"]
+SLD = "stolid.checker:Checker"

stolid-2022.3.6.2/setup.cfg

@@ -0,0 +1,30 @@
+[metadata]
+name = seasonable
+version = 2021.9.1
+description = API abstractions
+long_description = file: README.rst
+license = BSD 3-Clause License
+
+[options]
+package_dir = 
+	=src
+packages = find:
+
+[options.extras_require]
+test = 
+	coverage
+	virtue
+lint = 
+	black
+	mypy
+	flake8
+	pylint
+doc = sphinx
+
+[options.packages.find]
+where = src
+
+[egg_info]
+tag_build = 
+tag_date = 0
+

stolid-2022.3.6.2/src/stolid/__init__.py

@@ -0,0 +1,3 @@
+import importlib.metadata
+
+__version__ = importlib.metadata.version(__name__)