Skip to content

Commit cf72d81

Browse files
committed
Fixing some docs, removing code coverage
1 parent 6073046 commit cf72d81

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

70 files changed

+11180
-115
lines changed

.github/workflows/integration_tests.yml

Lines changed: 1 addition & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -60,13 +60,4 @@ jobs:
6060

6161
- name: Install dependencies and check code
6262
run: |
63-
uv run pytest -m "integration_test" --cov src/midst_toolkit --cov-report=xml tests
64-
65-
# Uncomment this once this repo is configured on Codecov
66-
- name: Upload coverage to Codecov
67-
uses: codecov/codecov-action@18283e04ce6e62d37312384ff67231eb8fd56d24
68-
with:
69-
token: ${{ secrets.CODECOV_TOKEN }}
70-
slug: VectorInstitute/midst-toolkit
71-
fail_ci_if_error: true
72-
verbose: true
63+
uv run pytest -m "integration_test"

.github/workflows/unit_tests.yml

Lines changed: 1 addition & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -60,13 +60,4 @@ jobs:
6060

6161
- name: Install dependencies and check code
6262
run: |
63-
uv run pytest -m "not integration_test" --cov src/midst_toolkit --cov-report=xml tests
64-
65-
# Uncomment this once this repo is configured on Codecov
66-
- name: Upload coverage to Codecov
67-
uses: codecov/codecov-action@18283e04ce6e62d37312384ff67231eb8fd56d24
68-
with:
69-
token: ${{ secrets.CODECOV_TOKEN }}
70-
slug: VectorInstitute/midst-toolkit
71-
fail_ci_if_error: true
72-
verbose: true
63+
uv run pytest -m "not integration_test"

.pre-commit-config.yaml

Lines changed: 0 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -48,12 +48,6 @@ repos:
4848
types: [python]
4949
exclude: "tests"
5050

51-
- repo: https://github.com/crate-ci/typos
52-
rev: v1 # v1.19.0
53-
hooks:
54-
- id: typos
55-
args: []
56-
5751
- repo: https://github.com/nbQA-dev/nbQA
5852
rev: 1.9.1
5953
hooks:

CONTRIBUTING.md

Lines changed: 36 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -84,3 +84,39 @@ Optional[Union[typing1, typing2]] -> typing1 | typing2 | None
8484

8585
There is a custom script that enforces this style. It is not infallible. So if there is an issue with it please fix or
8686
report it to us.
87+
88+
## Tests
89+
90+
All tests for the library are housed in the tests folder. The unit and integration tests are run using `pytest`. These
91+
tests are automatically run through GitHub integrations on PRs to the main branch of this repository. PRs that fail
92+
any of the tests will not be eligible to be merged until they are fixed.
93+
94+
To run all tests in the tests folder one only needs to run (with the venv active)
95+
```bash
96+
pytest .
97+
```
98+
To run a specific test with pytest, one runs
99+
```bash
100+
pytest tests/checkpointing/test_best_checkpointer.py
101+
```
102+
103+
If you use VS Code for development, you can setup the tests with the testing integration so that you can run
104+
debugging and other IDE features. Setup will vary depending on your VS Code environment, but in your .vscode
105+
folder your `settings.json` might look something like
106+
107+
``` JSON
108+
{
109+
"python.testing.unittestArgs": [
110+
"-v",
111+
"-s",
112+
".",
113+
"-p",
114+
"test_*.py"
115+
],
116+
"python.testing.pytestEnabled": true,
117+
"python.testing.unittestEnabled": false,
118+
"python.testing.pytestArgs": [
119+
"."
120+
]
121+
}
122+
```

README.md

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,6 @@
55
[![code checks](https://github.com/VectorInstitute/midst-toolkit/actions/workflows/code_checks.yml/badge.svg)](https://github.com/VectorInstitute/midst-toolkit/actions/workflows/code_checks.yml)
66
[![integration tests](https://github.com/VectorInstitute/midst-toolkit/actions/workflows/integration_tests.yml/badge.svg)](https://github.com/VectorInstitute/midst-toolkit/actions/workflows/integration_tests.yml)
77
[![docs](https://github.com/VectorInstitute/midst-toolkit/actions/workflows/docs.yml/badge.svg)](https://github.com/VectorInstitute/midst-toolkit/actions/workflows/docs.yml)
8-
[![codecov](https://codecov.io/github/VectorInstitute/midst-toolkit/graph/badge.svg?token=83MYFZ3UPA)](https://codecov.io/github/VectorInstitute/midst-toolkit)
98
![GitHub License](https://img.shields.io/github/license/VectorInstitute/midst-toolkit)
109

1110
A toolkit for facilitating MIA resiliency testing on diffusion-model-based synthetic tabular data. Many of the attacks

codecov.yml

Lines changed: 0 additions & 19 deletions
This file was deleted.

docs/api.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -2,21 +2,21 @@
22

33
## Top Level Module
44

5-
::: aieng_template_uv
5+
::: midst_toolkit
66
options:
77
show_root_heading: true
88
show_root_full_path: true
99

1010
## Foo Module
1111

12-
::: aieng_template_uv.foo
12+
::: midst_toolkit.foo
1313
options:
1414
show_root_heading: true
1515
show_root_full_path: true
1616

1717
## Bar Module
1818

19-
::: aieng_template_uv.bar
19+
::: midst_toolkit.bar
2020
options:
2121
show_root_heading: true
2222
show_root_full_path: true

docs/index.md

Lines changed: 10 additions & 50 deletions
Original file line numberDiff line numberDiff line change
@@ -1,54 +1,14 @@
1-
# Vector AI Engineering template (uv edition) repository
1+
# MIDST Toolkit Repository
22

3-
This template repository can be used to bootstrap AI Engineering project repositories
4-
on Github! The template is meant for python codebases since Python is the most commonly
5-
used language by our team.
3+
# MIDST Toolkit
64

7-
The template includes:
5+
----------------------------------------------------------------------------------------
86

9-
- [pyproject.toml](https://pip.pypa.io/en/stable/reference/build-system/pyproject-toml/)
10-
file to specify repository information and manage dependencies using
11-
[uv](https://docs.astral.sh/uv/).
7+
[![code checks](https://github.com/VectorInstitute/midst-toolkit/actions/workflows/code_checks.yml/badge.svg)](https://github.com/VectorInstitute/midst-toolkit/actions/workflows/code_checks.yml)
8+
[![integration tests](https://github.com/VectorInstitute/midst-toolkit/actions/workflows/integration_tests.yml/badge.svg)](https://github.com/VectorInstitute/midst-toolkit/actions/workflows/integration_tests.yml)
9+
[![docs](https://github.com/VectorInstitute/midst-toolkit/actions/workflows/docs.yml/badge.svg)](https://github.com/VectorInstitute/midst-toolkit/actions/workflows/docs.yml)
10+
![GitHub License](https://img.shields.io/github/license/VectorInstitute/midst-toolkit)
1211

13-
- [README.md](https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-readmes) which should have basic information on why the project is
14-
useful, installation instructions and other information on how users can get started.
15-
16-
- [.pre-commit-config.yaml](https://pre-commit.com/) for running pre-commit hooks that
17-
check for code-style, apply formatting, check for type hints and run tests.
18-
19-
- [.github/pull_request_template.md](https://docs.github.com/en/communities/using-templates-to-encourage-useful-issues-and-pull-requests/creating-a-pull-request-template-for-your-repository) for PRs.
20-
21-
- [.github/ISSUE_TEMPLATE](https://docs.github.com/en/communities/using-templates-to-encourage-useful-issues-and-pull-requests/configuring-issue-templates-for-your-repository) for bug reports and issues that can be raised on the repository.
22-
23-
- [.github/workflows](https://docs.github.com/en/actions/using-workflows) for running CI
24-
workflows using Github actions. The template includes CI workflows for code checks,
25-
documentation building and releasing python packages to PyPI.
26-
27-
- [LICENSE.md](https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/licensing-a-repository) for adding a license to the project repository.
28-
By default, this is the [Apache-2.0 license](http://www.apache.org/licenses/). Please
29-
change according to your project!
30-
31-
- [docs](https://squidfunk.github.io/mkdocs-material/) for adding project documentation. Typically
32-
projects should have API reference documentation, user guides and tutorials.
33-
34-
- [CONTRIBUTING.md](https://docs.github.com/en/communities/setting-up-your-project-for-healthy-contributions/setting-guidelines-for-repository-contributors) with basic guidelines on how others can
35-
contribute to the repository.
36-
37-
- [CODE_OF_CONDUCT.md](https://docs.github.com/en/communities/setting-up-your-project-for-healthy-contributions/adding-a-code-of-conduct-to-your-project) with standards on how the community engages in
38-
a healthy and constructive manner.
39-
40-
- [.gitignore](https://docs.github.com/en/get-started/getting-started-with-git/ignoring-files)
41-
with some standard file extensions to be ignored by git. Please add/modify as necessary.
42-
43-
- [codecov.yml](https://docs.codecov.com/docs/codecov-yaml) for using codecov.io to
44-
generate code coverage information for your repository. You would need to add codecov.io
45-
app as an [integration to your repository](https://docs.codecov.com/docs/how-to-create-a-github-app-for-codecov-enterprise).
46-
47-
48-
If you are starting a new project, you can navigate to the [Use this template](https://docs.github.com/en/repositories/creating-and-managing-repositories/creating-a-repository-from-a-template) button
49-
on the top right corner of the [template repository home page](https://github.com/VectorInstitute/aieng-template)
50-
which will allow you to bootstrap your project repo using this template.
51-
52-
Please check out the user guide page for more detailed information on using the
53-
template features. For existing projects, the [user guide](user_guide.md)
54-
can be followed to migrate to following the template more closely.
12+
A toolkit for facilitating MIA resiliency testing on diffusion-model-based synthetic tabular data. Many of the attacks
13+
included in this toolkit are based on the most success ones used in the
14+
[2025 SaTML MIDST Competition](https://vectorinstitute.github.io/MIDST/).

docs/user_guide.md

Lines changed: 0 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -135,12 +135,3 @@ The available workflows are:
135135
Publishing python package to PyPI. Create a `PYPI_API_TOKEN` and add it to the
136136
repository's actions [secret variables](https://docs.github.com/en/actions/security-guides/using-secrets-in-github-actions)
137137
in order to publish PyPI packages when new software releases are created on Github.
138-
139-
The test workflows also compute coverage and upload code coverage metrics to
140-
[codecov.io](https://app.codecov.io/gh/VectorInstitute/aieng-template). Create a
141-
`CODECOV_TOKEN` and add it to the repository's actions [secret variables](https://docs.github.com/en/actions/security-guides/using-secrets-in-github-actions).
142-
143-
!!! warning "codecov"
144-
The [codecov](https://app.codecov.io/github/VectorInstitute) tool is subscribed under the free tier
145-
which makes it usable only for public open-source repos. Hence, if you would like to develop in a
146-
private repo, it is recommended to remove the codecov actions from the github workflow files.

mypy_disallow_legacy_types.py

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,9 @@
55

66
# List of files that we want to skip with this check. Currently empty.
77
files_to_ignore: Set[str] = {"Empty"}
8-
file_types_to_ignore: Set[str] = {".png", ".pkl", ".pt", ".md", ".svg", ".ico"}
8+
file_types_to_ignore: Set[str] = {
9+
".png", ".pkl", ".pt", ".md", ".svg", ".ico", ".html", ".js", ".css", ".xml", ".xml.gz", ".inv"
10+
}
911
# List of disallowed types to search for that should no longer be imported from the typing library. These types
1012
# have been migrated to either collections.abc or into core python
1113
disallowed_types = [

0 commit comments

Comments
 (0)