radarx 0.1.dev2__tar.gz → 0.1.5__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (74) hide show
  1. radarx-0.1.5/.editorconfig +21 -0
  2. radarx-0.1.5/.github/ISSUE_TEMPLATE.md +15 -0
  3. radarx-0.1.5/.github/PULL_REQUEST_TEMPLATE.md +5 -0
  4. radarx-0.1.5/.github/workflows/ci.yml +197 -0
  5. radarx-0.1.5/.github/workflows/upload_pypi.yml +34 -0
  6. radarx-0.1.5/.gitignore +106 -0
  7. radarx-0.1.5/.pre-commit-config.yaml +32 -0
  8. radarx-0.1.5/.readthedocs.yaml +7 -0
  9. radarx-0.1.5/AUTHORS.md +9 -0
  10. radarx-0.1.5/CODE_OF_CONDUCT.md +80 -0
  11. radarx-0.1.5/CONTRIBUTING.md +143 -0
  12. {radarx-0.1.dev2 → radarx-0.1.5}/LICENSE +0 -1
  13. {radarx-0.1.dev2 → radarx-0.1.5}/MANIFEST.in +4 -4
  14. radarx-0.1.5/Makefile +91 -0
  15. {radarx-0.1.dev2 → radarx-0.1.5}/PKG-INFO +25 -2
  16. radarx-0.1.5/README.md +121 -0
  17. radarx-0.1.5/ci/notebooktests.yml +38 -0
  18. radarx-0.1.5/ci/unittests.yml +29 -0
  19. radarx-0.1.5/docs/_static/Radarx_Logo_micro.png +0 -0
  20. radarx-0.1.5/docs/_static/Radarx_logo.png +0 -0
  21. radarx-0.1.5/docs/_static/Radarx_logo_favicon.png +0 -0
  22. radarx-0.1.5/docs/_static/radarx_logo_micro.svg +9 -0
  23. radarx-0.1.5/docs/authors.md +2 -0
  24. {radarx-0.1.dev2 → radarx-0.1.5}/docs/conf.py +19 -15
  25. radarx-0.1.5/docs/contributing.md +2 -0
  26. radarx-0.1.5/docs/history.md +5 -0
  27. radarx-0.1.5/docs/index.md +32 -0
  28. radarx-0.1.5/docs/installation.md +58 -0
  29. radarx-0.1.5/docs/links.rst +3 -0
  30. radarx-0.1.5/docs/usage.md +23 -0
  31. radarx-0.1.5/environment.yml +34 -0
  32. radarx-0.1.5/examples/notebooks/IMD_Radar_Data.ipynb +250 -0
  33. radarx-0.1.5/examples/notebooks/confest.py +83 -0
  34. radarx-0.1.5/make.bat +36 -0
  35. {radarx-0.1.dev2 → radarx-0.1.5}/pyproject.toml +38 -18
  36. radarx-0.1.5/radarx/__init__.py +17 -0
  37. {radarx-0.1.dev2 → radarx-0.1.5}/radarx/io/__init__.py +3 -1
  38. {radarx-0.1.dev2 → radarx-0.1.5}/radarx/io/imd.py +118 -54
  39. radarx-0.1.5/radarx/testing/test_data_imd.py +58 -0
  40. {radarx-0.1.dev2 → radarx-0.1.5}/radarx/version.py +2 -2
  41. {radarx-0.1.dev2 → radarx-0.1.5}/radarx.egg-info/PKG-INFO +25 -2
  42. radarx-0.1.5/radarx.egg-info/SOURCES.txt +57 -0
  43. radarx-0.1.5/radarx.egg-info/requires.txt +28 -0
  44. radarx-0.1.5/requirements.txt +12 -0
  45. radarx-0.1.5/requirements_dev.txt +15 -0
  46. radarx-0.1.5/rst2md.sh +13 -0
  47. radarx-0.1.5/ruff.toml +0 -0
  48. radarx-0.1.5/tests/io/test_imd.py +448 -0
  49. radarx-0.1.5/tests/mock_data.py +157 -0
  50. {radarx-0.1.dev2 → radarx-0.1.5}/tests/test_radarx.py +0 -3
  51. radarx-0.1.5/tests/testing/test_test_timd_data.py +62 -0
  52. radarx-0.1.5/tox.ini +19 -0
  53. radarx-0.1.dev2/AUTHORS.rst +0 -13
  54. radarx-0.1.dev2/CONTRIBUTING.rst +0 -137
  55. radarx-0.1.dev2/HISTORY.rst +0 -8
  56. radarx-0.1.dev2/README.md +0 -1
  57. radarx-0.1.dev2/README.rst +0 -41
  58. radarx-0.1.dev2/docs/authors.rst +0 -1
  59. radarx-0.1.dev2/docs/contributing.rst +0 -1
  60. radarx-0.1.dev2/docs/history.rst +0 -1
  61. radarx-0.1.dev2/docs/index.rst +0 -20
  62. radarx-0.1.dev2/docs/installation.rst +0 -51
  63. radarx-0.1.dev2/docs/readme.rst +0 -1
  64. radarx-0.1.dev2/docs/usage.rst +0 -7
  65. radarx-0.1.dev2/radarx/__init__.py +0 -5
  66. radarx-0.1.dev2/radarx.egg-info/SOURCES.txt +0 -30
  67. radarx-0.1.dev2/radarx.egg-info/requires.txt +0 -6
  68. {radarx-0.1.dev2 → radarx-0.1.5}/docs/Makefile +0 -0
  69. {radarx-0.1.dev2 → radarx-0.1.5}/docs/make.bat +0 -0
  70. {radarx-0.1.dev2 → radarx-0.1.5}/radarx/radarx.py +0 -0
  71. {radarx-0.1.dev2 → radarx-0.1.5}/radarx.egg-info/dependency_links.txt +0 -0
  72. {radarx-0.1.dev2 → radarx-0.1.5}/radarx.egg-info/top_level.txt +0 -0
  73. {radarx-0.1.dev2 → radarx-0.1.5}/setup.cfg +0 -0
  74. {radarx-0.1.dev2 → radarx-0.1.5}/tests/__init__.py +0 -0
@@ -0,0 +1,21 @@
1
+ # http://editorconfig.org
2
+
3
+ root = true
4
+
5
+ [*]
6
+ indent_style = space
7
+ indent_size = 4
8
+ trim_trailing_whitespace = true
9
+ insert_final_newline = true
10
+ charset = utf-8
11
+ end_of_line = lf
12
+
13
+ [*.bat]
14
+ indent_style = tab
15
+ end_of_line = crlf
16
+
17
+ [LICENSE]
18
+ insert_final_newline = false
19
+
20
+ [Makefile]
21
+ indent_style = tab
@@ -0,0 +1,15 @@
1
+ * radarx version:
2
+ * Python version:
3
+ * Operating System:
4
+
5
+ ### Description
6
+
7
+ Describe what you were trying to get done.
8
+ Tell us what happened, what went wrong, and what you expected to happen.
9
+
10
+ ### What I Did
11
+
12
+ ```
13
+ Paste the command(s) you ran and the output.
14
+ If there was a crash, please include the traceback here.
15
+ ```
@@ -0,0 +1,5 @@
1
+ <!-- Please remove check-list items that aren't relevant to your changes -->
2
+
3
+ - [ ] Closes #xxxx
4
+ - [ ] Tests added
5
+ - [ ] Changes are documented in `history.md`
@@ -0,0 +1,197 @@
1
+ name: CI
2
+
3
+ on:
4
+ push:
5
+ branches: [ main ]
6
+ pull_request:
7
+ branches: [ main ]
8
+
9
+ workflow_dispatch:
10
+
11
+ jobs:
12
+ lint:
13
+ name: lint and style checks
14
+ runs-on: ubuntu-latest
15
+ steps:
16
+ - uses: actions/checkout@v4
17
+ - name: Set up Python
18
+ uses: actions/setup-python@v5
19
+ with:
20
+ python-version: "3.12"
21
+ - name: Install dependencies
22
+ run: |
23
+ python -m pip install --upgrade pip
24
+ pip install black black[jupyter] ruff
25
+ - name: Black style check
26
+ run: |
27
+ black --check .
28
+ - name: Lint with ruff
29
+ run: |
30
+ ruff check .
31
+
32
+ build_0:
33
+ name: radarx unit tests - linux
34
+ runs-on: ubuntu-latest
35
+ needs: [lint]
36
+ defaults:
37
+ run:
38
+ shell: bash -l {0}
39
+ env:
40
+ CONDA_ENV_FILE: ci/unittests.yml
41
+ strategy:
42
+ fail-fast: false
43
+ matrix:
44
+ python-version: ["3.10", "3.12"]
45
+ numpy-version: ["1", "2"]
46
+ steps:
47
+ - uses: actions/checkout@v4
48
+ with:
49
+ fetch-depth: 0
50
+ - name: Install micromamba environment
51
+ uses: mamba-org/setup-micromamba@v1
52
+ with:
53
+ environment-name: radarx-unit-tests
54
+ environment-file: ${{env.CONDA_ENV_FILE}}
55
+ cache-environment: true
56
+ cache-environment-key: "${{runner.os}}-${{runner.arch}}-py${{env.PYTHON_VERSION}}-${{env.TODAY}}-${{hashFiles(env.CONDA_ENV_FILE)}}"
57
+ create-args: >-
58
+ python=${{matrix.python-version}}
59
+ numpy=${{matrix.numpy-version}}
60
+ conda
61
+ - name: Install radarx
62
+ run: |
63
+ python -m pip install . --no-deps
64
+ - name: Version Info
65
+ run: |
66
+ python -c "import radarx; print(radarx.version.version)"
67
+ - name: Test with pytest
68
+ run: |
69
+ pytest -n auto --dist loadfile --verbose --durations=15 --cov-report xml:coverage_unit.xml --cov=radarx --pyargs tests
70
+ - name: Upload coverage to Codecov
71
+ uses: codecov/codecov-action@v4
72
+ with:
73
+ file: ./coverage_unit.xml
74
+ flags: unittests
75
+ env_vars: RUNNER_OS,PYTHON_VERSION
76
+ name: codecov-gha
77
+ fail_ci_if_error: false
78
+ token: ${{ secrets.CODECOV_TOKEN }}
79
+
80
+ build_1:
81
+ name: radarx notebook tests - linux
82
+ runs-on: ubuntu-latest
83
+ needs: [lint]
84
+ defaults:
85
+ run:
86
+ shell: bash -l {0}
87
+ env:
88
+ CONDA_ENV_FILE: ci/notebooktests.yml
89
+ strategy:
90
+ fail-fast: false
91
+ matrix:
92
+ python-version: ["3.12"]
93
+ numpy-version: ["2"]
94
+ steps:
95
+ - uses: actions/checkout@v4
96
+ with:
97
+ fetch-depth: 0
98
+ - name: Install micromamba environment
99
+ uses: mamba-org/setup-micromamba@v1
100
+ with:
101
+ environment-name: radarx-notebook-tests
102
+ environment-file: ${{env.CONDA_ENV_FILE}}
103
+ cache-environment: true
104
+ cache-environment-key: "${{runner.os}}-${{runner.arch}}-py${{env.PYTHON_VERSION}}-${{env.TODAY}}-${{hashFiles(env.CONDA_ENV_FILE)}}"
105
+ create-args: >-
106
+ python=${{matrix.python-version}}
107
+ numpy=${{matrix.numpy-version}}
108
+ conda
109
+ - name: Install radarx
110
+ run: |
111
+ python -m pip install . --no-deps
112
+ - name: Version Info
113
+ run: |
114
+ python -c "import radarx; print(radarx.version.version)"
115
+ # - name: Test with pytest
116
+ # run: |
117
+ # pytest -n auto --dist loadfile --verbose --durations=15 --cov-report xml:coverage_notebook.xml --cov=radarx --pyargs examples/notebooks
118
+ - name: Test with pytest and collect coverage
119
+ run: |
120
+ pytest --nbval --verbose --durations=15 --cov=radarx --cov-report=xml:coverage_notebook.xml examples/notebooks
121
+ - name: Upload coverage to Codecov
122
+ uses: codecov/codecov-action@v4
123
+ with:
124
+ file: ./coverage_notebook.xml
125
+ flags: notebooktests
126
+ env_vars: RUNNER_OS,PYTHON_VERSION
127
+ name: codecov-gha
128
+ fail_ci_if_error: false
129
+ token: ${{ secrets.CODECOV_TOKEN }}
130
+
131
+ test_build_distribution_testpypi:
132
+ name: test build distribution for testpypi
133
+ needs: [lint, build_0]
134
+ runs-on: ubuntu-latest
135
+ defaults:
136
+ run:
137
+ shell: bash -l {0}
138
+ steps:
139
+ - uses: actions/checkout@v4
140
+ with:
141
+ fetch-depth: 0
142
+ - name: Set up Python
143
+ uses: actions/setup-python@v5
144
+ with:
145
+ python-version: "3.12"
146
+ - name: Install dependencies
147
+ run: |
148
+ python -m pip install --upgrade pip
149
+ pip install build setuptools wheel twine toml-cli
150
+ - name: Package
151
+ run: |
152
+ toml set --toml-path pyproject.toml tool.setuptools_scm.local_scheme "no-local-version"
153
+ git update-index --assume-unchanged pyproject.toml
154
+ python -m build
155
+ cp dist/radarx*.gz dist/radarx1.gz
156
+ - name: Upload artifact
157
+ uses: actions/upload-artifact@v4
158
+ with:
159
+ name: radarx-1-${{github.event.number}}
160
+ path: dist/radarx1.gz
161
+ - name: Upload to TestPyPI
162
+ if: ${{ github.event_name == 'push' }}
163
+ env:
164
+ TWINE_USERNAME: __token__
165
+ TWINE_PASSWORD: ${{ secrets.TESTPYPI_API_TOKEN }}
166
+ run: |
167
+ rm -f dist/radarx1.gz
168
+ twine upload --repository testpypi dist/*
169
+
170
+ test_build_distribution_pypi:
171
+ name: test build distribution
172
+ needs: [lint, build_0, test_build_distribution_testpypi]
173
+ runs-on: ubuntu-latest
174
+ defaults:
175
+ run:
176
+ shell: bash -l {0}
177
+ steps:
178
+ - uses: actions/checkout@v4
179
+ with:
180
+ fetch-depth: 0
181
+ - name: Set up Python
182
+ uses: actions/setup-python@v5
183
+ with:
184
+ python-version: "3.12"
185
+ - name: Install dependencies
186
+ run: |
187
+ python -m pip install --upgrade pip
188
+ pip install build setuptools wheel
189
+ - name: Package
190
+ run: |
191
+ python -m build
192
+ cp dist/radarx*.gz dist/radarx0.gz
193
+ - name: Upload artifact
194
+ uses: actions/upload-artifact@v4
195
+ with:
196
+ name: radarx-0-${{github.event.number}}
197
+ path: dist/radarx0.gz
@@ -0,0 +1,34 @@
1
+ name: Build and Upload to PyPI
2
+
3
+ on:
4
+ release:
5
+ types:
6
+ - created
7
+ workflow_dispatch:
8
+
9
+ jobs:
10
+ upload_pypi:
11
+ name: Deploy to PyPI
12
+ runs-on: ubuntu-latest
13
+ defaults:
14
+ run:
15
+ shell: bash -l {0}
16
+ steps:
17
+ - uses: actions/checkout@v4
18
+ with:
19
+ fetch-depth: 0
20
+ - name: Set up Python
21
+ uses: actions/setup-python@v5
22
+ with:
23
+ python-version: "3.12"
24
+ - name: Install dependencies
25
+ run: |
26
+ python -m pip install --upgrade pip
27
+ pip install build setuptools wheel twine
28
+ - name: Package and Upload to PyPI
29
+ env:
30
+ TWINE_USERNAME: __token__
31
+ TWINE_PASSWORD: ${{ secrets.PYPI_API_TOKEN }}
32
+ run: |
33
+ python -m build
34
+ twine upload dist/*
@@ -0,0 +1,106 @@
1
+ # Byte-compiled / optimized / DLL files
2
+ __pycache__/
3
+ *.py[cod]
4
+ *$py.class
5
+
6
+ # C extensions
7
+ *.so
8
+
9
+ # Distribution / packaging
10
+ .Python
11
+ env/
12
+ build/
13
+ develop-eggs/
14
+ dist/
15
+ downloads/
16
+ eggs/
17
+ .eggs/
18
+ lib/
19
+ lib64/
20
+ parts/
21
+ sdist/
22
+ var/
23
+ wheels/
24
+ *.egg-info/
25
+ .installed.cfg
26
+ *.egg
27
+
28
+ # PyInstaller
29
+ # Usually these files are written by a python script from a template
30
+ # before PyInstaller builds the exe, so as to inject date/other infos into it.
31
+ *.manifest
32
+ *.spec
33
+
34
+ # Installer logs
35
+ pip-log.txt
36
+ pip-delete-this-directory.txt
37
+
38
+ # Unit test / coverage reports
39
+ htmlcov/
40
+ .tox/
41
+ .coverage
42
+ .coverage.*
43
+ .cache
44
+ nosetests.xml
45
+ coverage.xml
46
+ *.cover
47
+ .hypothesis/
48
+ .pytest_cache/
49
+
50
+ # Translations
51
+ *.mo
52
+ *.pot
53
+
54
+ # Django stuff:
55
+ *.log
56
+ local_settings.py
57
+
58
+ # Flask stuff:
59
+ instance/
60
+ .webassets-cache
61
+
62
+ # Scrapy stuff:
63
+ .scrapy
64
+
65
+ # Sphinx documentation
66
+ docs/_build/
67
+
68
+ # PyBuilder
69
+ target/
70
+
71
+ # Jupyter Notebook
72
+ .ipynb_checkpoints
73
+
74
+ # pyenv
75
+ .python-version
76
+
77
+ # celery beat schedule file
78
+ celerybeat-schedule
79
+
80
+ # SageMath parsed files
81
+ *.sage.py
82
+
83
+ # dotenv
84
+ .env
85
+
86
+ # virtualenv
87
+ .venv
88
+ venv/
89
+ ENV/
90
+
91
+ # Spyder project settings
92
+ .spyderproject
93
+ .spyproject
94
+
95
+ # Rope project settings
96
+ .ropeproject
97
+
98
+ # mkdocs documentation
99
+ /site
100
+
101
+ # mypy
102
+ .mypy_cache/
103
+
104
+ # IDE settings
105
+ .vscode/
106
+ .idea/
@@ -0,0 +1,32 @@
1
+ repos:
2
+ - repo: https://github.com/pre-commit/pre-commit-hooks
3
+ rev: v4.5.0
4
+ hooks:
5
+ - id: trailing-whitespace
6
+ - id: end-of-file-fixer
7
+ - id: check-docstring-first
8
+ - id: check-json
9
+ - id: check-yaml
10
+ - id: debug-statements
11
+ - id: mixed-line-ending
12
+ - repo: https://github.com/asottile/pyupgrade
13
+ rev: v3.15.1
14
+ hooks:
15
+ - id: pyupgrade
16
+ args:
17
+ - '--py38-plus'
18
+ - repo: https://github.com/kynan/nbstripout
19
+ rev: 0.7.1
20
+ hooks:
21
+ - id: nbstripout
22
+ args: ['--extra-keys', 'metadata.kernelspec cell.metadata.pycharm cell.metadata.tags']
23
+ - repo: https://github.com/charliermarsh/ruff-pre-commit
24
+ rev: 'v0.2.2'
25
+ hooks:
26
+ - id: ruff
27
+ args: ['--fix']
28
+ - repo: https://github.com/psf/black
29
+ rev: 24.2.0
30
+ hooks:
31
+ - id: black
32
+ - id: black-jupyter
@@ -0,0 +1,7 @@
1
+ version: 2
2
+ conda:
3
+ environment: environment.yml
4
+ build:
5
+ os: 'ubuntu-20.04'
6
+ tools:
7
+ python: 'mambaforge-latest'
@@ -0,0 +1,9 @@
1
+ # Credits
2
+
3
+ ## Development Lead
4
+
5
+ - Hamid Ali Syed \<<hamidsyed37@gmail.com>\>
6
+
7
+ ## Contributors
8
+
9
+ None yet. Why not be the first?
@@ -0,0 +1,80 @@
1
+ # Contributor Covenant Code of Conduct
2
+
3
+ ## Our Pledge
4
+
5
+ In the interest of fostering an open and welcoming environment, we as
6
+ contributors and maintainers pledge to make participation in our project
7
+ and our community a harassment-free experience for everyone, regardless
8
+ of age, body size, disability, ethnicity, sex characteristics, gender
9
+ identity and expression, level of experience, education, socio-economic
10
+ status, nationality, personal appearance, race, religion, or sexual
11
+ identity and orientation.
12
+
13
+ ## Our Standards
14
+
15
+ Examples of behavior that contributes to creating a positive environment
16
+ include:
17
+
18
+ - Using welcoming and inclusive language
19
+ - Being respectful of differing viewpoints and experiences
20
+ - Gracefully accepting constructive criticism
21
+ - Focusing on what is best for the community
22
+ - Showing empathy towards other community members
23
+
24
+ Examples of unacceptable behavior by participants include:
25
+
26
+ - The use of sexualized language or imagery and unwelcome sexual
27
+ attention or advances
28
+ - Trolling, insulting/derogatory comments, and personal or political
29
+ attacks
30
+ - Public or private harassment
31
+ - Publishing others\' private information, such as a physical or
32
+ electronic address, without explicit permission
33
+ - Other conduct which could reasonably be considered inappropriate in
34
+ a professional setting
35
+
36
+ ## Our Responsibilities
37
+
38
+ Project maintainers are responsible for clarifying the standards of
39
+ acceptable behavior and are expected to take appropriate and fair
40
+ corrective action in response to any instances of unacceptable behavior.
41
+
42
+ Project maintainers have the right and responsibility to remove, edit,
43
+ or reject comments, commits, code, wiki edits, issues, and other
44
+ contributions that are not aligned to this Code of Conduct, or to ban
45
+ temporarily or permanently any contributor for other behaviors that they
46
+ deem inappropriate, threatening, offensive, or harmful.
47
+
48
+ ## Scope
49
+
50
+ This Code of Conduct applies within all project spaces, and it also
51
+ applies when an individual is representing the project or its community
52
+ in public spaces. Examples of representing a project or community
53
+ include using an official project e-mail address, posting via an
54
+ official social media account, or acting as an appointed representative
55
+ at an online or offline event. Representation of a project may be
56
+ further defined and clarified by project maintainers.
57
+
58
+ ## Enforcement
59
+
60
+ Instances of abusive, harassing, or otherwise unacceptable behavior may
61
+ be reported by contacting the project team at \[INSERT EMAIL ADDRESS\].
62
+ All complaints will be reviewed and investigated and will result in a
63
+ response that is deemed necessary and appropriate to the circumstances.
64
+ The project team is obligated to maintain confidentiality with regard to
65
+ the reporter of an incident. Further details of specific enforcement
66
+ policies may be posted separately.
67
+
68
+ Project maintainers who do not follow or enforce the Code of Conduct in
69
+ good faith may face temporary or permanent repercussions as determined
70
+ by other members of the project\'s leadership.
71
+
72
+ ## Attribution
73
+
74
+ This Code of Conduct is adapted from the [Contributor
75
+ Covenant](https://www.contributor-covenant.org), version 1.4, available
76
+ at
77
+ <https://www.contributor-covenant.org/version/1/4/code-of-conduct.html>
78
+
79
+ For answers to common questions about this code of conduct, see
80
+ <https://www.contributor-covenant.org/faq>
@@ -0,0 +1,143 @@
1
+ # Contributing
2
+
3
+ Contributions are welcome, and they are greatly appreciated! Every
4
+ little bit helps, and credit will always be given.
5
+
6
+ You can contribute in many ways:
7
+
8
+ ## Types of Contributions
9
+
10
+ ### Report Bugs
11
+
12
+ Report bugs at <https://github.com/syedhamidali/radarx/issues>.
13
+
14
+ If you are reporting a bug, please include:
15
+
16
+ - Your operating system name and version.
17
+ - Any details about your local setup that might be helpful in
18
+ troubleshooting.
19
+ - Detailed steps to reproduce the bug.
20
+
21
+ ### Fix Bugs
22
+
23
+ Look through the GitHub issues for bugs. Anything tagged with \"bug\"
24
+ and \"help wanted\" is open to whoever wants to implement it.
25
+
26
+ ### Implement Features
27
+
28
+ Look through the GitHub issues for features. Anything tagged with
29
+ \"enhancement\" and \"help wanted\" is open to whoever wants to
30
+ implement it.
31
+
32
+ ### Write Documentation
33
+
34
+ radarx could always use more documentation, whether as part of the
35
+ official radarx docs, in docstrings, or even on the web in blog posts,
36
+ articles, and such.
37
+
38
+ ### Submit Feedback
39
+
40
+ The best way to send feedback is to file an issue at
41
+ <https://github.com/syedhamidali/radarx/issues>.
42
+
43
+ If you are proposing a feature:
44
+
45
+ - Explain in detail how it would work.
46
+ - Keep the scope as narrow as possible, to make it easier to
47
+ implement.
48
+ - Remember that this is a volunteer-driven project, and that
49
+ contributions are welcome :)
50
+
51
+ ## Get Started!
52
+
53
+ Ready to contribute? Here\'s how to set up [radarx]{.title-ref} for
54
+ local development.
55
+
56
+ 1. Fork the [radarx]{.title-ref} repo on GitHub.
57
+
58
+ 2. Clone your fork locally:
59
+
60
+ ``` {.shell}
61
+ $ git clone git@github.com:your_name_here/radarx.git
62
+ ```
63
+
64
+ 3. Install your local copy into a virtualenv. Assuming you have
65
+ virtualenvwrapper installed, this is how you set up your fork for
66
+ local development:
67
+
68
+ ``` {.shell}
69
+ $ mkvirtualenv radarx
70
+ $ cd radarx/
71
+ $ python setup.py develop
72
+ ```
73
+
74
+ 4. Create a branch for local development:
75
+
76
+ ``` {.shell}
77
+ $ git checkout -b name-of-your-bugfix-or-feature
78
+ ```
79
+
80
+ Now you can make your changes locally.
81
+
82
+ 5. When you\'re done making changes, check that your changes pass
83
+ flake8 and the tests, including testing other Python versions with
84
+ tox:
85
+
86
+ ``` {.shell}
87
+ $ make lint
88
+ $ make test
89
+ Or
90
+ $ make test-all
91
+ ```
92
+
93
+ To get flake8 and tox, just pip install them into your virtualenv.
94
+
95
+ 6. Commit your changes and push your branch to GitHub:
96
+
97
+ ``` {.shell}
98
+ $ git add .
99
+ $ git commit -m "Your detailed description of your changes."
100
+ $ git push origin name-of-your-bugfix-or-feature
101
+ ```
102
+
103
+ 7. Submit a pull request through the GitHub website.
104
+
105
+ ## Pull Request Guidelines
106
+
107
+ Before you submit a pull request, check that it meets these guidelines:
108
+
109
+ 1. The pull request should include tests.
110
+ 2. If the pull request adds functionality, the docs should be updated.
111
+ Put your new functionality into a function with a docstring, and add
112
+ the feature to the list in README.rst.
113
+ 3. The pull request should work for Python 3.5, 3.6, 3.7 and 3.8, and
114
+ for PyPy. Check
115
+ <https://travis-ci.com/syedhamidali/radarx/pull_requests> and make
116
+ sure that the tests pass for all supported Python versions.
117
+
118
+ ## Tips
119
+
120
+ To run a subset of tests:
121
+
122
+ ``` {.shell}
123
+ $ pytest tests.test_radarx
124
+ ```
125
+
126
+ ## Deploying
127
+
128
+ A reminder for the maintainers on how to deploy. Make sure all your
129
+ changes are committed (including an entry in HISTORY.rst). Then run:
130
+
131
+ ``` {.shell}
132
+ $ bump2version patch # possible: major / minor / patch
133
+ $ git push
134
+ $ git push --tags
135
+ ```
136
+
137
+ Travis will then deploy to PyPI if tests pass.
138
+
139
+ ## Code of Conduct
140
+
141
+ Please note that this project is released with a [Contributor Code of
142
+ Conduct](CODE_OF_CONDUCT.rst). By participating in this project you
143
+ agree to abide by its terms.
@@ -19,4 +19,3 @@ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
19
  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
20
  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
21
  SOFTWARE.
22
-
@@ -1,8 +1,8 @@
1
- include AUTHORS.rst
2
- include CONTRIBUTING.rst
3
- include HISTORY.rst
1
+ include AUTHORS.md
2
+ include CONTRIBUTING.md
3
+ include HISTORY.md
4
4
  include LICENSE
5
- include README.rst
5
+ include README.md
6
6
 
7
7
  recursive-include tests *
8
8
  recursive-exclude * __pycache__