first commit

.flake8

@@ -0,0 +1,19 @@
+[flake8]
+ignore =
+  D203,
+  # line too long
+  E501
+per-file-ignores =
+  # imported but unused
+  # __init__.py: F401
+  test_*.py: F401
+exclude =
+  .git,
+  __pycache__,
+  docs/source/conf.py,
+  old,
+  build,
+  dist,
+  .venv
+  pad*.py
+max-complexity = 25

.github/workflows/codeql-analysis.yml-

@@ -0,0 +1,67 @@
+# 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:
+  push:
+    branches: [ master ]
+  pull_request:
+    # The branches below must be a subset of the branches above
+    branches: [ master ]
+  schedule:
+    - cron: '16 15 * * 2'
+
+jobs:
+  analyze:
+    name: Analyze
+    runs-on: ubuntu-latest
+
+    strategy:
+      fail-fast: false
+      matrix:
+        language: [ 'python' ]
+        # CodeQL supports [ 'cpp', 'csharp', 'go', 'java', 'javascript', 'python' ]
+        # Learn more:
+        # https://docs.github.com/en/free-pro-team@latest/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning#changing-the-languages-that-are-analyzed
+
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v2
+
+    # Initializes the CodeQL tools for scanning.
+    - name: Initialize CodeQL
+      uses: github/codeql-action/init@v1
+      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
+
+    # Autobuild attempts to build any compiled languages  (C/C++, C#, or Java).
+    # If this step fails, then you should remove it and run the build manually (see below)
+    - name: Autobuild
+      uses: github/codeql-action/autobuild@v1
+
+    # ℹ️ Command-line programs to run using the OS shell.
+    # 📚 https://git.io/JvXDl
+
+    # ✏️ If the Autobuild fails above, remove it and uncomment the following three lines
+    #    and modify them (or add more) to build your code if your project
+    #    uses a compiled language
+
+    #- run: |
+    #   make bootstrap
+    #   make release
+
+    - name: Perform CodeQL Analysis
+      uses: github/codeql-action/analyze@v1

.github/workflows/routine-tests.yml

@@ -0,0 +1,30 @@
+name: pytest
+
+on:
+  push:
+
+jobs:
+  flake8-pytest:
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: [3.8]
+        poetry-version: [1.1.2]
+        os: [ubuntu-18.04, macos-latest, windows-latest]
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v2
+      - uses: actions/setup-python@v2
+        with:
+          python-version: ${{ matrix.python-version }}
+      - uses: abatilo/[email protected]
+        with:
+          poetry-version: ${{ matrix.poetry-version }}
+      - name: Install packages
+        run: poetry install  # --no-dev
+      - name: Run flake8
+        run: |
+          poetry run flake8 --exit-zero
+          # poetry run pytest
+      - name: Run pytest
+        run: poetry run pytest tests

.gitignore

@@ -0,0 +1,143 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+*.bat
+*.swp
+links/
+# .gitignore
+node_modules

LICENSE

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

README.md

@@ -0,0 +1,18 @@
+# mlbee
+[![pytest](https://github.com/ffreemt/mlbee/actions/workflows/routine-tests.yml/badge.svg)](https://github.com/ffreemt/mlbee/actions)[![python](https://img.shields.io/static/v1?label=python+&message=3.8%2B&color=blue)](https://www.python.org/downloads/)[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)[![PyPI version](https://badge.fury.io/py/mlbee.svg)](https://badge.fury.io/py/mlbee)
+
+mlbee descr
+
+## Install it
+
+```shell
+pip install git+https://github.com/ffreemt/mlbee
+# poetry add git+https://github.com/ffreemt/mlbee
+# git clone https://github.com/ffreemt/mlbee && cd mlbee
+```
+
+## Use it
+```python
+from mlbee import mlbee
+
+```

mlbee/__init__.py

@@ -0,0 +1,5 @@
+"""Init."""
+__version__ = "0.1.0"
+from .mlbee import mlbee
+
+__all__ = ("mlbee",)

mlbee/__main__.py

@@ -0,0 +1,45 @@
+"""Prep __main__.py."""
+# pylint: disable=invalid-name
+from pathlib import Path
+from typing import Optional
+
+import logzero
+import typer
+from logzero import logger
+from set_loglevel import set_loglevel
+
+from mlbee import __version__, mlbee
+
+logzero.loglevel(set_loglevel())
+
+app = typer.Typer(
+    name="mlbee",
+    add_completion=False,
+    help="mlbee help",
+)
+
+
+def _version_callback(value: bool) -> None:
+    if value:
+        typer.echo(f"{app.info.name} v.{__version__} -- ...")
+        raise typer.Exit()
+
+
+@app.command()
+def main(
+    version: Optional[bool] = typer.Option(  # pylint: disable=(unused-argument
+        None,
+        "--version",
+        "-v",
+        "-V",
+        help="Show version info and exit.",
+        callback=_version_callback,
+        is_eager=True,
+    ),
+):
+    """Define."""
+    ...
+
+
+if __name__ == "__main__":
+    app()

mlbee/mlbee.py

@@ -0,0 +1,7 @@
+"""Define mlbee."""
+from logzero import logger
+
+
+def mlbee():
+    """Define mlbee."""
+    logger.debug(" entry ")

nodemon.json

@@ -0,0 +1,21 @@
+{
+  "restartable": "rs",
+  "ignore": [
+    ".venv",
+    ".git",
+    "node_modules/**/node_modules"
+  ],
+  "verbose": true,
+  "execMap": {
+    "js": "node --harmony"
+  },
+  "watch": [
+    "tests",
+    "test/fixtures/",
+    "test/samples/"
+  ],
+  "env": {
+    "NODE_ENV": "development"
+  },
+  "ext": "js json py"
+}

package.json

@@ -0,0 +1,21 @@
+{
+    "dependencies": {
+        "npm-run-all": "^4.1.5"
+    },
+    "scripts": {
+        "start": "pyright && pytest && yarn style",
+        "test": "nodemon -w tests -w mlbee -x pytest tests",
+        "pyright": "nodemon -w mlbee -w .venv -e .py -x pyright mlbee tests",
+        "pytest": "nodemon -w tests -w mlbee -e .py -x pytest tests mlbee",
+        "style": "nodemon -w mlbee -w tests -x \"black tests mlbee && python -m flake8\"",
+        "docstyle": "nodemon -w mlbee -w tests -x pydocstyle --convention=google tests mlbee",
+        "pylint": "nodemon -w mlbee -e .py -x pylint mlbee",
+        "test:mlbee": "nodemon -w tests -e .py -x pytest -k mlbee tests",
+        "publish": "poetry build && poetry publish",
+        "black": "black tests mlbee",
+        "flake8": "flake8 tests mlbee",
+        "pflake8": "pflake8 tests mlbee",
+        "pep257": "pep257 tests mlbee",
+        "final": "run-s docstyle black flake8 pytest"
+    }
+}

poetry.toml

@@ -0,0 +1,3 @@
+[virtualenvs]
+create = true
+in-project = true

pylintrc

@@ -0,0 +1,7 @@
+[EXCEPTIONS]
+# C0301 line too long
+# R0801 dup
+# C0103 invalid-name
+# W0612 unused-variable
+# W0611 unused-import
+disable=W0703,R0801,C0103,C0301,W0612,W0611

pyproject.toml

@@ -0,0 +1,67 @@
+[tool.poetry]
+name = "mlbee"
+version = "0.1.0-alpha.0"
+description = "mlbee"
+authors = ["ffreemt"]
+license = "MIT"
+readme = "README.md"
+repository = "https://github.com/ffreemt/mlbee"
+
+[tool.poetry.dependencies]
+python = "^3.8.3"
+logzero = "^1.7.0"
+set-loglevel = "^0.1.2"
+icecream = "^2.1.1"
+install = "^1.3.5"
+
+[tool.poe.executor]
+type = "poetry"
+
+[tool.poe.tasks]
+memo = "echo poe test or poetry run poe test"
+test = "pytest tests"
+pyright = "pyright mlbee"
+flake8 = "flake8 mlbee --ignore F401,E501,F841"
+check = ["pyright", "flake8"]
+export = "poetry export --without-hashes -f requirements.txt -o requirements.txt"
+build = "poetry build"
+publish = "poetry publish"
+release = ["test", "build", "publish"]
+lint = { cmd = "pylint mlbee" }
+isort = "isort tests mlbee"
+black = "black tests mlbee"
+formt = ["isort", "black"]
+docstyle = "pydocstyle --convention=google tests mlbee"
+prerelease = {cmd = "poetry version prerelease && sync-version"}
+tunnel = {cmd = "ssh -CN ip_or_hostname_defined_in_hosts -L 9091:127.0.0.1:9091"}
+
+[tool.poetry.dev-dependencies]
+pytest = "^7.1"
+flake8 = "^3.9.2"
+pydocstyle = "^6.1.1"
+toml = "^0.10.2"
+# tbump = "^6.3.2"
+poethepoet = "^0.10.0"
+
+[tool.poetry.scripts]
+"mlbee" = "mlbee.__main__:app"
+
+[build-system]
+requires = ["poetry-core>=1.0.0"]
+build-backend = "poetry.core.masonry.api"
+
+[tool.pytest.ini_options]
+minversion = "6.0"
+addopts = "-ra -q --doctest-modules"
+log_cli = true
+testpaths = [
+    "tests",
+    # "integration",
+]
+
+[tool.black]
+skip-string-normalization = 0
+
+[tool.isort]
+profile = "black"
+multi_line_output = 3

pyrightconfig.json

@@ -0,0 +1,9 @@
+{
+   "include": ["tests", "mlbee"],
+  "venvPath": ".venv",
+  "reportTypeshedErrors": false,
+  "reportMissingImports": true,
+  "reportMissingTypeStubs": false,
+  "pythonVersion": "3.8",
+  "ignore": []
+}

tests/__init__.py

@@ -0,0 +1 @@
+"""Init."""

tests/test_mlbee.py

@@ -0,0 +1,17 @@
+"""Test mlbee."""
+# pylint: disable=broad-except
+from mlbee import __version__
+from mlbee import mlbee
+
+
+def test_version():
+    """Test version."""
+    assert __version__[:3] == "0.1"
+
+
+def test_sanity():
+    """Check sanity."""
+    try:
+        assert not mlbee()
+    except Exception:
+        assert True