From fdb9dff4b0ed870fe8cd697002b8ea1dde4b2047 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Fri, 22 Aug 2025 23:47:14 +0000
Subject: [PATCH 01/10] Initial plan
From afd8571f32ddd9c4046f35d44be5d0f2f1c9463a Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Fri, 22 Aug 2025 23:55:10 +0000
Subject: [PATCH 02/10] Add alternative decimal conversion method and
comprehensive research
Co-authored-by: DaveSkender <8432125+DaveSkender@users.noreply.github.com>
---
.../test_decimal_conversion_performance.py | 70 ++++++++
research_decimal_conversion.py | 114 ++++++++++++++
stock_indicators/_cstypes/__init__.py | 2 +-
stock_indicators/_cstypes/decimal.py | 12 ++
tests/common/test_cstype_conversion.py | 20 ++-
.../test_decimal_conversion_comparison.py | 149 ++++++++++++++++++
6 files changed, 365 insertions(+), 2 deletions(-)
create mode 100644 benchmarks/test_decimal_conversion_performance.py
create mode 100644 research_decimal_conversion.py
create mode 100644 tests/common/test_decimal_conversion_comparison.py
diff --git a/benchmarks/test_decimal_conversion_performance.py b/benchmarks/test_decimal_conversion_performance.py
new file mode 100644
index 00000000..a4d3f28b
--- /dev/null
+++ b/benchmarks/test_decimal_conversion_performance.py
@@ -0,0 +1,70 @@
+"""Benchmarks comparing performance of different decimal conversion methods."""
+
+import pytest
+from stock_indicators._cstypes import Decimal as CsDecimal
+from stock_indicators._cstypes.decimal import to_pydecimal, to_pydecimal_via_double
+
+
+@pytest.mark.performance
+class TestDecimalConversionPerformance:
+ """Benchmark performance of different decimal conversion methods."""
+
+ def test_benchmark_string_conversion(self, benchmark, raw_data):
+ """Benchmark the current string-based conversion method."""
+ from stock_indicators._cstypes.decimal import to_pydecimal
+
+ raw_data = raw_data * 100 # Use subset for faster testing
+
+ # Pre-convert to CsDecimal to isolate the conversion performance
+ cs_decimals = [CsDecimal(row[2]) for row in raw_data]
+
+ def convert_via_string(cs_decimals):
+ for cs_decimal in cs_decimals:
+ to_pydecimal(cs_decimal)
+
+ benchmark(convert_via_string, cs_decimals)
+
+ def test_benchmark_double_conversion(self, benchmark, raw_data):
+ """Benchmark the new double-based conversion method."""
+ from stock_indicators._cstypes.decimal import to_pydecimal_via_double
+
+ raw_data = raw_data * 100 # Use subset for faster testing
+
+ # Pre-convert to CsDecimal to isolate the conversion performance
+ cs_decimals = [CsDecimal(row[2]) for row in raw_data]
+
+ def convert_via_double(cs_decimals):
+ for cs_decimal in cs_decimals:
+ to_pydecimal_via_double(cs_decimal)
+
+ benchmark(convert_via_double, cs_decimals)
+
+ def test_benchmark_small_dataset_string_conversion(self, benchmark):
+ """Benchmark string conversion with a controlled small dataset."""
+ test_values = [
+ 1996.1012, 123.456789, 0.123456789, 999999.999999,
+ 0.000001, 1000000.0, 1.8e-05, 1.234e10
+ ] * 1000 # Repeat to get meaningful measurements
+
+ cs_decimals = [CsDecimal(val) for val in test_values]
+
+ def convert_via_string(cs_decimals):
+ for cs_decimal in cs_decimals:
+ to_pydecimal(cs_decimal)
+
+ benchmark(convert_via_string, cs_decimals)
+
+ def test_benchmark_small_dataset_double_conversion(self, benchmark):
+ """Benchmark double conversion with a controlled small dataset."""
+ test_values = [
+ 1996.1012, 123.456789, 0.123456789, 999999.999999,
+ 0.000001, 1000000.0, 1.8e-05, 1.234e10
+ ] * 1000 # Repeat to get meaningful measurements
+
+ cs_decimals = [CsDecimal(val) for val in test_values]
+
+ def convert_via_double(cs_decimals):
+ for cs_decimal in cs_decimals:
+ to_pydecimal_via_double(cs_decimal)
+
+ benchmark(convert_via_double, cs_decimals)
\ No newline at end of file
diff --git a/research_decimal_conversion.py b/research_decimal_conversion.py
new file mode 100644
index 00000000..98b158d1
--- /dev/null
+++ b/research_decimal_conversion.py
@@ -0,0 +1,114 @@
+"""
+Decimal Conversion Performance Research
+======================================
+
+This script demonstrates the performance vs precision trade-offs between different
+decimal conversion methods in the stock-indicators-python library.
+
+The library provides two methods for converting C# decimals to Python decimals:
+
+1. String-based conversion (default): High precision, slower performance
+2. Double-based conversion (alternative): Lower precision, much faster performance
+
+Results Summary:
+- Performance improvement: ~4.4x faster with double-based conversion
+- Precision trade-off: Small but measurable precision loss with floating-point arithmetic
+"""
+
+from decimal import Decimal as PyDecimal
+import time
+from stock_indicators._cstypes import Decimal as CsDecimal
+from stock_indicators._cstypes.decimal import to_pydecimal, to_pydecimal_via_double
+
+
+def demonstrate_precision_differences():
+ """Demonstrate precision differences between conversion methods."""
+ print("=== Precision Comparison ===\n")
+
+ test_values = [
+ 1996.1012,
+ 123.456789,
+ 0.123456789,
+ 999999.999999,
+ 1.8e-05,
+ 12345678901234567890.123456789,
+ ]
+
+ print(f"{'Value':<30} {'String Method':<35} {'Double Method':<35} {'Difference':<15}")
+ print("-" * 115)
+
+ for value in test_values:
+ try:
+ cs_decimal = CsDecimal(value)
+ string_result = to_pydecimal(cs_decimal)
+ double_result = to_pydecimal_via_double(cs_decimal)
+
+ difference = abs(string_result - double_result) if string_result != double_result else 0
+
+ print(f"{str(value):<30} {str(string_result):<35} {str(double_result):<35} {str(difference):<15}")
+ except Exception as e:
+ print(f"{str(value):<30} Error: {e}")
+
+ print()
+
+
+def demonstrate_performance_differences():
+ """Demonstrate performance differences between conversion methods."""
+ print("=== Performance Comparison ===\n")
+
+ # Create test data
+ test_values = [1996.1012, 123.456789, 0.123456789, 999999.999999] * 10000
+ cs_decimals = [CsDecimal(val) for val in test_values]
+
+ # Benchmark string conversion
+ start_time = time.perf_counter()
+ string_results = [to_pydecimal(cs_decimal) for cs_decimal in cs_decimals]
+ string_time = time.perf_counter() - start_time
+
+ # Benchmark double conversion
+ start_time = time.perf_counter()
+ double_results = [to_pydecimal_via_double(cs_decimal) for cs_decimal in cs_decimals]
+ double_time = time.perf_counter() - start_time
+
+ print(f"String-based conversion: {string_time:.4f} seconds")
+ print(f"Double-based conversion: {double_time:.4f} seconds")
+ print(f"Performance improvement: {string_time / double_time:.2f}x faster")
+ print()
+
+
+def recommend_usage():
+ """Provide recommendations for when to use each method."""
+ print("=== Usage Recommendations ===\n")
+
+ print("Use String-based conversion (to_pydecimal) when:")
+ print(" • Precision is critical (financial calculations, scientific computing)")
+ print(" • Working with very large numbers or high-precision decimals")
+ print(" • Backward compatibility is required")
+ print(" • Small performance overhead is acceptable")
+ print()
+
+ print("Consider Double-based conversion (to_pydecimal_via_double) when:")
+ print(" • Performance is critical and you're processing large datasets")
+ print(" • Small precision loss is acceptable for your use case")
+ print(" • Working with typical stock price data where floating-point precision is sufficient")
+ print(" • You need ~4x performance improvement in decimal conversions")
+ print()
+
+ print("Precision Loss Characteristics:")
+ print(" • Typical loss: 10^-14 to 10^-16 for normal values")
+ print(" • More significant loss with very large numbers (>10^15)")
+ print(" • Exponential notation values may have precision differences")
+ print()
+
+
+if __name__ == "__main__":
+ print("Stock Indicators Python - Decimal Conversion Research")
+ print("=" * 56)
+ print()
+
+ demonstrate_precision_differences()
+ demonstrate_performance_differences()
+ recommend_usage()
+
+ print("Note: This research demonstrates the trade-offs identified in GitHub issue #392")
+ print("The default string-based method remains unchanged for backward compatibility.")
\ No newline at end of file
diff --git a/stock_indicators/_cstypes/__init__.py b/stock_indicators/_cstypes/__init__.py
index f2e76b20..260fe8e4 100644
--- a/stock_indicators/_cstypes/__init__.py
+++ b/stock_indicators/_cstypes/__init__.py
@@ -3,5 +3,5 @@
from stock_indicators import _cslib
from .datetime import (DateTime, to_pydatetime)
-from .decimal import (Decimal, to_pydecimal)
+from .decimal import (Decimal, to_pydecimal, to_pydecimal_via_double)
from .list import (List)
diff --git a/stock_indicators/_cstypes/decimal.py b/stock_indicators/_cstypes/decimal.py
index d72972ef..1dd17b4f 100644
--- a/stock_indicators/_cstypes/decimal.py
+++ b/stock_indicators/_cstypes/decimal.py
@@ -33,3 +33,15 @@ def to_pydecimal(cs_decimal: CsDecimal) -> PyDecimal:
"""
if cs_decimal is not None:
return PyDecimal(cs_decimal.ToString(CsCultureInfo.InvariantCulture))
+
+
+def to_pydecimal_via_double(cs_decimal: CsDecimal) -> PyDecimal:
+ """
+ Converts an object to a native Python decimal object via double conversion.
+ This method offers better performance but may have precision loss.
+
+ Parameter:
+ cs_decimal : `System.Decimal` of C# or any `object` that can be represented as a number.
+ """
+ if cs_decimal is not None:
+ return PyDecimal(CsDecimal.ToDouble(cs_decimal))
diff --git a/tests/common/test_cstype_conversion.py b/tests/common/test_cstype_conversion.py
index bfeb832c..80e2293b 100644
--- a/tests/common/test_cstype_conversion.py
+++ b/tests/common/test_cstype_conversion.py
@@ -5,7 +5,7 @@
from stock_indicators._cslib import CsCultureInfo
from stock_indicators._cstypes import DateTime as CsDateTime
from stock_indicators._cstypes import Decimal as CsDecimal
-from stock_indicators._cstypes import to_pydatetime, to_pydecimal
+from stock_indicators._cstypes import to_pydatetime, to_pydecimal, to_pydecimal_via_double
class TestCsTypeConversion:
def test_datetime_conversion(self):
@@ -85,3 +85,21 @@ def test_large_decimal_conversion(self):
cs_decimal = CsDecimal(py_decimal)
assert to_pydecimal(cs_decimal) == PyDecimal(str(py_decimal))
+
+ def test_alternative_decimal_conversion_via_double(self):
+ """Test the alternative double-based conversion method."""
+ py_decimal = 1996.1012
+ cs_decimal = CsDecimal(py_decimal)
+
+ # Test that the function works (though precision may differ)
+ result = to_pydecimal_via_double(cs_decimal)
+ assert result is not None
+ assert isinstance(result, PyDecimal)
+
+ # The result should be close to the original, even if not exact
+ assert abs(float(result) - py_decimal) < 1e-10
+
+ def test_alternative_decimal_conversion_with_none(self):
+ """Test that the alternative method handles None correctly."""
+ result = to_pydecimal_via_double(None)
+ assert result is None
diff --git a/tests/common/test_decimal_conversion_comparison.py b/tests/common/test_decimal_conversion_comparison.py
new file mode 100644
index 00000000..97408570
--- /dev/null
+++ b/tests/common/test_decimal_conversion_comparison.py
@@ -0,0 +1,149 @@
+"""Tests comparing precision and performance of different decimal conversion methods."""
+
+from decimal import Decimal as PyDecimal
+import pytest
+
+from stock_indicators._cstypes import Decimal as CsDecimal
+from stock_indicators._cstypes.decimal import to_pydecimal, to_pydecimal_via_double
+
+
+class TestDecimalConversionComparison:
+ """Test precision differences between string and double conversion methods."""
+
+ def test_basic_decimal_conversion_comparison(self):
+ """Test basic decimal values for precision differences."""
+ test_values = [
+ 1996.1012,
+ 123.456789,
+ 0.123456789,
+ 999999.999999,
+ 0.000001,
+ 1000000.0,
+ ]
+
+ for py_decimal in test_values:
+ cs_decimal = CsDecimal(py_decimal)
+
+ string_result = to_pydecimal(cs_decimal)
+ double_result = to_pydecimal_via_double(cs_decimal)
+
+ # Check if they're the same
+ if string_result == double_result:
+ # No precision loss
+ assert string_result == double_result
+ else:
+ # Document precision loss
+ print(f"Precision difference for {py_decimal}:")
+ print(f" String method: {string_result}")
+ print(f" Double method: {double_result}")
+ print(f" Difference: {abs(string_result - double_result)}")
+
+ def test_exponential_notation_conversion_comparison(self):
+ """Test exponential notation values for precision differences."""
+ test_values = [
+ 1.8e-05,
+ 1.234e10,
+ 5.6789e-15,
+ 9.999e20,
+ ]
+
+ for py_decimal in test_values:
+ cs_decimal = CsDecimal(py_decimal)
+
+ string_result = to_pydecimal(cs_decimal)
+ double_result = to_pydecimal_via_double(cs_decimal)
+
+ print(f"Testing {py_decimal} (exponential notation):")
+ print(f" String method: {string_result}")
+ print(f" Double method: {double_result}")
+
+ # For exponential notation, we expect the string method to be more precise
+ if string_result != double_result:
+ print(f" Precision loss: {abs(string_result - double_result)}")
+
+ def test_large_decimal_conversion_comparison(self):
+ """Test large decimal values for precision differences."""
+ test_values = [
+ 12345678901234567890.123456789,
+ 999999999999999999.999999999,
+ 123456789012345.123456789,
+ ]
+
+ for py_decimal in test_values:
+ cs_decimal = CsDecimal(py_decimal)
+
+ string_result = to_pydecimal(cs_decimal)
+ double_result = to_pydecimal_via_double(cs_decimal)
+
+ print(f"Testing large decimal {py_decimal}:")
+ print(f" String method: {string_result}")
+ print(f" Double method: {double_result}")
+
+ # Large decimals are where we expect the most precision loss
+ if string_result != double_result:
+ precision_loss = abs(string_result - double_result)
+ relative_error = precision_loss / abs(string_result) if string_result != 0 else 0
+ print(f" Absolute precision loss: {precision_loss}")
+ print(f" Relative error: {relative_error:.2e}")
+
+ def test_high_precision_decimal_conversion_comparison(self):
+ """Test high precision decimal values."""
+ test_values = [
+ PyDecimal('3.141592653589793238462643383279502884197'),
+ PyDecimal('2.718281828459045235360287471352662497757'),
+ PyDecimal('1.414213562373095048801688724209698078569'),
+ PyDecimal('0.123456789012345678901234567890123456789'),
+ ]
+
+ for py_decimal in test_values:
+ cs_decimal = CsDecimal(str(py_decimal))
+
+ string_result = to_pydecimal(cs_decimal)
+ double_result = to_pydecimal_via_double(cs_decimal)
+
+ print(f"Testing high precision {py_decimal}:")
+ print(f" Original: {py_decimal}")
+ print(f" String method: {string_result}")
+ print(f" Double method: {double_result}")
+
+ # Compare precision loss
+ string_loss = abs(py_decimal - string_result)
+ double_loss = abs(py_decimal - double_result)
+
+ print(f" String precision loss: {string_loss}")
+ print(f" Double precision loss: {double_loss}")
+
+ def test_edge_cases_conversion_comparison(self):
+ """Test edge cases like very small and very large numbers."""
+ test_values = [
+ 1e-28, # Very small
+ 1e28, # Very large
+ 0.0, # Zero
+ -123.456, # Negative
+ float('inf') if hasattr(float, '__dict__') and 'inf' in str(float('inf')) else 1e308, # Large number as alternative
+ ]
+
+ for py_decimal in test_values:
+ try:
+ cs_decimal = CsDecimal(py_decimal)
+
+ string_result = to_pydecimal(cs_decimal)
+ double_result = to_pydecimal_via_double(cs_decimal)
+
+ print(f"Testing edge case {py_decimal}:")
+ print(f" String method: {string_result}")
+ print(f" Double method: {double_result}")
+
+ if string_result != double_result:
+ print(f" Difference: {abs(string_result - double_result)}")
+
+ except Exception as e:
+ print(f"Error testing {py_decimal}: {e}")
+
+ def test_none_input_handling(self):
+ """Test that both methods handle None input correctly."""
+ string_result = to_pydecimal(None)
+ double_result = to_pydecimal_via_double(None)
+
+ assert string_result is None
+ assert double_result is None
\ No newline at end of file
From a7f42f8e098e4262b4aa13d756220027ebf2bd9c Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Fri, 29 Aug 2025 00:19:52 +0000
Subject: [PATCH 03/10] Update all indicators to use faster decimal conversion
method
Co-authored-by: DaveSkender <8432125+DaveSkender@users.noreply.github.com>
---
benchmark_sample.json | 261 +++++++++++++
decimal_benchmark.json | 368 ++++++++++++++++++
stock_indicators/indicators/atr_stop.py | 8 +-
stock_indicators/indicators/common/candles.py | 12 +-
stock_indicators/indicators/common/quote.py | 22 +-
stock_indicators/indicators/donchian.py | 10 +-
stock_indicators/indicators/fcb.py | 6 +-
stock_indicators/indicators/fractal.py | 6 +-
stock_indicators/indicators/heikin_ashi.py | 12 +-
stock_indicators/indicators/ichimoku.py | 12 +-
stock_indicators/indicators/pivot_points.py | 20 +-
stock_indicators/indicators/pivots.py | 10 +-
stock_indicators/indicators/renko.py | 12 +-
stock_indicators/indicators/rolling_pivots.py | 20 +-
stock_indicators/indicators/slope.py | 4 +-
stock_indicators/indicators/super_trend.py | 8 +-
stock_indicators/indicators/zig_zag.py | 8 +-
17 files changed, 714 insertions(+), 85 deletions(-)
create mode 100644 benchmark_sample.json
create mode 100644 decimal_benchmark.json
diff --git a/benchmark_sample.json b/benchmark_sample.json
new file mode 100644
index 00000000..3a48b382
--- /dev/null
+++ b/benchmark_sample.json
@@ -0,0 +1,261 @@
+{
+ "machine_info": {
+ "node": "pkrvmccyg1gnepe",
+ "processor": "x86_64",
+ "machine": "x86_64",
+ "python_compiler": "GCC 13.3.0",
+ "python_implementation": "CPython",
+ "python_implementation_version": "3.12.3",
+ "python_version": "3.12.3",
+ "python_build": [
+ "main",
+ "Aug 14 2025 17:47:21"
+ ],
+ "release": "6.11.0-1018-azure",
+ "system": "Linux",
+ "cpu": {
+ "python_version": "3.12.3.final.0 (64 bit)",
+ "cpuinfo_version": [
+ 9,
+ 0,
+ 0
+ ],
+ "cpuinfo_version_string": "9.0.0",
+ "arch": "X86_64",
+ "bits": 64,
+ "count": 4,
+ "arch_string_raw": "x86_64",
+ "vendor_id_raw": "AuthenticAMD",
+ "brand_raw": "AMD EPYC 7763 64-Core Processor",
+ "hz_advertised_friendly": "3.2409 GHz",
+ "hz_actual_friendly": "3.2409 GHz",
+ "hz_advertised": [
+ 3240884000,
+ 0
+ ],
+ "hz_actual": [
+ 3240884000,
+ 0
+ ],
+ "stepping": 1,
+ "model": 1,
+ "family": 25,
+ "flags": [
+ "3dnowext",
+ "3dnowprefetch",
+ "abm",
+ "adx",
+ "aes",
+ "aperfmperf",
+ "apic",
+ "arat",
+ "avx",
+ "avx2",
+ "bmi1",
+ "bmi2",
+ "clflush",
+ "clflushopt",
+ "clwb",
+ "clzero",
+ "cmov",
+ "cmp_legacy",
+ "constant_tsc",
+ "cpuid",
+ "cr8_legacy",
+ "cx16",
+ "cx8",
+ "de",
+ "decodeassists",
+ "erms",
+ "extd_apicid",
+ "f16c",
+ "flushbyasid",
+ "fma",
+ "fpu",
+ "fsgsbase",
+ "fsrm",
+ "fxsr",
+ "fxsr_opt",
+ "ht",
+ "hypervisor",
+ "invpcid",
+ "lahf_lm",
+ "lm",
+ "mca",
+ "mce",
+ "misalignsse",
+ "mmx",
+ "mmxext",
+ "movbe",
+ "msr",
+ "mtrr",
+ "nonstop_tsc",
+ "nopl",
+ "npt",
+ "nrip_save",
+ "nx",
+ "osvw",
+ "osxsave",
+ "pae",
+ "pat",
+ "pausefilter",
+ "pcid",
+ "pclmulqdq",
+ "pdpe1gb",
+ "pfthreshold",
+ "pge",
+ "pni",
+ "popcnt",
+ "pse",
+ "pse36",
+ "rdpid",
+ "rdpru",
+ "rdrand",
+ "rdrnd",
+ "rdseed",
+ "rdtscp",
+ "rep_good",
+ "sep",
+ "sha",
+ "sha_ni",
+ "smap",
+ "smep",
+ "sse",
+ "sse2",
+ "sse4_1",
+ "sse4_2",
+ "sse4a",
+ "ssse3",
+ "svm",
+ "syscall",
+ "topoext",
+ "tsc",
+ "tsc_known_freq",
+ "tsc_reliable",
+ "tsc_scale",
+ "umip",
+ "user_shstk",
+ "v_vmsave_vmload",
+ "vaes",
+ "vmcb_clean",
+ "vme",
+ "vmmcall",
+ "vpclmulqdq",
+ "xgetbv1",
+ "xsave",
+ "xsavec",
+ "xsaveerptr",
+ "xsaveopt",
+ "xsaves"
+ ],
+ "l3_cache_size": 524288,
+ "l2_cache_size": 1048576,
+ "l1_data_cache_size": 65536,
+ "l1_instruction_cache_size": 65536,
+ "l2_cache_line_size": 512,
+ "l2_cache_associativity": 6
+ }
+ },
+ "commit_info": {
+ "id": "afd8571f32ddd9c4046f35d44be5d0f2f1c9463a",
+ "time": "2025-08-22T23:55:10Z",
+ "author_time": "2025-08-22T23:55:10Z",
+ "dirty": true,
+ "project": "stock-indicators-python",
+ "branch": "copilot/fix-392"
+ },
+ "benchmarks": [
+ {
+ "group": null,
+ "name": "test_benchmark_rsi",
+ "fullname": "benchmarks/test_benchmark_indicators.py::TestPerformance::test_benchmark_rsi",
+ "params": null,
+ "param": null,
+ "extra_info": {},
+ "options": {
+ "disable_gc": false,
+ "timer": "perf_counter",
+ "min_rounds": 5,
+ "max_time": 1.0,
+ "min_time": 5e-06,
+ "warmup": false
+ },
+ "stats": {
+ "min": 0.004117928999960441,
+ "max": 0.013795678999997563,
+ "mean": 0.0047654412641540975,
+ "stddev": 0.0016516754227122268,
+ "rounds": 53,
+ "median": 0.00432412300000351,
+ "iqr": 0.0003096714999770711,
+ "q1": 0.004292769750009029,
+ "q3": 0.0046024412499861,
+ "iqr_outliers": 5,
+ "stddev_outliers": 2,
+ "outliers": "2;5",
+ "ld15iqr": 0.004117928999960441,
+ "hd15iqr": 0.0050827120000462855,
+ "ops": 209.84415599076905,
+ "total": 0.25256838700016715,
+ "data": [
+ 0.004580091999969227,
+ 0.004422116999990067,
+ 0.013795678999997563,
+ 0.004366281999978128,
+ 0.004225759999997081,
+ 0.004235747999985051,
+ 0.004223445000036463,
+ 0.004206474000000071,
+ 0.011844792999966103,
+ 0.0045093900000097165,
+ 0.004313873999990392,
+ 0.004351004000000103,
+ 0.004283387000043604,
+ 0.0042905910000285985,
+ 0.004296802999988358,
+ 0.004322300000012547,
+ 0.004293496000002506,
+ 0.004338329999995949,
+ 0.004311410000013893,
+ 0.004333369999983461,
+ 0.004312050000010004,
+ 0.004320806999999149,
+ 0.0043358959999864055,
+ 0.0043086640000069565,
+ 0.004302082000037899,
+ 0.00432412300000351,
+ 0.004307621999998901,
+ 0.004326467999987926,
+ 0.004293646000007811,
+ 0.004287755999996534,
+ 0.0042568480000113595,
+ 0.005241398000009667,
+ 0.00427911999997832,
+ 0.004302371999983734,
+ 0.006015285000046333,
+ 0.004374427000016112,
+ 0.004283697999994729,
+ 0.0050827120000462855,
+ 0.004117928999960441,
+ 0.0041739819999975225,
+ 0.004212424999991526,
+ 0.004307622999988325,
+ 0.004365762000020368,
+ 0.004572388000042338,
+ 0.004558742000028815,
+ 0.0046694890000367195,
+ 0.004747805000022254,
+ 0.004778744000020652,
+ 0.004727838000007978,
+ 0.004700225999954455,
+ 0.0047361030000274695,
+ 0.004718600999979117,
+ 0.004681410999978652
+ ],
+ "iterations": 1
+ }
+ }
+ ],
+ "datetime": "2025-08-29T00:19:11.069407+00:00",
+ "version": "5.1.0"
+}
\ No newline at end of file
diff --git a/decimal_benchmark.json b/decimal_benchmark.json
new file mode 100644
index 00000000..dc445eba
--- /dev/null
+++ b/decimal_benchmark.json
@@ -0,0 +1,368 @@
+{
+ "machine_info": {
+ "node": "pkrvmccyg1gnepe",
+ "processor": "x86_64",
+ "machine": "x86_64",
+ "python_compiler": "GCC 13.3.0",
+ "python_implementation": "CPython",
+ "python_implementation_version": "3.12.3",
+ "python_version": "3.12.3",
+ "python_build": [
+ "main",
+ "Aug 14 2025 17:47:21"
+ ],
+ "release": "6.11.0-1018-azure",
+ "system": "Linux",
+ "cpu": {
+ "python_version": "3.12.3.final.0 (64 bit)",
+ "cpuinfo_version": [
+ 9,
+ 0,
+ 0
+ ],
+ "cpuinfo_version_string": "9.0.0",
+ "arch": "X86_64",
+ "bits": 64,
+ "count": 4,
+ "arch_string_raw": "x86_64",
+ "vendor_id_raw": "AuthenticAMD",
+ "brand_raw": "AMD EPYC 7763 64-Core Processor",
+ "hz_advertised_friendly": "3.1897 GHz",
+ "hz_actual_friendly": "3.1897 GHz",
+ "hz_advertised": [
+ 3189697000,
+ 0
+ ],
+ "hz_actual": [
+ 3189697000,
+ 0
+ ],
+ "stepping": 1,
+ "model": 1,
+ "family": 25,
+ "flags": [
+ "3dnowext",
+ "3dnowprefetch",
+ "abm",
+ "adx",
+ "aes",
+ "aperfmperf",
+ "apic",
+ "arat",
+ "avx",
+ "avx2",
+ "bmi1",
+ "bmi2",
+ "clflush",
+ "clflushopt",
+ "clwb",
+ "clzero",
+ "cmov",
+ "cmp_legacy",
+ "constant_tsc",
+ "cpuid",
+ "cr8_legacy",
+ "cx16",
+ "cx8",
+ "de",
+ "decodeassists",
+ "erms",
+ "extd_apicid",
+ "f16c",
+ "flushbyasid",
+ "fma",
+ "fpu",
+ "fsgsbase",
+ "fsrm",
+ "fxsr",
+ "fxsr_opt",
+ "ht",
+ "hypervisor",
+ "invpcid",
+ "lahf_lm",
+ "lm",
+ "mca",
+ "mce",
+ "misalignsse",
+ "mmx",
+ "mmxext",
+ "movbe",
+ "msr",
+ "mtrr",
+ "nonstop_tsc",
+ "nopl",
+ "npt",
+ "nrip_save",
+ "nx",
+ "osvw",
+ "osxsave",
+ "pae",
+ "pat",
+ "pausefilter",
+ "pcid",
+ "pclmulqdq",
+ "pdpe1gb",
+ "pfthreshold",
+ "pge",
+ "pni",
+ "popcnt",
+ "pse",
+ "pse36",
+ "rdpid",
+ "rdpru",
+ "rdrand",
+ "rdrnd",
+ "rdseed",
+ "rdtscp",
+ "rep_good",
+ "sep",
+ "sha",
+ "sha_ni",
+ "smap",
+ "smep",
+ "sse",
+ "sse2",
+ "sse4_1",
+ "sse4_2",
+ "sse4a",
+ "ssse3",
+ "svm",
+ "syscall",
+ "topoext",
+ "tsc",
+ "tsc_known_freq",
+ "tsc_reliable",
+ "tsc_scale",
+ "umip",
+ "user_shstk",
+ "v_vmsave_vmload",
+ "vaes",
+ "vmcb_clean",
+ "vme",
+ "vmmcall",
+ "vpclmulqdq",
+ "xgetbv1",
+ "xsave",
+ "xsavec",
+ "xsaveerptr",
+ "xsaveopt",
+ "xsaves"
+ ],
+ "l3_cache_size": 524288,
+ "l2_cache_size": 1048576,
+ "l1_data_cache_size": 65536,
+ "l1_instruction_cache_size": 65536,
+ "l2_cache_line_size": 512,
+ "l2_cache_associativity": 6
+ }
+ },
+ "commit_info": {
+ "id": "afd8571f32ddd9c4046f35d44be5d0f2f1c9463a",
+ "time": "2025-08-22T23:55:10Z",
+ "author_time": "2025-08-22T23:55:10Z",
+ "dirty": true,
+ "project": "stock-indicators-python",
+ "branch": "copilot/fix-392"
+ },
+ "benchmarks": [
+ {
+ "group": null,
+ "name": "test_benchmark_string_conversion",
+ "fullname": "benchmarks/test_decimal_conversion_performance.py::TestDecimalConversionPerformance::test_benchmark_string_conversion",
+ "params": null,
+ "param": null,
+ "extra_info": {},
+ "options": {
+ "disable_gc": false,
+ "timer": "perf_counter",
+ "min_rounds": 5,
+ "max_time": 1.0,
+ "min_time": 5e-06,
+ "warmup": false
+ },
+ "stats": {
+ "min": 0.7325220469999749,
+ "max": 0.7649998720000326,
+ "mean": 0.7484877762000111,
+ "stddev": 0.01293506082654267,
+ "rounds": 5,
+ "median": 0.7438407870000106,
+ "iqr": 0.01932975200000442,
+ "q1": 0.7404289295000126,
+ "q3": 0.759758681500017,
+ "iqr_outliers": 0,
+ "stddev_outliers": 2,
+ "outliers": "2;0",
+ "ld15iqr": 0.7325220469999749,
+ "hd15iqr": 0.7649998720000326,
+ "ops": 1.3360271627639513,
+ "total": 3.742438881000055,
+ "data": [
+ 0.7649998720000326,
+ 0.7580116180000118,
+ 0.7438407870000106,
+ 0.7325220469999749,
+ 0.7430645570000252
+ ],
+ "iterations": 1
+ }
+ },
+ {
+ "group": null,
+ "name": "test_benchmark_double_conversion",
+ "fullname": "benchmarks/test_decimal_conversion_performance.py::TestDecimalConversionPerformance::test_benchmark_double_conversion",
+ "params": null,
+ "param": null,
+ "extra_info": {},
+ "options": {
+ "disable_gc": false,
+ "timer": "perf_counter",
+ "min_rounds": 5,
+ "max_time": 1.0,
+ "min_time": 5e-06,
+ "warmup": false
+ },
+ "stats": {
+ "min": 0.1825159699999972,
+ "max": 0.18806874099999504,
+ "mean": 0.18591620700001008,
+ "stddev": 0.0020690422297870207,
+ "rounds": 6,
+ "median": 0.18601237650000257,
+ "iqr": 0.0030443619999687144,
+ "q1": 0.18492170800004715,
+ "q3": 0.18796607000001586,
+ "iqr_outliers": 0,
+ "stddev_outliers": 2,
+ "outliers": "2;0",
+ "ld15iqr": 0.1825159699999972,
+ "hd15iqr": 0.18806874099999504,
+ "ops": 5.378767220654119,
+ "total": 1.1154972420000604,
+ "data": [
+ 0.18796607000001586,
+ 0.18806874099999504,
+ 0.18602239500000906,
+ 0.1825159699999972,
+ 0.1860023579999961,
+ 0.18492170800004715
+ ],
+ "iterations": 1
+ }
+ },
+ {
+ "group": null,
+ "name": "test_benchmark_small_dataset_string_conversion",
+ "fullname": "benchmarks/test_decimal_conversion_performance.py::TestDecimalConversionPerformance::test_benchmark_small_dataset_string_conversion",
+ "params": null,
+ "param": null,
+ "extra_info": {},
+ "options": {
+ "disable_gc": false,
+ "timer": "perf_counter",
+ "min_rounds": 5,
+ "max_time": 1.0,
+ "min_time": 5e-06,
+ "warmup": false
+ },
+ "stats": {
+ "min": 0.11232148100003769,
+ "max": 0.130109377999986,
+ "mean": 0.11914829611111423,
+ "stddev": 0.00519572324269448,
+ "rounds": 9,
+ "median": 0.11796109599998772,
+ "iqr": 0.0037342927499963707,
+ "q1": 0.11647189075000597,
+ "q3": 0.12020618350000234,
+ "iqr_outliers": 1,
+ "stddev_outliers": 3,
+ "outliers": "3;1",
+ "ld15iqr": 0.11232148100003769,
+ "hd15iqr": 0.130109377999986,
+ "ops": 8.392902228894899,
+ "total": 1.072334665000028,
+ "data": [
+ 0.12453965499997821,
+ 0.11808340400000361,
+ 0.11610276999999769,
+ 0.11659493100000873,
+ 0.11876169300001038,
+ 0.11796109599998772,
+ 0.11232148100003769,
+ 0.11786025700001801,
+ 0.130109377999986
+ ],
+ "iterations": 1
+ }
+ },
+ {
+ "group": null,
+ "name": "test_benchmark_small_dataset_double_conversion",
+ "fullname": "benchmarks/test_decimal_conversion_performance.py::TestDecimalConversionPerformance::test_benchmark_small_dataset_double_conversion",
+ "params": null,
+ "param": null,
+ "extra_info": {},
+ "options": {
+ "disable_gc": false,
+ "timer": "perf_counter",
+ "min_rounds": 5,
+ "max_time": 1.0,
+ "min_time": 5e-06,
+ "warmup": false
+ },
+ "stats": {
+ "min": 0.02704283100001703,
+ "max": 0.03192401600000494,
+ "mean": 0.028659376206897784,
+ "stddev": 0.0012744020134468667,
+ "rounds": 29,
+ "median": 0.02932063000002927,
+ "iqr": 0.0022160254999903373,
+ "q1": 0.027243878500001983,
+ "q3": 0.02945990399999232,
+ "iqr_outliers": 0,
+ "stddev_outliers": 9,
+ "outliers": "9;0",
+ "ld15iqr": 0.02704283100001703,
+ "hd15iqr": 0.03192401600000494,
+ "ops": 34.892594757848165,
+ "total": 0.8311219100000358,
+ "data": [
+ 0.027566559999968376,
+ 0.029905132000010326,
+ 0.027739352999958555,
+ 0.0297897660000217,
+ 0.03192401600000494,
+ 0.02725564799999347,
+ 0.0294210569999791,
+ 0.027102441000010913,
+ 0.029439872000011746,
+ 0.029437568000048486,
+ 0.027056555999990906,
+ 0.029217895999977372,
+ 0.02716995800000177,
+ 0.029346398000029694,
+ 0.029442916999983026,
+ 0.02710562800001526,
+ 0.029510865000020203,
+ 0.02704283100001703,
+ 0.02932063000002927,
+ 0.029763548000005358,
+ 0.02720857000002752,
+ 0.029396952000013243,
+ 0.02717985599997519,
+ 0.02958176699996784,
+ 0.029708996000010757,
+ 0.02742982399996663,
+ 0.02936918899996499,
+ 0.029105046000040602,
+ 0.027583069999991494
+ ],
+ "iterations": 1
+ }
+ }
+ ],
+ "datetime": "2025-08-29T00:19:35.472239+00:00",
+ "version": "5.1.0"
+}
\ No newline at end of file
diff --git a/stock_indicators/indicators/atr_stop.py b/stock_indicators/indicators/atr_stop.py
index 140b1774..7816ec92 100644
--- a/stock_indicators/indicators/atr_stop.py
+++ b/stock_indicators/indicators/atr_stop.py
@@ -4,7 +4,7 @@
from stock_indicators._cslib import CsIndicator
from stock_indicators._cstypes import List as CsList
from stock_indicators._cstypes import Decimal as CsDecimal
-from stock_indicators._cstypes import to_pydecimal
+from stock_indicators._cstypes import to_pydecimal_via_double
from stock_indicators.indicators.common.enums import EndType
from stock_indicators.indicators.common.helpers import CondenseMixin, RemoveWarmupMixin
from stock_indicators.indicators.common.results import IndicatorResults, ResultBase
@@ -51,7 +51,7 @@ class AtrStopResult(ResultBase):
@property
def atr_stop(self) -> Optional[Decimal]:
- return to_pydecimal(self._csdata.AtrStop)
+ return to_pydecimal_via_double(self._csdata.AtrStop)
@atr_stop.setter
def atr_stop(self, value):
@@ -59,7 +59,7 @@ def atr_stop(self, value):
@property
def buy_stop(self) -> Optional[Decimal]:
- return to_pydecimal(self._csdata.BuyStop)
+ return to_pydecimal_via_double(self._csdata.BuyStop)
@buy_stop.setter
def buy_stop(self, value):
@@ -67,7 +67,7 @@ def buy_stop(self, value):
@property
def sell_stop(self) -> Optional[Decimal]:
- return to_pydecimal(self._csdata.SellStop)
+ return to_pydecimal_via_double(self._csdata.SellStop)
@sell_stop.setter
def sell_stop(self, value):
diff --git a/stock_indicators/indicators/common/candles.py b/stock_indicators/indicators/common/candles.py
index a6345fab..c166b83b 100644
--- a/stock_indicators/indicators/common/candles.py
+++ b/stock_indicators/indicators/common/candles.py
@@ -4,7 +4,7 @@
from stock_indicators._cslib import CsCandleProperties
from stock_indicators._cstypes import Decimal as CsDecimal
-from stock_indicators._cstypes import to_pydecimal
+from stock_indicators._cstypes import to_pydecimal_via_double
from stock_indicators.indicators.common._contrib.type_resolver import generate_cs_inherited_class
from stock_indicators.indicators.common.enums import Match
from stock_indicators.indicators.common.helpers import CondenseMixin
@@ -15,24 +15,24 @@
class _CandleProperties(_Quote):
@property
def size(self) -> Optional[Decimal]:
- return to_pydecimal(self.High - self.Low)
+ return to_pydecimal_via_double(self.High - self.Low)
@property
def body(self) -> Optional[Decimal]:
- return to_pydecimal(self.Open - self.Close \
+ return to_pydecimal_via_double(self.Open - self.Close \
if (self.Open > self.Close) \
else self.Close - self.Open)
@property
def upper_wick(self) -> Optional[Decimal]:
- return to_pydecimal(self.High - (
+ return to_pydecimal_via_double(self.High - (
self.Open \
if self.Open > self.Close \
else self.Close))
@property
def lower_wick(self) -> Optional[Decimal]:
- return to_pydecimal((self.Close \
+ return to_pydecimal_via_double((self.Close \
if self.Open > self.Close \
else self.Open) - self.Low)
@@ -70,7 +70,7 @@ class CandleResult(ResultBase):
@property
def price(self) -> Optional[Decimal]:
- return to_pydecimal(self._csdata.Price)
+ return to_pydecimal_via_double(self._csdata.Price)
@price.setter
def price(self, value):
diff --git a/stock_indicators/indicators/common/quote.py b/stock_indicators/indicators/common/quote.py
index dd986851..1cde4b4f 100644
--- a/stock_indicators/indicators/common/quote.py
+++ b/stock_indicators/indicators/common/quote.py
@@ -6,7 +6,7 @@
from stock_indicators._cstypes import List as CsList
from stock_indicators._cstypes import DateTime as CsDateTime
from stock_indicators._cstypes import Decimal as CsDecimal
-from stock_indicators._cstypes import to_pydatetime, to_pydecimal
+from stock_indicators._cstypes import to_pydatetime, to_pydecimal_via_double
from stock_indicators.indicators.common.enums import CandlePart
from stock_indicators.indicators.common._contrib.type_resolver import generate_cs_inherited_class
@@ -20,31 +20,31 @@ def _set_date(quote, value):
quote.Date = CsDateTime(value)
def _get_open(quote):
- return to_pydecimal(quote.Open)
+ return to_pydecimal_via_double(quote.Open)
def _set_open(quote, value):
quote.Open = CsDecimal(value)
def _get_high(quote):
- return to_pydecimal(quote.High)
+ return to_pydecimal_via_double(quote.High)
def _set_high(quote, value):
quote.High = CsDecimal(value)
def _get_low(quote):
- return to_pydecimal(quote.Low)
+ return to_pydecimal_via_double(quote.Low)
def _set_low(quote, value):
quote.Low = CsDecimal(value)
def _get_close(quote):
- return to_pydecimal(quote.Close)
+ return to_pydecimal_via_double(quote.Close)
def _set_close(quote, value):
quote.Close = CsDecimal(value)
def _get_volume(quote):
- return to_pydecimal(quote.Volume)
+ return to_pydecimal_via_double(quote.Volume)
def _set_volume(quote, value):
quote.Volume = CsDecimal(value)
@@ -72,11 +72,11 @@ def from_csquote(cls, cs_quote: CsQuote):
"""Constructs `Quote` instance from C# `Quote` instance."""
return cls(
date=to_pydatetime(cs_quote.Date),
- open=to_pydecimal(cs_quote.Open),
- high=to_pydecimal(cs_quote.High),
- low=to_pydecimal(cs_quote.Low),
- close=to_pydecimal(cs_quote.Close),
- volume=to_pydecimal(cs_quote.Volume)
+ open=to_pydecimal_via_double(cs_quote.Open),
+ high=to_pydecimal_via_double(cs_quote.High),
+ low=to_pydecimal_via_double(cs_quote.Low),
+ close=to_pydecimal_via_double(cs_quote.Close),
+ volume=to_pydecimal_via_double(cs_quote.Volume)
)
@classmethod
diff --git a/stock_indicators/indicators/donchian.py b/stock_indicators/indicators/donchian.py
index f577e109..e53795a4 100644
--- a/stock_indicators/indicators/donchian.py
+++ b/stock_indicators/indicators/donchian.py
@@ -4,7 +4,7 @@
from stock_indicators._cslib import CsIndicator
from stock_indicators._cstypes import List as CsList
from stock_indicators._cstypes import Decimal as CsDecimal
-from stock_indicators._cstypes import to_pydecimal
+from stock_indicators._cstypes import to_pydecimal_via_double
from stock_indicators.indicators.common.helpers import CondenseMixin, RemoveWarmupMixin
from stock_indicators.indicators.common.results import IndicatorResults, ResultBase
from stock_indicators.indicators.common.quote import Quote
@@ -41,7 +41,7 @@ class DonchianResult(ResultBase):
@property
def upper_band(self) -> Optional[Decimal]:
- return to_pydecimal(self._csdata.UpperBand)
+ return to_pydecimal_via_double(self._csdata.UpperBand)
@upper_band.setter
def upper_band(self, value):
@@ -49,7 +49,7 @@ def upper_band(self, value):
@property
def lower_band(self) -> Optional[Decimal]:
- return to_pydecimal(self._csdata.LowerBand)
+ return to_pydecimal_via_double(self._csdata.LowerBand)
@lower_band.setter
def lower_band(self, value):
@@ -57,7 +57,7 @@ def lower_band(self, value):
@property
def center_line(self) -> Optional[Decimal]:
- return to_pydecimal(self._csdata.Centerline)
+ return to_pydecimal_via_double(self._csdata.Centerline)
@center_line.setter
def center_line(self, value):
@@ -65,7 +65,7 @@ def center_line(self, value):
@property
def width(self) -> Optional[Decimal]:
- return to_pydecimal(self._csdata.Width)
+ return to_pydecimal_via_double(self._csdata.Width)
@width.setter
def width(self, value):
diff --git a/stock_indicators/indicators/fcb.py b/stock_indicators/indicators/fcb.py
index a7c6615b..543ac805 100644
--- a/stock_indicators/indicators/fcb.py
+++ b/stock_indicators/indicators/fcb.py
@@ -4,7 +4,7 @@
from stock_indicators._cslib import CsIndicator
from stock_indicators._cstypes import List as CsList
from stock_indicators._cstypes import Decimal as CsDecimal
-from stock_indicators._cstypes import to_pydecimal
+from stock_indicators._cstypes import to_pydecimal_via_double
from stock_indicators.indicators.common.helpers import CondenseMixin, RemoveWarmupMixin
from stock_indicators.indicators.common.results import IndicatorResults, ResultBase
from stock_indicators.indicators.common.quote import Quote
@@ -43,7 +43,7 @@ class FCBResult(ResultBase):
@property
def upper_band(self) -> Optional[Decimal]:
- return to_pydecimal(self._csdata.UpperBand)
+ return to_pydecimal_via_double(self._csdata.UpperBand)
@upper_band.setter
def upper_band(self, value):
@@ -51,7 +51,7 @@ def upper_band(self, value):
@property
def lower_band(self) -> Optional[Decimal]:
- return to_pydecimal(self._csdata.LowerBand)
+ return to_pydecimal_via_double(self._csdata.LowerBand)
@lower_band.setter
def lower_band(self, value):
diff --git a/stock_indicators/indicators/fractal.py b/stock_indicators/indicators/fractal.py
index 18548d63..eeb1880b 100644
--- a/stock_indicators/indicators/fractal.py
+++ b/stock_indicators/indicators/fractal.py
@@ -4,7 +4,7 @@
from stock_indicators._cslib import CsIndicator
from stock_indicators._cstypes import List as CsList
from stock_indicators._cstypes import Decimal as CsDecimal
-from stock_indicators._cstypes import to_pydecimal
+from stock_indicators._cstypes import to_pydecimal_via_double
from stock_indicators.indicators.common.enums import EndType
from stock_indicators.indicators.common.helpers import CondenseMixin
from stock_indicators.indicators.common.results import IndicatorResults, ResultBase
@@ -61,7 +61,7 @@ class FractalResult(ResultBase):
@property
def fractal_bear(self) -> Optional[Decimal]:
- return to_pydecimal(self._csdata.FractalBear)
+ return to_pydecimal_via_double(self._csdata.FractalBear)
@fractal_bear.setter
def fractal_bear(self, value):
@@ -69,7 +69,7 @@ def fractal_bear(self, value):
@property
def fractal_bull(self) -> Optional[Decimal]:
- return to_pydecimal(self._csdata.FractalBull)
+ return to_pydecimal_via_double(self._csdata.FractalBull)
@fractal_bull.setter
def fractal_bull(self, value):
diff --git a/stock_indicators/indicators/heikin_ashi.py b/stock_indicators/indicators/heikin_ashi.py
index 02674d0c..42ab6da4 100644
--- a/stock_indicators/indicators/heikin_ashi.py
+++ b/stock_indicators/indicators/heikin_ashi.py
@@ -4,7 +4,7 @@
from stock_indicators._cslib import CsIndicator
from stock_indicators._cstypes import List as CsList
from stock_indicators._cstypes import Decimal as CsDecimal
-from stock_indicators._cstypes import to_pydecimal
+from stock_indicators._cstypes import to_pydecimal_via_double
from stock_indicators.indicators.common.results import IndicatorResults, ResultBase
from stock_indicators.indicators.common.quote import Quote
@@ -37,7 +37,7 @@ class HeikinAshiResult(ResultBase):
@property
def open(self) -> Decimal:
- return to_pydecimal(self._csdata.Open)
+ return to_pydecimal_via_double(self._csdata.Open)
@open.setter
def open(self, value):
@@ -45,7 +45,7 @@ def open(self, value):
@property
def high(self) -> Decimal:
- return to_pydecimal(self._csdata.High)
+ return to_pydecimal_via_double(self._csdata.High)
@high.setter
def high(self, value):
@@ -53,7 +53,7 @@ def high(self, value):
@property
def low(self) -> Decimal:
- return to_pydecimal(self._csdata.Low)
+ return to_pydecimal_via_double(self._csdata.Low)
@low.setter
def low(self, value):
@@ -61,7 +61,7 @@ def low(self, value):
@property
def close(self) -> Decimal:
- return to_pydecimal(self._csdata.Close)
+ return to_pydecimal_via_double(self._csdata.Close)
@close.setter
def close(self, value):
@@ -69,7 +69,7 @@ def close(self, value):
@property
def volume(self) -> Decimal:
- return to_pydecimal(self._csdata.Volume)
+ return to_pydecimal_via_double(self._csdata.Volume)
@volume.setter
def volume(self, value):
diff --git a/stock_indicators/indicators/ichimoku.py b/stock_indicators/indicators/ichimoku.py
index 5a11444d..21648a9a 100644
--- a/stock_indicators/indicators/ichimoku.py
+++ b/stock_indicators/indicators/ichimoku.py
@@ -4,7 +4,7 @@
from stock_indicators._cslib import CsIndicator
from stock_indicators._cstypes import List as CsList
from stock_indicators._cstypes import Decimal as CsDecimal
-from stock_indicators._cstypes import to_pydecimal
+from stock_indicators._cstypes import to_pydecimal_via_double
from stock_indicators.indicators.common.helpers import CondenseMixin
from stock_indicators.indicators.common.results import IndicatorResults, ResultBase
from stock_indicators.indicators.common.quote import Quote
@@ -81,7 +81,7 @@ class IchimokuResult(ResultBase):
@property
def tenkan_sen(self) -> Optional[Decimal]:
- return to_pydecimal(self._csdata.TenkanSen)
+ return to_pydecimal_via_double(self._csdata.TenkanSen)
@tenkan_sen.setter
def tenkan_sen(self, value):
@@ -89,7 +89,7 @@ def tenkan_sen(self, value):
@property
def kijun_sen(self) -> Optional[Decimal]:
- return to_pydecimal(self._csdata.KijunSen)
+ return to_pydecimal_via_double(self._csdata.KijunSen)
@kijun_sen.setter
def kijun_sen(self, value):
@@ -97,7 +97,7 @@ def kijun_sen(self, value):
@property
def senkou_span_a(self) -> Optional[Decimal]:
- return to_pydecimal(self._csdata.SenkouSpanA)
+ return to_pydecimal_via_double(self._csdata.SenkouSpanA)
@senkou_span_a.setter
def senkou_span_a(self, value):
@@ -105,7 +105,7 @@ def senkou_span_a(self, value):
@property
def senkou_span_b(self) -> Optional[Decimal]:
- return to_pydecimal(self._csdata.SenkouSpanB)
+ return to_pydecimal_via_double(self._csdata.SenkouSpanB)
@senkou_span_b.setter
def senkou_span_b(self, value):
@@ -113,7 +113,7 @@ def senkou_span_b(self, value):
@property
def chikou_span(self) -> Optional[Decimal]:
- return to_pydecimal(self._csdata.ChikouSpan)
+ return to_pydecimal_via_double(self._csdata.ChikouSpan)
@chikou_span.setter
def chikou_span(self, value):
diff --git a/stock_indicators/indicators/pivot_points.py b/stock_indicators/indicators/pivot_points.py
index e7379b24..25118843 100644
--- a/stock_indicators/indicators/pivot_points.py
+++ b/stock_indicators/indicators/pivot_points.py
@@ -4,7 +4,7 @@
from stock_indicators._cslib import CsIndicator
from stock_indicators._cstypes import List as CsList
from stock_indicators._cstypes import Decimal as CsDecimal
-from stock_indicators._cstypes import to_pydecimal
+from stock_indicators._cstypes import to_pydecimal_via_double
from stock_indicators.indicators.common.enums import PeriodSize, PivotPointType
from stock_indicators.indicators.common.helpers import RemoveWarmupMixin
from stock_indicators.indicators.common.results import IndicatorResults, ResultBase
@@ -49,7 +49,7 @@ class PivotPointsResult(ResultBase):
@property
def r4(self) -> Optional[Decimal]:
- return to_pydecimal(self._csdata.R4)
+ return to_pydecimal_via_double(self._csdata.R4)
@r4.setter
def r4(self, value):
@@ -57,7 +57,7 @@ def r4(self, value):
@property
def r3(self) -> Optional[Decimal]:
- return to_pydecimal(self._csdata.R3)
+ return to_pydecimal_via_double(self._csdata.R3)
@r3.setter
def r3(self, value):
@@ -65,7 +65,7 @@ def r3(self, value):
@property
def r2(self) -> Optional[Decimal]:
- return to_pydecimal(self._csdata.R2)
+ return to_pydecimal_via_double(self._csdata.R2)
@r2.setter
def r2(self, value):
@@ -73,7 +73,7 @@ def r2(self, value):
@property
def r1(self) -> Optional[Decimal]:
- return to_pydecimal(self._csdata.R1)
+ return to_pydecimal_via_double(self._csdata.R1)
@r1.setter
def r1(self, value):
@@ -81,7 +81,7 @@ def r1(self, value):
@property
def pp(self) -> Optional[Decimal]:
- return to_pydecimal(self._csdata.PP)
+ return to_pydecimal_via_double(self._csdata.PP)
@pp.setter
def pp(self, value):
@@ -89,7 +89,7 @@ def pp(self, value):
@property
def s1(self) -> Optional[Decimal]:
- return to_pydecimal(self._csdata.S1)
+ return to_pydecimal_via_double(self._csdata.S1)
@s1.setter
def s1(self, value):
@@ -97,7 +97,7 @@ def s1(self, value):
@property
def s2(self) -> Optional[Decimal]:
- return to_pydecimal(self._csdata.S2)
+ return to_pydecimal_via_double(self._csdata.S2)
@s2.setter
def s2(self, value):
@@ -105,7 +105,7 @@ def s2(self, value):
@property
def s3(self) -> Optional[Decimal]:
- return to_pydecimal(self._csdata.S3)
+ return to_pydecimal_via_double(self._csdata.S3)
@s3.setter
def s3(self, value):
@@ -113,7 +113,7 @@ def s3(self, value):
@property
def s4(self) -> Optional[Decimal]:
- return to_pydecimal(self._csdata.S4)
+ return to_pydecimal_via_double(self._csdata.S4)
@s4.setter
def s4(self, value):
diff --git a/stock_indicators/indicators/pivots.py b/stock_indicators/indicators/pivots.py
index 26540ea9..4904e1a8 100644
--- a/stock_indicators/indicators/pivots.py
+++ b/stock_indicators/indicators/pivots.py
@@ -4,7 +4,7 @@
from stock_indicators._cslib import CsIndicator
from stock_indicators._cstypes import List as CsList
from stock_indicators._cstypes import Decimal as CsDecimal
-from stock_indicators._cstypes import to_pydecimal
+from stock_indicators._cstypes import to_pydecimal_via_double
from stock_indicators.indicators.common.enums import EndType, PivotTrend
from stock_indicators.indicators.common.helpers import CondenseMixin
from stock_indicators.indicators.common.results import IndicatorResults, ResultBase
@@ -57,7 +57,7 @@ class PivotsResult(ResultBase):
@property
def high_point(self) -> Optional[Decimal]:
- return to_pydecimal(self._csdata.HighPoint)
+ return to_pydecimal_via_double(self._csdata.HighPoint)
@high_point.setter
def high_point(self, value):
@@ -65,7 +65,7 @@ def high_point(self, value):
@property
def low_point(self) -> Optional[Decimal]:
- return to_pydecimal(self._csdata.LowPoint)
+ return to_pydecimal_via_double(self._csdata.LowPoint)
@low_point.setter
def low_point(self, value):
@@ -73,7 +73,7 @@ def low_point(self, value):
@property
def high_line(self) -> Optional[Decimal]:
- return to_pydecimal(self._csdata.HighLine)
+ return to_pydecimal_via_double(self._csdata.HighLine)
@high_line.setter
def high_line(self, value):
@@ -81,7 +81,7 @@ def high_line(self, value):
@property
def low_line(self) -> Optional[Decimal]:
- return to_pydecimal(self._csdata.LowLine)
+ return to_pydecimal_via_double(self._csdata.LowLine)
@low_line.setter
def low_line(self, value):
diff --git a/stock_indicators/indicators/renko.py b/stock_indicators/indicators/renko.py
index b06e12c1..51b57a98 100644
--- a/stock_indicators/indicators/renko.py
+++ b/stock_indicators/indicators/renko.py
@@ -4,7 +4,7 @@
from stock_indicators._cslib import CsIndicator
from stock_indicators._cstypes import List as CsList
from stock_indicators._cstypes import Decimal as CsDecimal
-from stock_indicators._cstypes import to_pydecimal
+from stock_indicators._cstypes import to_pydecimal_via_double
from stock_indicators.indicators.common.enums import EndType
from stock_indicators.indicators.common.results import IndicatorResults, ResultBase
from stock_indicators.indicators.common.quote import Quote
@@ -77,7 +77,7 @@ class RenkoResult(ResultBase):
@property
def open(self) -> Decimal:
- return to_pydecimal(self._csdata.Open)
+ return to_pydecimal_via_double(self._csdata.Open)
@open.setter
def open(self, value):
@@ -85,7 +85,7 @@ def open(self, value):
@property
def high(self) -> Decimal:
- return to_pydecimal(self._csdata.High)
+ return to_pydecimal_via_double(self._csdata.High)
@high.setter
def high(self, value):
@@ -93,7 +93,7 @@ def high(self, value):
@property
def low(self) -> Decimal:
- return to_pydecimal(self._csdata.Low)
+ return to_pydecimal_via_double(self._csdata.Low)
@low.setter
def low(self, value):
@@ -101,7 +101,7 @@ def low(self, value):
@property
def close(self) -> Decimal:
- return to_pydecimal(self._csdata.Close)
+ return to_pydecimal_via_double(self._csdata.Close)
@close.setter
def close(self, value):
@@ -109,7 +109,7 @@ def close(self, value):
@property
def volume(self) -> Decimal:
- return to_pydecimal(self._csdata.Volume)
+ return to_pydecimal_via_double(self._csdata.Volume)
@volume.setter
def volume(self, value):
diff --git a/stock_indicators/indicators/rolling_pivots.py b/stock_indicators/indicators/rolling_pivots.py
index 44267dc0..647a48d3 100644
--- a/stock_indicators/indicators/rolling_pivots.py
+++ b/stock_indicators/indicators/rolling_pivots.py
@@ -4,7 +4,7 @@
from stock_indicators._cslib import CsIndicator
from stock_indicators._cstypes import List as CsList
from stock_indicators._cstypes import Decimal as CsDecimal
-from stock_indicators._cstypes import to_pydecimal
+from stock_indicators._cstypes import to_pydecimal_via_double
from stock_indicators.indicators.common.enums import PivotPointType
from stock_indicators.indicators.common.helpers import RemoveWarmupMixin
from stock_indicators.indicators.common.results import IndicatorResults, ResultBase
@@ -51,7 +51,7 @@ class RollingPivotsResult(ResultBase):
@property
def r4(self) -> Optional[Decimal]:
- return to_pydecimal(self._csdata.R4)
+ return to_pydecimal_via_double(self._csdata.R4)
@r4.setter
def r4(self, value):
@@ -59,7 +59,7 @@ def r4(self, value):
@property
def r3(self) -> Optional[Decimal]:
- return to_pydecimal(self._csdata.R3)
+ return to_pydecimal_via_double(self._csdata.R3)
@r3.setter
def r3(self, value):
@@ -67,7 +67,7 @@ def r3(self, value):
@property
def r2(self) -> Optional[Decimal]:
- return to_pydecimal(self._csdata.R2)
+ return to_pydecimal_via_double(self._csdata.R2)
@r2.setter
def r2(self, value):
@@ -75,7 +75,7 @@ def r2(self, value):
@property
def r1(self) -> Optional[Decimal]:
- return to_pydecimal(self._csdata.R1)
+ return to_pydecimal_via_double(self._csdata.R1)
@r1.setter
def r1(self, value):
@@ -83,7 +83,7 @@ def r1(self, value):
@property
def pp(self) -> Optional[Decimal]:
- return to_pydecimal(self._csdata.PP)
+ return to_pydecimal_via_double(self._csdata.PP)
@pp.setter
def pp(self, value):
@@ -91,7 +91,7 @@ def pp(self, value):
@property
def s1(self) -> Optional[Decimal]:
- return to_pydecimal(self._csdata.S1)
+ return to_pydecimal_via_double(self._csdata.S1)
@s1.setter
def s1(self, value):
@@ -99,7 +99,7 @@ def s1(self, value):
@property
def s2(self) -> Optional[Decimal]:
- return to_pydecimal(self._csdata.S2)
+ return to_pydecimal_via_double(self._csdata.S2)
@s2.setter
def s2(self, value):
@@ -107,7 +107,7 @@ def s2(self, value):
@property
def s3(self) -> Optional[Decimal]:
- return to_pydecimal(self._csdata.S3)
+ return to_pydecimal_via_double(self._csdata.S3)
@s3.setter
def s3(self, value):
@@ -115,7 +115,7 @@ def s3(self, value):
@property
def s4(self) -> Optional[Decimal]:
- return to_pydecimal(self._csdata.S4)
+ return to_pydecimal_via_double(self._csdata.S4)
@s4.setter
def s4(self, value):
diff --git a/stock_indicators/indicators/slope.py b/stock_indicators/indicators/slope.py
index 40457b93..5ccc79b6 100644
--- a/stock_indicators/indicators/slope.py
+++ b/stock_indicators/indicators/slope.py
@@ -4,7 +4,7 @@
from stock_indicators._cslib import CsIndicator
from stock_indicators._cstypes import List as CsList
from stock_indicators._cstypes import Decimal as CsDecimal
-from stock_indicators._cstypes import to_pydecimal
+from stock_indicators._cstypes import to_pydecimal_via_double
from stock_indicators.indicators.common.helpers import CondenseMixin, RemoveWarmupMixin
from stock_indicators.indicators.common.results import IndicatorResults, ResultBase
from stock_indicators.indicators.common.quote import Quote
@@ -74,7 +74,7 @@ def r_squared(self, value):
@property
def line(self) -> Optional[Decimal]:
- return to_pydecimal(self._csdata.Line)
+ return to_pydecimal_via_double(self._csdata.Line)
@line.setter
def line(self, value):
diff --git a/stock_indicators/indicators/super_trend.py b/stock_indicators/indicators/super_trend.py
index 012d237b..5bd3d236 100644
--- a/stock_indicators/indicators/super_trend.py
+++ b/stock_indicators/indicators/super_trend.py
@@ -4,7 +4,7 @@
from stock_indicators._cslib import CsIndicator
from stock_indicators._cstypes import List as CsList
from stock_indicators._cstypes import Decimal as CsDecimal
-from stock_indicators._cstypes import to_pydecimal
+from stock_indicators._cstypes import to_pydecimal_via_double
from stock_indicators.indicators.common.helpers import CondenseMixin, RemoveWarmupMixin
from stock_indicators.indicators.common.results import IndicatorResults, ResultBase
from stock_indicators.indicators.common.quote import Quote
@@ -46,7 +46,7 @@ class SuperTrendResult(ResultBase):
@property
def super_trend(self) -> Optional[Decimal]:
- return to_pydecimal(self._csdata.SuperTrend)
+ return to_pydecimal_via_double(self._csdata.SuperTrend)
@super_trend.setter
def super_trend(self, value):
@@ -54,7 +54,7 @@ def super_trend(self, value):
@property
def upper_band(self) -> Optional[Decimal]:
- return to_pydecimal(self._csdata.UpperBand)
+ return to_pydecimal_via_double(self._csdata.UpperBand)
@upper_band.setter
def upper_band(self, value):
@@ -62,7 +62,7 @@ def upper_band(self, value):
@property
def lower_band(self) -> Optional[Decimal]:
- return to_pydecimal(self._csdata.LowerBand)
+ return to_pydecimal_via_double(self._csdata.LowerBand)
@lower_band.setter
def lower_band(self, value):
diff --git a/stock_indicators/indicators/zig_zag.py b/stock_indicators/indicators/zig_zag.py
index 7ccb2165..b3a49ba7 100644
--- a/stock_indicators/indicators/zig_zag.py
+++ b/stock_indicators/indicators/zig_zag.py
@@ -4,7 +4,7 @@
from stock_indicators._cslib import CsIndicator
from stock_indicators._cstypes import List as CsList
from stock_indicators._cstypes import Decimal as CsDecimal
-from stock_indicators._cstypes import to_pydecimal
+from stock_indicators._cstypes import to_pydecimal_via_double
from stock_indicators.indicators.common.enums import EndType
from stock_indicators.indicators.common.helpers import CondenseMixin
from stock_indicators.indicators.common.results import IndicatorResults, ResultBase
@@ -48,7 +48,7 @@ class ZigZagResult(ResultBase):
@property
def zig_zag(self) -> Optional[Decimal]:
- return to_pydecimal(self._csdata.ZigZag)
+ return to_pydecimal_via_double(self._csdata.ZigZag)
@zig_zag.setter
def zig_zag(self, value):
@@ -64,7 +64,7 @@ def point_type(self, value):
@property
def retrace_high(self) -> Optional[Decimal]:
- return to_pydecimal(self._csdata.RetraceHigh)
+ return to_pydecimal_via_double(self._csdata.RetraceHigh)
@retrace_high.setter
def retrace_high(self, value):
@@ -72,7 +72,7 @@ def retrace_high(self, value):
@property
def retrace_low(self) -> Optional[Decimal]:
- return to_pydecimal(self._csdata.RetraceLow)
+ return to_pydecimal_via_double(self._csdata.RetraceLow)
@retrace_low.setter
def retrace_low(self, value):
From 6529ffb15354c0f7bd15cc53d103ac77362cefe7 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Fri, 29 Aug 2025 00:20:47 +0000
Subject: [PATCH 04/10] Final verification - all indicators now use 4x faster
conversion method
Co-authored-by: DaveSkender <8432125+DaveSkender@users.noreply.github.com>
---
sample_indicators.json | 830 +++++++++++++++++++++++++++++++++++++++++
1 file changed, 830 insertions(+)
create mode 100644 sample_indicators.json
diff --git a/sample_indicators.json b/sample_indicators.json
new file mode 100644
index 00000000..5fbcf3c5
--- /dev/null
+++ b/sample_indicators.json
@@ -0,0 +1,830 @@
+{
+ "machine_info": {
+ "node": "pkrvmccyg1gnepe",
+ "processor": "x86_64",
+ "machine": "x86_64",
+ "python_compiler": "GCC 13.3.0",
+ "python_implementation": "CPython",
+ "python_implementation_version": "3.12.3",
+ "python_version": "3.12.3",
+ "python_build": [
+ "main",
+ "Aug 14 2025 17:47:21"
+ ],
+ "release": "6.11.0-1018-azure",
+ "system": "Linux",
+ "cpu": {
+ "python_version": "3.12.3.final.0 (64 bit)",
+ "cpuinfo_version": [
+ 9,
+ 0,
+ 0
+ ],
+ "cpuinfo_version_string": "9.0.0",
+ "arch": "X86_64",
+ "bits": 64,
+ "count": 4,
+ "arch_string_raw": "x86_64",
+ "vendor_id_raw": "AuthenticAMD",
+ "brand_raw": "AMD EPYC 7763 64-Core Processor",
+ "hz_advertised_friendly": "3.2696 GHz",
+ "hz_actual_friendly": "3.2696 GHz",
+ "hz_advertised": [
+ 3269647000,
+ 0
+ ],
+ "hz_actual": [
+ 3269647000,
+ 0
+ ],
+ "stepping": 1,
+ "model": 1,
+ "family": 25,
+ "flags": [
+ "3dnowext",
+ "3dnowprefetch",
+ "abm",
+ "adx",
+ "aes",
+ "aperfmperf",
+ "apic",
+ "arat",
+ "avx",
+ "avx2",
+ "bmi1",
+ "bmi2",
+ "clflush",
+ "clflushopt",
+ "clwb",
+ "clzero",
+ "cmov",
+ "cmp_legacy",
+ "constant_tsc",
+ "cpuid",
+ "cr8_legacy",
+ "cx16",
+ "cx8",
+ "de",
+ "decodeassists",
+ "erms",
+ "extd_apicid",
+ "f16c",
+ "flushbyasid",
+ "fma",
+ "fpu",
+ "fsgsbase",
+ "fsrm",
+ "fxsr",
+ "fxsr_opt",
+ "ht",
+ "hypervisor",
+ "invpcid",
+ "lahf_lm",
+ "lm",
+ "mca",
+ "mce",
+ "misalignsse",
+ "mmx",
+ "mmxext",
+ "movbe",
+ "msr",
+ "mtrr",
+ "nonstop_tsc",
+ "nopl",
+ "npt",
+ "nrip_save",
+ "nx",
+ "osvw",
+ "osxsave",
+ "pae",
+ "pat",
+ "pausefilter",
+ "pcid",
+ "pclmulqdq",
+ "pdpe1gb",
+ "pfthreshold",
+ "pge",
+ "pni",
+ "popcnt",
+ "pse",
+ "pse36",
+ "rdpid",
+ "rdpru",
+ "rdrand",
+ "rdrnd",
+ "rdseed",
+ "rdtscp",
+ "rep_good",
+ "sep",
+ "sha",
+ "sha_ni",
+ "smap",
+ "smep",
+ "sse",
+ "sse2",
+ "sse4_1",
+ "sse4_2",
+ "sse4a",
+ "ssse3",
+ "svm",
+ "syscall",
+ "topoext",
+ "tsc",
+ "tsc_known_freq",
+ "tsc_reliable",
+ "tsc_scale",
+ "umip",
+ "user_shstk",
+ "v_vmsave_vmload",
+ "vaes",
+ "vmcb_clean",
+ "vme",
+ "vmmcall",
+ "vpclmulqdq",
+ "xgetbv1",
+ "xsave",
+ "xsavec",
+ "xsaveerptr",
+ "xsaveopt",
+ "xsaves"
+ ],
+ "l3_cache_size": 524288,
+ "l2_cache_size": 1048576,
+ "l1_data_cache_size": 65536,
+ "l1_instruction_cache_size": 65536,
+ "l2_cache_line_size": 512,
+ "l2_cache_associativity": 6
+ }
+ },
+ "commit_info": {
+ "id": "a7f42f8e098e4262b4aa13d756220027ebf2bd9c",
+ "time": "2025-08-29T00:19:52Z",
+ "author_time": "2025-08-29T00:19:52Z",
+ "dirty": false,
+ "project": "stock-indicators-python",
+ "branch": "copilot/fix-392"
+ },
+ "benchmarks": [
+ {
+ "group": null,
+ "name": "test_benchmark_adl",
+ "fullname": "benchmarks/test_benchmark_indicators.py::TestPerformance::test_benchmark_adl",
+ "params": null,
+ "param": null,
+ "extra_info": {},
+ "options": {
+ "disable_gc": false,
+ "timer": "perf_counter",
+ "min_rounds": 5,
+ "max_time": 1.0,
+ "min_time": 5e-06,
+ "warmup": false
+ },
+ "stats": {
+ "min": 0.004155546999982107,
+ "max": 0.013560205000032965,
+ "mean": 0.0047062188500007094,
+ "stddev": 0.0014954287159835418,
+ "rounds": 60,
+ "median": 0.0043053374999999505,
+ "iqr": 0.0003481554999780201,
+ "q1": 0.004267045500000677,
+ "q3": 0.004615200999978697,
+ "iqr_outliers": 3,
+ "stddev_outliers": 2,
+ "outliers": "2;3",
+ "ld15iqr": 0.004155546999982107,
+ "hd15iqr": 0.00592049700003372,
+ "ops": 212.48480614110184,
+ "total": 0.2823731310000426,
+ "data": [
+ 0.004623871999967832,
+ 0.00440846000003603,
+ 0.013560205000032965,
+ 0.00441229599999815,
+ 0.004255884000031074,
+ 0.004243299999984629,
+ 0.004237900999953581,
+ 0.004218875999981719,
+ 0.011387143000035849,
+ 0.0043632459999685125,
+ 0.0042923529999825405,
+ 0.004293135000011716,
+ 0.004270561999987876,
+ 0.004275841999969998,
+ 0.004271304000042164,
+ 0.004277043999991292,
+ 0.004281010999989121,
+ 0.004290329000014026,
+ 0.004304525999998532,
+ 0.004306149000001369,
+ 0.004298092999988512,
+ 0.004312370000036481,
+ 0.0042932740000196645,
+ 0.0043090140000003885,
+ 0.0043227500000284635,
+ 0.004336315000045943,
+ 0.004284337000001415,
+ 0.004268297999999504,
+ 0.004297371999996358,
+ 0.004250072999980148,
+ 0.005015595000031681,
+ 0.004257568000014089,
+ 0.00424249999997528,
+ 0.00592049700003372,
+ 0.004265291999956844,
+ 0.004264892000037435,
+ 0.004253210000001673,
+ 0.00426579300000185,
+ 0.00473475899997311,
+ 0.0041887489999794525,
+ 0.004155546999982107,
+ 0.004191283000011481,
+ 0.0042725760000053015,
+ 0.004259842999999819,
+ 0.004561615999989499,
+ 0.004513916999997036,
+ 0.004671901999984129,
+ 0.004745950999961224,
+ 0.0047050649999960115,
+ 0.004673295000031885,
+ 0.0046419759999594135,
+ 0.00509457300000804,
+ 0.004690156999970441,
+ 0.004634272000032524,
+ 0.0046841660000040974,
+ 0.0046065299999895615,
+ 0.004580862000011621,
+ 0.004590629999995599,
+ 0.004570472000011705,
+ 0.004574309000020094
+ ],
+ "iterations": 1
+ }
+ },
+ {
+ "group": null,
+ "name": "test_benchmark_adx",
+ "fullname": "benchmarks/test_benchmark_indicators.py::TestPerformance::test_benchmark_adx",
+ "params": null,
+ "param": null,
+ "extra_info": {},
+ "options": {
+ "disable_gc": false,
+ "timer": "perf_counter",
+ "min_rounds": 5,
+ "max_time": 1.0,
+ "min_time": 5e-06,
+ "warmup": false
+ },
+ "stats": {
+ "min": 0.0030446910000136995,
+ "max": 0.005754725999963739,
+ "mean": 0.00458679419148816,
+ "stddev": 0.000572037585613571,
+ "rounds": 141,
+ "median": 0.00461690899999212,
+ "iqr": 0.000997692500050107,
+ "q1": 0.0040995994999804,
+ "q3": 0.005097292000030507,
+ "iqr_outliers": 0,
+ "stddev_outliers": 36,
+ "outliers": "36;0",
+ "ld15iqr": 0.0030446910000136995,
+ "hd15iqr": 0.005754725999963739,
+ "ops": 218.01719419975882,
+ "total": 0.6467379809998306,
+ "data": [
+ 0.005027217000019846,
+ 0.004721455000037622,
+ 0.004696217999992314,
+ 0.0046790559999863035,
+ 0.004686529999958111,
+ 0.004655531999958384,
+ 0.004676320999976724,
+ 0.004643750000013824,
+ 0.004625386000043363,
+ 0.00461690899999212,
+ 0.004604075000031571,
+ 0.005508204999955524,
+ 0.00466282500002535,
+ 0.0046315970000136986,
+ 0.004577996000023177,
+ 0.004588236000017787,
+ 0.0046025830000075985,
+ 0.004563640000014857,
+ 0.004608023000002959,
+ 0.004588866999995389,
+ 0.004569611000022178,
+ 0.004571655000006558,
+ 0.004593064999994567,
+ 0.004574609999963286,
+ 0.004750138000019888,
+ 0.004796665000014855,
+ 0.004720613999950274,
+ 0.0047768080000309965,
+ 0.004794410999977572,
+ 0.0049881830000231275,
+ 0.005038667999997415,
+ 0.0049740970000016205,
+ 0.00502009300004147,
+ 0.00547067499996956,
+ 0.00512747400000535,
+ 0.005055669999990187,
+ 0.005014562000042133,
+ 0.005121583000004648,
+ 0.0051362299999482275,
+ 0.005028760000016064,
+ 0.005031704999964859,
+ 0.005079783999974552,
+ 0.0050880000000006476,
+ 0.005093560000034358,
+ 0.00511472000005142,
+ 0.005119659000001775,
+ 0.005110291999983474,
+ 0.005133154000020568,
+ 0.005108488000018951,
+ 0.005091687000003731,
+ 0.005164723999996568,
+ 0.005147761999978684,
+ 0.00513556900000367,
+ 0.005157839999981206,
+ 0.005733206000002156,
+ 0.00531195899998238,
+ 0.005212703000040619,
+ 0.005216870999959156,
+ 0.005193517000009251,
+ 0.005263206999984504,
+ 0.005543221000039011,
+ 0.00530662799997117,
+ 0.0053240419999838196,
+ 0.005291730000010375,
+ 0.005280700000014349,
+ 0.005362451999985751,
+ 0.005301840000015545,
+ 0.0052218199999742865,
+ 0.005238511000015933,
+ 0.0052701409999826865,
+ 0.00551115100000743,
+ 0.0054032799999959025,
+ 0.005149765999988176,
+ 0.005025843999987956,
+ 0.00480440000001181,
+ 0.004752182999993693,
+ 0.005256345000020701,
+ 0.004850886999975046,
+ 0.004823676000000887,
+ 0.004854414000021734,
+ 0.004740449999985685,
+ 0.004558599999995749,
+ 0.004223373999991509,
+ 0.0042903890000047795,
+ 0.004154003999985889,
+ 0.004141711000045234,
+ 0.004158642999982476,
+ 0.004141951000008248,
+ 0.0041843209999683495,
+ 0.004132805000040207,
+ 0.004117936999989524,
+ 0.004130470000006881,
+ 0.004109421000009661,
+ 0.004108720000033372,
+ 0.004117616000030466,
+ 0.00411882800000285,
+ 0.004104611999991903,
+ 0.004094242999997277,
+ 0.004585781000002953,
+ 0.004100753999978224,
+ 0.004090285000017957,
+ 0.004096135999986927,
+ 0.004067722999991474,
+ 0.004070748999993157,
+ 0.004079004000004716,
+ 0.004068134000021928,
+ 0.004064507000009598,
+ 0.004328318999966996,
+ 0.005754725999963739,
+ 0.004190832999995564,
+ 0.004179692000036539,
+ 0.004122524999957022,
+ 0.004068233999987569,
+ 0.004048566999983905,
+ 0.004069736999952056,
+ 0.004052094000030593,
+ 0.004054047000010996,
+ 0.004075257000010879,
+ 0.0040471939999520146,
+ 0.004181475999985196,
+ 0.004442814000015005,
+ 0.004052163999972436,
+ 0.004047424999953364,
+ 0.004033849999984795,
+ 0.004025404000003618,
+ 0.004004234999968048,
+ 0.004005866999989394,
+ 0.004020294999975249,
+ 0.0039975319999712156,
+ 0.003992663000019547,
+ 0.004028608999988137,
+ 0.004041583999992326,
+ 0.004009724000013648,
+ 0.0038875770000004195,
+ 0.003574741999955222,
+ 0.0037509530000079394,
+ 0.0032807019999836484,
+ 0.0031931080000049405,
+ 0.0030658300000254712,
+ 0.0030446910000136995,
+ 0.003044912000007116
+ ],
+ "iterations": 1
+ }
+ },
+ {
+ "group": null,
+ "name": "test_benchmark_atr",
+ "fullname": "benchmarks/test_benchmark_indicators.py::TestPerformance::test_benchmark_atr",
+ "params": null,
+ "param": null,
+ "extra_info": {},
+ "options": {
+ "disable_gc": false,
+ "timer": "perf_counter",
+ "min_rounds": 5,
+ "max_time": 1.0,
+ "min_time": 5e-06,
+ "warmup": false
+ },
+ "stats": {
+ "min": 0.0016491220000034446,
+ "max": 0.011764949999985674,
+ "mean": 0.002450997012121289,
+ "stddev": 0.0008844536612553618,
+ "rounds": 165,
+ "median": 0.0023368580000351358,
+ "iqr": 0.00034969999997258583,
+ "q1": 0.0022588612500271665,
+ "q3": 0.0026085612499997524,
+ "iqr_outliers": 34,
+ "stddev_outliers": 8,
+ "outliers": "8;34",
+ "ld15iqr": 0.0017573960000163424,
+ "hd15iqr": 0.0032836169999654885,
+ "ops": 407.997233393002,
+ "total": 0.4044145070000127,
+ "data": [
+ 0.002898517999994965,
+ 0.0026494319999983418,
+ 0.011764949999985674,
+ 0.0027047549999679177,
+ 0.0026453840000044693,
+ 0.0026259179999783555,
+ 0.002609205999988262,
+ 0.0026156790000300134,
+ 0.002611080999997739,
+ 0.0026076640000383122,
+ 0.0026773040000307446,
+ 0.002626228999986324,
+ 0.002595611000003828,
+ 0.0026115510000295217,
+ 0.002625045999991471,
+ 0.0026316989999486395,
+ 0.0026084460000106446,
+ 0.0026497019999851545,
+ 0.0026242550000006304,
+ 0.0026113609999924847,
+ 0.003107208000017181,
+ 0.0026374900000405432,
+ 0.002639914999974735,
+ 0.002665300999979081,
+ 0.002595451000047433,
+ 0.0025911930000006578,
+ 0.0025916239999901336,
+ 0.0025722070000142594,
+ 0.002592595999999503,
+ 0.0025847210000051746,
+ 0.002600430000029519,
+ 0.002583277999974598,
+ 0.0025938680000194836,
+ 0.002721516999997675,
+ 0.002605809999977282,
+ 0.0025899710000203413,
+ 0.0025875769999856857,
+ 0.0025804329999914444,
+ 0.002592074999995475,
+ 0.0026089069999670755,
+ 0.0026278920000208927,
+ 0.0025877969999896777,
+ 0.0030395410000210177,
+ 0.0025991379999936726,
+ 0.0025878159999592754,
+ 0.002590031000011095,
+ 0.0025883179999937056,
+ 0.0025780790000453635,
+ 0.0025622400000315793,
+ 0.002563921999978902,
+ 0.002632339999991018,
+ 0.002559895000047163,
+ 0.002556147999996483,
+ 0.0025720069999692896,
+ 0.0025640729999736322,
+ 0.00255368300003056,
+ 0.003643780999993851,
+ 0.0026043269999718177,
+ 0.002625818000012714,
+ 0.0033978810000121484,
+ 0.004245265000008658,
+ 0.004235246000007464,
+ 0.004112727000006089,
+ 0.004050231000007898,
+ 0.004660701999966932,
+ 0.0032836169999654885,
+ 0.002723750999962249,
+ 0.002677785000003041,
+ 0.0026321190000544448,
+ 0.002582536999966578,
+ 0.0024976779999974497,
+ 0.0024397900000394657,
+ 0.0023368580000351358,
+ 0.0023128419999807193,
+ 0.0023412360000065746,
+ 0.0023929220000127316,
+ 0.0023210279999830163,
+ 0.0023080539999682514,
+ 0.0022852719999946203,
+ 0.0023090060000185986,
+ 0.002328151999961392,
+ 0.002346245000012459,
+ 0.0023081940000224677,
+ 0.0023014920000150596,
+ 0.0023231929999951717,
+ 0.0022669470000096226,
+ 0.0027005569999687395,
+ 0.002288977999967301,
+ 0.0022766950000345787,
+ 0.002284040000006371,
+ 0.0022729280000248764,
+ 0.002264703000037116,
+ 0.0022736089999852993,
+ 0.002258871000037743,
+ 0.002264642999989519,
+ 0.0022588319999954365,
+ 0.002284549999956198,
+ 0.00227035400001796,
+ 0.0022701520000509845,
+ 0.0022638810000330523,
+ 0.002274430999989363,
+ 0.0022657950000279925,
+ 0.002267848999963462,
+ 0.0022606750000022657,
+ 0.002302584000005936,
+ 0.0022746810000171536,
+ 0.00228185499997835,
+ 0.0023537099999657585,
+ 0.0027249429999756103,
+ 0.0023245950000045923,
+ 0.002375981000000138,
+ 0.002293256999962523,
+ 0.0023103789999936453,
+ 0.002289909999944939,
+ 0.002264351999997416,
+ 0.0023058200000036777,
+ 0.0022827669999969658,
+ 0.002347367000027134,
+ 0.002275983999993514,
+ 0.002274993000014547,
+ 0.002282186999991609,
+ 0.0022545649999869966,
+ 0.002260945999978503,
+ 0.002217436000023554,
+ 0.0021643559999802164,
+ 0.0021457420000388083,
+ 0.002132156000016039,
+ 0.0021618310000235397,
+ 0.0020814420000192513,
+ 0.002020517000005384,
+ 0.002399835999995048,
+ 0.002041386000030343,
+ 0.0018751949999682438,
+ 0.001816715999950702,
+ 0.001923285999964719,
+ 0.0017573960000163424,
+ 0.001692864999995436,
+ 0.0016777459999843813,
+ 0.0016665050000028714,
+ 0.0016569370000070194,
+ 0.0016661540000200148,
+ 0.0016496339999889642,
+ 0.0016670159999989664,
+ 0.0016662549999750809,
+ 0.0016491220000034446,
+ 0.0016712439999650996,
+ 0.0016776859999936278,
+ 0.0016515869999693678,
+ 0.0016615769999930308,
+ 0.001669420999974136,
+ 0.001686142000039581,
+ 0.0016696420000243961,
+ 0.0020427390000463674,
+ 0.0016927849999888167,
+ 0.0016948589999969954,
+ 0.001654773000041132,
+ 0.001675653000006605,
+ 0.002834097999993901,
+ 0.0022707549999836374,
+ 0.001687074000017219,
+ 0.0017340520000175275,
+ 0.0017175709999719402,
+ 0.0017265380000139885,
+ 0.0016989160000093761,
+ 0.0018924679999940963
+ ],
+ "iterations": 1
+ }
+ },
+ {
+ "group": null,
+ "name": "test_benchmark_rsi",
+ "fullname": "benchmarks/test_benchmark_indicators.py::TestPerformance::test_benchmark_rsi",
+ "params": null,
+ "param": null,
+ "extra_info": {},
+ "options": {
+ "disable_gc": false,
+ "timer": "perf_counter",
+ "min_rounds": 5,
+ "max_time": 1.0,
+ "min_time": 5e-06,
+ "warmup": false
+ },
+ "stats": {
+ "min": 0.0016467390000229898,
+ "max": 0.01064789499997687,
+ "mean": 0.0018119636275843794,
+ "stddev": 0.000760554472376585,
+ "rounds": 145,
+ "median": 0.0016945369999916693,
+ "iqr": 4.666499998506879e-05,
+ "q1": 0.001680679250014805,
+ "q3": 0.0017273442499998737,
+ "iqr_outliers": 17,
+ "stddev_outliers": 3,
+ "outliers": "3;17",
+ "ld15iqr": 0.0016467390000229898,
+ "hd15iqr": 0.0018006469999818364,
+ "ops": 551.8874577704138,
+ "total": 0.262734725999735,
+ "data": [
+ 0.0020465050000098017,
+ 0.001769777999982125,
+ 0.001805704999981117,
+ 0.0017745370000170624,
+ 0.0017038760000218645,
+ 0.0017124419999845486,
+ 0.0017146960000218314,
+ 0.0021638349999761886,
+ 0.00171552699998756,
+ 0.0016897290000201792,
+ 0.0016831469999942783,
+ 0.0017001879999725134,
+ 0.0017188929999747415,
+ 0.001675261999992017,
+ 0.001669259999971473,
+ 0.0016617069999824707,
+ 0.0016740799999865885,
+ 0.0017130429999951957,
+ 0.001681293000046935,
+ 0.0016773659999671509,
+ 0.0016797799999608287,
+ 0.0016827359999638247,
+ 0.001667757999996411,
+ 0.0016764339999895128,
+ 0.001684578999970654,
+ 0.0016723960000035731,
+ 0.0016821140000047308,
+ 0.0016867730000171832,
+ 0.01064789499997687,
+ 0.0017289830000208894,
+ 0.0021686039999622153,
+ 0.001710127000023931,
+ 0.0016967109999654895,
+ 0.0016823249999902146,
+ 0.0017787860000453293,
+ 0.0017518750000249383,
+ 0.0017668130000174642,
+ 0.002015236999966419,
+ 0.002654712999969888,
+ 0.0017500619999850642,
+ 0.0017346529999713312,
+ 0.0018006469999818364,
+ 0.001709306000009292,
+ 0.0017362259999913476,
+ 0.0017249039999569504,
+ 0.0017069109999852117,
+ 0.0017526859999748012,
+ 0.0022172349999891594,
+ 0.001723752999964745,
+ 0.001690160000009655,
+ 0.001692404000039005,
+ 0.0016828759999611975,
+ 0.001698545000010654,
+ 0.0021166479999692456,
+ 0.001700938999988466,
+ 0.0016797499999938736,
+ 0.0016948179999758395,
+ 0.0016971129999774348,
+ 0.0017005690000360119,
+ 0.001672345999963909,
+ 0.0016989359999683984,
+ 0.001679800999966119,
+ 0.0016658449999908953,
+ 0.0016797400000427842,
+ 0.0016772449999962191,
+ 0.0016844290000221918,
+ 0.0017086650000237569,
+ 0.0016892380000399498,
+ 0.0016966909999496238,
+ 0.001717751999990469,
+ 0.001785448000021006,
+ 0.0017482389999941006,
+ 0.0016778160000399112,
+ 0.001688064999996186,
+ 0.0016809720000310335,
+ 0.0016738389999773062,
+ 0.0021687440000164315,
+ 0.001700247999963267,
+ 0.0016960610000182896,
+ 0.0017771520000451346,
+ 0.0016857010000421724,
+ 0.0017100270000014461,
+ 0.001699527000027956,
+ 0.0016762239999934536,
+ 0.0018753560000277503,
+ 0.001705929000024753,
+ 0.001678597000022819,
+ 0.0016616870000234485,
+ 0.0016921029999821258,
+ 0.0016885960000081468,
+ 0.0016875150000146277,
+ 0.0016677379999805453,
+ 0.0016856210000355532,
+ 0.002039902999968035,
+ 0.003050492999989274,
+ 0.0022955210000077386,
+ 0.001736747000052219,
+ 0.0017267979999928684,
+ 0.0017860680000012508,
+ 0.002127517000019452,
+ 0.0016945369999916693,
+ 0.0016898190000347313,
+ 0.0016910220000454501,
+ 0.001672435999978461,
+ 0.0016922940000085873,
+ 0.0017657209999697443,
+ 0.0017621139999732804,
+ 0.0017181229999891912,
+ 0.0017196840000224256,
+ 0.001703335000001971,
+ 0.0017002690000254006,
+ 0.001683837999962634,
+ 0.0017378890000259162,
+ 0.0016837879999798133,
+ 0.0016884869999671537,
+ 0.0016857819999813728,
+ 0.0017029229999820927,
+ 0.0016843490000155725,
+ 0.001691031000007115,
+ 0.0017837650000274152,
+ 0.0016952089999904274,
+ 0.0017094149999934416,
+ 0.0021169369999824994,
+ 0.0017017409999766642,
+ 0.0016888270000094963,
+ 0.0016608249999876534,
+ 0.0016851400000064132,
+ 0.001679348999971353,
+ 0.0016864930000224376,
+ 0.001649993999990329,
+ 0.0016836279999665749,
+ 0.001681182999959674,
+ 0.0016467390000229898,
+ 0.0016828369999757342,
+ 0.001678567999988445,
+ 0.00167527199999995,
+ 0.0016750209999827348,
+ 0.0016781770000307006,
+ 0.0016580289999978959,
+ 0.0016709540000192646,
+ 0.0016866830000026312,
+ 0.0016533909999907337,
+ 0.001677807000021403,
+ 0.0016685390000361622,
+ 0.0016521090000196637
+ ],
+ "iterations": 1
+ }
+ }
+ ],
+ "datetime": "2025-08-29T00:20:09.319243+00:00",
+ "version": "5.1.0"
+}
\ No newline at end of file
From 1c01662af55c8fd644b0f212f4d7635e371ed3c3 Mon Sep 17 00:00:00 2001
From: Dave Skender <8432125+DaveSkender@users.noreply.github.com>
Date: Thu, 28 Aug 2025 20:58:01 -0400
Subject: [PATCH 05/10] refactor: Improve code formatting and readability
across multiple indicator files
---
stock_indicators/indicators/atr_stop.py | 14 ++++-
stock_indicators/indicators/donchian.py | 2 +
stock_indicators/indicators/fcb.py | 2 +
stock_indicators/indicators/fractal.py | 25 ++++++--
stock_indicators/indicators/heikin_ashi.py | 2 +
stock_indicators/indicators/ichimoku.py | 62 ++++++++++++++-----
stock_indicators/indicators/pivot_points.py | 14 +++--
stock_indicators/indicators/pivots.py | 22 +++++--
stock_indicators/indicators/renko.py | 22 ++++---
stock_indicators/indicators/rolling_pivots.py | 15 +++--
stock_indicators/indicators/slope.py | 3 +
stock_indicators/indicators/super_trend.py | 10 ++-
stock_indicators/indicators/zig_zag.py | 14 +++--
13 files changed, 153 insertions(+), 54 deletions(-)
diff --git a/stock_indicators/indicators/atr_stop.py b/stock_indicators/indicators/atr_stop.py
index 7816ec92..b2444892 100644
--- a/stock_indicators/indicators/atr_stop.py
+++ b/stock_indicators/indicators/atr_stop.py
@@ -11,8 +11,12 @@
from stock_indicators.indicators.common.quote import Quote
-def get_atr_stop(quotes: Iterable[Quote], lookback_periods: int = 21,
- multiplier: float = 3, end_type: EndType = EndType.CLOSE):
+def get_atr_stop(
+ quotes: Iterable[Quote],
+ lookback_periods: int = 21,
+ multiplier: float = 3,
+ end_type: EndType = EndType.CLOSE,
+):
"""Get ATR Trailing Stop calculated.
ATR Trailing Stop attempts to determine the primary trend of prices by using
@@ -40,7 +44,9 @@ def get_atr_stop(quotes: Iterable[Quote], lookback_periods: int = 21,
- [ATR Trailing Stop Reference](https://python.stockindicators.dev/indicators/AtrStop/#content)
- [Helper Methods](https://python.stockindicators.dev/utilities/#content)
"""
- results = CsIndicator.GetAtrStop[Quote](CsList(Quote, quotes), lookback_periods, multiplier, end_type.cs_value)
+ results = CsIndicator.GetAtrStop[Quote](
+ CsList(Quote, quotes), lookback_periods, multiplier, end_type.cs_value
+ )
return AtrStopResults(results, AtrStopResult)
@@ -75,6 +81,8 @@ def sell_stop(self, value):
_T = TypeVar("_T", bound=AtrStopResult)
+
+
class AtrStopResults(CondenseMixin, RemoveWarmupMixin, IndicatorResults[_T]):
"""
A wrapper class for the list of ATR Trailing Stop results.
diff --git a/stock_indicators/indicators/donchian.py b/stock_indicators/indicators/donchian.py
index e53795a4..979727ec 100644
--- a/stock_indicators/indicators/donchian.py
+++ b/stock_indicators/indicators/donchian.py
@@ -73,6 +73,8 @@ def width(self, value):
_T = TypeVar("_T", bound=DonchianResult)
+
+
class DonchianResults(CondenseMixin, RemoveWarmupMixin, IndicatorResults[_T]):
"""
A wrapper class for the list of Donchian Channels results.
diff --git a/stock_indicators/indicators/fcb.py b/stock_indicators/indicators/fcb.py
index 543ac805..422883cf 100644
--- a/stock_indicators/indicators/fcb.py
+++ b/stock_indicators/indicators/fcb.py
@@ -59,6 +59,8 @@ def lower_band(self, value):
_T = TypeVar("_T", bound=FCBResult)
+
+
class FCBResults(CondenseMixin, RemoveWarmupMixin, IndicatorResults[_T]):
"""
A wrapper class for the list of Fractal Chaos Bands (FCB) results.
diff --git a/stock_indicators/indicators/fractal.py b/stock_indicators/indicators/fractal.py
index eeb1880b..2aca5a91 100644
--- a/stock_indicators/indicators/fractal.py
+++ b/stock_indicators/indicators/fractal.py
@@ -12,10 +12,16 @@
@overload
-def get_fractal(quotes: Iterable[Quote], window_span: int = 2, end_type = EndType.HIGH_LOW) -> "FractalResults[FractalResult]": ...
+def get_fractal(
+ quotes: Iterable[Quote], window_span: int = 2, end_type=EndType.HIGH_LOW
+) -> "FractalResults[FractalResult]": ...
@overload
-def get_fractal(quotes: Iterable[Quote], left_span: int, right_span: int, end_type = EndType.HIGH_LOW) -> "FractalResults[FractalResult]": ...
-def get_fractal(quotes, left_span = None, right_span = EndType.HIGH_LOW, end_type = EndType.HIGH_LOW):
+def get_fractal(
+ quotes: Iterable[Quote], left_span: int, right_span: int, end_type=EndType.HIGH_LOW
+) -> "FractalResults[FractalResult]": ...
+def get_fractal(
+ quotes, left_span=None, right_span=EndType.HIGH_LOW, end_type=EndType.HIGH_LOW
+):
"""Get Williams Fractal calculated.
Williams Fractal is a retrospective price pattern that
@@ -46,10 +52,15 @@ def get_fractal(quotes, left_span = None, right_span = EndType.HIGH_LOW, end_typ
- [Helper Methods](https://python.stockindicators.dev/utilities/#content)
"""
if isinstance(right_span, EndType):
- if left_span is None: left_span = 2
- fractal_results = CsIndicator.GetFractal[Quote](CsList(Quote, quotes), left_span, right_span.cs_value)
+ if left_span is None:
+ left_span = 2
+ fractal_results = CsIndicator.GetFractal[Quote](
+ CsList(Quote, quotes), left_span, right_span.cs_value
+ )
else:
- fractal_results = CsIndicator.GetFractal[Quote](CsList(Quote, quotes), left_span, right_span, end_type.cs_value)
+ fractal_results = CsIndicator.GetFractal[Quote](
+ CsList(Quote, quotes), left_span, right_span, end_type.cs_value
+ )
return FractalResults(fractal_results, FractalResult)
@@ -77,6 +88,8 @@ def fractal_bull(self, value):
_T = TypeVar("_T", bound=FractalResult)
+
+
class FractalResults(CondenseMixin, IndicatorResults[_T]):
"""
A wrapper class for the list of Williams Fractal results.
diff --git a/stock_indicators/indicators/heikin_ashi.py b/stock_indicators/indicators/heikin_ashi.py
index 42ab6da4..14deac33 100644
--- a/stock_indicators/indicators/heikin_ashi.py
+++ b/stock_indicators/indicators/heikin_ashi.py
@@ -77,6 +77,8 @@ def volume(self, value):
_T = TypeVar("_T", bound=HeikinAshiResult)
+
+
class HeikinAshiResults(IndicatorResults[_T]):
"""
A wrapper class for the list of Heikin-Ashi results.
diff --git a/stock_indicators/indicators/ichimoku.py b/stock_indicators/indicators/ichimoku.py
index 21648a9a..946b5d4b 100644
--- a/stock_indicators/indicators/ichimoku.py
+++ b/stock_indicators/indicators/ichimoku.py
@@ -11,19 +11,37 @@
@overload
-def get_ichimoku(quotes: Iterable[Quote], tenkan_periods: int = 9,
- kijun_periods: int = 26, senkou_b_periods: int = 52) -> "IchimokuResults[IchimokuResult]": ...
+def get_ichimoku(
+ quotes: Iterable[Quote],
+ tenkan_periods: int = 9,
+ kijun_periods: int = 26,
+ senkou_b_periods: int = 52,
+) -> "IchimokuResults[IchimokuResult]": ...
@overload
-def get_ichimoku(quotes: Iterable[Quote], tenkan_periods: int,
- kijun_periods: int, senkou_b_periods: int,
- offset_periods: int) -> "IchimokuResults[IchimokuResult]": ...
+def get_ichimoku(
+ quotes: Iterable[Quote],
+ tenkan_periods: int,
+ kijun_periods: int,
+ senkou_b_periods: int,
+ offset_periods: int,
+) -> "IchimokuResults[IchimokuResult]": ...
@overload
-def get_ichimoku(quotes: Iterable[Quote], tenkan_periods: int,
- kijun_periods: int, senkou_b_periods: int,
- senkou_offset: int, chikou_offset: int) -> "IchimokuResults[IchimokuResult]": ...
-def get_ichimoku(quotes: Iterable[Quote], tenkan_periods: int = None,
- kijun_periods: int = None, senkou_b_periods: int = None,
- senkou_offset: int = None, chikou_offset: int = None):
+def get_ichimoku(
+ quotes: Iterable[Quote],
+ tenkan_periods: int,
+ kijun_periods: int,
+ senkou_b_periods: int,
+ senkou_offset: int,
+ chikou_offset: int,
+) -> "IchimokuResults[IchimokuResult]": ...
+def get_ichimoku(
+ quotes: Iterable[Quote],
+ tenkan_periods: int = None,
+ kijun_periods: int = None,
+ senkou_b_periods: int = None,
+ senkou_offset: int = None,
+ chikou_offset: int = None,
+):
"""Get Ichimoku Cloud calculated.
Ichimoku Cloud, also known as Ichimoku Kinkō Hyō, is a collection of indicators
@@ -62,15 +80,23 @@ def get_ichimoku(quotes: Iterable[Quote], tenkan_periods: int = None,
"""
if chikou_offset is None:
if senkou_offset is None:
- if tenkan_periods is None: tenkan_periods = 9
- if kijun_periods is None: kijun_periods = 26
- if senkou_b_periods is None: senkou_b_periods = 52
+ if tenkan_periods is None:
+ tenkan_periods = 9
+ if kijun_periods is None:
+ kijun_periods = 26
+ if senkou_b_periods is None:
+ senkou_b_periods = 52
senkou_offset = kijun_periods
chikou_offset = senkou_offset
- results = CsIndicator.GetIchimoku[Quote](CsList(Quote, quotes), tenkan_periods,
- kijun_periods, senkou_b_periods,
- senkou_offset, chikou_offset)
+ results = CsIndicator.GetIchimoku[Quote](
+ CsList(Quote, quotes),
+ tenkan_periods,
+ kijun_periods,
+ senkou_b_periods,
+ senkou_offset,
+ chikou_offset,
+ )
return IchimokuResults(results, IchimokuResult)
@@ -121,6 +147,8 @@ def chikou_span(self, value):
_T = TypeVar("_T", bound=IchimokuResult)
+
+
class IchimokuResults(CondenseMixin, IndicatorResults[_T]):
"""
A wrapper class for the list of Ichimoku Cloud results.
diff --git a/stock_indicators/indicators/pivot_points.py b/stock_indicators/indicators/pivot_points.py
index 25118843..76b3b372 100644
--- a/stock_indicators/indicators/pivot_points.py
+++ b/stock_indicators/indicators/pivot_points.py
@@ -11,8 +11,11 @@
from stock_indicators.indicators.common.quote import Quote
-def get_pivot_points(quotes, window_size: PeriodSize,
- point_type: PivotPointType = PivotPointType.STANDARD):
+def get_pivot_points(
+ quotes,
+ window_size: PeriodSize,
+ point_type: PivotPointType = PivotPointType.STANDARD,
+):
"""Get Pivot Points calculated.
Pivot Points depict support and resistance levels, based on
@@ -37,8 +40,9 @@ def get_pivot_points(quotes, window_size: PeriodSize,
- [Pivot Points Reference](https://python.stockindicators.dev/indicators/PivotPoints/#content)
- [Helper Methods](https://python.stockindicators.dev/utilities/#content)
"""
- results = CsIndicator.GetPivotPoints[Quote](CsList(Quote, quotes), window_size.cs_value,
- point_type.cs_value)
+ results = CsIndicator.GetPivotPoints[Quote](
+ CsList(Quote, quotes), window_size.cs_value, point_type.cs_value
+ )
return PivotPointsResults(results, PivotPointsResult)
@@ -121,6 +125,8 @@ def s4(self, value):
_T = TypeVar("_T", bound=PivotPointsResult)
+
+
class PivotPointsResults(RemoveWarmupMixin, IndicatorResults[_T]):
"""
A wrapper class for the list of Pivot Points results.
diff --git a/stock_indicators/indicators/pivots.py b/stock_indicators/indicators/pivots.py
index 4904e1a8..dff4e652 100644
--- a/stock_indicators/indicators/pivots.py
+++ b/stock_indicators/indicators/pivots.py
@@ -11,9 +11,13 @@
from stock_indicators.indicators.common.quote import Quote
-def get_pivots(quotes: Iterable[Quote], left_span: int = 2,
- right_span: int = 2, max_trend_periods: int = 20,
- end_type: EndType = EndType.HIGH_LOW):
+def get_pivots(
+ quotes: Iterable[Quote],
+ left_span: int = 2,
+ right_span: int = 2,
+ max_trend_periods: int = 20,
+ end_type: EndType = EndType.HIGH_LOW,
+):
"""Get Pivots calculated.
Pivots is an extended version of Williams Fractal that includes
@@ -44,9 +48,13 @@ def get_pivots(quotes: Iterable[Quote], left_span: int = 2,
- [Pivots Reference](https://python.stockindicators.dev/indicators/Pivots/#content)
- [Helper Methods](https://python.stockindicators.dev/utilities/#content)
"""
- results = CsIndicator.GetPivots[Quote](CsList(Quote, quotes), left_span,
- right_span, max_trend_periods,
- end_type.cs_value)
+ results = CsIndicator.GetPivots[Quote](
+ CsList(Quote, quotes),
+ left_span,
+ right_span,
+ max_trend_periods,
+ end_type.cs_value,
+ )
return PivotsResults(results, PivotsResult)
@@ -109,6 +117,8 @@ def low_trend(self, value):
_T = TypeVar("_T", bound=PivotsResult)
+
+
class PivotsResults(CondenseMixin, IndicatorResults[_T]):
"""
A wrapper class for the list of Pivots results.
diff --git a/stock_indicators/indicators/renko.py b/stock_indicators/indicators/renko.py
index 51b57a98..19845810 100644
--- a/stock_indicators/indicators/renko.py
+++ b/stock_indicators/indicators/renko.py
@@ -10,8 +10,9 @@
from stock_indicators.indicators.common.quote import Quote
-def get_renko(quotes: Iterable[Quote], brick_size: float,
- end_type: EndType = EndType.CLOSE):
+def get_renko(
+ quotes: Iterable[Quote], brick_size: float, end_type: EndType = EndType.CLOSE
+):
"""Get Renko Chart calculated.
Renko Chart is a modified Japanese candlestick pattern
@@ -35,13 +36,15 @@ def get_renko(quotes: Iterable[Quote], brick_size: float,
- [Renko Chart Reference](https://python.stockindicators.dev/indicators/Renko/#content)
- [Helper Methods](https://python.stockindicators.dev/utilities/#content)
"""
- results = CsIndicator.GetRenko[Quote](CsList(Quote, quotes), CsDecimal(brick_size),
- end_type.cs_value)
+ results = CsIndicator.GetRenko[Quote](
+ CsList(Quote, quotes), CsDecimal(brick_size), end_type.cs_value
+ )
return RenkoResults(results, RenkoResult)
-def get_renko_atr(quotes: Iterable[Quote], atr_periods: int,
- end_type: EndType = EndType.CLOSE):
+def get_renko_atr(
+ quotes: Iterable[Quote], atr_periods: int, end_type: EndType = EndType.CLOSE
+):
"""Get ATR Renko Chart calculated.
The ATR Renko Chart is a modified Japanese candlestick pattern
@@ -65,8 +68,9 @@ def get_renko_atr(quotes: Iterable[Quote], atr_periods: int,
- [ATR Renko Chart Reference](https://python.stockindicators.dev/indicators/Renko/#content)
- [Helper Methods](https://python.stockindicators.dev/utilities/#content)
"""
- results = CsIndicator.GetRenkoAtr[Quote](CsList(Quote, quotes), atr_periods,
- end_type.cs_value)
+ results = CsIndicator.GetRenkoAtr[Quote](
+ CsList(Quote, quotes), atr_periods, end_type.cs_value
+ )
return RenkoResults(results, RenkoResult)
@@ -125,6 +129,8 @@ def is_up(self, value):
_T = TypeVar("_T", bound=RenkoResult)
+
+
class RenkoResults(IndicatorResults[_T]):
"""
A wrapper class for the list of Renko Chart results.
diff --git a/stock_indicators/indicators/rolling_pivots.py b/stock_indicators/indicators/rolling_pivots.py
index 647a48d3..445add99 100644
--- a/stock_indicators/indicators/rolling_pivots.py
+++ b/stock_indicators/indicators/rolling_pivots.py
@@ -11,8 +11,12 @@
from stock_indicators.indicators.common.quote import Quote
-def get_rolling_pivots(quotes: Iterable[Quote], window_periods: int,
- offset_periods: int, point_type: PivotPointType = PivotPointType.STANDARD):
+def get_rolling_pivots(
+ quotes: Iterable[Quote],
+ window_periods: int,
+ offset_periods: int,
+ point_type: PivotPointType = PivotPointType.STANDARD,
+):
"""Get Rolling Pivot Points calculated.
Rolling Pivot Points is a modern update to traditional fixed calendar window Pivot Points.
@@ -39,8 +43,9 @@ def get_rolling_pivots(quotes: Iterable[Quote], window_periods: int,
- [Rolling Pivot Points Reference](https://python.stockindicators.dev/indicators/RollingPivots/#content)
- [Helper Methods](https://python.stockindicators.dev/utilities/#content)
"""
- results = CsIndicator.GetRollingPivots[Quote](CsList(Quote, quotes), window_periods,
- offset_periods, point_type.cs_value)
+ results = CsIndicator.GetRollingPivots[Quote](
+ CsList(Quote, quotes), window_periods, offset_periods, point_type.cs_value
+ )
return RollingPivotsResults(results, RollingPivotsResult)
@@ -123,6 +128,8 @@ def s4(self, value):
_T = TypeVar("_T", bound=RollingPivotsResult)
+
+
class RollingPivotsResults(RemoveWarmupMixin, IndicatorResults[_T]):
"""
A wrapper class for the list of Rolling Pivot Points results.
diff --git a/stock_indicators/indicators/slope.py b/stock_indicators/indicators/slope.py
index 5ccc79b6..28a534d6 100644
--- a/stock_indicators/indicators/slope.py
+++ b/stock_indicators/indicators/slope.py
@@ -80,7 +80,10 @@ def line(self) -> Optional[Decimal]:
def line(self, value):
self._csdata.Line = CsDecimal(value)
+
_T = TypeVar("_T", bound=SlopeResult)
+
+
class SlopeResults(CondenseMixin, RemoveWarmupMixin, IndicatorResults[_T]):
"""
A wrapper class for the list of Slope results.
diff --git a/stock_indicators/indicators/super_trend.py b/stock_indicators/indicators/super_trend.py
index 5bd3d236..78394d59 100644
--- a/stock_indicators/indicators/super_trend.py
+++ b/stock_indicators/indicators/super_trend.py
@@ -10,7 +10,9 @@
from stock_indicators.indicators.common.quote import Quote
-def get_super_trend(quotes: Iterable[Quote], lookback_periods: int = 10, multiplier: float = 3):
+def get_super_trend(
+ quotes: Iterable[Quote], lookback_periods: int = 10, multiplier: float = 3
+):
"""Get SuperTrend calculated.
SuperTrend attempts to determine the primary trend of Close prices by using
@@ -35,7 +37,9 @@ def get_super_trend(quotes: Iterable[Quote], lookback_periods: int = 10, multipl
- [SuperTrend Reference](https://python.stockindicators.dev/indicators/SuperTrend/#content)
- [Helper Methods](https://python.stockindicators.dev/utilities/#content)
"""
- super_trend_results = CsIndicator.GetSuperTrend[Quote](CsList(Quote, quotes), lookback_periods, multiplier)
+ super_trend_results = CsIndicator.GetSuperTrend[Quote](
+ CsList(Quote, quotes), lookback_periods, multiplier
+ )
return SuperTrendResults(super_trend_results, SuperTrendResult)
@@ -70,6 +74,8 @@ def lower_band(self, value):
_T = TypeVar("_T", bound=SuperTrendResult)
+
+
class SuperTrendResults(CondenseMixin, RemoveWarmupMixin, IndicatorResults[_T]):
"""
A wrapper class for the list of Super Trend results.
diff --git a/stock_indicators/indicators/zig_zag.py b/stock_indicators/indicators/zig_zag.py
index b3a49ba7..4368a055 100644
--- a/stock_indicators/indicators/zig_zag.py
+++ b/stock_indicators/indicators/zig_zag.py
@@ -11,8 +11,11 @@
from stock_indicators.indicators.common.quote import Quote
-def get_zig_zag(quotes: Iterable[Quote], end_type: EndType = EndType.CLOSE,
- percent_change: float = 5):
+def get_zig_zag(
+ quotes: Iterable[Quote],
+ end_type: EndType = EndType.CLOSE,
+ percent_change: float = 5,
+):
"""Get Zig Zag calculated.
Zig Zag is a price chart overlay that simplifies the up and down
@@ -36,8 +39,9 @@ def get_zig_zag(quotes: Iterable[Quote], end_type: EndType = EndType.CLOSE,
- [Zig Zag Reference](https://python.stockindicators.dev/indicators/ZigZag/#content)
- [Helper Methods](https://python.stockindicators.dev/utilities/#content)
"""
- results = CsIndicator.GetZigZag[Quote](CsList(Quote, quotes), end_type.cs_value,
- CsDecimal(percent_change))
+ results = CsIndicator.GetZigZag[Quote](
+ CsList(Quote, quotes), end_type.cs_value, CsDecimal(percent_change)
+ )
return ZigZagResults(results, ZigZagResult)
@@ -80,6 +84,8 @@ def retrace_low(self, value):
_T = TypeVar("_T", bound=ZigZagResult)
+
+
class ZigZagResults(CondenseMixin, IndicatorResults[_T]):
"""
A wrapper class for the list of Zig Zag results.
From 092a890c63e418ac6f10fa9e1a432a49961da05d Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Wed, 24 Dec 2025 09:54:30 +0000
Subject: [PATCH 06/10] Merge main branch and resolve conflicts for decimal
conversion performance improvement
Co-authored-by: DaveSkender <8432125+DaveSkender@users.noreply.github.com>
---
.coderabbit.yaml | 277 ++
.devcontainer/devcontainer.json | 83 +-
.devcontainer/post-create.sh | 25 +
.devcontainer/setup.sh | 10 -
.github/workflows/ci.yml | 63 +
.github/workflows/deploy-package.yml | 6 +-
.github/workflows/deploy-website.yml | 2 +-
.github/workflows/lint-pull-request.yml | 52 +-
.github/workflows/test-code-coverage.yml | 12 +-
.github/workflows/test-indicators-full.yml | 26 +-
.github/workflows/test-indicators.yml | 16 +-
.github/workflows/test-localization.yml | 11 +-
.github/workflows/test-performance.yml | 10 +-
.github/workflows/test-website-a11y.yml | 2 +-
.github/workflows/test-website-links.yml | 2 +-
.markdownlint-cli2.jsonc | 57 +
.pylintrc | 21 -
.vscode/extensions.json | 5 +-
.vscode/mcp.json | 36 +
.vscode/settings.json | 47 +-
.vscode/tasks.json | 212 +-
README.md | 6 +-
benchmarks/conftest.py | 5 +-
benchmarks/test_benchmark_indicators.py | 8 +-
docs/Gemfile.lock | 6 +-
docs/_indicators/AtrStop.md | 1 -
docs/contributing.md | 62 +-
docs/pages/guide.md | 46 +-
docs/pages/performance.md | 4 +-
pyproject.toml | 55 +-
requirements-test.txt | 3 +
requirements.txt | 2 +-
stock_indicators/__init__.py | 7 +
stock_indicators/_cslib/__init__.py | 190 +-
.../_cslib/lib/Skender.Stock.Indicators.dll | Bin 219648 -> 218112 bytes
.../_cslib/lib/Skender.Stock.Indicators.xml | 2742 +++++++++++++++++
stock_indicators/_cstypes/__init__.py | 6 +-
stock_indicators/_cstypes/datetime.py | 5 +-
stock_indicators/_cstypes/decimal.py | 71 +-
stock_indicators/_cstypes/list.py | 21 +-
stock_indicators/exceptions.py | 23 +
stock_indicators/indicators/__init__.py | 170 +-
stock_indicators/indicators/adl.py | 4 +-
stock_indicators/indicators/adx.py | 12 +-
stock_indicators/indicators/alligator.py | 30 +-
stock_indicators/indicators/alma.py | 13 +-
stock_indicators/indicators/aroon.py | 4 +-
stock_indicators/indicators/atr.py | 4 +-
stock_indicators/indicators/atr_stop.py | 4 +-
stock_indicators/indicators/awesome.py | 8 +-
stock_indicators/indicators/basic_quotes.py | 12 +-
stock_indicators/indicators/beta.py | 18 +-
.../indicators/bollinger_bands.py | 12 +-
stock_indicators/indicators/bop.py | 4 +-
stock_indicators/indicators/cci.py | 4 +-
.../indicators/chaikin_oscillator.py | 12 +-
stock_indicators/indicators/chandelier.py | 17 +-
stock_indicators/indicators/chop.py | 4 +-
stock_indicators/indicators/cmf.py | 4 +-
stock_indicators/indicators/cmo.py | 4 +-
.../indicators/common/__init__.py | 27 +-
.../common/_contrib/type_resolver.py | 15 +-
stock_indicators/indicators/common/candles.py | 47 +-
stock_indicators/indicators/common/enums.py | 13 +-
stock_indicators/indicators/common/helpers.py | 52 +-
stock_indicators/indicators/common/quote.py | 151 +-
stock_indicators/indicators/common/results.py | 96 +-
stock_indicators/indicators/connors_rsi.py | 17 +-
stock_indicators/indicators/correlation.py | 14 +-
stock_indicators/indicators/dema.py | 4 +-
stock_indicators/indicators/doji.py | 4 +-
stock_indicators/indicators/donchian.py | 4 +-
stock_indicators/indicators/dpo.py | 4 +-
stock_indicators/indicators/dynamic.py | 8 +-
stock_indicators/indicators/elder_ray.py | 4 +-
stock_indicators/indicators/ema.py | 13 +-
stock_indicators/indicators/epma.py | 4 +-
stock_indicators/indicators/fcb.py | 4 +-
.../indicators/fisher_transform.py | 8 +-
stock_indicators/indicators/force_index.py | 4 +-
stock_indicators/indicators/fractal.py | 8 +-
stock_indicators/indicators/gator.py | 15 +-
stock_indicators/indicators/heikin_ashi.py | 4 +-
stock_indicators/indicators/hma.py | 4 +-
stock_indicators/indicators/ht_trendline.py | 4 +-
stock_indicators/indicators/hurst.py | 4 +-
stock_indicators/indicators/ichimoku.py | 40 +-
stock_indicators/indicators/kama.py | 23 +-
stock_indicators/indicators/keltner.py | 17 +-
stock_indicators/indicators/kvo.py | 17 +-
stock_indicators/indicators/ma_envelopes.py | 17 +-
stock_indicators/indicators/macd.py | 24 +-
stock_indicators/indicators/mama.py | 12 +-
stock_indicators/indicators/mfi.py | 4 +-
stock_indicators/indicators/obv.py | 4 +-
stock_indicators/indicators/parabolic_sar.py | 43 +-
stock_indicators/indicators/pivot_points.py | 4 +-
stock_indicators/indicators/pivots.py | 4 +-
stock_indicators/indicators/pmo.py | 17 +-
stock_indicators/indicators/prs.py | 18 +-
stock_indicators/indicators/pvo.py | 17 +-
stock_indicators/indicators/renko.py | 4 +-
stock_indicators/indicators/roc.py | 28 +-
stock_indicators/indicators/rolling_pivots.py | 4 +-
stock_indicators/indicators/rsi.py | 4 +-
stock_indicators/indicators/slope.py | 4 +-
stock_indicators/indicators/sma.py | 20 +-
stock_indicators/indicators/smi.py | 24 +-
stock_indicators/indicators/smma.py | 4 +-
stock_indicators/indicators/starc_bands.py | 22 +-
stock_indicators/indicators/stc.py | 17 +-
stock_indicators/indicators/stdev.py | 13 +-
stock_indicators/indicators/stdev_channels.py | 16 +-
stock_indicators/indicators/stoch.py | 26 +-
stock_indicators/indicators/stoch_rsi.py | 20 +-
stock_indicators/indicators/super_trend.py | 4 +-
stock_indicators/indicators/t3.py | 14 +-
stock_indicators/indicators/tema.py | 4 +-
stock_indicators/indicators/tr.py | 4 +-
stock_indicators/indicators/trix.py | 12 +-
stock_indicators/indicators/tsi.py | 17 +-
stock_indicators/indicators/ulcer_index.py | 4 +-
stock_indicators/indicators/ultimate.py | 17 +-
.../indicators/volatility_stop.py | 14 +-
stock_indicators/indicators/vortex.py | 4 +-
stock_indicators/indicators/vwap.py | 117 +-
stock_indicators/indicators/vwma.py | 4 +-
stock_indicators/indicators/williams_r.py | 4 +-
stock_indicators/indicators/wma.py | 13 +-
stock_indicators/indicators/zig_zag.py | 4 +-
.../common/test-dateof-roundtrip-variants.py | 5 +-
tests/common/test_candle.py | 63 +-
tests/common/test_common.py | 15 +-
tests/common/test_cstype_conversion.py | 34 +-
tests/common/test_cstype_datetime_kind.py | 24 +-
tests/common/test_dateof_equivalence.py | 2 +-
.../common/test_dateof_identity_roundtrip.py | 1 +
tests/common/test_indicator_results.py | 57 +-
tests/common/test_locale.py | 12 +-
tests/common/test_quote.py | 87 +-
tests/common/test_sma_roundtrip_dates.py | 8 +-
tests/common/test_type_compatibility.py | 7 +-
tests/conftest.py | 26 +-
tests/test_adl.py | 29 +-
tests/test_adx.py | 33 +-
tests/test_basic_quote.py | 33 +-
tests/test_connors_rsi.py | 2 -
tests/test_gator.py | 31 +-
tests/test_hurst.py | 4 +-
tests/test_parabolic_sar.py | 22 +-
tests/test_renko.py | 16 +-
tests/test_sma_analysis.py | 9 +-
tests/test_starc_bands.py | 1 -
tests/test_stdev.py | 27 +-
tests/test_stoch.py | 3 -
tests/test_trix.py | 9 +-
tests/test_tsi.py | 3 +
tests/test_ulcer_index.py | 3 +
tests/test_vwap.py | 1 -
tests/utiltest.py | 13 +-
typings/Skender/Stock/Indicators/__init__.pyi | 17 +
.../System/Collections/Generic/__init__.pyi | 4 +
typings/System/Globalization/__init__.pyi | 4 +
typings/System/Threading/__init__.pyi | 3 +
typings/System/__init__.pyi | 8 +
typings/pythonnet/__init__.pyi | 3 +
typings/stock_indicators/_cslib/__init__.pyi | 25 +
167 files changed, 5313 insertions(+), 1144 deletions(-)
create mode 100644 .coderabbit.yaml
create mode 100644 .devcontainer/post-create.sh
delete mode 100755 .devcontainer/setup.sh
create mode 100644 .github/workflows/ci.yml
create mode 100644 .markdownlint-cli2.jsonc
delete mode 100644 .pylintrc
create mode 100644 .vscode/mcp.json
create mode 100644 stock_indicators/_cslib/lib/Skender.Stock.Indicators.xml
create mode 100644 stock_indicators/exceptions.py
create mode 100644 typings/Skender/Stock/Indicators/__init__.pyi
create mode 100644 typings/System/Collections/Generic/__init__.pyi
create mode 100644 typings/System/Globalization/__init__.pyi
create mode 100644 typings/System/Threading/__init__.pyi
create mode 100644 typings/System/__init__.pyi
create mode 100644 typings/pythonnet/__init__.pyi
create mode 100644 typings/stock_indicators/_cslib/__init__.pyi
diff --git a/.coderabbit.yaml b/.coderabbit.yaml
new file mode 100644
index 00000000..8f166db2
--- /dev/null
+++ b/.coderabbit.yaml
@@ -0,0 +1,277 @@
+# yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json
+# CodeRabbit config docs: https://docs.coderabbit.ai/reference/configuration
+# Defaults and examples GitHub repo: coderabbitai/awesome-coderabbit
+
+# General settings
+language: "en-US" # Language for reviews (default: "en-US")
+tone_instructions: "" # Custom tone for reviews (default: "")
+enable_free_tier: false # Enable free tier features (default: true)
+inheritance: false # top-level instructions (default: false)
+
+# preview features
+early_access: true # Enable early-access features (default: false)
+
+# ISSUE ENRICHMENT (preview)
+issue_enrichment:
+ auto_enrich:
+ enabled: false # Enable auto issue enrichment (default: true)
+ planning:
+ enabled: true # Enable generating a planning for issues (default: true)
+ auto_planning:
+ enabled: true # Enable auto-generated plans based on labels (default: true)
+ labels: # Triggering labels for auto-planning (default: [])
+ - rabbit-plan
+ labeling:
+ auto_apply_labels: false
+ labeling_instructions: []
+
+# REVIEWS
+reviews:
+ profile: "chill"
+ review_status: true
+ commit_status: true
+ fail_commit_status: false
+ request_changes_workflow: false
+ enable_prompt_for_ai_agents: true
+ in_progress_fortune: false
+
+ abort_on_close: true
+ disable_cache: false
+
+ # High level summary of the changes in the PR/MR description or walkthrough.
+ high_level_summary: false
+ high_level_summary_in_walkthrough: false
+ high_level_summary_placeholder: "@coderabbitai summary"
+
+ # Walkthrough
+ collapse_walkthrough: true
+ changed_files_summary: false # Generate a summary of the changed files in the walkthrough.
+ sequence_diagrams: false # Generate sequence diagrams in the walkthrough.
+ estimate_code_review_effort: false # Generate review effort in walkthrough.
+ assess_linked_issues: true # Assess how well the changes address the linked issues in the walkthrough.
+ related_issues: false # Include possibly related issues in the walkthrough.
+ related_prs: false # Include possibly related pull requests in the walkthrough.
+ poem: false # Generate a poem in the walkthrough comment.
+
+ # Automatic review scheduling
+ auto_review:
+ enabled: true
+ auto_incremental_review: true # Review each push (default: true)
+ drafts: false # Review Draft pull requests (default: false)
+ base_branches:
+ - ".*"
+
+ # Automatic labels
+ # Suggest labels based on the changes in the pull request in the walkthrough.
+ suggested_labels: false
+ auto_apply_labels: false
+
+ # Automatic reviewers
+ # Suggest reviewers based on the changes in the pull request in the walkthrough.
+ suggested_reviewers: false
+ auto_assign_reviewers: false
+
+ # Automatic PR titles
+ auto_title_placeholder: "@coderabbitai"
+ auto_title_instructions: |
+ Use conventional commit with short (<65 chars) sentence case Subject. See Copilot instructions.
+
+ Title strategy:
+ - Focus on the PRIMARY contribution or most central feature delivered in the PR
+ - Do NOT base the title on the last commit message
+ - Do NOT choose the most verbose or largest change
+ - Identify the core purpose or business value of the PR
+ - Keep titles concise and meaningful
+
+ Requirements:
+ - Use lowercase for type: feat, fix, docs, style, refactor, perf, test, build, ci, chore, revert, or plan
+ - Subject must start with an uppercase letter
+ - Keep total title length ≤ 65 characters
+ - Use imperative mood (e.g., "Add feature" not "Added feature")
+
+ Examples:
+ - `feat: Add WebSocket support` (not "Update connection manager")
+ - `fix: Resolve authentication timeout` (not "Fix bug in auth service")
+ - `docs: Improve API examples` (not "Update documentation files")
+ - `chore: Update dependencies` (when that's the sole purpose)
+
+ # Path specific review instructions
+ path_instructions:
+ - path: "**/src/**"
+ instructions: "Ensure alignment to latest language and framework standards, and our organization's coding standards"
+ - path: "**/test/**"
+ instructions: "Focus on test coverage, edge cases, and alignment to test framework"
+ - path: "**/api/**"
+ instructions: "Ensure proper error handling and API documentation"
+ - path: "**/*.md"
+ instructions: "Check for broken links and formatting according to markdown configuration and instructions"
+
+ # Code enhancement features
+ finishing_touches:
+ docstrings:
+ enabled: false # Generate docstrings for PRs/MRs (default: true)
+ unit_tests:
+ enabled: false # Generate unit tests for PRs/MRs (default: true)
+
+ # Pre-merge validation checks
+ pre_merge_checks:
+ docstrings: # Docstring coverage check (default: warning)
+ mode: off
+ description: # PR description validation (default: warning)
+ mode: off
+ issue_assessment: # Linked issue assessment (default: warning)
+ mode: off
+ title: # PR title validation (default: warning)
+ mode: off
+
+ # Files to include/exclude from reviews
+ path_filters:
+ - "**" # Include all (base)
+ - "!node_modules/" # NPM dependencies
+ - "!*-lock.json" # NPM/PNPM lock files
+ - "!packages.lock.json" # NuGet lock file
+ - "!packages/" # NuGet packages cache
+ - "!_cslib/" # DLL library path
+ - "!.jekyll-cache/" # Jekyll cache
+ - "!.pytest_cache/" # Python test cache
+ - "!__pycache__/" # Python caches
+ - "!.venv/" # Python virtual env
+ - "!.benchmarks/" # Benchmarks cache
+ - "!.coverage/" # Code coverage reports
+ - "!vendor/" # Ruby vendor and gem files
+ - "!Gemfile.lock" # Ruby dependencies lock
+ - "!.vitepress/cache/" # VitePress cache
+ - "!.vitepress/dist/" # VitePress build output
+ - "!bin/" # .NET build output
+ - "!obj/" # .NET build intermediate files
+ - "!*.g.cs" # Generated source code
+ - "!*.docx" # Office Word
+ - "!*.pptx" # Office PowerPoint
+ - "!*.xlsx" # Office Spreadsheets
+ - "!*.bak" # Backup files
+ - "!*.zip" # Compressed files
+
+ # Tool integrations
+ tools:
+
+ # tools: default on
+ actionlint: # GitHub Actions workflow static checker
+ enabled: true
+ ast-grep: # Code pattern analysis using AST
+ essential_rules: true
+ gitleaks: # Secret/credential scanner
+ enabled: true
+ github-checks: # GitHub Checks integration
+ enabled: true
+ timeout_ms: 90000
+ markdownlint: # Markdown linter for consistency
+ enabled: true
+ osvScanner: # Vulnerability package scanner
+ enabled: true
+ ruff: # Python linter and formatter
+ enabled: true
+ semgrep: # Security & code quality static analysis
+ enabled: true
+ shellcheck: # Shell script linter
+ enabled: true
+ yamllint: # YAML linter
+ enabled: true
+
+ # tools: default off
+ biome: # Fast formatter, linter, and analyzer for web
+ enabled: false
+ brakeman: # Rails security vulnerability scanner
+ enabled: false
+ buf: # Protobuf linter
+ enabled: false
+ checkov: # Infrastructure-as-code static analyzer
+ enabled: false
+ checkmake: # Makefile linter
+ enabled: false
+ circleci: # CircleCI config static checker
+ enabled: false
+ clang: # C/C++ static analysis tool
+ enabled: false
+ clippy: # Rust linter
+ enabled: false
+ cppcheck: # C/C++ static analyzer
+ enabled: false
+ detekt: # Kotlin static analyzer
+ enabled: false
+ dotenvLint: # .env file linter
+ enabled: false
+ eslint: # JavaScript/TypeScript linter
+ enabled: false
+ flake8: # Python linter
+ enabled: false
+ fortitudeLint: # Fortran linter
+ enabled: false
+ golangci-lint: # Go linter runner
+ enabled: false
+ hadolint: # Dockerfile linter
+ enabled: false
+ htmlhint: # HTML linter
+ enabled: false
+ languagetool: # Grammar and style checker (30+ languages)
+ enabled: false
+ luacheck: # Lua linter
+ enabled: false
+ oxc: # JavaScript/TypeScript linter in Rust
+ enabled: false
+ phpcs: # PHP linter and coding standard checker
+ enabled: false
+ phpmd: # PHP code quality analyzer
+ enabled: false
+ phpstan: # PHP static analysis tool
+ enabled: false
+ pmd: # Java/multilanguage static analyzer
+ enabled: false
+ prismaLint: # Prisma schema linter
+ enabled: false
+ pylint: # Python static analyzer
+ enabled: false
+ regal: # Rego linter and language server
+ enabled: false
+ rubocop: # Ruby linter and code formatter
+ enabled: false
+ shopifyThemeCheck: # Shopify Liquid theme linter
+ enabled: false
+ sqlfluff: # SQL linter
+ enabled: false
+ swiftlint: # Swift linter
+ enabled: false
+
+# CHAT FEATURES
+chat:
+ art: false
+ auto_reply: true
+ integrations:
+ jira:
+ usage: disabled
+ linear:
+ usage: disabled
+
+# KNOWLEDGE BASE
+knowledge_base:
+ opt_out: false
+ web_search:
+ enabled: true
+ code_guidelines:
+ enabled: true
+ filePatterns:
+ - "**/agents.md"
+ - ".github/copilot-instructions.md"
+ - ".github/instructions/**/*.instructions.md"
+ - ".github/skills/**/*skill.md"
+ learnings:
+ scope: auto
+ issues:
+ scope: auto
+ pull_requests:
+ scope: auto
+ mcp:
+ usage: auto
+ jira:
+ usage: disabled
+ linear:
+ usage: disabled
diff --git a/.devcontainer/devcontainer.json b/.devcontainer/devcontainer.json
index 85748491..32609b39 100644
--- a/.devcontainer/devcontainer.json
+++ b/.devcontainer/devcontainer.json
@@ -9,36 +9,20 @@
*/
{
"name": "Stock Indicators for Python",
- "image": "mcr.microsoft.com/devcontainers/python:3.12",
- "forwardPorts": [],
- "remoteUser": "vscode",
+ "image": "mcr.microsoft.com/devcontainers/python:3.13",
"features": {
- "ghcr.io/devcontainers/features/git:1": {
- "version": "os-provided"
- },
"ghcr.io/devcontainers/features/dotnet:2": {
- "version": "lts"
+ "version": "10.0",
+ "additionalVersions": "9.0,8.0"
},
"ghcr.io/devcontainers/features/node:1": {
"version": "lts",
"pnpmVersion": "none",
"nvmVersion": "none"
},
- "ghcr.io/devcontainers/features/github-cli:1": {
- "installDirectlyFromGitHubRelease": true,
- "version": "latest"
- },
- "ghcr.io/devcontainers/features/azure-cli:1": {
- "version": "latest"
- },
+ "ghcr.io/devcontainers/features/github-cli:1": {},
"ghcr.io/devcontainers/features/ruby:1": {
"version": "3.3"
- },
- "ghcr.io/devcontainers-extra/features/isort:2": {
- "version": "latest"
- },
- "ghcr.io/devcontainers-extra/features/pylint:2": {
- "version": "latest"
}
},
// Use 'settings' to set *default* container specific settings.json
@@ -48,26 +32,39 @@
// container overrides only
// otherwise use .vscode/settings.json
"settings": {
- "pylint.importStrategy": "fromEnvironment",
- "python.defaultInterpreterPath": "/usr/local/bin/python"
- },
- // required extensions
- // for recommended, see .vscode/extensions.json
- "extensions": [
- "donjayamanne.python-extension-pack",
- "DavidAnson.vscode-markdownlint",
- "EditorConfig.EditorConfig",
- "ms-python.black-formatter",
- "ms-python.debugpy",
- "ms-python.isort",
- "ms-python.python",
- "ms-python.pylint",
- "ms-python.vscode-pylance"
- ]
- }
- },
- // Runs after the container is created
- "postCreateCommand": "chmod +x .devcontainer/setup.sh && .devcontainer/setup.sh",
- // Runs every time the container starts
- "postStartCommand": "echo 'Container started'"
-}
+ "python.defaultInterpreterPath": "${containerWorkspaceFolder}/.venv/bin/python",
+ "python.testing.pytestEnabled": true,
+ "python.testing.unittestEnabled": false,
+ "[python]": {
+ "editor.defaultFormatter": "charliermarsh.ruff",
+ "editor.formatOnSave": true,
+ "editor.codeActionsOnSave": {
+ "source.organizeImports.ruff": "explicit",
+ "source.fixAll.ruff": "explicit"
+ }
+ },
+ // required extensions
+ // for recommended, see .vscode/extensions.json
+ "extensions": [
+ "charliermarsh.ruff",
+ "DavidAnson.vscode-markdownlint",
+ "EditorConfig.EditorConfig",
+ "ms-python.debugpy",
+ "ms-python.python",
+ "ms-python.vscode-pylance"
+ ]
+ }
+ },
+ "forwardPorts": [
+ 4000
+ ],
+ "portsAttributes": {
+ "4000": {
+ "label": "Doc Site (Jekyll)",
+ "onAutoForward": "notify"
+ }
+ },
+ "remoteUser": "vscode",
+ "postCreateCommand": ".devcontainer/post-create.sh",
+ "postStartCommand": "echo 'Container started'"
+ }
diff --git a/.devcontainer/post-create.sh b/.devcontainer/post-create.sh
new file mode 100644
index 00000000..03560b04
--- /dev/null
+++ b/.devcontainer/post-create.sh
@@ -0,0 +1,25 @@
+#!/bin/bash
+set -e
+
+# Create virtual environment if it doesn't exist
+if [ ! -d ".venv" ]; then
+ echo "Creating virtual environment..."
+ python -m venv .venv
+fi
+
+# Activate virtual environment
+source .venv/bin/activate
+
+# Upgrade pip
+echo "Upgrading pip..."
+python -m pip install --upgrade pip
+
+# Install core dependencies
+echo "Installing core dependencies..."
+pip install -r requirements.txt
+
+# Install test dependencies
+echo "Installing test dependencies..."
+pip install -r requirements-test.txt
+
+echo "✓ Dev container setup complete!"
diff --git a/.devcontainer/setup.sh b/.devcontainer/setup.sh
deleted file mode 100755
index 7ad8e56e..00000000
--- a/.devcontainer/setup.sh
+++ /dev/null
@@ -1,10 +0,0 @@
-#!/bin/bash
-
-# install or upgrade pip
-python -m ensurepip --upgrade
-
-# install core dependencies
-pip install -r requirements.txt
-
-# install test dependencies
-pip install -r requirements-test.txt
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
new file mode 100644
index 00000000..dcd91906
--- /dev/null
+++ b/.github/workflows/ci.yml
@@ -0,0 +1,63 @@
+name: CI
+
+on:
+ push:
+ pull_request:
+
+permissions:
+ contents: read
+
+jobs:
+ linting:
+ runs-on: ubuntu-latest
+
+ steps:
+ - name: Checkout source
+ uses: actions/checkout@v6
+
+ - name: Setup .NET
+ uses: actions/setup-dotnet@v5
+ with:
+ dotnet-version: 10.x
+ dotnet-quality: ga
+
+ - name: Setup Python
+ uses: actions/setup-python@v6
+ with:
+ python-version: 3.13
+ cache: "pip"
+
+ - name: Create virtual environment
+ run: python -m venv .venv
+
+ - name: Install dependencies
+ run: |
+ source .venv/bin/activate
+ python -m pip install --upgrade pip
+ python -m pip install -e .
+ python -m pip install -r requirements-test.txt
+
+ - name: Ruff lint
+ run: |
+ source .venv/bin/activate
+ ruff check .
+
+ - name: Ruff format check
+ run: |
+ source .venv/bin/activate
+ ruff format --check .
+
+ - name: Pyright
+ run: |
+ source .venv/bin/activate
+ pyright
+
+ - name: Pytest
+ run: |
+ source .venv/bin/activate
+ pytest
+
+ - name: pip-audit
+ run: |
+ source .venv/bin/activate
+ pip-audit -r requirements.txt -r requirements-test.txt
diff --git a/.github/workflows/deploy-package.yml b/.github/workflows/deploy-package.yml
index 2e35e2d8..22df88cb 100644
--- a/.github/workflows/deploy-package.yml
+++ b/.github/workflows/deploy-package.yml
@@ -19,15 +19,15 @@ jobs:
steps:
- name: Checkout source
- uses: actions/checkout@v5
+ uses: actions/checkout@v6
with:
fetch-tags: true
fetch-depth: 0
- name: Setup Python
- uses: actions/setup-python@v5
+ uses: actions/setup-python@v6
with:
- python-version: 3.12
+ python-version: 3.13
- name: Build library
run: |
diff --git a/.github/workflows/deploy-website.yml b/.github/workflows/deploy-website.yml
index b58c2f68..96de73a9 100644
--- a/.github/workflows/deploy-website.yml
+++ b/.github/workflows/deploy-website.yml
@@ -29,7 +29,7 @@ jobs:
steps:
- name: Checkout source
- uses: actions/checkout@v5
+ uses: actions/checkout@v6
- name: Setup Ruby
uses: ruby/setup-ruby@v1
diff --git a/.github/workflows/lint-pull-request.yml b/.github/workflows/lint-pull-request.yml
index 56118d78..95c01a2b 100644
--- a/.github/workflows/lint-pull-request.yml
+++ b/.github/workflows/lint-pull-request.yml
@@ -1,26 +1,48 @@
-name: Pull request
+name: Lint pull request
on:
pull_request_target:
+ branches:
+ - "main"
+ - "v[0-9]*"
types:
- opened
- edited
- unlabeled
+ - ready_for_review
+
+concurrency:
+ group: >-
+ ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
+ cancel-in-progress: true
permissions:
pull-requests: write
jobs:
- main:
- name: lint PR title
+ title:
runs-on: ubuntu-latest
+ if: ${{ !github.event.pull_request.draft }}
steps:
- - uses: amannn/action-semantic-pull-request@v5
+ - uses: amannn/action-semantic-pull-request@v6.1.1
id: lint_pr_title
env:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
with:
+ types: |
+ feat
+ fix
+ docs
+ style
+ refactor
+ perf
+ test
+ build
+ ci
+ chore
+ revert
+ plan
subjectPattern: ^([A-Z]).+$
subjectPatternError: >
The subject "**{subject}**" must start with an uppercase character.
@@ -28,8 +50,9 @@ jobs:
ignoreLabels: |
bot
dependencies
+ automated
- - uses: marocchino/sticky-pull-request-comment@v2
+ - uses: marocchino/sticky-pull-request-comment@v2.9.4
if: always() && (steps.lint_pr_title.outputs.error_message != null)
with:
header: pr-title-lint-error
@@ -47,6 +70,7 @@ jobs:
- `feat: Add API endpoint for market data`
- `fix: Resolve WebSocket connection issues`
+ - `plan: Define technical implementation approach`
- `chore: Update NuGet dependencies`
@@ -56,29 +80,33 @@ jobs:
- `feat: Add API endpoint for market data`
- `fix: Resolve WebSocket connection issues`
+ #### Planning & architecture
+ - `plan: Define technical implementation approach`
+
#### Code quality
- `style: Format trading strategy classes`
- `refactor: Restructure trading engine components`
- `perf: Optimize trade order execution flow`
-
+
#### Documentation & testing
- `docs: Update API documentation`
- `test: Add unit tests for sign-in flow`
-
+
#### Infrastructure
- - `build: Update .NET SDK version to 8.0`
+ - `build: Update .NET SDK version to 10.0`
- `ci: Add workflow for performance testing`
- `chore: Update NuGet dependencies`
-
+
#### Other
- `revert: Remove faulty market data provider`
-
- See [Conventional Commits](https://www.conventionalcommits.org) for more details.
+
+ See [Conventional Commits](https://www.conventionalcommits.org)
+ for more details.
# Delete a previous comment when the issue has been resolved
- if: ${{ steps.lint_pr_title.outputs.error_message == null }}
- uses: marocchino/sticky-pull-request-comment@v2
+ uses: marocchino/sticky-pull-request-comment@v2.9.4
with:
header: pr-title-lint-error
delete: true
diff --git a/.github/workflows/test-code-coverage.yml b/.github/workflows/test-code-coverage.yml
index adb0063b..bc860047 100644
--- a/.github/workflows/test-code-coverage.yml
+++ b/.github/workflows/test-code-coverage.yml
@@ -6,7 +6,7 @@ name: Test code coverage
on:
push:
branches: ["main"]
- pull_request_target:
+ pull_request:
branches: ["*"]
workflow_dispatch:
@@ -27,20 +27,20 @@ jobs:
CODACY_PROJECT_TOKEN: ${{ secrets.CODACY_PROJECT_TOKEN }}
steps:
- - name: Checkout PR
- uses: actions/checkout@v5
+ - name: Checkout source
+ uses: actions/checkout@v6
with:
# Explicitly checkout PR code
ref: ${{ github.event.pull_request.head.sha }}
- name: Setup .NET
- uses: actions/setup-dotnet@v4
+ uses: actions/setup-dotnet@v5
with:
- dotnet-version: 9.x
+ dotnet-version: 10.x
dotnet-quality: ga
- name: Setup Python
- uses: actions/setup-python@v5
+ uses: actions/setup-python@v6
with:
python-version: 3.13
cache: "pip"
diff --git a/.github/workflows/test-indicators-full.yml b/.github/workflows/test-indicators-full.yml
index de8685d3..b802f433 100644
--- a/.github/workflows/test-indicators-full.yml
+++ b/.github/workflows/test-indicators-full.yml
@@ -23,26 +23,26 @@ jobs:
# Primary testing on Ubuntu (free tier)
- os: ubuntu-24.04-arm
python-version: "3.8"
- dotnet-version: "6.x"
- - os: ubuntu-24.04-arm
- python-version: "3.10"
dotnet-version: "8.x"
- os: ubuntu-24.04-arm
- python-version: "3.12"
+ python-version: "3.10"
dotnet-version: "9.x"
-
+ - os: ubuntu-24.04-arm
+ python-version: "3.13"
+ dotnet-version: "10.x"
+
# Essential platform compatibility testing (reduced matrix)
- os: windows-2025
python-version: "3.12"
- dotnet-version: "9.x"
+ dotnet-version: "10.x"
- os: macos-15
- python-version: "3.12"
- dotnet-version: "9.x"
-
+ python-version: "3.13"
+ dotnet-version: "10.x"
+
# Legacy support verification
- os: ubuntu-22.04
python-version: "3.8"
- dotnet-version: "6.x"
+ dotnet-version: "8.x"
runs-on: ${{ matrix.os }}
name: "Py${{ matrix.python-version }}/.NET${{ matrix.dotnet-version }} on ${{ matrix.os }}"
@@ -54,16 +54,16 @@ jobs:
steps:
- name: Checkout source
- uses: actions/checkout@v5
+ uses: actions/checkout@v6
- name: Setup .NET
- uses: actions/setup-dotnet@v4
+ uses: actions/setup-dotnet@v5
with:
dotnet-version: ${{ matrix.dotnet-version }}
dotnet-quality: ga
- name: Setup Python
- uses: actions/setup-python@v5
+ uses: actions/setup-python@v6
with:
python-version: ${{ matrix.python-version }}
cache: "pip"
diff --git a/.github/workflows/test-indicators.yml b/.github/workflows/test-indicators.yml
index ca1341ff..06ead104 100644
--- a/.github/workflows/test-indicators.yml
+++ b/.github/workflows/test-indicators.yml
@@ -20,14 +20,14 @@ jobs:
include:
- # Primary testing on Ubuntu (free tier) with older configuration
+ # Primary testing on Ubuntu (free tier) with minimum supported .NET version
- os: ubuntu-22.04
- dotnet-version: "6.x"
+ dotnet-version: "8.x"
python-version: "3.8"
# Primary testing on Ubuntu (free tier) with newer configuration
- os: ubuntu-24.04-arm
- dotnet-version: "9.x"
+ dotnet-version: "10.x"
python-version: "3.13"
post-summary: true
@@ -46,10 +46,10 @@ jobs:
steps:
- name: Checkout source
- uses: actions/checkout@v5
+ uses: actions/checkout@v6
- name: Check debug settings
- if: ${{ matrix.post-summary }} == 'true'
+ if: ${{ matrix['post-summary'] == true }}
shell: bash
run: |
echo "Checking for debug logging settings in package files..."
@@ -64,13 +64,13 @@ jobs:
echo "✓ No debug logging settings found."
- name: Setup .NET
- uses: actions/setup-dotnet@v4
+ uses: actions/setup-dotnet@v5
with:
dotnet-version: ${{ matrix.dotnet-version }}
dotnet-quality: ga
- name: Setup Python
- uses: actions/setup-python@v5
+ uses: actions/setup-python@v6
with:
python-version: ${{ matrix.python-version }}
cache: "pip"
@@ -97,6 +97,6 @@ jobs:
- name: Post test summary
uses: test-summary/action@v2
- if: ${{ matrix.post-summary }} == 'true'
+ if: ${{ matrix['post-summary'] == true }}
with:
paths: test-results.xml
diff --git a/.github/workflows/test-localization.yml b/.github/workflows/test-localization.yml
index 832fad9a..29e2daa3 100644
--- a/.github/workflows/test-localization.yml
+++ b/.github/workflows/test-localization.yml
@@ -48,16 +48,17 @@ jobs:
PYTHONIOENCODING: utf-8
steps:
- - uses: actions/checkout@v5
+ - name: Checkout source
+ uses: actions/checkout@v6
- - uses: actions/setup-dotnet@v4
+ - uses: actions/setup-dotnet@v5
with:
- dotnet-version: 9.x
+ dotnet-version: 10.x
dotnet-quality: ga
- - uses: actions/setup-python@v5
+ - uses: actions/setup-python@v6
with:
- python-version: 3.12
+ python-version: 3.13
cache: "pip"
- name: Configure Linux locale
diff --git a/.github/workflows/test-performance.yml b/.github/workflows/test-performance.yml
index 76e651c4..176bad1d 100644
--- a/.github/workflows/test-performance.yml
+++ b/.github/workflows/test-performance.yml
@@ -21,20 +21,20 @@ jobs:
steps:
- name: Checkout source
- uses: actions/checkout@v5
+ uses: actions/checkout@v6
with:
fetch-depth: 0
- name: Setup .NET
- uses: actions/setup-dotnet@v4
+ uses: actions/setup-dotnet@v5
with:
- dotnet-version: 9.x
+ dotnet-version: 10.x
dotnet-quality: ga
- name: Setup Python
- uses: actions/setup-python@v5
+ uses: actions/setup-python@v6
with:
- python-version: 3.12
+ python-version: 3.13
cache: "pip"
- name: Setup GitVersion
diff --git a/.github/workflows/test-website-a11y.yml b/.github/workflows/test-website-a11y.yml
index 0f925299..ed7f6542 100644
--- a/.github/workflows/test-website-a11y.yml
+++ b/.github/workflows/test-website-a11y.yml
@@ -29,7 +29,7 @@ jobs:
steps:
- name: Checkout source
- uses: actions/checkout@v5
+ uses: actions/checkout@v6
- name: Setup Ruby
uses: ruby/setup-ruby@v1
diff --git a/.github/workflows/test-website-links.yml b/.github/workflows/test-website-links.yml
index da87bd15..affe3233 100644
--- a/.github/workflows/test-website-links.yml
+++ b/.github/workflows/test-website-links.yml
@@ -29,7 +29,7 @@ jobs:
steps:
- name: Checkout source
- uses: actions/checkout@v5
+ uses: actions/checkout@v6
- name: Setup Ruby
uses: ruby/setup-ruby@v1
diff --git a/.markdownlint-cli2.jsonc b/.markdownlint-cli2.jsonc
new file mode 100644
index 00000000..d11a7dc6
--- /dev/null
+++ b/.markdownlint-cli2.jsonc
@@ -0,0 +1,57 @@
+{
+ "globs": [
+ "**/*.md",
+ "**/*.markdown"
+ ],
+ "ignores": [
+ "**/.pytest_cache/**",
+ "**/.coverage/**",
+ "**/.git/**",
+ "**/.github/**",
+ "**/.venv/**",
+ "**/_site/**",
+ "**/__pycache__/**",
+ "**/_cslib/**",
+ "**/node_modules/**",
+ "**/TestResults/**",
+ "**/*playwright*/**",
+ "**/vendor/**"
+ ],
+ "config": {
+ "default": true,
+ "MD003": {
+ "style": "atx"
+ },
+ "MD004": {
+ "style": "dash"
+ },
+ "MD007": {
+ "indent": 2
+ },
+ "MD013": false,
+ "MD025": false,
+ "MD029": {
+ "style": "ordered"
+ },
+ "MD033": {
+ "allowed_elements": [
+ "a",
+ "code",
+ "details",
+ "summary",
+ "sub",
+ "sup",
+ "kbd",
+ "abbr",
+ "img",
+ "br"
+ ]
+ },
+ "MD046": {
+ "style": "fenced"
+ },
+ "MD048": {
+ "style": "backtick"
+ }
+ }
+}
diff --git a/.pylintrc b/.pylintrc
deleted file mode 100644
index 3340ad6c..00000000
--- a/.pylintrc
+++ /dev/null
@@ -1,21 +0,0 @@
-[MASTER]
-extension-pkg-allow-list=
- clr
-
-ignore-long-lines=yes
-
-ignore-imports=yes
-
-disable=
- C0103, # Variable name doesn't conform to snake_case naming style
- C0114, # Missing module docstring
- C0115, # Missing class docstring
- C0116, # Missing function or method docstring
- C0301, # Line too long
- C0321, # More than one statement on a single line
- C0413, # Import should be at the top of the file
- C0415, # Import outside toplevel
- E0401, # Import error
- W0212, # Access to a protected member of a client class
- R0903, # Too few public methods
- R0913 # Too many arguments
diff --git a/.vscode/extensions.json b/.vscode/extensions.json
index 61fe2e05..091bc9a5 100644
--- a/.vscode/extensions.json
+++ b/.vscode/extensions.json
@@ -1,13 +1,10 @@
{
"recommendations": [
- "donjayamanne.python-extension-pack",
+ "charliermarsh.ruff",
"DavidAnson.vscode-markdownlint",
"EditorConfig.EditorConfig",
- "ms-python.black-formatter",
"ms-python.debugpy",
- "ms-python.isort",
"ms-python.python",
- "ms-python.pylint",
"ms-python.vscode-pylance"
]
}
diff --git a/.vscode/mcp.json b/.vscode/mcp.json
new file mode 100644
index 00000000..f9052861
--- /dev/null
+++ b/.vscode/mcp.json
@@ -0,0 +1,36 @@
+{
+ "servers": {
+ "cloudflare": {
+ "type": "stdio",
+ "command": "npx",
+ "args": [
+ "mcp-remote@latest",
+ "https://docs.mcp.cloudflare.com/mcp"
+ ]
+ },
+ "context7": {
+ "type": "stdio",
+ "command": "npx",
+ "args": [
+ "-y",
+ "@upstash/context7-mcp@latest"
+ ]
+ },
+ "playwright": {
+ "type": "stdio",
+ "command": "npx",
+ "args": [
+ "-y",
+ "@playwright/mcp@latest"
+ ]
+ }
+ },
+ "inputs": [
+ {
+ "id": "codacy_account_token",
+ "type": "promptString",
+ "description": "Your personal Codacy Account API token (from app.codacy.com → Account). Required.",
+ "password": true
+ }
+ ]
+}
diff --git a/.vscode/settings.json b/.vscode/settings.json
index d4ab9939..42007812 100644
--- a/.vscode/settings.json
+++ b/.vscode/settings.json
@@ -1,35 +1,44 @@
{
- "isort.args": [
- "--profile",
- "black"
+ "github.copilot.chat.githubMcpServer.enabled": true,
+ "github.copilot.chat.githubMcpServer.readonly": true,
+ "github.copilot.chat.githubMcpServer.toolsets": [
+ "default", // default: context, repos, issues, pull_requests, users
+ "actions",
+ // "projects",
+ "copilot",
+ "github_support_docs_search",
+ "web_search"
],
- "isort.check": true,
- "isort.importStrategy": "fromEnvironment", // default: "useBundled"
+ "github.copilot.chat.tools.memory.enabled": true,
"markdownlint.config": {
- "default": true, // Enable all default rules
- "MD013": false, // Disable line length checking entirely
- "MD025": false, // Allow multiple top level headers in the same document
- "MD033": { // Allow specific HTML elements
+ "default": true, // Enable all default rules
+ "MD013": false, // Disable line length checking entirely
+ "MD025": false, // Allow multiple top level headers in the same document
+ "MD033": { // Allow specific HTML elements
"allowed_elements": [
"details",
"summary",
- "h1" // we use h1 as a Jekyll-y page title
+ "h1" // we use h1 as a Jekyll-y page title
]
},
- "MD041": false // Allow content before first heading
+ "MD041": false // Allow content before first heading
},
- "pylint.importStrategy": "fromEnvironment", // default: "useBundled"
"python.testing.pytestArgs": [
"tests"
],
+ "python.defaultInterpreterPath": ".venv/bin/python",
"python.testing.pytestEnabled": true,
"python.testing.unittestEnabled": false,
- "[markdown]": {
- "editor.defaultFormatter": "DavidAnson.vscode-markdownlint",
- "files.trimTrailingWhitespace": true
- },
"[python]": {
- "editor.defaultFormatter": "ms-python.black-formatter"
- },
- "python.analysis.typeCheckingMode": "basic"
+ "editor.defaultFormatter": "charliermarsh.ruff",
+ "editor.formatOnSave": true,
+ "editor.codeActionsOnSave": {
+ "source.organizeImports.ruff": "explicit",
+ "source.fixAll.ruff": "explicit"
+ },
+ "[markdown]": {
+ "editor.defaultFormatter": "DavidAnson.vscode-markdownlint",
+ "files.trimTrailingWhitespace": true
+ }
+ }
}
diff --git a/.vscode/tasks.json b/.vscode/tasks.json
index 94524055..29f562d4 100644
--- a/.vscode/tasks.json
+++ b/.vscode/tasks.json
@@ -1,60 +1,25 @@
{
+ // See https://go.microsoft.com/fwlink/?LinkId=733558
+ // Schema: https://code.visualstudio.com/docs/reference/tasks-appendix
+ "$schema": "vscode://schemas/tasks",
"version": "2.0.0",
+ // defaults
+ "group": "none",
+ "presentation": {
+ "clear": true,
+ "echo": true,
+ "panel": "dedicated",
+ "focus": true,
+ "reveal": "always",
+ "revealProblems": "onProblem",
+ "showReuseMessage": false
+ },
+ "problemMatcher": [],
+ "options": {
+ "cwd": "${workspaceFolder}"
+ },
+ // tasks
"tasks": [
- {
- "label": "Build",
- "type": "shell",
- "command": "pip install -r requirements.txt && pip install -r requirements-test.txt",
- "group": "build",
- "problemMatcher": []
- },
- {
- "label": "Test: All",
- "dependsOrder": "parallel",
- "dependsOn": [
- "Test: Unit (default)",
- "Test: Coverage",
- "Test: Performance",
- "Test: Localization"
- ],
- "group": "test",
- "problemMatcher": []
- },
- {
- "label": "Test: Unit (default)",
- "type": "shell",
- "command": "pytest -vr A",
- "group": "test",
- "problemMatcher": []
- },
- {
- "label": "Test: Coverage",
- "type": "shell",
- "command": "pytest --cov=stock_indicators --cov-report=term-missing",
- "group": "none",
- "problemMatcher": []
- },
- {
- "label": "Test: Performance",
- "type": "shell",
- "command": "pytest -m performance",
- "group": "none",
- "problemMatcher": []
- },
- {
- "label": "Test: Performance (focus)",
- "type": "shell",
- "command": "pytest -m \"performance and perf_focus\"",
- "group": "none",
- "problemMatcher": []
- },
- {
- "label": "Test: Localization",
- "type": "shell",
- "command": "pytest -m localization -vr A",
- "group": "none",
- "problemMatcher": []
- },
{
"label": "Install: Ruby Packages (docs)",
"type": "shell",
@@ -65,23 +30,17 @@
"BUNDLE_GEMFILE": "${workspaceFolder}/docs/Gemfile",
"BUNDLE_PATH": "${workspaceFolder}/docs/vendor/bundle"
}
- },
- "group": "none",
- "problemMatcher": []
+ }
},
{
"label": "Install: Python Packages",
"type": "shell",
- "command": "pip install -r requirements.txt && pip install -r requirements-test.txt",
- "group": "none",
- "problemMatcher": []
+ "command": "python -m pip install -r requirements.txt && python -m pip install -r requirements-test.txt"
},
{
"label": "Update: Python Packages",
"type": "shell",
- "command": "pip install -U -r requirements.txt && pip install -U -r requirements-test.txt",
- "group": "none",
- "problemMatcher": []
+ "command": "python -m pip install -U -r requirements.txt && python -m pip install -U -r requirements-test.txt"
},
{
"label": "Update: Ruby Packages (docs)",
@@ -93,9 +52,7 @@
"BUNDLE_GEMFILE": "${workspaceFolder}/docs/Gemfile",
"BUNDLE_PATH": "${workspaceFolder}/docs/vendor/bundle"
}
- },
- "group": "none",
- "problemMatcher": []
+ }
},
{
"label": "Update: All Packages",
@@ -103,9 +60,82 @@
"dependsOn": [
"Update: Python Packages",
"Update: Ruby Packages (docs)"
+ ]
+ },
+ {
+ "label": "Build",
+ "type": "shell",
+ "command": "python -m pip install -r requirements.txt && python -m pip install -r requirements-test.txt",
+ "group": {
+ "kind": "build",
+ "isDefault": true
+ }
+ },
+ {
+ "label": "Lint: Code",
+ "type": "shell",
+ "command": "python -m ruff check . && python -m ruff format --check .",
+ "group": "test"
+ },
+ {
+ "label": "Lint: Code (fix)",
+ "type": "shell",
+ "command": "python -m ruff check --fix . && python -m ruff format ."
+ },
+ {
+ "label": "Lint: Markdown files",
+ "detail": "Run markdownlint over documentation",
+ "type": "shell",
+ "command": "echo y | npx markdownlint-cli2",
+ "group": "test",
+ "problemMatcher": "$markdownlint"
+ },
+ {
+ "label": "Lint: Markdown files (fix)",
+ "detail": "Auto-fix markdown formatting issues",
+ "type": "shell",
+ "command": "echo y | npx markdownlint-cli2 --fix",
+ "problemMatcher": "$markdownlint"
+ },
+ {
+ "label": "Test: All",
+ "dependsOrder": "parallel",
+ "dependsOn": [
+ "Test: Unit (default)",
+ "Test: Coverage",
+ "Test: Performance",
+ "Test: Localization"
],
- "group": "none",
- "problemMatcher": []
+ "group": "test"
+ },
+ {
+ "label": "Test: Unit (default)",
+ "type": "shell",
+ "command": "python -m pytest -vr A",
+ "group": {
+ "kind": "test",
+ "isDefault": true
+ }
+ },
+ {
+ "label": "Test: Coverage",
+ "type": "shell",
+ "command": "python -m pytest --cov=stock_indicators --cov-report=term-missing"
+ },
+ {
+ "label": "Test: Performance",
+ "type": "shell",
+ "command": "python -m pytest -m performance"
+ },
+ {
+ "label": "Test: Performance (focus)",
+ "type": "shell",
+ "command": "python -m pytest -m \"performance and perf_focus\""
+ },
+ {
+ "label": "Test: Localization",
+ "type": "shell",
+ "command": "python -m pytest -m localization -vr A"
},
{
"label": "Run: Doc Site with LiveReload",
@@ -120,69 +150,37 @@
"BUNDLE_GEMFILE": "${workspaceFolder}/docs/Gemfile",
"BUNDLE_PATH": "${workspaceFolder}/docs/vendor/bundle"
}
- },
- "group": "none",
- "problemMatcher": []
+ }
},
{
"label": "Benchmark: JSON (prompt filename)",
"type": "shell",
- "command": "pytest -m performance --benchmark-json=.benchmarks/${input:benchJsonOut}",
- "options": {
- "cwd": "${workspaceFolder}"
- },
- "group": "none",
- "problemMatcher": []
+ "command": "python -m pytest -m performance --benchmark-json=.benchmarks/${input:benchJsonOut}"
},
{
"label": "Benchmark: Focus JSON (prompt filename)",
"type": "shell",
- "command": "pytest -m \"performance and perf_focus\" --benchmark-json=.benchmarks/${input:benchJsonOut}",
- "options": {
- "cwd": "${workspaceFolder}"
- },
- "group": "none",
- "problemMatcher": []
+ "command": "python -m pytest -m \"performance and perf_focus\" --benchmark-json=.benchmarks/${input:benchJsonOut}"
},
{
"label": "Benchmark: Autosave to .benchmarks",
"type": "shell",
- "command": "pytest -m performance --benchmark-autosave --benchmark-save-data",
- "options": {
- "cwd": "${workspaceFolder}"
- },
- "group": "none",
- "problemMatcher": []
+ "command": "python -m pytest -m performance --benchmark-autosave --benchmark-save-data"
},
{
"label": "Benchmark: Focus Autosave to .benchmarks",
"type": "shell",
- "command": "pytest -m \"performance and perf_focus\" --benchmark-autosave --benchmark-save-data",
- "options": {
- "cwd": "${workspaceFolder}"
- },
- "group": "none",
- "problemMatcher": []
+ "command": "python -m pytest -m \"performance and perf_focus\" --benchmark-autosave --benchmark-save-data"
},
{
"label": "Benchmark: List Saved Runs",
"type": "shell",
- "command": "pytest-benchmark list",
- "options": {
- "cwd": "${workspaceFolder}"
- },
- "group": "none",
- "problemMatcher": []
+ "command": "pytest-benchmark list"
},
{
"label": "Benchmark: Compare Saved Runs",
"type": "shell",
- "command": "pytest-benchmark compare ${input:benchBase} ${input:benchTarget}",
- "options": {
- "cwd": "${workspaceFolder}"
- },
- "group": "none",
- "problemMatcher": []
+ "command": "pytest-benchmark compare ${input:benchBase} ${input:benchTarget}"
}
],
"inputs": [
diff --git a/README.md b/README.md
index 1b32e6cc..e2d33019 100644
--- a/README.md
+++ b/README.md
@@ -22,9 +22,9 @@ Visit our project site for more information:
### Windows
-1. Install .NET SDK (6.0 or newer):
+1. Install .NET SDK (8.0 or newer):
- Download from [Microsoft .NET Downloads](https://dotnet.microsoft.com/download)
- - Or using winget: `winget install Microsoft.DotNet.SDK.6`
+ - Or using winget: `winget install Microsoft.DotNet.SDK.8`
- Verify: `dotnet --info`
2. Install the package:
@@ -35,7 +35,7 @@ Visit our project site for more information:
### macOS
-1. Install .NET SDK (6.0 or newer):
+1. Install .NET SDK (8.0 or newer):
```bash
brew install dotnet-sdk
diff --git a/benchmarks/conftest.py b/benchmarks/conftest.py
index 28aaf09e..c6518ee3 100644
--- a/benchmarks/conftest.py
+++ b/benchmarks/conftest.py
@@ -35,7 +35,7 @@ def get_data_from_csv(filename):
data_path = quotes_dir / f"{filename}.csv"
logger.debug("Loading benchmark data from: %s", data_path)
- with open(data_path, "r", newline="", encoding="utf-8") as csvfile:
+ with open(data_path, newline="", encoding="utf-8") as csvfile:
reader = csv.reader(csvfile)
data = list(reader)
return data[1:] # skips the first row, those are headers
@@ -62,9 +62,10 @@ def parse_date(date_str):
@pytest.fixture(scope="session")
-def raw_data(filename: str = 'Default'):
+def raw_data(filename: str = "Default"):
return get_data_from_csv(filename)
+
@pytest.fixture(scope="session")
def quotes(days: int = 502):
rows = get_data_from_csv("Default")
diff --git a/benchmarks/test_benchmark_indicators.py b/benchmarks/test_benchmark_indicators.py
index 5a18555e..ef3f2ca5 100644
--- a/benchmarks/test_benchmark_indicators.py
+++ b/benchmarks/test_benchmark_indicators.py
@@ -6,7 +6,6 @@
@pytest.mark.performance
class TestPerformance:
-
def test_benchmark_adl(self, benchmark, quotes):
benchmark(indicators.get_adl, quotes)
@@ -262,17 +261,20 @@ def test_benchmark_converting_to_IndicatorResults(self, benchmark, quotes):
from stock_indicators._cslib import CsIndicator
from stock_indicators.indicators.common.enums import CandlePart
from stock_indicators.indicators.common.quote import Quote
- from stock_indicators.indicators.sma import SMAResults, SMAResult
+ from stock_indicators.indicators.sma import SMAResult, SMAResults
candle_part: CandlePart = CandlePart.CLOSE
lookback_periods = 12
- quotes = Quote.use(quotes * 1000, candle_part) # Error occurs if not assigned to local var.
+ quotes = Quote.use(
+ quotes * 1000, candle_part
+ ) # Error occurs if not assigned to local var.
results = CsIndicator.GetSma(quotes, lookback_periods)
benchmark(SMAResults, results, SMAResult)
def test_benchmark_converting_to_CsDecimal(self, benchmark, raw_data):
from stock_indicators._cstypes import Decimal as CsDecimal
+
raw_data = raw_data * 1000
def convert_to_quotes(rows):
diff --git a/docs/Gemfile.lock b/docs/Gemfile.lock
index 62504987..30c558ea 100644
--- a/docs/Gemfile.lock
+++ b/docs/Gemfile.lock
@@ -40,7 +40,7 @@ GEM
ffi (>= 1.15.0)
eventmachine (1.2.7)
execjs (2.10.0)
- faraday (2.13.4)
+ faraday (2.14.0)
faraday-net_http (>= 2.0, < 3.5)
json
logger
@@ -261,7 +261,7 @@ GEM
rb-fsevent (0.11.2)
rb-inotify (0.11.1)
ffi (~> 1.0)
- rexml (3.4.1)
+ rexml (3.4.2)
rouge (3.30.0)
rubyzip (2.4.1)
safe_yaml (1.0.5)
@@ -286,7 +286,7 @@ GEM
unicode-display_width (1.8.0)
uri (1.0.3)
wdm (0.2.0)
- webrick (1.9.1)
+ webrick (1.9.2)
PLATFORMS
x64-mingw-ucrt
diff --git a/docs/_indicators/AtrStop.md b/docs/_indicators/AtrStop.md
index bcd6979e..a31a03ba 100644
--- a/docs/_indicators/AtrStop.md
+++ b/docs/_indicators/AtrStop.md
@@ -89,7 +89,6 @@ Created by Welles Wilder, the ATR Trailing Stop indicator attempts to determine
-
### Sources
- [C# core]({{site.dotnet.src}}/a-d/AtrStop/AtrStop.Series.cs)
diff --git a/docs/contributing.md b/docs/contributing.md
index 5f9b786c..7e1b7a00 100644
--- a/docs/contributing.md
+++ b/docs/contributing.md
@@ -50,11 +50,9 @@ For new features, submit an issue with the `enhancement` label.
## Development Environment (Quick Setup)
-- Recommended tools: Git, Node.js, npm, Docker, Python, Docker Desktop, Visual Studio Code (see `.vscode/extensions.json` for recommended extensions).
-- This project supports [VS Code Dev Containers](https://code.visualstudio.com/docs/remote/containers) for a consistent development environment. Open the project in VS Code and select "Reopen in Container" (requires the Remote - Containers extension).
-- You can test GitHub Actions workflows locally using [`act`](https://github.com/nektos/act), which is preinstalled in the devcontainer. Example: `act -l` to list workflows, `act` to run all workflows.
-
-For more details, see the [official documentation](https://github.com/nektos/act#readme) and the project README.
+- Recommended tools: Git, Python 3.8+, Docker (optional), and Visual Studio Code (see `.vscode/extensions.json` for recommended extensions).
+- This project supports [VS Code Dev Containers](https://code.visualstudio.com/docs/remote/containers) for a consistent development environment. Open the project in VS Code and select "Reopen in Container" (requires the Dev Containers extension).
+- Local installs are plain `pip + venv`; no Poetry/Conda/Hatch required.
---
@@ -68,10 +66,10 @@ For more details, see the [official documentation](https://github.com/nektos/act
### Windows Setup
-1. Install .NET SDK (6.0 or newer):
+1. Install .NET SDK (8.0 or newer):
```powershell
- winget install Microsoft.DotNet.SDK.6
+ winget install Microsoft.DotNet.SDK.8
# Or download from https://dotnet.microsoft.com/download
```
@@ -80,13 +78,15 @@ For more details, see the [official documentation](https://github.com/nektos/act
```powershell
git clone https://github.com/facioquo/stock-indicators-python.git
cd stock-indicators-python
- pip install -r requirements.txt
- pip install -r requirements-test.txt
+ python -m venv .venv
+ .venv\Scripts\python -m pip install --upgrade pip
+ .venv\Scripts\python -m pip install -e .
+ .venv\Scripts\python -m pip install -r requirements-test.txt
```
### macOS Setup
-1. Install .NET SDK (6.0 or newer):
+1. Install .NET SDK (8.0 or newer):
```bash
brew install dotnet-sdk
@@ -97,13 +97,16 @@ For more details, see the [official documentation](https://github.com/nektos/act
```bash
git clone https://github.com/facioquo/stock-indicators-python.git
cd stock-indicators-python
- pip install -r requirements.txt
- pip install -r requirements-test.txt
+ python -m venv .venv
+ source .venv/bin/activate
+ python -m pip install --upgrade pip
+ python -m pip install -e .
+ python -m pip install -r requirements-test.txt
```
## Testing
-- We use [pytest](https://docs.pytest.org) for testing.
+- We use [Ruff](https://docs.astral.sh/ruff/) for linting/formatting, [Pyright](https://microsoft.github.io/pyright/) for type checking, and [pytest](https://docs.pytest.org) for tests. `pip-audit` runs in CI.
- Review the `tests` folder for examples of unit tests. Just copy one of these.
- New indicators should be tested against manually calculated, proven, accurate results. It is helpful to include your manual calculations spreadsheet in the appropriate indicator folder when [submitting changes](#submitting-changes).
- Historical Stock Quotes are automatically added as pytest fixtures. The various `.csv` files in the `samples` folder are used in the unit tests. See `tests/conftest.py` for their usage. A `History.xlsx` Excel file is also included in the `samples` folder that contains the same information but separated by sheets. Use this for your manual calculations to ensure that it is correct. Do not commit changes to this Excel file.
@@ -112,41 +115,38 @@ For more details, see the [official documentation](https://github.com/nektos/act
### Running Tests
+Common commands (after activating `.venv`):
+
```bash
-# install core dependencies
-pip install -r requirements.txt
+# lint and format
+python -m ruff check .
+python -m ruff format --check .
-# install dependencies
-pip install -r requirements-test.txt
+# type-check
+python -m pyright
# run standard unit tests
-pytest
+python -m pytest
```
-To run different types of tests, use the following commands:
-
-- **Normal unit tests** (default):
-
- ```bash
- pytest
- ```
+To run different types of tests:
- **Non-standard `localization` tests**:
```bash
- pytest -m "localization"
+ python -m pytest -m "localization"
```
- **Performance tests**:
```bash
- pytest -m "performance"
+ python -m pytest -m "performance"
```
- **All tests** (not recommended):
```bash
- pytest -m ""
+ python -m pytest -m ""
```
You can also use the `-svr A` arguments with pytest to get more detailed output:
@@ -161,14 +161,14 @@ pytest -svr A
### Performance benchmarking
-Running the commands below in your console will show performance data. You can find the latest results [here]({{site.baseurl}}/performance/).
+Running the commands below in your console will produce [benchmark performance data](https://python.stockindicators.dev/performance/) that we include on our documentation site.
```bash
# install dependencies
-pip install -r requirements-test.txt
+python -m pip install -r requirements-test.txt
# run performance tests
-pytest -m "performance"
+python -m pytest -m "performance"
```
## Documentation
diff --git a/docs/pages/guide.md b/docs/pages/guide.md
index 1cc644c1..53c9fe5f 100644
--- a/docs/pages/guide.md
+++ b/docs/pages/guide.md
@@ -31,11 +31,11 @@ layout: page
> Install **Python** and the **.NET SDK**. Use the latest versions for better performance.
| Installer | Min | Latest | Download |
- |---| :---: | :---: | --- |
- | Python | 3.8 | 3.12 | [@python.org](https://www.python.org/downloads/) |
- | .NET SDK | 6.0 | 8.0 | [@microsoft.com](https://dotnet.microsoft.com/en-us/download) |
+ | --- | :---: | :---: | --- |
+ | Python | 3.8 | 3.13 | [@python.org](https://www.python.org/downloads/) |
+ | .NET SDK | 8.0 | 10.0 | [@microsoft.com](https://dotnet.microsoft.com/en-us/download) |
- Note: we do not support the open source [Mono .NET Framework](https://www.mono-project.com).
+ Note: we do not support the open source [Mono .NET Framework](https://www.mono-project.com). Python 3.14+ is not yet supported due to `pythonnet` compatibility.
2. Install the **stock-indicators** Python package into your environment.
@@ -127,7 +127,7 @@ from stock_indicators.indicators.common.quote import Quote
[[source]](https://github.com/facioquo/stock-indicators-python/blob/main/stock_indicators/indicators/common/quote.py)
| name | type | notes |
-| -- |-- |-- |
+| ---- | ---- | ----- |
| date | [`datetime.datetime`](https://docs.python.org/3.8/library/datetime.html#datetime.datetime) | Date |
| open | [`decimal.Decimal`](https://docs.python.org/3.8/library/decimal.html?highlight=decimal#decimal.Decimal), Optional | Open price |
| high | [`decimal.Decimal`](https://docs.python.org/3.8/library/decimal.html?highlight=decimal#decimal.Decimal), Optional | High price |
@@ -289,7 +289,7 @@ from stock_indicators.indicators.common.enums import Match
```
| type | description |
-|-- |:-- |
+| ---- | :---------- |
| `Match.BULL_CONFIRMED` | Confirmation of a prior bull Match |
| `Match.BULL_SIGNAL` | Matching bullish pattern |
| `Match.BULL_BASIS` | Bars supporting a bullish Match |
@@ -303,23 +303,23 @@ from stock_indicators.indicators.common.enums import Match
The `CandleProperties` class is an extended version of `Quote`, and contains additional calculated properties.
-| name | type | notes |
-| -- |-- |-- |
-| `date` | datetime | Date |
-| `open` | Decimal | Open price |
-| `high` | Decimal | High price |
-| `low` | Decimal | Low price |
-| `close` | Decimal | Close price |
-| `volume` | Decimal | Volume |
-| `size` | Decimal, Optional | `high-low` |
-| `body` | Decimal, Optional | `|open-close|` |
-| `upper_wick` | Decimal, Optional | Upper wick size |
-| `lower_wick` | Decimal, Optional | Lower wick size |
-| `body_pct` | float, Optional | `body/size` |
-| `upper_wick_pct` | float, Optional | `upper_wick/size` |
-| `lower_wick_pct` | float, Optional | `lower_wick/size` |
-| `is_bullish` | bool | `close>open` direction |
-| `is_bearish` | bool | `closeopen` direction |
+| `is_bearish` | bool | `close=3.0.0",
+ "pythonnet>=3.0.5",
"typing_extensions>=4.4.0"
]
keywords = [
@@ -61,3 +61,56 @@ exclude = ["tests*", "benchmarks*", "test_data*", "docs*"]
# can be empty if no extra settings are needed, presence enables setuptools_scm
[tool.setuptools_scm]
local_scheme = "no-local-version"
+
+[tool.ruff]
+target-version = "py38"
+line-length = 88
+
+[tool.ruff.lint]
+select = [
+ "E", # pycodestyle errors
+ "F", # pyflakes
+ "I", # import sorting
+ "B", # flake8-bugbear
+ "UP", # pyupgrade
+ "C4", # flake8-comprehensions
+ "TID",# flake8-tidy-imports
+ "PT", # flake8-pytest-style
+ "RUF" # Ruff-specific rules
+]
+ignore = [
+ "B905", # allow zip without strict length check on py38 support floor
+ "E501" # allow longer docstrings/comments
+]
+
+[tool.ruff.lint.isort]
+known-first-party = ["stock_indicators"]
+
+[tool.ruff.lint.per-file-ignores]
+"stock_indicators/__init__.py" = ["F401", "F403"]
+"stock_indicators/_cslib/__init__.py" = ["F401"]
+"stock_indicators/_cstypes/__init__.py" = ["F401"]
+"stock_indicators/indicators/__init__.py" = ["F401"]
+
+[tool.ruff.format]
+quote-style = "double"
+
+[tool.pyright]
+include = ["stock_indicators", "tests"]
+pythonVersion = "3.8"
+typeCheckingMode = "standard"
+useLibraryCodeForTypes = true
+reportMissingImports = "none"
+reportMissingModuleSource = "none"
+reportMissingTypeStubs = "none"
+stubPath = "typings"
+exclude = ["typings"]
+reportInvalidTypeForm = "none"
+reportAttributeAccessIssue = "none"
+reportOperatorIssue = "none"
+reportReturnType = "none"
+reportGeneralTypeIssues = "none"
+reportArgumentType = "none"
+reportInconsistentOverload = "none"
+reportIndexIssue = "none"
+reportCallIssue = "none"
diff --git a/requirements-test.txt b/requirements-test.txt
index 48573f14..90f51398 100644
--- a/requirements-test.txt
+++ b/requirements-test.txt
@@ -3,3 +3,6 @@ pytest
pytest-cov
pytest-benchmark
backports.zoneinfo; python_version < '3.9'
+ruff
+pyright
+pip-audit
diff --git a/requirements.txt b/requirements.txt
index 9045a0c0..91659dac 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -1,3 +1,3 @@
# _cslib
-pythonnet>=3.0.0
+pythonnet>=3.0.5
typing_extensions>=4.4.0
diff --git a/stock_indicators/__init__.py b/stock_indicators/__init__.py
index f2d5deb1..c7561952 100644
--- a/stock_indicators/__init__.py
+++ b/stock_indicators/__init__.py
@@ -15,4 +15,11 @@
"""
from stock_indicators import indicators
+from stock_indicators.exceptions import (
+ IndicatorCalculationError,
+ StockIndicatorsError,
+ StockIndicatorsInitializationError,
+ TypeConversionError,
+ ValidationError,
+)
from stock_indicators.indicators.common import *
diff --git a/stock_indicators/_cslib/__init__.py b/stock_indicators/_cslib/__init__.py
index defaa45b..90d3b8b0 100644
--- a/stock_indicators/_cslib/__init__.py
+++ b/stock_indicators/_cslib/__init__.py
@@ -1,96 +1,158 @@
"""
Skender.Stock.Indicators
~~~~~~~~~~~~~~~~~~~~~~~~
+# pylint: disable=duplicate-code # Property patterns are expected to repeat
-This module loads `Skender.Stock.Indicators.dll`(v2.6.1), which is a compiled library
+This module loads `Skender.Stock.Indicators.dll`(v2.7.1), which is a compiled library
package from , written in C#.
-The target framework of dll is `.NET 6.0`.
+The target framework of dll is `.NET 8.0`.
"""
import logging
import platform
from pathlib import Path
+from typing import Any
from pythonnet import load
-# Setup logging
+from stock_indicators.exceptions import StockIndicatorsInitializationError
from stock_indicators.logging_config import configure_logging
+# Setup logging
configure_logging(debug=False) # Set to True if you need debug this module
logger = logging.getLogger(__name__)
-try:
- # Load CLR
- load(runtime="coreclr")
- import clr
- logger.debug("CLR loaded successfully on %s", platform.system())
- # Get absolute paths
- base_path = Path(__file__).parent.resolve()
- dll_path = base_path / "lib" / "Skender.Stock.Indicators.dll"
-
- # Set assembly resolve path
- from System import IO, AppDomain
+def _initialize_clr() -> Any:
+ """Initialize the CLR runtime."""
+ try:
+ load(runtime="coreclr")
+ import clr as clr_module
+
+ logger.debug("CLR loaded successfully on %s", platform.system())
+ return clr_module
+ except Exception as e:
+ init_error_msg = (
+ "Failed to load .NET CLR runtime.\n"
+ "Please ensure .NET 8.0+ is installed: https://dotnet.microsoft.com/download\n"
+ f"Platform: {platform.system()}\n"
+ f"Error: {e!s}"
+ )
+ raise StockIndicatorsInitializationError(init_error_msg) from e
+
+
+def _setup_assembly_probing(assembly_dll_path: Path) -> None:
+ """Setup assembly probing path for .NET dependency resolution."""
+ try:
+ from System import IO, AppDomain
+
+ current_domain = AppDomain.CurrentDomain
+ assembly_path = IO.Path.GetDirectoryName(str(assembly_dll_path))
+ current_domain.SetData("PROBING_PATH", assembly_path)
+ logger.debug("Set assembly probing path to: %s", assembly_path)
+ except Exception as e: # pylint: disable=broad-exception-caught
+ # Broad exception catch is necessary for C# interop
+ logger.warning("Failed to set assembly probing path: %s", e)
- current_domain = AppDomain.CurrentDomain
- assembly_path = IO.Path.GetDirectoryName(str(dll_path))
- current_domain.SetData("PROBING_PATH", assembly_path)
- logger.debug("Set assembly probing path to: %s", assembly_path)
+def _load_assembly(assembly_dll_path: Path):
+ """Load the Stock Indicators assembly."""
try:
- # Load the assembly first
from System.Reflection import Assembly
- logger.debug("Loading assembly from: %s", dll_path)
- assembly = Assembly.LoadFile(str(dll_path))
- logger.debug("Assembly loaded: %s", assembly.FullName)
+ if not assembly_dll_path.exists():
+ raise FileNotFoundError(f"Assembly not found at: {assembly_dll_path}")
+
+ logger.debug("Loading assembly from: %s", assembly_dll_path)
+ loaded_assembly = Assembly.LoadFile(str(assembly_dll_path))
+ logger.debug("Assembly loaded: %s", loaded_assembly.FullName)
- # Add reference after successful load
- clr.AddReference(assembly.FullName) # pylint: disable=no-member
- logger.debug("Assembly reference added")
+ return loaded_assembly
+ except Exception as e:
+ load_error_msg = (
+ f"Failed to load Stock Indicators assembly from: {assembly_dll_path}\n"
+ "Please ensure the .NET assembly is present and compatible.\n"
+ f"Error: {e!s}"
+ )
+ raise StockIndicatorsInitializationError(load_error_msg) from e
- except Exception as asm_error:
- logger.error("Error loading assembly: %s", str(asm_error))
- if hasattr(asm_error, "LoaderExceptions"):
- for ex in asm_error.LoaderExceptions:
- logger.error("Loader exception: %s", str(ex))
- raise
+
+def _add_assembly_reference(loaded_assembly, clr_module) -> None:
+ """Add reference to the loaded assembly."""
+ try:
+ clr_module.AddReference(loaded_assembly.FullName) # pylint: disable=no-member
+ logger.debug("Assembly reference added successfully")
+ except Exception as e:
+ ref_error_msg = (
+ f"Failed to add reference to assembly: {loaded_assembly.FullName}\n"
+ f"Error: {e!s}"
+ )
+ raise StockIndicatorsInitializationError(ref_error_msg) from e
+
+
+try:
+ # Initialize CLR
+ clr = _initialize_clr()
+
+ # Get assembly path
+ base_path = Path(__file__).parent.resolve()
+ dll_path = base_path / "lib" / "Skender.Stock.Indicators.dll"
+
+ # Setup assembly probing
+ _setup_assembly_probing(dll_path)
+
+ # Load assembly
+ assembly = _load_assembly(dll_path)
+
+ # Add assembly reference
+ _add_assembly_reference(assembly, clr)
except Exception as e:
- logger.error("Detailed error information: %s", str(e))
- if hasattr(e, "__cause__") and e.__cause__ is not None:
- logger.error("Caused by: %s", str(e.__cause__))
+ # Re-raise our custom exception or wrap unexpected errors
+ if not isinstance(e, StockIndicatorsInitializationError):
+ error_msg = (
+ "Stock Indicators initialization failed due to unexpected error.\n"
+ "Please ensure .NET 8.0+ is installed: https://dotnet.microsoft.com/download\n"
+ f"Error: {e!s}"
+ )
+ raise StockIndicatorsInitializationError(error_msg) from e
+ raise
+
+# Library modules (common) - Import after successful initialization
+try:
+ from Skender.Stock.Indicators import BetaType as CsBetaType
+ from Skender.Stock.Indicators import CandlePart as CsCandlePart
+ from Skender.Stock.Indicators import CandleProperties as CsCandleProperties
+ from Skender.Stock.Indicators import ChandelierType as CsChandelierType
+ from Skender.Stock.Indicators import EndType as CsEndType
+ from Skender.Stock.Indicators import Indicator as CsIndicator
+ from Skender.Stock.Indicators import Match as CsMatch
+ from Skender.Stock.Indicators import MaType as CsMaType
+ from Skender.Stock.Indicators import PeriodSize as CsPeriodSize
+ from Skender.Stock.Indicators import PivotPointType as CsPivotPointType
+ from Skender.Stock.Indicators import PivotTrend as CsPivotTrend
+ from Skender.Stock.Indicators import Quote as CsQuote
+ from Skender.Stock.Indicators import QuoteUtility as CsQuoteUtility
+ from Skender.Stock.Indicators import ResultBase as CsResultBase
+ from Skender.Stock.Indicators import ResultUtility as CsResultUtility
+
+ # Built-in System types
+ from System import DateTime as CsDateTime
+ from System import Decimal as CsDecimal
+ from System import Enum as CsEnum
+ from System.Collections.Generic import IEnumerable as CsIEnumerable
+ from System.Collections.Generic import List as CsList
+ from System.Globalization import CultureInfo as CsCultureInfo
+ from System.Globalization import NumberStyles as CsNumberStyles
+
+ logger.info("Stock Indicators library initialized successfully")
+
+except ImportError as e:
error_msg = (
- "Stock Indicators initialization failed.\n"
- "Please ensure .NET 6.0+ is installed: https://dotnet.microsoft.com/download\n"
- f"Error: {str(e)}"
+ "Failed to import Stock Indicators types after successful assembly loading.\n"
+ "This may indicate a version mismatch or missing dependencies.\n"
+ f"Error: {e!s}"
)
- raise ImportError(error_msg) from e
-
-# Library modules (common)
-from Skender.Stock.Indicators import BetaType as CsBetaType
-from Skender.Stock.Indicators import CandlePart as CsCandlePart
-from Skender.Stock.Indicators import CandleProperties as CsCandleProperties
-from Skender.Stock.Indicators import ChandelierType as CsChandelierType
-from Skender.Stock.Indicators import EndType as CsEndType
-from Skender.Stock.Indicators import Indicator as CsIndicator
-from Skender.Stock.Indicators import Match as CsMatch
-from Skender.Stock.Indicators import MaType as CsMaType
-from Skender.Stock.Indicators import PeriodSize as CsPeriodSize
-from Skender.Stock.Indicators import PivotPointType as CsPivotPointType
-from Skender.Stock.Indicators import PivotTrend as CsPivotTrend
-from Skender.Stock.Indicators import Quote as CsQuote
-from Skender.Stock.Indicators import QuoteUtility as CsQuoteUtility
-from Skender.Stock.Indicators import ResultBase as CsResultBase
-from Skender.Stock.Indicators import ResultUtility as CsResultUtility
-
-# Built-in
-from System import DateTime as CsDateTime
-from System import Decimal as CsDecimal
-from System import Enum as CsEnum
-from System.Collections.Generic import IEnumerable as CsIEnumerable
-from System.Collections.Generic import List as CsList
-from System.Globalization import CultureInfo as CsCultureInfo
-from System.Globalization import NumberStyles as CsNumberStyles
+ raise StockIndicatorsInitializationError(error_msg) from e
diff --git a/stock_indicators/_cslib/lib/Skender.Stock.Indicators.dll b/stock_indicators/_cslib/lib/Skender.Stock.Indicators.dll
index 5351569df45c68b08cd7a3f8ac9fdc0336c8fe42..454e6c608872fdc723381ee5a44256b47b881d0d 100644
GIT binary patch
literal 218112
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%0AK8*
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