README.md

@@ -6,11 +6,12 @@
 
 Automatic one-way trades.
 
-This program is a wrapper around
-[`fin_depo`](https://gitfub.space/Jmaa/fin-depo/) for automatically trading
-one-way trades, by using repeated trades over a period. Can be used to slowly
-enter or exit positions, for example low-volume crypto currencies, or as an
-automated investment savings system.
+This is a wrapper about [`fin_depo`](https://gitfub.space/Jmaa/fin-depo/) for
+automatically trading one way trades, by using repeated trades
+over a period.
+
+The primary motivation is for trading low-volume crypto assets slowly without
+affecting the price too much.
 
 Supported sites:
 
@@ -26,51 +27,23 @@ pip install -r requirements.txt
 
 ## Usage
 
-1. Create configuration file. See below and in `examples/` folder for inspiration.
-2. [Create KuCoin API key](https://www.kucoin.com/account/api) with **General**
-   and **Spot Trading** permissions.
-3. Add KuCoin API key secrets (`KUCOIN_KEY`, `KUCOIN_SECRET`, `KUCOIN_PASS`) to
-   an [`secret_loader` accessible
-   location](https://gitfub.space/Jmaa/secret_loader#user-content-accessible) .
-4. Run script using `python -m crypto_seller --config CONFIG_FILE`.
+Run using from the top directory:
+
+```shell
+python -m crypto_seller
+```
 
 The script will now automatically sell assets over time. The interval between
 sell-offs are randomized to avoid front-running, and the amounts are also
-randomized to avoid certain attacks (only relevant for smallish intervals of
-less than a week).
+randomized to avoid too consistent behaviour.
 
 The log will both be displayed in the shell, and be placed in a log file
 `output/log.txt`. Every sell-off will be logged to the `output/trades.csv`
 file, with as much information as possible. Keep both of these for tax
 purposes, if relevant.
 
-## Configuration
-
-Example configurations can be found in the `examples/` folder.
-
-Configurations are `.json` files, with the following fields:
-
-```json
-{
-    "input_asset": str,
-    "output_asset": str,
-    "input_amount_low": float,
-    "input_amount_high": float,
-    "interval_minutes_low": int,
-    "interval_minutes_high": int
-}
-```
-
-While `input_amount_low` and `input_amount_high` can be identical (and
-the same for `interval_minutes_XX`) it is discouraged, to avoid frontrunning attacks.
-
 ## Auditing information
 
-As mentioned before, this program is mostly glue code and wrappering around
-library functionality. The glue application code allows for running the main
-loop of checking balance, selling amount and sleeping until the next iteration,
-with some argument and configuration parsing thrown in.
-
 The most relevant libraries for auditing are:
 
 - [`fin_depo`](https://gitfub.space/Jmaa/fin-depo): Library for programmatic
@@ -78,11 +51,8 @@ The most relevant libraries for auditing are:
   This is the library that reads balances and places market orders.
 - [`fin_defs`](https://gitfub.space/Jmaa/fin-defs): Definitions of financial
   assets and instruments. Used by `fin_depo`.
-- [`secret_loader`](https://gitfub.space/Jmaa/secret_loader): Library for
-  loading of secrets (passwords, API keys, secret keys, configuration files,
-  etc.) from standardized locations.
-- [`python-kucoin`](https://python-kucoin.readthedocs.io/en/latest/): Used by
-  `fin_depo` to provide KuCoin backend.
+- [`python-kucoin`](https://python-kucoin.readthedocs.io/en/latest/) is used by
+  `fin_depo` for providing KuCoin support.
 
 ## Taxation
 
@@ -107,8 +77,8 @@ most mature on the danish market, and does support KuCoin.
       * Catch runtime errors when selling
       * Show errors to log.
       * Stop loop and exit with results, and error indicator.
-- [X] Document configuration
-- [X] Document code auditing
+- [ ] Document configuration
+- [ ] Document code auditing
 - [X] Parse configuration from json.
 - [X] Ensure sell time is included in order details
 - [X] Log all trades to CSV file.

crypto_seller/__init__.py

@@ -2,11 +2,12 @@
 
 Automatic one-way trades.
 
-This program is a wrapper around
-[`fin_depo`](https://gitfub.space/Jmaa/fin-depo/) for automatically trading
-one-way trades, by using repeated trades over a period. Can be used to slowly
-enter or exit positions, for example low-volume crypto currencies, or as an
-automated investment savings system.
+This is a wrapper about [`fin_depo`](https://gitfub.space/Jmaa/fin-depo/) for
+automatically trading one way trades, by using repeated trades
+over a period.
+
+The primary motivation is for trading low-volume crypto assets slowly without
+affecting the price too much.
 
 Supported sites:
 
@@ -22,51 +23,23 @@ pip install -r requirements.txt
 
 ## Usage
 
-1. Create configuration file. See below and in `examples/` folder for inspiration.
-2. [Create KuCoin API key](https://www.kucoin.com/account/api) with **General**
-   and **Spot Trading** permissions.
-3. Add KuCoin API key secrets (`KUCOIN_KEY`, `KUCOIN_SECRET`, `KUCOIN_PASS`) to
-   an [`secret_loader` accessible
-   location](https://gitfub.space/Jmaa/secret_loader#user-content-accessible) .
-4. Run script using `python -m crypto_seller --config CONFIG_FILE`.
+Run using from the top directory:
+
+```shell
+python -m crypto_seller
+```
 
 The script will now automatically sell assets over time. The interval between
 sell-offs are randomized to avoid front-running, and the amounts are also
-randomized to avoid certain attacks (only relevant for smallish intervals of
-less than a week).
+randomized to avoid too consistent behaviour.
 
 The log will both be displayed in the shell, and be placed in a log file
 `output/log.txt`. Every sell-off will be logged to the `output/trades.csv`
 file, with as much information as possible. Keep both of these for tax
 purposes, if relevant.
 
-## Configuration
-
-Example configurations can be found in the `examples/` folder.
-
-Configurations are `.json` files, with the following fields:
-
-```json
-{
-    "input_asset": str,
-    "output_asset": str,
-    "input_amount_low": float,
-    "input_amount_high": float,
-    "interval_minutes_low": int,
-    "interval_minutes_high": int
-}
-```
-
-While `input_amount_low` and `input_amount_high` can be identical (and
-the same for `interval_minutes_XX`) it is discouraged, to avoid frontrunning attacks.
-
 ## Auditing information
 
-As mentioned before, this program is mostly glue code and wrappering around
-library functionality. The glue application code allows for running the main
-loop of checking balance, selling amount and sleeping until the next iteration,
-with some argument and configuration parsing thrown in.
-
 The most relevant libraries for auditing are:
 
 - [`fin_depo`](https://gitfub.space/Jmaa/fin-depo): Library for programmatic
@@ -74,11 +47,8 @@ The most relevant libraries for auditing are:
   This is the library that reads balances and places market orders.
 - [`fin_defs`](https://gitfub.space/Jmaa/fin-defs): Definitions of financial
   assets and instruments. Used by `fin_depo`.
-- [`secret_loader`](https://gitfub.space/Jmaa/secret_loader): Library for
-  loading of secrets (passwords, API keys, secret keys, configuration files,
-  etc.) from standardized locations.
-- [`python-kucoin`](https://python-kucoin.readthedocs.io/en/latest/): Used by
-  `fin_depo` to provide KuCoin backend.
+- [`python-kucoin`](https://python-kucoin.readthedocs.io/en/latest/) is used by
+  `fin_depo` for providing KuCoin support.
 
 ## Taxation
 
@@ -103,8 +73,8 @@ most mature on the danish market, and does support KuCoin.
       * Catch runtime errors when selling
       * Show errors to log.
       * Stop loop and exit with results, and error indicator.
-- [X] Document configuration
-- [X] Document code auditing
+- [ ] Document configuration
+- [ ] Document code auditing
 - [X] Parse configuration from json.
 - [X] Ensure sell time is included in order details
 - [X] Log all trades to CSV file.

crypto_seller/_version.py

@@ -1 +1 @@
-__version__ = '0.1.3'
+__version__ = '0.1.2'

crypto_seller/order_csv.py

@@ -1,17 +1,12 @@
 import csv
-import dataclasses
 from pathlib import Path
 
 import fin_depo
 
 
-@dataclasses.dataclass(frozen=True)
 class CsvFileLogger:
-    """Outputs the given `TradeOrderDetails` to the CSV file at the specified
-    path.
-    """
-
-    path: Path
+    def __init__(self, path: Path):
+        self.path = path
 
     def __call__(self, trade_order: fin_depo.data.TradeOrderDetails):
         fieldnames: list[str] = [
@@ -26,10 +21,6 @@ class CsvFileLogger:
             'raw_order_details',
         ]
 
-        # Ensure that directory exists
-        self.path.parent.mkdir(parents=True, exist_ok=True)
-
-        # Write row in CSV file
         with open(self.path, 'a') as f:
             writer = csv.DictWriter(f, fieldnames=fieldnames)
             writer.writerow(trade_order.__dict__)

crypto_seller/secrets_config.py

@@ -1,5 +1,4 @@
 """Handles secrets for the `crypto_seller` system."""
-
 from secret_loader import SecretLoader
 
 __all__ = ['KUCOIN_KEY', 'KUCOIN_SECRET', 'KUCOIN_PASS']

setup.py

@@ -15,11 +15,12 @@ PACKAGE_DESCRIPTION = """
 
 Automatic one-way trades.
 
-This program is a wrapper around
-[`fin_depo`](https://gitfub.space/Jmaa/fin-depo/) for automatically trading
-one-way trades, by using repeated trades over a period. Can be used to slowly
-enter or exit positions, for example low-volume crypto currencies, or as an
-automated investment savings system.
+This is a wrapper about [`fin_depo`](https://gitfub.space/Jmaa/fin-depo/) for
+automatically trading one way trades, by using repeated trades
+over a period.
+
+The primary motivation is for trading low-volume crypto assets slowly without
+affecting the price too much.
 
 Supported sites:
 
@@ -35,51 +36,23 @@ pip install -r requirements.txt
 
 ## Usage
 
-1. Create configuration file. See below and in `examples/` folder for inspiration.
-2. [Create KuCoin API key](https://www.kucoin.com/account/api) with **General**
-   and **Spot Trading** permissions.
-3. Add KuCoin API key secrets (`KUCOIN_KEY`, `KUCOIN_SECRET`, `KUCOIN_PASS`) to
-   an [`secret_loader` accessible
-   location](https://gitfub.space/Jmaa/secret_loader#user-content-accessible) .
-4. Run script using `python -m crypto_seller --config CONFIG_FILE`.
+Run using from the top directory:
+
+```shell
+python -m crypto_seller
+```
 
 The script will now automatically sell assets over time. The interval between
 sell-offs are randomized to avoid front-running, and the amounts are also
-randomized to avoid certain attacks (only relevant for smallish intervals of
-less than a week).
+randomized to avoid too consistent behaviour.
 
 The log will both be displayed in the shell, and be placed in a log file
 `output/log.txt`. Every sell-off will be logged to the `output/trades.csv`
 file, with as much information as possible. Keep both of these for tax
 purposes, if relevant.
 
-## Configuration
-
-Example configurations can be found in the `examples/` folder.
-
-Configurations are `.json` files, with the following fields:
-
-```json
-{
-    "input_asset": str,
-    "output_asset": str,
-    "input_amount_low": float,
-    "input_amount_high": float,
-    "interval_minutes_low": int,
-    "interval_minutes_high": int
-}
-```
-
-While `input_amount_low` and `input_amount_high` can be identical (and
-the same for `interval_minutes_XX`) it is discouraged, to avoid frontrunning attacks.
-
 ## Auditing information
 
-As mentioned before, this program is mostly glue code and wrappering around
-library functionality. The glue application code allows for running the main
-loop of checking balance, selling amount and sleeping until the next iteration,
-with some argument and configuration parsing thrown in.
-
 The most relevant libraries for auditing are:
 
 - [`fin_depo`](https://gitfub.space/Jmaa/fin-depo): Library for programmatic
@@ -87,11 +60,8 @@ The most relevant libraries for auditing are:
   This is the library that reads balances and places market orders.
 - [`fin_defs`](https://gitfub.space/Jmaa/fin-defs): Definitions of financial
   assets and instruments. Used by `fin_depo`.
-- [`secret_loader`](https://gitfub.space/Jmaa/secret_loader): Library for
-  loading of secrets (passwords, API keys, secret keys, configuration files,
-  etc.) from standardized locations.
-- [`python-kucoin`](https://python-kucoin.readthedocs.io/en/latest/): Used by
-  `fin_depo` to provide KuCoin backend.
+- [`python-kucoin`](https://python-kucoin.readthedocs.io/en/latest/) is used by
+  `fin_depo` for providing KuCoin support.
 
 ## Taxation
 
@@ -116,8 +86,8 @@ most mature on the danish market, and does support KuCoin.
       * Catch runtime errors when selling
       * Show errors to log.
       * Stop loop and exit with results, and error indicator.
-- [X] Document configuration
-- [X] Document code auditing
+- [ ] Document configuration
+- [ ] Document code auditing
 - [X] Parse configuration from json.
 - [X] Ensure sell time is included in order details
 - [X] Log all trades to CSV file.