quasimoto 0.1.0__tar.gz

quasimoto-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 Vaughn Kottler
+
+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.

quasimoto-0.1.0/PKG-INFO

@@ -0,0 +1,113 @@
+Metadata-Version: 2.1
+Name: quasimoto
+Version: 0.1.0
+Summary: A lossless audio generator.
+Home-page: https://github.com/vkottler/quasimoto
+Author: Vaughn Kottler
+Author-email: Vaughn Kottler <vaughnkottler@gmail.com>
+Maintainer-email: Vaughn Kottler <vaughnkottler@gmail.com>
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Operating System :: Unix
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: License :: OSI Approved :: MIT License
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: vcorelib
+Provides-Extra: test
+Requires-Dist: pylint; extra == "test"
+Requires-Dist: flake8; extra == "test"
+Requires-Dist: black; extra == "test"
+Requires-Dist: ruff; extra == "test"
+Requires-Dist: mypy; extra == "test"
+Requires-Dist: isort; extra == "test"
+Requires-Dist: yamllint; extra == "test"
+Requires-Dist: yambs; extra == "test"
+Requires-Dist: vmklib; extra == "test"
+Requires-Dist: sphinx; extra == "test"
+Requires-Dist: sphinx-book-theme; extra == "test"
+Requires-Dist: setuptools-wrapper; extra == "test"
+Requires-Dist: types-setuptools; extra == "test"
+
+<!--
+    =====================================
+    generator=datazen
+    version=3.1.4
+    hash=32f83dc4656170a9cfc0c52220eb0ead
+    =====================================
+-->
+
+# quasimoto ([0.1.0](https://pypi.org/project/quasimoto/))
+
+[![python](https://img.shields.io/pypi/pyversions/quasimoto.svg)](https://pypi.org/project/quasimoto/)
+![Build Status](https://github.com/vkottler/quasimoto/workflows/Python%20Package/badge.svg)
+[![codecov](https://codecov.io/gh/vkottler/quasimoto/branch/master/graphs/badge.svg?branch=master)](https://codecov.io/github/vkottler/quasimoto)
+![PyPI - Status](https://img.shields.io/pypi/status/quasimoto)
+![Dependents (via libraries.io)](https://img.shields.io/librariesio/dependents/pypi/quasimoto)
+
+*A lossless audio generator.*
+
+## Documentation
+
+### Generated
+
+* By [sphinx-apidoc](https://vkottler.github.io/python/sphinx/quasimoto)
+(What's [`sphinx-apidoc`](https://www.sphinx-doc.org/en/master/man/sphinx-apidoc.html)?)
+* By [pydoc](https://vkottler.github.io/python/pydoc/quasimoto.html)
+(What's [`pydoc`](https://docs.python.org/3/library/pydoc.html)?)
+
+## Python Version Support
+
+This package is tested with the following Python minor versions:
+
+* [`python3.11`](https://docs.python.org/3.11/)
+* [`python3.12`](https://docs.python.org/3.12/)
+
+## Platform Support
+
+This package is tested on the following platforms:
+
+* `ubuntu-latest`
+* `macos-latest`
+* `windows-latest`
+
+# Introduction
+
+# Command-line Options
+
+```
+$ ./venv3.11/bin/quasimoto -h
+
+usage: quasimoto [-h] [--version] [-v] [-q] [--curses] [--no-uvloop] [-C DIR]
+                 {gen,noop} ...
+
+A lossless audio generator.
+
+options:
+  -h, --help         show this help message and exit
+  --version          show program's version number and exit
+  -v, --verbose      set to increase logging verbosity
+  -q, --quiet        set to reduce output
+  --curses           whether or not to use curses.wrapper when starting
+  --no-uvloop        whether or not to disable uvloop as event loop driver
+  -C DIR, --dir DIR  execute from a specific directory
+
+commands:
+  {gen,noop}         set of available commands
+    gen              generate audio
+    noop             command stub (does nothing)
+
+```
+
+# Internal Dependency Graph
+
+A coarse view of the internal structure and scale of
+`quasimoto`'s source.
+Generated using [pydeps](https://github.com/thebjorn/pydeps) (via
+`mk python-deps`).
+
+![quasimoto's Dependency Graph](im/pydeps.svg)

quasimoto-0.1.0/README.md

@@ -0,0 +1,78 @@
+<!--
+    =====================================
+    generator=datazen
+    version=3.1.4
+    hash=32f83dc4656170a9cfc0c52220eb0ead
+    =====================================
+-->
+
+# quasimoto ([0.1.0](https://pypi.org/project/quasimoto/))
+
+[![python](https://img.shields.io/pypi/pyversions/quasimoto.svg)](https://pypi.org/project/quasimoto/)
+![Build Status](https://github.com/vkottler/quasimoto/workflows/Python%20Package/badge.svg)
+[![codecov](https://codecov.io/gh/vkottler/quasimoto/branch/master/graphs/badge.svg?branch=master)](https://codecov.io/github/vkottler/quasimoto)
+![PyPI - Status](https://img.shields.io/pypi/status/quasimoto)
+![Dependents (via libraries.io)](https://img.shields.io/librariesio/dependents/pypi/quasimoto)
+
+*A lossless audio generator.*
+
+## Documentation
+
+### Generated
+
+* By [sphinx-apidoc](https://vkottler.github.io/python/sphinx/quasimoto)
+(What's [`sphinx-apidoc`](https://www.sphinx-doc.org/en/master/man/sphinx-apidoc.html)?)
+* By [pydoc](https://vkottler.github.io/python/pydoc/quasimoto.html)
+(What's [`pydoc`](https://docs.python.org/3/library/pydoc.html)?)
+
+## Python Version Support
+
+This package is tested with the following Python minor versions:
+
+* [`python3.11`](https://docs.python.org/3.11/)
+* [`python3.12`](https://docs.python.org/3.12/)
+
+## Platform Support
+
+This package is tested on the following platforms:
+
+* `ubuntu-latest`
+* `macos-latest`
+* `windows-latest`
+
+# Introduction
+
+# Command-line Options
+
+```
+$ ./venv3.11/bin/quasimoto -h
+
+usage: quasimoto [-h] [--version] [-v] [-q] [--curses] [--no-uvloop] [-C DIR]
+                 {gen,noop} ...
+
+A lossless audio generator.
+
+options:
+  -h, --help         show this help message and exit
+  --version          show program's version number and exit
+  -v, --verbose      set to increase logging verbosity
+  -q, --quiet        set to reduce output
+  --curses           whether or not to use curses.wrapper when starting
+  --no-uvloop        whether or not to disable uvloop as event loop driver
+  -C DIR, --dir DIR  execute from a specific directory
+
+commands:
+  {gen,noop}         set of available commands
+    gen              generate audio
+    noop             command stub (does nothing)
+
+```
+
+# Internal Dependency Graph
+
+A coarse view of the internal structure and scale of
+`quasimoto`'s source.
+Generated using [pydeps](https://github.com/thebjorn/pydeps) (via
+`mk python-deps`).
+
+![quasimoto's Dependency Graph](im/pydeps.svg)

quasimoto-0.1.0/pyproject.toml

@@ -0,0 +1,47 @@
+[build-system]
+requires = ["setuptools-wrapper", "trove-classifiers"]
+build-backend = "setuptools.build_meta:__legacy__"
+
+[project]
+name = "quasimoto"
+version = "0.1.0"
+description = "A lossless audio generator."
+readme = "README.md"
+requires-python = ">=3.11"
+authors = [
+  {name = "Vaughn Kottler", email = "vaughnkottler@gmail.com"}
+]
+maintainers = [
+  {name = "Vaughn Kottler", email = "vaughnkottler@gmail.com"}
+]
+classifiers = [
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Operating System :: Microsoft :: Windows",
+  "Operating System :: MacOS",
+  "Operating System :: POSIX :: Linux",
+  "Operating System :: Unix",
+  "Development Status :: 5 - Production/Stable",
+  "License :: OSI Approved :: MIT License"
+]
+dynamic = ["dependencies"]
+
+[project.optional-dependencies]
+test = [
+  "pylint",
+  "flake8",
+  "black",
+  "ruff",
+  "mypy",
+  "isort",
+  "yamllint",
+  "yambs",
+  "vmklib",
+  "sphinx",
+  "sphinx-book-theme",
+  "setuptools-wrapper",
+  "types-setuptools"
+]
+
+[project.scripts]
+quasimoto = "quasimoto.entry:main"

quasimoto-0.1.0/quasimoto/__init__.py

@@ -0,0 +1,13 @@
+# =====================================
+# generator=datazen
+# version=3.1.4
+# hash=5270e41d1149e6ca425f99c76f92c409
+# =====================================
+
+"""
+Useful defaults and other package metadata.
+"""
+
+DESCRIPTION = "A lossless audio generator."
+PKG_NAME = "quasimoto"
+VERSION = "0.1.0"

quasimoto-0.1.0/quasimoto/__main__.py

@@ -0,0 +1,17 @@
+# =====================================
+# generator=datazen
+# version=3.1.4
+# hash=dd15fcaae00a97a45b4568b47c90f634
+# =====================================
+"""
+quasimoto - Package's default entry-point.
+"""
+
+# built-in
+import sys
+
+# internal
+from quasimoto.entry import main
+
+if __name__ == "__main__":
+    sys.exit(main(sys.argv))

quasimoto-0.1.0/quasimoto/app.py

@@ -0,0 +1,37 @@
+# =====================================
+# generator=datazen
+# version=3.1.4
+# hash=6cf9ea2f116be006d3ff0bf0607799ef
+# =====================================
+
+"""
+This package's command-line entry-point application.
+"""
+
+# built-in
+from argparse import ArgumentParser as _ArgumentParser
+from argparse import Namespace as _Namespace
+from typing import Optional as _Optional
+
+# third-party
+from vcorelib.args import CommandFunction as _CommandFunction
+from vcorelib.args import app_args as _app_args
+
+# internal
+from quasimoto.commands.all import commands
+
+COMMAND: _Optional[_CommandFunction] = None
+
+
+def entry(args: _Namespace) -> int:
+    """Execute the requested task."""
+
+    assert COMMAND is not None
+    return COMMAND(args)
+
+
+def add_app_args(parser: _ArgumentParser) -> None:
+    """Add application-specific arguments to the command-line parser."""
+    global COMMAND  # pylint: disable=global-statement
+    add, COMMAND = _app_args(commands, {})
+    add(parser)

quasimoto-0.1.0/quasimoto/commands/all.py

@@ -0,0 +1,32 @@
+# =====================================
+# generator=datazen
+# version=3.1.4
+# hash=b8d2bc2e3ccbd1d7eab451040c2edb8e
+# =====================================
+
+"""
+A module aggregating package commands.
+"""
+
+# built-in
+from typing import List as _List
+from typing import Tuple as _Tuple
+
+# third-party
+from vcorelib.args import CommandRegister as _CommandRegister
+
+# internal
+from quasimoto.commands.gen import add_gen_cmd
+
+
+def commands() -> _List[_Tuple[str, str, _CommandRegister]]:
+    """Get this package's commands."""
+
+    return [
+        (
+            "gen",
+            "generate audio",
+            add_gen_cmd,
+        ),
+        ("noop", "command stub (does nothing)", lambda _: lambda _: 0),
+    ]

quasimoto-0.1.0/quasimoto/commands/gen.py

@@ -0,0 +1,46 @@
+"""
+An entry-point for the 'gen' command.
+"""
+
+# built-in
+import argparse
+from enum import StrEnum
+from pathlib import Path
+
+# third-party
+from vcorelib.args import CommandFunction
+
+# internal
+from quasimoto import PKG_NAME
+
+
+class AudioFileTypes(StrEnum):
+    """An enumeration for supported file types."""
+
+    WAVE = "wav"
+
+
+DEFAULT_FORMAT = AudioFileTypes.WAVE
+
+
+def gen_cmd(args: argparse.Namespace) -> int:
+    """Execute the arbiter command."""
+
+    with args.output.open("wb") as out_fd:
+        print(out_fd)
+
+    return 0
+
+
+def add_gen_cmd(parser: argparse.ArgumentParser) -> CommandFunction:
+    """Add gen-command arguments to its parser."""
+
+    parser.add_argument(
+        "-o",
+        "--output",
+        type=Path,
+        default=f"{PKG_NAME}.{DEFAULT_FORMAT}",
+        help="output file to write",
+    )
+
+    return gen_cmd

quasimoto-0.1.0/quasimoto/dev_requirements.txt

@@ -0,0 +1,13 @@
+pylint
+flake8
+black
+ruff
+mypy
+isort
+yamllint
+yambs
+vmklib
+sphinx
+sphinx-book-theme
+setuptools-wrapper
+types-setuptools

quasimoto-0.1.0/quasimoto/entry.py

@@ -0,0 +1,80 @@
+# =====================================
+# generator=datazen
+# version=3.1.4
+# hash=281a9fdcd0c2f153d07ec1a8acb71936
+# =====================================
+
+"""
+This package's command-line entry-point (boilerplate).
+"""
+
+# built-in
+import argparse
+import os
+from pathlib import Path
+import sys
+from typing import List
+
+# third-party
+from vcorelib.logging import init_logging, logging_args
+
+# internal
+from quasimoto import DESCRIPTION, VERSION
+from quasimoto.app import add_app_args, entry
+
+
+def main(argv: List[str] = None) -> int:
+    """Program entry-point."""
+
+    result = 0
+
+    # fall back on command-line arguments
+    command_args = sys.argv
+    if argv is not None:
+        command_args = argv
+
+    # initialize argument parsing
+    parser = argparse.ArgumentParser(description=DESCRIPTION)
+    parser.add_argument(
+        "--version",
+        action="version",
+        version=f"%(prog)s {VERSION}",
+    )
+    logging_args(parser)
+    parser.add_argument(
+        "-C",
+        "--dir",
+        default=Path.cwd(),
+        dest="dir",
+        type=Path,
+        help="execute from a specific directory",
+    )
+    starting_dir = Path.cwd()
+
+    add_app_args(parser)
+
+    # parse arguments and execute the requested command
+    try:
+        args = parser.parse_args(command_args[1:])
+        args.version = VERSION
+        args.dir = args.dir.resolve()
+
+        # initialize logging
+        init_logging(
+            args, default_format="%(name)-36s - %(levelname)-6s - %(message)s"
+        )
+
+        # change to the specified directory
+        os.chdir(args.dir)
+
+        # run the application
+        result = entry(args)
+    except SystemExit as exc:
+        result = 1
+        if exc.code is not None and isinstance(exc.code, int):
+            result = exc.code
+
+    # return to starting dir
+    os.chdir(starting_dir)
+
+    return result

quasimoto-0.1.0/quasimoto/requirements.txt

@@ -0,0 +1 @@
+vcorelib

quasimoto-0.1.0/quasimoto.egg-info/PKG-INFO

@@ -0,0 +1,113 @@
+Metadata-Version: 2.1
+Name: quasimoto
+Version: 0.1.0
+Summary: A lossless audio generator.
+Home-page: https://github.com/vkottler/quasimoto
+Author: Vaughn Kottler
+Author-email: Vaughn Kottler <vaughnkottler@gmail.com>
+Maintainer-email: Vaughn Kottler <vaughnkottler@gmail.com>
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Operating System :: Unix
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: License :: OSI Approved :: MIT License
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: vcorelib
+Provides-Extra: test
+Requires-Dist: pylint; extra == "test"
+Requires-Dist: flake8; extra == "test"
+Requires-Dist: black; extra == "test"
+Requires-Dist: ruff; extra == "test"
+Requires-Dist: mypy; extra == "test"
+Requires-Dist: isort; extra == "test"
+Requires-Dist: yamllint; extra == "test"
+Requires-Dist: yambs; extra == "test"
+Requires-Dist: vmklib; extra == "test"
+Requires-Dist: sphinx; extra == "test"
+Requires-Dist: sphinx-book-theme; extra == "test"
+Requires-Dist: setuptools-wrapper; extra == "test"
+Requires-Dist: types-setuptools; extra == "test"
+
+<!--
+    =====================================
+    generator=datazen
+    version=3.1.4
+    hash=32f83dc4656170a9cfc0c52220eb0ead
+    =====================================
+-->
+
+# quasimoto ([0.1.0](https://pypi.org/project/quasimoto/))
+
+[![python](https://img.shields.io/pypi/pyversions/quasimoto.svg)](https://pypi.org/project/quasimoto/)
+![Build Status](https://github.com/vkottler/quasimoto/workflows/Python%20Package/badge.svg)
+[![codecov](https://codecov.io/gh/vkottler/quasimoto/branch/master/graphs/badge.svg?branch=master)](https://codecov.io/github/vkottler/quasimoto)
+![PyPI - Status](https://img.shields.io/pypi/status/quasimoto)
+![Dependents (via libraries.io)](https://img.shields.io/librariesio/dependents/pypi/quasimoto)
+
+*A lossless audio generator.*
+
+## Documentation
+
+### Generated
+
+* By [sphinx-apidoc](https://vkottler.github.io/python/sphinx/quasimoto)
+(What's [`sphinx-apidoc`](https://www.sphinx-doc.org/en/master/man/sphinx-apidoc.html)?)
+* By [pydoc](https://vkottler.github.io/python/pydoc/quasimoto.html)
+(What's [`pydoc`](https://docs.python.org/3/library/pydoc.html)?)
+
+## Python Version Support
+
+This package is tested with the following Python minor versions:
+
+* [`python3.11`](https://docs.python.org/3.11/)
+* [`python3.12`](https://docs.python.org/3.12/)
+
+## Platform Support
+
+This package is tested on the following platforms:
+
+* `ubuntu-latest`
+* `macos-latest`
+* `windows-latest`
+
+# Introduction
+
+# Command-line Options
+
+```
+$ ./venv3.11/bin/quasimoto -h
+
+usage: quasimoto [-h] [--version] [-v] [-q] [--curses] [--no-uvloop] [-C DIR]
+                 {gen,noop} ...
+
+A lossless audio generator.
+
+options:
+  -h, --help         show this help message and exit
+  --version          show program's version number and exit
+  -v, --verbose      set to increase logging verbosity
+  -q, --quiet        set to reduce output
+  --curses           whether or not to use curses.wrapper when starting
+  --no-uvloop        whether or not to disable uvloop as event loop driver
+  -C DIR, --dir DIR  execute from a specific directory
+
+commands:
+  {gen,noop}         set of available commands
+    gen              generate audio
+    noop             command stub (does nothing)
+
+```
+
+# Internal Dependency Graph
+
+A coarse view of the internal structure and scale of
+`quasimoto`'s source.
+Generated using [pydeps](https://github.com/thebjorn/pydeps) (via
+`mk python-deps`).
+
+![quasimoto's Dependency Graph](im/pydeps.svg)

quasimoto-0.1.0/quasimoto.egg-info/SOURCES.txt

@@ -0,0 +1,22 @@
+LICENSE
+README.md
+pyproject.toml
+setup.py
+quasimoto/__init__.py
+quasimoto/__main__.py
+quasimoto/app.py
+quasimoto/dev_requirements.txt
+quasimoto/entry.py
+quasimoto/py.typed
+quasimoto/requirements.txt
+quasimoto.egg-info/PKG-INFO
+quasimoto.egg-info/SOURCES.txt
+quasimoto.egg-info/dependency_links.txt
+quasimoto.egg-info/entry_points.txt
+quasimoto.egg-info/requires.txt
+quasimoto.egg-info/top_level.txt
+quasimoto/commands/__init__.py
+quasimoto/commands/all.py
+quasimoto/commands/gen.py
+tests/test_entry.py
+tests/test_resources.py

quasimoto-0.1.0/quasimoto.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

quasimoto-0.1.0/quasimoto.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+quasimoto = quasimoto.entry:main

quasimoto-0.1.0/quasimoto.egg-info/requires.txt

@@ -0,0 +1,16 @@
+vcorelib
+
+[test]
+pylint
+flake8
+black
+ruff
+mypy
+isort
+yamllint
+yambs
+vmklib
+sphinx
+sphinx-book-theme
+setuptools-wrapper
+types-setuptools

quasimoto-0.1.0/quasimoto.egg-info/top_level.txt

@@ -0,0 +1 @@
+quasimoto

quasimoto-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

quasimoto-0.1.0/setup.py

@@ -0,0 +1,38 @@
+# =====================================
+# generator=datazen
+# version=3.1.4
+# hash=372222f3f6b266691437ff06877b630c
+# =====================================
+
+"""
+quasimoto - Package definition for distribution.
+"""
+
+# third-party
+try:
+    from setuptools_wrapper.setup import setup
+except (ImportError, ModuleNotFoundError):
+    from quasimoto_bootstrap.setup import setup  # type: ignore
+
+# internal
+from quasimoto import DESCRIPTION, PKG_NAME, VERSION
+
+author_info = {
+    "name": "Vaughn Kottler",
+    "email": "vaughnkottler@gmail.com",
+    "username": "vkottler",
+}
+pkg_info = {
+    "name": PKG_NAME,
+    "slug": PKG_NAME.replace("-", "_"),
+    "version": VERSION,
+    "description": DESCRIPTION,
+    "versions": [
+        "3.11",
+        "3.12",
+    ],
+}
+setup(
+    pkg_info,
+    author_info,
+)

quasimoto-0.1.0/tests/test_entry.py

@@ -0,0 +1,28 @@
+"""
+quasimoto - Test the program's entry-point.
+"""
+
+# built-in
+from subprocess import check_output
+from sys import executable
+from unittest.mock import patch
+
+# module under test
+from quasimoto import PKG_NAME
+from quasimoto.entry import main as quasimoto_main
+
+
+def test_entry_basic():
+    """Test basic argument parsing."""
+
+    args = [PKG_NAME, "noop"]
+    assert quasimoto_main(args) == 0
+
+    with patch("quasimoto.entry.entry", side_effect=SystemExit(1)):
+        assert quasimoto_main(args) != 0
+
+
+def test_package_entry():
+    """Test the command-line entry through the 'python -m' invocation."""
+
+    check_output([executable, "-m", "quasimoto", "-h"])

quasimoto-0.1.0/tests/test_resources.py

@@ -0,0 +1,13 @@
+"""
+Test that we can load test resources.
+"""
+
+# internal
+from tests.resources import resource
+
+
+def test_resources_basic():
+    """Test that we can locate test data."""
+
+    assert resource("test.txt").is_file()
+    assert resource("test.txt", valid=False).is_file()