sdtoolkit 0.1.0__tar.gz

sdtoolkit-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ramesh-xyz
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

sdtoolkit-0.1.0/PKG-INFO

@@ -0,0 +1,247 @@
+Metadata-Version: 2.4
+Name: sdtoolkit
+Version: 0.1.0
+Summary: Dependency-free standard deviation, variance and relative standard deviation for Python
+Author: Ramesh-xyz
+License-Expression: MIT
+Project-URL: Homepage, https://standarddeviationcalculator.net/
+Project-URL: Documentation, https://ramesh-xyz.github.io/statistics-calculator-toolkit/python.html
+Project-URL: Source, https://github.com/Ramesh-xyz/statistics-calculator-toolkit
+Project-URL: Issues, https://github.com/Ramesh-xyz/statistics-calculator-toolkit/issues
+Project-URL: Changelog, https://github.com/Ramesh-xyz/statistics-calculator-toolkit/blob/main/CHANGELOG.md
+Keywords: standard deviation,variance,coefficient of variation,statistics
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Scientific/Engineering :: Mathematics
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# sdtoolkit for Python
+
+Part of [statistics-calculator-toolkit](https://github.com/Ramesh-xyz/statistics-calculator-toolkit), which ships the same API for
+[several languages](https://ramesh-xyz.github.io/statistics-calculator-toolkit/).
+
+`sdtoolkit` is a small, dependency-free Python package for standard
+deviation, variance, sum of squares, relative standard deviation (RSD) and
+coefficient of variation, with a command-line interface. It uses only the
+standard library and supports Python 3.9 and later.
+
+## Problems it solves
+
+- **Picking the wrong formula.** Population and sample versions have
+  separate, explicitly named functions, and the CLI prints which divisor it
+  used.
+- **Silent precision loss.** The shortcut `Σx² − (Σx)²/n` can return zero or
+  even a negative variance for data far from zero. sdtoolkit uses a two-pass
+  algorithm with `math.fsum`.
+- **Garbage in, number out.** `None`, `NaN`, infinities, booleans and strings
+  raise a clear error instead of producing a plausible-looking result. Missing
+  values are never skipped silently.
+- **Undefined RSD.** A zero mean raises an error instead of returning
+  infinity or dividing by zero.
+
+## Features
+
+| function | returns |
+|---|---|
+| `mean(data)` | arithmetic mean |
+| `sum_of_squares(data)` | SS = Σ(x − x̄)² |
+| `population_variance(data)` | SS / N |
+| `sample_variance(data)` | SS / (n − 1) |
+| `population_stdev(data)` | √(SS / N) |
+| `sample_stdev(data)` | √(SS / (n − 1)) |
+| `relative_std_dev(data, population=False)` | 100 × SD / \|mean\|, in percent |
+| `coefficient_of_variation(data, population=False)` | SD / \|mean\|, as a ratio |
+| `describe(data, population=False)` | `Summary` dataclass with all of the above plus min, max, range |
+
+All errors are raised as `sdtoolkit.StatisticsError`, a subclass of
+`ValueError`.
+
+## Install
+
+```
+pip install sdtoolkit
+```
+
+Or from a clone, without installing:
+
+```
+PYTHONPATH=src python -m sdtoolkit 1 2 3
+```
+
+## Usage
+
+### Python
+
+```python
+>>> import sdtoolkit as sd
+>>> data = [2, 4, 4, 4, 5, 5, 7, 9]
+>>> sd.mean(data)
+5.0
+>>> sd.sum_of_squares(data)
+32.0
+>>> sd.population_variance(data), sd.population_stdev(data)
+(4.0, 2.0)
+>>> sd.sample_variance(data), sd.sample_stdev(data)
+(4.571428571428571, 2.138089935299395)
+>>> sd.relative_std_dev(data)
+42.7617987059879
+>>> sd.coefficient_of_variation(data, population=True)
+0.4
+>>> sd.describe(data)
+Summary(n=8, mean=5.0, minimum=2.0, maximum=9.0, range=7.0, sum_of_squares=32.0, variance=4.571428571428571, stdev=2.138089935299395, rsd_percent=42.7617987059879, population=False)
+>>> sd.describe(data, population=True).as_dict()["stdev"]
+2.0
+```
+
+### Command line
+
+```console
+$ python -m sdtoolkit 2 4 4 4 5 5 7 9
+n                8
+mean             5
+min              2
+max              9
+range            7
+sum of squares   32
+sample variance  4.571428571
+sample std dev   2.138089935
+RSD (%)          42.76179871
+(divisor: n - 1)
+```
+
+```console
+$ python -m sdtoolkit --population 2 4 4 4 5 5 7 9
+n                    8
+mean                 5
+min                  2
+max                  9
+range                7
+sum of squares       32
+population variance  4
+population std dev   2
+RSD (%)              40
+(divisor: N)
+```
+
+Read one column of a CSV file (lines starting with `#` are treated as
+comments):
+
+```console
+$ python -m sdtoolkit --csv examples/sample-datasets.csv --column lab_replicate_mg_l
+n                10
+mean             12.405
+min              12.36
+max              12.45
+range            0.09
+sum of squares   0.00825
+sample variance  0.0009166666667
+sample std dev   0.03027650354
+RSD (%)          0.244066937
+(divisor: n - 1)
+```
+
+Errors go to stderr with exit status 1:
+
+```console
+$ python -m sdtoolkit 1 2 x
+error: argument 3: 'x' is not a number
+$ python -m sdtoolkit 5
+error: sample statistics need at least 2 data points, got 1
+```
+
+After `pip install .` the same CLI is also available as `sdtoolkit`.
+
+## Population vs sample
+
+Use the population functions when your data are the entire group you are
+describing. Use the sample functions when your data are drawn from a larger
+group you want to draw conclusions about. The sample formulas divide by
+n − 1 (Bessel's correction), which makes the sample variance an unbiased
+estimate of the population variance, and they need at least two values.
+
+`describe`, `relative_std_dev`, `coefficient_of_variation` and the CLI
+default to the sample formulas. Details:
+[Sample vs population](https://ramesh-xyz.github.io/statistics-calculator-toolkit/sample-vs-population.html).
+
+## Formulas
+
+```
+x̄   = Σxᵢ / n
+SS   = Σ (xᵢ − x̄)²
+σ²   = SS / N              σ = √σ²
+s²   = SS / (n − 1)        s = √s²
+CV   = s / |x̄|
+RSD  = 100 × s / |x̄|  %
+```
+
+A step-by-step walk-through of these formulas is on the
+[standard deviation formula reference](https://standarddeviationcalculator.net/standard-deviation-formula/).
+
+Further reading:
+
+- [Standard deviation](https://ramesh-xyz.github.io/statistics-calculator-toolkit/standard-deviation.html)
+- [Variance](https://ramesh-xyz.github.io/statistics-calculator-toolkit/variance.html)
+- [Sample vs population](https://ramesh-xyz.github.io/statistics-calculator-toolkit/sample-vs-population.html)
+- [Relative standard deviation](https://ramesh-xyz.github.io/statistics-calculator-toolkit/relative-standard-deviation.html)
+- [Outliers](https://ramesh-xyz.github.io/statistics-calculator-toolkit/outliers.html)
+
+## Example datasets
+
+[`examples/sample-datasets.csv`](https://github.com/Ramesh-xyz/statistics-calculator-toolkit/blob/main/examples/sample-datasets.csv) has three
+small columns: lab replicate readings, exam scores and daily temperatures.
+They are **illustrative values made up for teaching, not real research
+data.** [`examples/worked-examples.md`](https://github.com/Ramesh-xyz/statistics-calculator-toolkit/blob/main/examples/worked-examples.md) works
+through each one by hand and checks the result with the code.
+
+## Accuracy and edge cases
+
+- **Algorithm.** Two passes: the mean, then the squared deviations from it,
+  each summed with `math.fsum`. A correction term removes the rounding error
+  left in the mean. The test suite compares results with Python's
+  `statistics.pvariance`, `variance`, `pstdev` and `stdev` (which use exact
+  rational arithmetic) to a relative tolerance of 1e-12, including data
+  offset by 10⁹ and 10¹².
+- **Accepted input.** Any iterable of `int`, `float`, `decimal.Decimal` or
+  `fractions.Fraction`. Decimals and fractions are converted to `float`, so
+  their extra precision is not kept and results are always `float`.
+- **Rejected input.** `bool`, `None`, strings, NaN, ±infinity, complex
+  numbers, and integers too large for a float raise `StatisticsError` naming
+  the offending item.
+- **Missing values are not skipped.** `None` raises, and an empty CSV cell
+  raises with its row number. Remove or impute missing data yourself so the
+  choice is visible in your code.
+- **Empty input** raises. **Sample statistics with one value** raise.
+  Population variance of one value is 0.
+- **Zero mean.** `relative_std_dev` and `coefficient_of_variation` raise;
+  `describe` sets `rsd_percent` to `None`. RSD is only meaningful for
+  ratio-scale data; see
+  [Relative standard deviation](https://ramesh-xyz.github.io/statistics-calculator-toolkit/relative-standard-deviation.html).
+
+```python
+>>> sd.mean([1, None, 3])
+Traceback (most recent call last):
+  ...
+sdtoolkit.core.StatisticsError: item 1: None (missing value); remove or fill it before computing
+>>> sd.sample_stdev([1e9 + 4, 1e9 + 7, 1e9 + 13, 1e9 + 16]) ** 2
+30.0
+```
+
+## Tests
+
+```
+PYTHONPATH=src python -m unittest discover -s tests
+```
+
+The suite uses only `unittest`. GitHub Actions runs it on Python 3.9 to 3.13
+([workflow](https://github.com/Ramesh-xyz/statistics-calculator-toolkit/blob/main/.github/workflows/test-python.yml)).
+
+## Contributing
+
+See [CONTRIBUTING.md](https://github.com/Ramesh-xyz/statistics-calculator-toolkit/blob/main/CONTRIBUTING.md).
+
+## License
+
+MIT. See [LICENSE](https://github.com/Ramesh-xyz/statistics-calculator-toolkit/blob/main/LICENSE).

sdtoolkit-0.1.0/README.md

@@ -0,0 +1,103 @@
+# statistics-calculator-toolkit
+
+Small, dependency-free libraries for the mean, sum of squared deviations,
+population and sample variance, population and sample standard deviation,
+coefficient of variation and relative standard deviation (RSD). Ten
+languages share one API, one algorithm and one set of test vectors.
+
+Documentation: <https://ramesh-xyz.github.io/statistics-calculator-toolkit/>
+
+## Problems it solves
+
+- **Picking the wrong formula.** Population and sample versions are separate,
+  explicitly named functions.
+- **Silent precision loss.** The shortcut `Σx² − (Σx)²/n` can return zero or
+  a negative variance for data far from zero. Every implementation here uses
+  a corrected two-pass algorithm with compensated summation.
+- **Garbage in, number out.** NaN, infinities and (in dynamic languages)
+  `null`, booleans and strings raise an error naming the bad item. Missing
+  values are never skipped silently.
+- **Undefined RSD.** A zero mean raises an error instead of returning
+  infinity.
+
+## Packages
+
+| language | directory | registry | install |
+|---|---|---|---|
+| Python | [`src/sdtoolkit`](src/sdtoolkit) | PyPI | `pip install sdtoolkit` |
+| JavaScript / TypeScript | [`js`](js) | npm | `npm install @rameshxyz/sdtoolkit` |
+| Rust | [`rust`](rust) | crates.io | `cargo add sdtoolkit` |
+| Go | [`go/sdtoolkit`](go/sdtoolkit) | Go modules | `go get github.com/Ramesh-xyz/statistics-calculator-toolkit/go/sdtoolkit` |
+| R | [`r`](r) | CRAN | `install.packages("sdcalc")` |
+| Java / Kotlin | [`java`](java) | Maven Central | `io.github.ramesh-xyz:sdtoolkit` |
+| C# / .NET | [`dotnet`](dotnet) | NuGet | `dotnet add package SdToolkit` |
+| Ruby | [`ruby`](ruby) | RubyGems | `gem install sdtoolkit` |
+| PHP | [`php`](php) | Packagist | `composer require ramesh-xyz/sdtoolkit` |
+| Dart / Flutter | [`dart`](dart) | pub.dev | `dart pub add sdtoolkit` |
+
+Each package is released on its own from a git tag (see
+[RELEASING.md](RELEASING.md)); [CHANGELOG.md](CHANGELOG.md) lists what has
+shipped. Each directory's README has usage examples for that language. The
+Python package and its command-line tool are documented in
+[docs/python.md](docs/python.md).
+
+## Example
+
+```python
+>>> import sdtoolkit as sd
+>>> data = [2, 4, 4, 4, 5, 5, 7, 9]
+>>> sd.population_variance(data), sd.population_stdev(data)
+(4.0, 2.0)
+>>> sd.sample_variance(data), sd.sample_stdev(data)
+(4.571428571428571, 2.138089935299395)
+>>> sd.relative_std_dev(data)
+42.7617987059879
+```
+
+```console
+$ python -m sdtoolkit --population 2 4 4 4 5 5 7 9
+n                    8
+mean                 5
+min                  2
+max                  9
+range                7
+sum of squares       32
+population variance  4
+population std dev   2
+RSD (%)              40
+(divisor: N)
+```
+
+The same numbers come out of every language; [docs/api.md](docs/api.md)
+lists the function names per language, the shared edge-case behaviour and the
+floating-point differences.
+
+## Formulas
+
+```
+x̄   = Σxᵢ / n
+SS   = Σ (xᵢ − x̄)²
+σ²   = SS / N              σ = √σ²
+s²   = SS / (n − 1)        s = √s²
+CV   = s / |x̄|
+RSD  = 100 × s / |x̄|  %
+```
+
+Guides: [standard deviation](docs/standard-deviation.md),
+[variance](docs/variance.md),
+[sample vs population](docs/sample-vs-population.md),
+[relative standard deviation](docs/relative-standard-deviation.md),
+[outliers](docs/outliers.md). Illustrative datasets and hand-worked examples
+are in [examples/](examples).
+
+## Interactive Standard Deviation Calculator
+
+For an interactive online calculator and additional worked examples, visit [StandardDeviationCalculator.net](https://standarddeviationcalculator.net/).
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md).
+
+## License
+
+MIT. See [LICENSE](LICENSE).

sdtoolkit-0.1.0/docs/python.md

@@ -0,0 +1,227 @@
+# sdtoolkit for Python
+
+Part of [statistics-calculator-toolkit](https://github.com/Ramesh-xyz/statistics-calculator-toolkit), which ships the same API for
+[several languages](https://ramesh-xyz.github.io/statistics-calculator-toolkit/).
+
+`sdtoolkit` is a small, dependency-free Python package for standard
+deviation, variance, sum of squares, relative standard deviation (RSD) and
+coefficient of variation, with a command-line interface. It uses only the
+standard library and supports Python 3.9 and later.
+
+## Problems it solves
+
+- **Picking the wrong formula.** Population and sample versions have
+  separate, explicitly named functions, and the CLI prints which divisor it
+  used.
+- **Silent precision loss.** The shortcut `Σx² − (Σx)²/n` can return zero or
+  even a negative variance for data far from zero. sdtoolkit uses a two-pass
+  algorithm with `math.fsum`.
+- **Garbage in, number out.** `None`, `NaN`, infinities, booleans and strings
+  raise a clear error instead of producing a plausible-looking result. Missing
+  values are never skipped silently.
+- **Undefined RSD.** A zero mean raises an error instead of returning
+  infinity or dividing by zero.
+
+## Features
+
+| function | returns |
+|---|---|
+| `mean(data)` | arithmetic mean |
+| `sum_of_squares(data)` | SS = Σ(x − x̄)² |
+| `population_variance(data)` | SS / N |
+| `sample_variance(data)` | SS / (n − 1) |
+| `population_stdev(data)` | √(SS / N) |
+| `sample_stdev(data)` | √(SS / (n − 1)) |
+| `relative_std_dev(data, population=False)` | 100 × SD / \|mean\|, in percent |
+| `coefficient_of_variation(data, population=False)` | SD / \|mean\|, as a ratio |
+| `describe(data, population=False)` | `Summary` dataclass with all of the above plus min, max, range |
+
+All errors are raised as `sdtoolkit.StatisticsError`, a subclass of
+`ValueError`.
+
+## Install
+
+```
+pip install sdtoolkit
+```
+
+Or from a clone, without installing:
+
+```
+PYTHONPATH=src python -m sdtoolkit 1 2 3
+```
+
+## Usage
+
+### Python
+
+```python
+>>> import sdtoolkit as sd
+>>> data = [2, 4, 4, 4, 5, 5, 7, 9]
+>>> sd.mean(data)
+5.0
+>>> sd.sum_of_squares(data)
+32.0
+>>> sd.population_variance(data), sd.population_stdev(data)
+(4.0, 2.0)
+>>> sd.sample_variance(data), sd.sample_stdev(data)
+(4.571428571428571, 2.138089935299395)
+>>> sd.relative_std_dev(data)
+42.7617987059879
+>>> sd.coefficient_of_variation(data, population=True)
+0.4
+>>> sd.describe(data)
+Summary(n=8, mean=5.0, minimum=2.0, maximum=9.0, range=7.0, sum_of_squares=32.0, variance=4.571428571428571, stdev=2.138089935299395, rsd_percent=42.7617987059879, population=False)
+>>> sd.describe(data, population=True).as_dict()["stdev"]
+2.0
+```
+
+### Command line
+
+```console
+$ python -m sdtoolkit 2 4 4 4 5 5 7 9
+n                8
+mean             5
+min              2
+max              9
+range            7
+sum of squares   32
+sample variance  4.571428571
+sample std dev   2.138089935
+RSD (%)          42.76179871
+(divisor: n - 1)
+```
+
+```console
+$ python -m sdtoolkit --population 2 4 4 4 5 5 7 9
+n                    8
+mean                 5
+min                  2
+max                  9
+range                7
+sum of squares       32
+population variance  4
+population std dev   2
+RSD (%)              40
+(divisor: N)
+```
+
+Read one column of a CSV file (lines starting with `#` are treated as
+comments):
+
+```console
+$ python -m sdtoolkit --csv examples/sample-datasets.csv --column lab_replicate_mg_l
+n                10
+mean             12.405
+min              12.36
+max              12.45
+range            0.09
+sum of squares   0.00825
+sample variance  0.0009166666667
+sample std dev   0.03027650354
+RSD (%)          0.244066937
+(divisor: n - 1)
+```
+
+Errors go to stderr with exit status 1:
+
+```console
+$ python -m sdtoolkit 1 2 x
+error: argument 3: 'x' is not a number
+$ python -m sdtoolkit 5
+error: sample statistics need at least 2 data points, got 1
+```
+
+After `pip install .` the same CLI is also available as `sdtoolkit`.
+
+## Population vs sample
+
+Use the population functions when your data are the entire group you are
+describing. Use the sample functions when your data are drawn from a larger
+group you want to draw conclusions about. The sample formulas divide by
+n − 1 (Bessel's correction), which makes the sample variance an unbiased
+estimate of the population variance, and they need at least two values.
+
+`describe`, `relative_std_dev`, `coefficient_of_variation` and the CLI
+default to the sample formulas. Details:
+[Sample vs population](https://ramesh-xyz.github.io/statistics-calculator-toolkit/sample-vs-population.html).
+
+## Formulas
+
+```
+x̄   = Σxᵢ / n
+SS   = Σ (xᵢ − x̄)²
+σ²   = SS / N              σ = √σ²
+s²   = SS / (n − 1)        s = √s²
+CV   = s / |x̄|
+RSD  = 100 × s / |x̄|  %
+```
+
+A step-by-step walk-through of these formulas is on the
+[standard deviation formula reference](https://standarddeviationcalculator.net/standard-deviation-formula/).
+
+Further reading:
+
+- [Standard deviation](https://ramesh-xyz.github.io/statistics-calculator-toolkit/standard-deviation.html)
+- [Variance](https://ramesh-xyz.github.io/statistics-calculator-toolkit/variance.html)
+- [Sample vs population](https://ramesh-xyz.github.io/statistics-calculator-toolkit/sample-vs-population.html)
+- [Relative standard deviation](https://ramesh-xyz.github.io/statistics-calculator-toolkit/relative-standard-deviation.html)
+- [Outliers](https://ramesh-xyz.github.io/statistics-calculator-toolkit/outliers.html)
+
+## Example datasets
+
+[`examples/sample-datasets.csv`](https://github.com/Ramesh-xyz/statistics-calculator-toolkit/blob/main/examples/sample-datasets.csv) has three
+small columns: lab replicate readings, exam scores and daily temperatures.
+They are **illustrative values made up for teaching, not real research
+data.** [`examples/worked-examples.md`](https://github.com/Ramesh-xyz/statistics-calculator-toolkit/blob/main/examples/worked-examples.md) works
+through each one by hand and checks the result with the code.
+
+## Accuracy and edge cases
+
+- **Algorithm.** Two passes: the mean, then the squared deviations from it,
+  each summed with `math.fsum`. A correction term removes the rounding error
+  left in the mean. The test suite compares results with Python's
+  `statistics.pvariance`, `variance`, `pstdev` and `stdev` (which use exact
+  rational arithmetic) to a relative tolerance of 1e-12, including data
+  offset by 10⁹ and 10¹².
+- **Accepted input.** Any iterable of `int`, `float`, `decimal.Decimal` or
+  `fractions.Fraction`. Decimals and fractions are converted to `float`, so
+  their extra precision is not kept and results are always `float`.
+- **Rejected input.** `bool`, `None`, strings, NaN, ±infinity, complex
+  numbers, and integers too large for a float raise `StatisticsError` naming
+  the offending item.
+- **Missing values are not skipped.** `None` raises, and an empty CSV cell
+  raises with its row number. Remove or impute missing data yourself so the
+  choice is visible in your code.
+- **Empty input** raises. **Sample statistics with one value** raise.
+  Population variance of one value is 0.
+- **Zero mean.** `relative_std_dev` and `coefficient_of_variation` raise;
+  `describe` sets `rsd_percent` to `None`. RSD is only meaningful for
+  ratio-scale data; see
+  [Relative standard deviation](https://ramesh-xyz.github.io/statistics-calculator-toolkit/relative-standard-deviation.html).
+
+```python
+>>> sd.mean([1, None, 3])
+Traceback (most recent call last):
+  ...
+sdtoolkit.core.StatisticsError: item 1: None (missing value); remove or fill it before computing
+>>> sd.sample_stdev([1e9 + 4, 1e9 + 7, 1e9 + 13, 1e9 + 16]) ** 2
+30.0
+```
+
+## Tests
+
+```
+PYTHONPATH=src python -m unittest discover -s tests
+```
+
+The suite uses only `unittest`. GitHub Actions runs it on Python 3.9 to 3.13
+([workflow](https://github.com/Ramesh-xyz/statistics-calculator-toolkit/blob/main/.github/workflows/test-python.yml)).
+
+## Contributing
+
+See [CONTRIBUTING.md](https://github.com/Ramesh-xyz/statistics-calculator-toolkit/blob/main/CONTRIBUTING.md).
+
+## License
+
+MIT. See [LICENSE](https://github.com/Ramesh-xyz/statistics-calculator-toolkit/blob/main/LICENSE).

sdtoolkit-0.1.0/pyproject.toml

@@ -0,0 +1,32 @@
+[build-system]
+requires = ["setuptools>=77"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "sdtoolkit"
+version = "0.1.0"
+description = "Dependency-free standard deviation, variance and relative standard deviation for Python"
+readme = "docs/python.md"
+requires-python = ">=3.9"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "Ramesh-xyz" }]
+keywords = ["standard deviation", "variance", "coefficient of variation", "statistics"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Operating System :: OS Independent",
+    "Topic :: Scientific/Engineering :: Mathematics",
+]
+
+[project.urls]
+Homepage = "https://standarddeviationcalculator.net/"
+Documentation = "https://ramesh-xyz.github.io/statistics-calculator-toolkit/python.html"
+Source = "https://github.com/Ramesh-xyz/statistics-calculator-toolkit"
+Issues = "https://github.com/Ramesh-xyz/statistics-calculator-toolkit/issues"
+Changelog = "https://github.com/Ramesh-xyz/statistics-calculator-toolkit/blob/main/CHANGELOG.md"
+
+[project.scripts]
+sdtoolkit = "sdtoolkit.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]

sdtoolkit-0.1.0/setup.cfg

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

sdtoolkit-0.1.0/src/sdtoolkit/__init__.py

@@ -0,0 +1,31 @@
+"""sdtoolkit: dependency-free standard deviation, variance and RSD."""
+
+from .core import (
+    StatisticsError,
+    Summary,
+    coefficient_of_variation,
+    describe,
+    mean,
+    population_stdev,
+    population_variance,
+    relative_std_dev,
+    sample_stdev,
+    sample_variance,
+    sum_of_squares,
+)
+
+__version__ = "0.1.0"
+
+__all__ = [
+    "StatisticsError",
+    "Summary",
+    "coefficient_of_variation",
+    "describe",
+    "mean",
+    "population_stdev",
+    "population_variance",
+    "relative_std_dev",
+    "sample_stdev",
+    "sample_variance",
+    "sum_of_squares",
+]

sdtoolkit-0.1.0/src/sdtoolkit/__main__.py

@@ -0,0 +1,5 @@
+import sys
+
+from .cli import main
+
+sys.exit(main())