binarylane-cli 0.13.0__tar.gz → 0.15.0__tar.gz

{binarylane_cli-0.13.0 → binarylane_cli-0.15.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: binarylane-cli
-Version: 0.13.0
+Version: 0.15.0
 Summary: 
 Author: Nathan O'Sullivan
 Author-email: nathan.osullivan@mammoth.com.au
@@ -13,6 +13,7 @@ Classifier: Programming Language :: Python :: 3.11
 Requires-Dist: attrs (>=22.2.0,<23.0.0)
 Requires-Dist: backports.cached-property (>=1.0.2,<2.0.0) ; python_version < "3.8"
 Requires-Dist: httpx (>=0.23.0,<0.24.0)
+Requires-Dist: importlib-metadata ; python_version < "3.8"
 Requires-Dist: python-dateutil (>=2.8.2,<3.0.0)
 Requires-Dist: terminaltables (>=3.1.10,<4.0.0)
 Requires-Dist: typing-extensions (>=4.0.0,<5.0.0) ; python_version < "3.8"

{binarylane_cli-0.13.0 → binarylane_cli-0.15.0}/lib/binarylane/api/servers/get_v2_servers_server_id_console.py

@@ -72,9 +72,10 @@ def sync_detailed(
     *,
     client: Client,
 ) -> Response[Union[Any, ConsoleResponse, ProblemDetails, ValidationProblemDetails]]:
-    """
+    """Fetch the Console URLs for a Server
+
     Args:
-        server_id (int): The target server id.
+        server_id (int): The ID of the server for which console URLs will be fetched.
 
     Raises:
         errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
@@ -102,9 +103,10 @@ def sync(
     *,
     client: Client,
 ) -> Optional[Union[Any, ConsoleResponse, ProblemDetails, ValidationProblemDetails]]:
-    """
+    """Fetch the Console URLs for a Server
+
     Args:
-        server_id (int): The target server id.
+        server_id (int): The ID of the server for which console URLs will be fetched.
 
     Raises:
         errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
@@ -125,9 +127,10 @@ async def asyncio_detailed(
     *,
     client: Client,
 ) -> Response[Union[Any, ConsoleResponse, ProblemDetails, ValidationProblemDetails]]:
-    """
+    """Fetch the Console URLs for a Server
+
     Args:
-        server_id (int): The target server id.
+        server_id (int): The ID of the server for which console URLs will be fetched.
 
     Raises:
         errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
@@ -153,9 +156,10 @@ async def asyncio(
     *,
     client: Client,
 ) -> Optional[Union[Any, ConsoleResponse, ProblemDetails, ValidationProblemDetails]]:
-    """
+    """Fetch the Console URLs for a Server
+
     Args:
-        server_id (int): The target server id.
+        server_id (int): The ID of the server for which console URLs will be fetched.
 
     Raises:
         errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.

{binarylane_cli-0.13.0 → binarylane_cli-0.15.0}/lib/binarylane/errors.py

@@ -1,6 +1,5 @@
 """ Contains shared errors types that can be raised from API functions """
 
-
 from __future__ import annotations
 
 

{binarylane_cli-0.13.0 → binarylane_cli-0.15.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "binarylane-cli"
-version = "0.13.0"
+version = "0.15.0"
 description = ""
 authors = ["Nathan O'Sullivan <nathan.osullivan@mammoth.com.au>"]
 readme = "README.md"
@@ -14,9 +14,10 @@ attrs = "^22.2.0"
 python-dateutil = "^2.8.2"
 "backports.cached-property" = { version = "^1.0.2", python = "<3.8" }
 typing-extensions = { version = "^4.0.0", python = "<3.8" }
+importlib-metadata = { version = "*", python = "<3.8" }
 
 [tool.poetry.scripts]
-bl = "binarylane.console.app:main"
+bl = "binarylane.console.__main__:main"
 
 [tool.poetry.group.dev.dependencies]
 taskipy = "^1.10.3"
@@ -42,6 +43,7 @@ test = "pytest tests"
 check = "task isort && task black && task mypy && task pylint && task test && task safety"
 
 [tool.isort]
+py_version = 37
 line_length = 120
 profile = "black"
 sections=['FUTURE', 'STDLIB', 'COMPAT', 'THIRDPARTY', 'FIRSTPARTY', 'LOCALFOLDER']
@@ -49,10 +51,11 @@ no_lines_before=["COMPAT"]
 known_compat=["binarylane.pycompat"]
 known_first_party=["binarylane"]
 known_local_folder=["binarylane.console"]
+add_imports=["from __future__ import annotations"]
 
 [tool.black]
 line-length = 120
-target_version = ['py37', 'py38', 'py39']
+target_version = ["py37"]
 
 [tool.pylint.format]
 max-line-length = 120
@@ -78,9 +81,9 @@ strict_equality = true
 mypy_path = "lib:src"
 namespace_packages = true
 explicit_package_bases = true
-exclude = [
-    'src/binarylane/console/actions\.py$',  # from python 3.9
-]
+
+[tool.pyright]
+extraPaths = ["src", "lib"]
 
 [build-system]
 requires = ["poetry-core"]

{binarylane_cli-0.13.0 → binarylane_cli-0.15.0}/setup.py

@@ -44,26 +44,10 @@ packages = \
  'binarylane.api.sizes',
  'binarylane.api.software',
  'binarylane.api.vpcs',
+ 'binarylane.config',
  'binarylane.console',
- 'binarylane.console.app',
  'binarylane.console.commands',
- 'binarylane.console.commands.accounts',
- 'binarylane.console.commands.actions',
- 'binarylane.console.commands.customers',
- 'binarylane.console.commands.data_usages',
- 'binarylane.console.commands.domains',
- 'binarylane.console.commands.failover_ips',
- 'binarylane.console.commands.images',
- 'binarylane.console.commands.keys',
- 'binarylane.console.commands.load_balancers',
- 'binarylane.console.commands.regions',
- 'binarylane.console.commands.reverse_names',
- 'binarylane.console.commands.sample_sets',
- 'binarylane.console.commands.server_actions',
- 'binarylane.console.commands.servers',
- 'binarylane.console.commands.sizes',
- 'binarylane.console.commands.software',
- 'binarylane.console.commands.vpcs',
+ 'binarylane.console.commands.api',
  'binarylane.console.parser',
  'binarylane.console.printers',
  'binarylane.console.runners',
@@ -81,14 +65,15 @@ install_requires = \
 
 extras_require = \
 {':python_version < "3.8"': ['backports.cached-property>=1.0.2,<2.0.0',
-                             'typing-extensions>=4.0.0,<5.0.0']}
+                             'typing-extensions>=4.0.0,<5.0.0',
+                             'importlib-metadata']}
 
 entry_points = \
-{'console_scripts': ['bl = binarylane.console.app:main']}
+{'console_scripts': ['bl = binarylane.console.__main__:main']}
 
 setup_kwargs = {
     'name': 'binarylane-cli',
-    'version': '0.13.0',
+    'version': '0.15.0',
     'description': '',
     'long_description': '# `bl`: BinaryLane command-line interface\n\n```\n$ bl --help\nusage: bl [OPTIONS] COMMAND\n\nbl is a command-line interface for the BinaryLane API\n\nOptions:\n  --help                Display available commands and descriptions\n\nAvailable Commands:\n    account             Access account commands\n    action              Access action commands\n    configure           Configure access to BinaryLane API\n    domain              Access domain commands\n    image               Access image commands\n    load-balancer       Access load-balancer commands\n    region              Access region commands\n    server              Access server commands\n    size                Access size commands\n    software            Access software commands\n    ssh-key             Access ssh-key commands\n    version             Show the current version\n    vpc                 Access vpc commands\n```\n\n## Installation\n\n`bl` requires Python 3.7 or later and has been tested on a variety of Linux\ndistributions, Windows and Mac OSX. To install:\n\n```\npip install binarylane-cli\n```\n\n### Portable install (without Python)\n\nThe [releases page](https://github.com/binarylane/binarylane-cli/releases) has\na standalone `bl.exe` for use on Windows.\n\n\n## Getting Started\n\nThe BinaryLane CLI program is invoked by running `bl` (or `bl.exe` on Windows).\nTo use `bl` you must configure the program with a BinaryLane customer access\ntoken.\n\n 1. To start the configuration process, run:\n```\nbl configure\n```\n\n 2. A prompt will be shown requesting access token. Go to [Developer API](https://home.binarylane.com.au/api-info) section of BinaryLane website and select **+ Create Token**, enter a name such as *CLI* and **Create**. \n\n 3. Copy the displayed token and paste at the `bl` *Enter your API access token:*\nprompt.\n\n 4. To confirm token is working correctly, use `bl` to display BinaryLane account details:\n```\nbl account get\n``` \n\n## Usage\n\n`bl` provides commands to access all functionality provided by the [BinaryLane\nAPI](https://api.binarylane.com.au/reference/), organised into a *command\ntree*. The general form for invoking an command is `bl NOUN [NOUN] VERB`.\nFor example:\n\n - `bl server list`: Displays list of servers\n - `bl domain record create`: Create a DNS record\n\nThe available commands at each level of the tree are displayed by running `bl`\nwith no arguments:\n\n```\n$ bl\n\nusage: bl [OPTIONS] COMMAND\n\nbl is a command-line interface for the binaryLane API\n\nOptions:\n  --help                Display available commands and descriptions\n\nAvailable Commands:\n    account             Access account commands\n    action              Access action commands\n    configure           Configure access to binaryLane API\n    domain              Access domain commands\n    image               Access image commands\n    load-balancer       Access load-balancer commands\n    region              Access region commands\n    server              Access server commands\n    size                Access size commands\n    software            Access software commands\n    ssh-key             Access ssh-key commands\n    version             Show the current version\n    vpc                 Access vpc commands\n```\n\nTo see the available commands within the tree:\n\n```\nbl NOUN [NOUN]\n```\n\nFor example:\n\n```\n$ bl domain\nusage: bl domain [OPTIONS] COMMAND\n\nAccess domain commands\n\nOptions:\n  --help                Display available commands and descriptions\n\nAvailable Commands:\n    create              Create a new domain\n    delete              Delete an existing domain\n    get                 Fetch an existing domain\n    list                List all domains\n    nameservers         Access domain nameservers commands\n    record              Access domain record commands\n```\n\nTo see the required arguments and optional parameters for a command:\n\n```\nbl NOUN [NOUN] VERB --help\n```\n\nFor example:\n\n```\n$ bl domain create --help\nusage: bl domain create [OPTIONS] --name NAME [PARAMETERS]\n\nCreate a New Domain\n\nOptions:\n  --help                Display command options and descriptions\n  --curl                Display API request as a \'curl\' command-line\n  --no-header           Display columns without field labels\n  --output OUTPUT       Desired output format [plain, table, tsv, json] (Default: "table")\n\nArguments:\n  --name NAME           The domain name to add to the DNS management system.\n\nParameters:\n  --ip-address IP_ADDRESS\n                        An optional IPv4 address that will be used to create an A record for the root domain.\n```\n\n### Walkthrough: Creating a server\n\nServer creation is provided by the `bl server create` command. Use `--help` to\nview all arguments and parameters:\n\n```\n$ bl server list --help\nusage: bl server create [OPTIONS] --size SIZE --image IMAGE --region REGION [PARAMETERS]\n\nCreate a new server.\n\nOptions:\n  --help                Display command options and descriptions\n  --curl                Display API request as a \'curl\' command-line\n  --no-header           Display columns without field labels\n  --output OUTPUT       Desired output format [plain, table, tsv, json] (Default: "table")\n  --async               Do not wait for requested action to complete\n  --quiet               Do not show progress while waiting for requested action to complete\n\nArguments:\n  --size SIZE           The slug of the selected size.\n  --image IMAGE         The slug or id of the selected operating system.\n  --region REGION       The slug of the selected region.\n\nParameters:\n  --name NAME           The hostname of your server, such as vps01.yourcompany.com. If not\n                        provided, the server will be created with a random name.\n  --backups, --no-backups\n                        If true this will enable two daily backups for the server.\n                        Options.daily_backups will override this value if provided. Setting\n                        this to false has no effect.\n  --ipv6, --no-ipv6     If true this will enable IPv6 for this server.\n  --ssh-keys [SSH_KEYS [SSH_KEYS ...]]\n                        This may be either the SSH keys Ids or fingerprints. If this is null\n                        or not provided any SSH keys that have been marked as default will be\n                        deployed (if the operating system supports SSH keys). Submit an empty\n                        array to disable deployment of default keys.\n  --password PASSWORD   If this is provided the default remote user account\'s password will be\n                        set to this value. If this is null a random password will be generated\n                        and emailed to the account email address.\n  <additional parameters omitted for brevity>\n```\n\nIn the help displayed by `bl`, **Arguments** are required and **Parameters**\nare optional. For the `bl server list` command `--size SIZE`, `--image IMAGE`,\nand `--region REGION` are required. A list of available choices for each can be\ndisplayed by running:\n\n```\nbl size list\nbl image list\nbl region list\n```\n\nFor example, to create a minimum-sized Ubuntu 22.04 LTS server in Sydney using\nSSH public key authentication:\n\n```\n$ bl server create --size std-min --image ubuntu-22.04-lts --region syd\ncompleted.\n┌───────────────────────────┬─────────────────────────────────────────────────────────────────────────────────────┐\n│ name                      │ value                                                                               │\n├───────────────────────────┼─────────────────────────────────────────────────────────────────────────────────────┤\n│ id                        │ 210658                                                                              │\n│ name                      │ giant-rudolf.bnr.la                                                                 │\n│ memory                    │ 1024                                                                                │\n│ vcpus                     │ 1                                                                                   │\n│ disk                      │ 20                                                                                  │\n│ created_at                │ 2023-01-20T02:02:32+00:00                                                           │\n│ status                    │ new                                                                                 │\n│ region                    │ Sydney                                                                              │\n│ image                     │ 20.04 LTS                                                                           │\n│ size                      │ std-min                                                                             │\n│ size_slug                 │ std-min                                                                             │\n│ networks                  │ v4: [{\'ip_address\': \'175.45.180.1\',  \'type\': \'public\', \'netmask\': \'255.255.255.0... │\n  <additional rows omitted for brevity>\n└───────────────────────────┴─────────────────────────────────────────────────────────────────────────────────────┘\n```\n\n### Server passwords\n\nThe use of SSH public key authentication is strongly recommended where\npossible. When public key authentication is not suitable or the image being\ndeployed does not support SSH public key authentication (e.g. Windows Server),\ncommands such as `bl server create` and `bl server action password-reset` have\nan optional `--password PASSWORD` parameter that specifies the password to use.\n\nFor example, to create a server per the previous example with password\nauthentication:\n\n```\n$ bl server create --size std-min --image ubuntu-22.04-lts --region syd --password \'qq7s6GYZgbiVG3\'\n```\n\nUpon completion, the root password for the server in this example would be `qq7s6GYZgbiVG3`.\n\n:warning: **Internet-connected servers with password-based authentication enabled\nmust have a strong, randomly generated password.** Brute-force login attempts\nare pervasive on the public internet: if a server password is not randomly\ngenerated, unauthorised access is likely to occur.\n\n### Server actions\n\n`bl` can be used to perform any action that the BinaryLane website can perform,\nincluding:\n\n - Take and restore backups\n - Change plan, operating system, or reinstall\n - Restart and power cycle\n - and many more...\n\nA list of available commands is displayed by running `bl server action`:\n\n```\n$ bl server action\n\nAvailable Commands:\n    add-disk            Create an additional disk for a server\n    attach-backup       Attach a backup to a server\n    change-advanced-features\n                        Change the advanced features of a server\n    change-advanced-firewall-rules\n                        Change the advanced firewall rules for a server\n    change-backup-schedule\n                        Change the backup schedule of a server\n    change-ipv6         Enable or disable IPv6 for a server\n    change-ipv6-reverse-nameservers\n                        Update the IPv6 reverse name servers for a server\n    change-kernel       Change the kernel of a server\n  <additional actions omitted for brevity>\n    ping                Attempt to ping a server\n    power-cycle         Power a server off and then on\n    power-off           Power a server off\n    power-on            Power a server on\n    reboot              Request a server perform a reboot\n    rebuild             Rebuild an existing server\n    rename              Rename a server\n    resize              Update the size and related options for a server\n    resize-disk         Alter the size of an existing disk for a server\n    restore             Restore a backup to a server\n    shutdown            Request a server perform a shutdown\n    take-backup         Take a backup of a server\n    uncancel            Revert the cancellation of a server\n    uptime              Check the uptime of a server\n```\n\nEach server action has a mandatory `SERVER_ID` argument  which can be obtained\nfrom `bl server list`.\n\nMany actions have additional *action-specific* arguments and parameters. Run\n`bl server action COMMAND --help` to see what a particular action supports.\n\n#### Example: password reset\n\n 1. Use `--help` to see the available arguments and parameters:\n\n\n```\n$ bl server action password-reset --help\nusage: bl server action password-reset [OPTIONS] SERVER_ID [PARAMETERS]\n\nReset the Password of a Server\n\n<options omitted for brevity>\n\nArguments:\n  SERVER_ID            The ID of the server on which the action should be performed.\n\nParameters:\n  --username USERNAME  The username of the user to change the password.\n  --password PASSWORD  If this is provided the specified or default remote user\'s account\n                       password will be set to this value.\n```\n\n 2. Use `bl server list` to obtain the numeric server ID. In this example, the\nserver requiring a password reset is ID 123456.\n\n 3. Provide the server ID and desired password to the `password-reset` command:\n\n```\nbl server action password-reset 123456 --password \'qq7s6GYZgbiVG3\'\n```\n\n### Asynchronous actions\n\n`bl` commands that perform an action - `bl create server`, `bl server\naction restore-backup`, and many others - default to *synchronous* handling\nwhere `bl` will display progress information to the console and not exit until\nthe command finishes.\n\nIn some scenarios such as when creating multiple servers, it may be desirable\nrun the command with *asynchronous* handling where `bl` will exit as\nsoon as the BinaryLane API accepts the requested command. To do so, include the\n`--async` option in the command invocation. For example:\n\n```\n$ bl server create --size std-min --image ubuntu-22.04-lts --region syd --async\n```\n\n### Configuration file\n\n`bl configure` creates a configuration file containing the API token, and reads\nthat configuration file on subsequent invocations. The configuration file is\nstored at:\n\n * `$XDG_CONFIG_HOME/binarylane/config.ini`\n\nTypically the environment variable `$XDG_CONFIG_HOME` is not set, in which case\nthe configuration file stored at:\n\n - **Linux/Mac/etc**: `$HOME/.config` - typical file location is\n   `/home/username/.config/binarylane/config.ini`\n - **Windows**: `$APPDATA` - typical file location is\n   `C:\\Users\\UserName\\AppData\\Roaming\\binarylane\\config.ini`\n\n\n### Environment variables\n\nFor environments where the use of `bl configure` and a permanent configuration\nfile are not suitable, environment variables may be utilised instead.\n\nThe environment variable `BL_API_TOKEN` may be used to provide the API token\nrequired to perform `bl` commands.\n\n## Versioning\n\n`bl` uses [semantic versioning](https://semver.org/spec/v2.0.0.html) to version\n[releases](https://github.com/binarylane/binarylane-cli/releases).\n\nSemantic versions are in the form of `MAJOR.MINOR.PATCH`. The value of `MAJOR`\nis currently **0**, which indicates that each new release of the `bl` program may\ncontain changes to its interface that are not backwards-compatible with\nprevious releases such as:\n\n - Command names may change, or moved within the command tree\n - Parameter names may change, or be removed entirely\n - Available field names may change, or be removed entirely\n - Default set of displayed fields displayed in output may change\n\nSuch changes in a new release are not likely to impact interactive use of `bl`,\nbut may cause problems for customers who integrate `bl` into non-interactive\nenvironments such as automation.\n\nIn non-interactive environments, customers should review the release\nChangelog prior to deploying an updated `0.x.y` release, and  ensure that any\nrequired adjustments to the non-interactive environment are made prior to\nupgrading the `bl` program itself.\n',
     'author': "Nathan O'Sullivan",

binarylane_cli-0.15.0/src/binarylane/config/__init__.py

@@ -0,0 +1,54 @@
+from __future__ import annotations
+
+from argparse import Namespace
+from pathlib import Path
+from typing import Dict, Optional
+
+import binarylane.config.sources as src
+from binarylane.config.options import OptionAttributes, OptionName
+from binarylane.config.repository import Repository, Source
+
+
+class _Config(Repository, OptionAttributes):
+    def __init__(self) -> None:
+        super().__init__(default_source=True)
+
+
+class DefaultConfig(_Config):
+    pass
+
+
+class UserConfig(_Config):
+    def __init__(self, *, config_file: Optional[Path] = src.FileSource.DEFAULT_PATH) -> None:
+        super().__init__()
+
+        self.add_source(src.FileSource(config_file))
+        self.add_source(src.EnvironmentSource())
+
+    def add_commandline(self, commandline: Namespace) -> None:
+        self.add_source(src.CommandlineSource(commandline))
+
+    def add_source(self, source: Source) -> None:
+        super().add_source(source)
+
+        # If we have a file source, update its config section:
+        try:
+            self.get_source(src.FileSource).section_name = self.config_section
+        except KeyError:
+            pass
+
+    def save(self) -> None:
+        # We will determine what to save by comparing current state with default
+        default = DefaultConfig()
+
+        # Create a dictionary of options with non-default values
+        config_options: Dict[str, Optional[str]] = {}
+        config_options[OptionName.API_URL] = self.api_url if self.api_url != default.api_url else None
+        config_options[OptionName.API_TOKEN] = self.api_token if self.api_token != default.api_token else None
+        config_options[OptionName.API_DEVELOPMENT] = (
+            str(self.api_development).lower() if self.api_development != default.api_development else None
+        )
+
+        # Write configuration to disk
+        file = self.get_source(src.FileSource)
+        file.save(config_options)

binarylane_cli-0.15.0/src/binarylane/config/options.py

@@ -0,0 +1,94 @@
+from __future__ import annotations
+
+from abc import ABC, abstractmethod
+from configparser import ConfigParser
+from enum import Enum
+from typing import ClassVar, Optional
+
+
+class OptionName(str, Enum):
+    API_URL = "api-url"
+    API_TOKEN = "api-token"
+    API_DEVELOPMENT = "api-development"
+    CONFIG_SECTION = "context"
+
+    def __str__(self) -> str:
+        return self.value
+
+
+class OptionAttributes(ABC):
+    """Typed access to value of each configuration option"""
+
+    UNCONFIGURED_TOKEN: ClassVar[str] = "unconfigured"
+
+    @abstractmethod
+    def get_option(self, name: OptionName) -> Optional[str]:
+        ...
+
+    @abstractmethod
+    def required_option(self, name: OptionName) -> str:
+        ...
+
+    @abstractmethod
+    def add_option(self, name: OptionName, value: str) -> None:
+        ...
+
+    @staticmethod
+    def to_bool(name: str) -> bool:
+        value = ConfigParser.BOOLEAN_STATES.get(name.lower())
+        if value is not None:
+            return value
+        raise ValueError(f"Not a boolean: {name}")
+
+    @property
+    def api_url(self) -> str:
+        return self.required_option(OptionName.API_URL)
+
+    @property
+    def api_token(self) -> str:
+        value = self.get_option(OptionName.API_TOKEN)
+
+        # NOTE: on handling when `get(Option.API_TOKEN) is None` - i.e. has not been configured:
+        #
+        # 1. The code-generated endpoints currently all have AuthenticatedClient as a parameter, regardless of
+        #    whether the given endpoint actually requires authentication, however there are endpoints returning
+        #    non-customer specific information like `bl size list`, `bl region list` that do not require
+        #    authentication to get a HTTP 200 response from. For this reason, we currently must create an
+        #    AuthenticatedClient() object for every request.
+        # 2. The code-generated AuthenticatedClient is generated with `token: str` rather than `Optional[str]`
+        #    which makes sense, so we need to provide /something/.
+        # 3. If token is "" then httpx will raise LocalProtocolError about the "Authorization: Bearer " header.
+        # 4. If static type-checking is ignored and AuthenticatedClient is provided with `token=None`, then
+        #    that value is coerced to str resulting in "Authorization: Bearer None" but that will look like a bug.
+        # 5. Since "" is not accepted by httpx, for clarity we use a value of "unconfigured" for this situation.
+        # 6. If the called endpoint does require an API token the response will be HTTP 401. Our response() method
+        #    will then display a message requesting a token be provided via `bl configure`. If endpoint is
+        #    publicly accessable, the "Authorization: Bearer unconfigured" header is ignored and the response
+        #    will be HTTP 200, which can then be processed as normal.
+        #
+        # TLDR: when user has not provided an API token, because of current limitations with generated
+        # client library we cannot know whether a given endpoint requires authorization or is publically accessible,
+        # so we use "Authorization: Bearer unconfigured" and handle whatever HTTP response the endpoint provides.
+        #
+        # If point 1 is resolved in the future, when user has not provided a token and code generation correctly
+        # indicates that authorization is required we can skip the API call entirely and immediately display the
+        # message requesting `bl configure`; while public endpoints would use the token-less Client() instead.
+
+        if value is None:
+            return self.UNCONFIGURED_TOKEN
+        return value
+
+    @api_token.setter
+    def api_token(self, value: str) -> None:
+        self.add_option(OptionName.API_TOKEN, value)
+
+    @property
+    def api_development(self) -> bool:
+        value = self.get_option(OptionName.API_DEVELOPMENT)
+        if value is None:
+            return False
+        return self.to_bool(value)
+
+    @property
+    def config_section(self) -> str:
+        return self.required_option(OptionName.CONFIG_SECTION)

binarylane_cli-0.15.0/src/binarylane/config/repository.py

@@ -0,0 +1,53 @@
+from __future__ import annotations
+
+from typing import List, Optional, Type, TypeVar
+from binarylane.pycompat.typing import Protocol
+
+import binarylane.config.sources as src
+from binarylane.config.options import OptionName
+
+
+class Source(Protocol):
+    def get(self, name: str) -> Optional[str]:
+        ...
+
+
+T = TypeVar("T", bound=Source)
+
+
+class Repository:
+    _sources: List[Source]
+
+    def __init__(self, default_source: bool = True) -> None:
+        self._sources = []
+
+        if default_source:
+            self.add_source(src.DefaultSource())
+
+    def add_source(self, source: Source) -> None:
+        self._sources.append(source)
+
+    def get_source(self, source_type: Type[T]) -> T:
+        for source in self._sources[::-1]:
+            if isinstance(source, source_type):
+                return source
+        raise KeyError(str(source_type))
+
+    def add_option(self, name: OptionName, value: str) -> None:
+        self.add_source(src.RuntimeSource({name: value}))
+
+    def get_option(self, name: OptionName) -> Optional[str]:
+        for source in self._sources[::-1]:
+            value = source.get(name)
+            if value is not None:
+                return value
+        return None
+
+    def required_option(self, name: OptionName) -> str:
+        value = self.get_option(name)
+        if value is None:
+            raise KeyError(name)
+        return value
+
+    def __repr__(self) -> str:
+        return f"Repository([{', '.join([repr(source) for source in self._sources])}])"

binarylane_cli-0.15.0/src/binarylane/config/sources.py

@@ -0,0 +1,141 @@
+from __future__ import annotations
+
+import argparse
+import configparser
+import os
+import sys
+from abc import ABC
+from pathlib import Path
+from typing import ClassVar, Dict, Optional
+
+
+class _SourceBase(ABC):
+    _config: Dict[str, str]
+
+    def get(self, name: str) -> Optional[str]:
+        return self._config.get(name, None)
+
+    def __repr__(self) -> str:
+        return f"{type(self).__name__}({self._config})"
+
+
+class CommandlineSource(_SourceBase):
+    def __init__(self, config: argparse.Namespace) -> None:
+        self._config = {key.replace("_", "-"): str(value) for key, value in vars(config).items() if value is not None}
+
+
+class DefaultSource(_SourceBase):
+    def __init__(self) -> None:
+        self._config = {
+            "api-url": "https://api.binarylane.com.au",
+            "context": "bl",
+        }
+
+
+class EnvironmentSource(_SourceBase):
+    prefix: ClassVar[str] = "BL_"
+
+    def __init__(self) -> None:
+        self._config = {self._get_name(key): value for key, value in os.environ.items() if key.startswith(self.prefix)}
+
+    def _get_name(self, key: str) -> str:
+        return key[len(self.prefix) :].lower().replace("_", "-")
+
+
+class FileSource:
+    DEFAULT_PATH = Path("__DEFAULT__")
+    _DIRNAME = "binarylane"
+    _FILENAME = "config.ini"
+    _path: Optional[Path]
+    section_name: str
+
+    _parser: configparser.ConfigParser
+
+    def __init__(self, config_file: Optional[Path] = None) -> None:
+        if config_file is self.DEFAULT_PATH:
+            config_file = self._get_config_dir() / self._FILENAME
+        self._path = config_file
+
+        # ConfigParser with default settings supports a lot of different features. We have disabled them
+        # to narrow the configuration file format, to simplify a potential migration to a different config format.
+        self._parser = configparser.ConfigParser(
+            delimiters=("="),
+            comment_prefixes=("#", ";"),
+            empty_lines_in_values=False,
+            interpolation=None,
+            default_section="",  # this effectively disables the default section as `[]` is not a valid section header
+        )
+        self._read()
+        self.section_name = "bl"
+
+    @staticmethod
+    def _get_config_home() -> Path:
+        """Return platform-specific path that programs should store configuration in"""
+        # On windows, configuration is stored in APPDATA
+        if sys.platform == "win32":
+            appdata = os.getenv("APPDATA")
+            if not appdata:
+                raise EnvironmentError("%APPDATA% is not set?")
+            return Path(appdata)
+
+        # On other systems, use XDG_CONFIG_HOME if set
+        xdg_config_home = os.getenv("XDG_CONFIG_HOME")
+        if xdg_config_home:
+            return Path(xdg_config_home)
+
+        # Otherwise, use HOME/.config
+        home_config = Path.home() / ".config"
+
+        # Ensure $HOME/.config is a directory, creating it if necessary
+        if home_config.exists() and not home_config.is_dir():
+            raise EnvironmentError(f"{home_config} is not a directory?")
+        home_config.mkdir(mode=0o700, exist_ok=True)
+        return home_config
+
+    def _get_config_dir(self) -> Path:
+        return self._get_config_home() / self._DIRNAME
+
+    def _read(self) -> None:
+        if self._path is None:
+            return
+
+        if self._path.exists():
+            self._parser.read(self._path)
+
+    def save(self, config_options: Dict[str, Optional[str]]) -> None:
+        if self._path is None:
+            raise ValueError("Cannot save when FileSource.config_file is None")
+
+        # Update the section with provided options:
+        for option, value in config_options.items():
+            if value is not None:
+                # ConfigParser needs actual str, not _Value
+                self._section[option] = str(value)
+            # A value of None means "use default", and so should be removed from the section
+            else:
+                self._section.pop(option, None)
+
+        # Ensure config directory exists
+        config_dir = self._path.parent
+        config_dir.mkdir(mode=0o700, exist_ok=True)
+
+        # Write the updated config to disk
+        with open(self._path, "w", encoding="utf-8") as file:
+            self._parser.write(file)
+
+    @property
+    def _section(self) -> configparser.SectionProxy:
+        if self.section_name not in self._parser:
+            self._parser[self.section_name] = {}
+        return self._parser[self.section_name]
+
+    def get(self, name: str) -> Optional[str]:
+        return self._section.get(name, None)
+
+    def __repr__(self) -> str:
+        return f"FileSource(config_file={self._path!r}, section_name={self.section_name!r})"
+
+
+class RuntimeSource(_SourceBase):
+    def __init__(self, config: Dict[str, str]) -> None:
+        self._config = config

binarylane_cli-0.13.0/src/binarylane/console/app/__init__.py → binarylane_cli-0.15.0/src/binarylane/console/__main__.py

@@ -4,7 +4,7 @@ import logging
 import os
 import sys
 
-from binarylane.console.app.app import App
+from binarylane.console.app import App
 
 logger = logging.getLogger(__name__)
 
@@ -22,3 +22,7 @@ def main() -> int:
     except Exception as exc:
         logger.exception(exc)
         return -1
+
+
+if __name__ == "__main__":
+    sys.exit(main())