fasti 0.2.0

Dates, calendars, business-day conventions and day-count fractions for financial code. Native Rust, no_std, float-free; designed after QuantLib's ql/time.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185

name: Release (Python)

# Publishes fasti-dates to PyPI when a py-v* tag is pushed. The crate's own
# release train is v*, and the two patterns do not overlap: py-v0.2.0 is
# not matched by v*. The tag is the trigger, but the version of record is
# the one in bindings/python/Cargo.toml.
# workflow_dispatch runs everything except the upload, so the fifteen
# artifacts can be proven to build before a tag commits to a version
# number that PyPI will never release back.
on:
  push:
    tags: ["py-v*"]
  workflow_dispatch:

env:
  CARGO_TERM_COLOR: always
  CARGO_INCREMENTAL: 0

jobs:
  verify:
    name: verify tag
    # Nothing to verify on a manual run: there is no tag to disagree
    # with the manifest, and skipping this skips publish with it.
    if: startsWith(github.ref, 'refs/tags/py-v')
    runs-on: ubuntu-latest
    outputs:
      version: ${{ steps.check.outputs.version }}
    steps:
      - uses: actions/checkout@v7
      - uses: dtolnay/rust-toolchain@stable
      - id: check
        working-directory: bindings/python
        run: |
          set -euo pipefail
          tag="${GITHUB_REF_NAME#py-v}"
          manifest=$(cargo metadata --no-deps --format-version 1 \
            | python3 -c 'import json,sys; print(json.load(sys.stdin)["packages"][0]["version"])')
          if [ "$tag" != "$manifest" ]; then
            echo "::error::tag py-v$tag does not match Cargo.toml version $manifest"
            exit 1
          fi
          echo "version=$manifest" >> "$GITHUB_OUTPUT"

  gates:
    name: gates
    runs-on: ubuntu-latest
    defaults:
      run:
        working-directory: bindings/python
    steps:
      - uses: actions/checkout@v7
      - uses: actions/setup-python@v6
        with:
          python-version: "3.10"
      - uses: dtolnay/rust-toolchain@stable
        with:
          components: clippy, rustfmt
      - run: cargo fmt --all --check
      - run: cargo clippy --locked --all-targets -- -D warnings
      - run: pip install . pytest mypy
      - run: pytest
      - run: mypy

  sdist:
    name: sdist
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v7
      - uses: PyO3/maturin-action@v1
        with:
          command: sdist
          args: --out dist
          working-directory: bindings/python
      - uses: actions/upload-artifact@v4
        with:
          name: dist-sdist
          path: bindings/python/dist/*.tar.gz

  # One abi3 wheel per platform covers CPython 3.10 and up.
  wheels:
    name: wheel (${{ matrix.target }} ${{ matrix.manylinux || matrix.runner }})
    runs-on: ${{ matrix.runner }}
    strategy:
      fail-fast: false
      matrix:
        include:
          - { runner: ubuntu-latest, target: x86_64, manylinux: auto }
          - { runner: ubuntu-latest, target: aarch64, manylinux: auto }
          - { runner: ubuntu-latest, target: x86_64, manylinux: musllinux_1_2 }
          - { runner: ubuntu-latest, target: aarch64, manylinux: musllinux_1_2 }
          - { runner: macos-13, target: x86_64 }
          - { runner: macos-14, target: aarch64 }
          - { runner: windows-latest, target: x64 }
    steps:
      - uses: actions/checkout@v7
      - uses: PyO3/maturin-action@v1
        with:
          command: build
          args: --release --locked --out dist
          target: ${{ matrix.target }}
          manylinux: ${{ matrix.manylinux }}
          working-directory: bindings/python
      - uses: actions/upload-artifact@v4
        with:
          name: dist-abi3-${{ matrix.target }}-${{ matrix.manylinux || matrix.runner }}
          path: bindings/python/dist/*.whl

  # abi3 is a no-op on a free-threaded interpreter, so 3.14t needs a
  # wheel of its own on every platform.
  wheels-free-threaded:
    name: wheel 3.14t (${{ matrix.target }} ${{ matrix.manylinux || matrix.runner }})
    runs-on: ${{ matrix.runner }}
    strategy:
      fail-fast: false
      matrix:
        include:
          - { runner: ubuntu-latest, target: x86_64, manylinux: auto }
          - { runner: ubuntu-latest, target: aarch64, manylinux: auto }
          - { runner: ubuntu-latest, target: x86_64, manylinux: musllinux_1_2 }
          - { runner: ubuntu-latest, target: aarch64, manylinux: musllinux_1_2 }
          - { runner: macos-13, target: x86_64 }
          - { runner: macos-14, target: aarch64 }
          - { runner: windows-latest, target: x64 }
    steps:
      - uses: actions/checkout@v7
      - uses: actions/setup-python@v6
        with:
          python-version: "3.14t"
      - uses: PyO3/maturin-action@v1
        with:
          command: build
          args: --release --locked --out dist --interpreter 3.14t
          target: ${{ matrix.target }}
          manylinux: ${{ matrix.manylinux }}
          working-directory: bindings/python
      - uses: actions/upload-artifact@v4
        with:
          name: dist-ft-${{ matrix.target }}-${{ matrix.manylinux || matrix.runner }}
          path: bindings/python/dist/*.whl

  audit:
    name: audit artifacts
    needs: [sdist, wheels, wheels-free-threaded]
    runs-on: ubuntu-latest
    steps:
      - uses: actions/setup-python@v6
        with:
          python-version: "3.12"
      - uses: actions/download-artifact@v4
        with:
          pattern: dist-*
          merge-multiple: true
          path: dist
      - run: pip install abi3audit twine
      - run: twine check --strict dist/*
      # Only the abi3 wheels claim the stable ABI; the 3.14t ones are
      # version-specific and abi3audit is not asked about them.
      - name: Every abi3 wheel keeps to the stable ABI
        run: |
          set -euo pipefail
          ls dist/
          for wheel in dist/*abi3*.whl; do
            abi3audit --strict "$wheel"
          done

  publish:
    name: publish to PyPI
    needs: [verify, gates, audit]
    # Belt and braces: verify is already tag-gated, and a skipped
    # dependency skips this job, but an upload is worth saying twice.
    if: startsWith(github.ref, 'refs/tags/py-v')
    runs-on: ubuntu-latest
    # Trusted publishing: PyPI mints a short-lived token from this
    # workflow's OIDC identity, so there is no stored secret. The
    # environment carries the protection rules.
    environment: pypi
    permissions:
      id-token: write
    steps:
      - uses: actions/download-artifact@v4
        with:
          pattern: dist-*
          merge-multiple: true
          path: dist
      - uses: pypa/gh-action-pypi-publish@release/v1