Merged PR 2405: Test new main release

Author: Kenneth Nordum

.gitignore

@@ -136,3 +136,6 @@ dmypy.json
 
 # Cython debug symbols
 cython_debug/
+
+#Ides
+.idea/

CHANGES.md

@@ -0,0 +1,6 @@
+# NGI Python KOF Parser
+
+## Version 0.0.1
+
+
+

README.md

@@ -1,20 +1,97 @@
-# Introduction 
-TODO: Give a short introduction of your project. Let this section explain the objectives or the motivation behind this project. 
+# NGI KOF Parser
+
+This is the NGI Python package for parsing kof files.
+
+References:
+
+NORWEGIAN GEOTECHNICAL SOCIETY
+- [NGF - VEILEDNING FOR
+SYMBOLER OG DEFINISJONER I GEOTEKNIKK](http://ngf.no/wp-content/uploads/2015/03/2_NGF-ny-melding-2-endelig-utgave-2011-12-04-med-topp-og-bunntekst-Alt-3.pdf)
+- [Norkart KOF specification](http://www.anleggsdata.no/wp-content/uploads/2018/04/KOF-BESKRIVELSE-Oppdatert2005.pdf)
+
+Latest releases see [CHANGES.md](CHANGES.md)
+
+# Installation (end user) 
+
+```bash
+
+pip install ngi-kof-parser
+
+```
+
+## Basic usage
+
+```python
+from ngi_kof_parser import KOFParser
+
+parser = KOFParser()
+
+# ETRS89/NTM10:
+srid = 5110
+locations = parser.parse('tests/data/test.kof', srid)
+
+for location in locations:
+   print(location)
+
+# Output:
+# name='SMPLOC1' point_easting=112892.81 point_northing=1217083.64 point_z=1.0 srid=5110 methods=[]
+# name='SMPLOC2' point_easting=112893.15 point_northing=1217079.46 point_z=2.0 srid=5110 methods=['TOT']
+# name='SMPLOC3' point_easting=112891.88 point_northing=1217073.01 point_z=0.0 srid=5110 methods=['CPT']
+# name='SMPLOC4' point_easting=112891.9 point_northing=1217067.54 point_z=0.0 srid=5110 methods=['RP']
+# name='SMPLOC5' point_easting=112902.92 point_northing=1217074.73 point_z=0.0 srid=5110 methods=['SA']
+# name='SMPLOC6' point_easting=112901.11 point_northing=1217069.56 point_z=0.0 srid=5110 methods=['PZ']
+# name='SMPLOC7' point_easting=1217069.56 point_northing=112901.11 point_z=0.0 srid=5110 methods=['PZ']
+
+```
+
+# Getting Started developing
+
+1. Software dependencies
+
+   - Python 3.9 or higher
+   - Poetry
+   - black code formatter
+
+2. Clone this repository
+
+3. Install
+
+   `poetry install`
+
 
-# Getting Started
-TODO: Guide users through getting your code up and running on their own system. In this section you can talk about:
-1.	Installation process
-2.	Software dependencies
-3.	Latest releases
-4.	API references
 
 # Build and Test
-TODO: Describe and show how to build your code and run the tests. 
 
-# Contribute
-TODO: Explain how other users and developers can contribute to make your code better. 
+Run in the project root folder: 
+
+    poetry install
+    pytest 
+
+Build the package wheel: 
+
+    poetry build
+
+
+# Publish
+
+To publish the package to NGI's private Azure Artifacts repository set the following configuration: 
+
+    poetry config repositories.ngi https://pkgs.dev.azure.com/ngi001/277b2f77-691a-4d92-bd89-8e7cac121676/_packaging/fieldmanager/pypi/upload
+
+To publish the package to Azure Artifacts, make sure you have set up your NGI credentials.
+
+You need to generate Personal Access Token (PAT). Follow
+[this guide](https://docs.microsoft.com/en-us/azure/devops/organizations/accounts/use-personal-access-tokens-to-authenticate)
+for how to get a PAT via the Azure DevOps GUI. `Packaging (Read, write, & manage)` access is sufficient.
+
+If you want to publish your newly built package you need to set your NGI credentials: 
+
+    poetry config pypi-token.ngi <PAT>
+
+    poetry publish -r ngi
+
+# TODOs
 
-If you want to learn more about creating good readme files then refer the following [guidelines](https://docs.microsoft.com/en-us/azure/devops/repos/git/create-a-readme?view=azure-devops). You can also seek inspiration from the below readme files:
-- [ASP.NET Core](https://github.com/aspnet/Home)
-- [Visual Studio Code](https://github.com/Microsoft/vscode)
-- [Chakra Core](https://github.com/Microsoft/ChakraCore)
+- Add tests
+- Extend with position transformation from file data srid (input) to project srid (output)
+- Extend with position transformation from file srid (input) to new output fields in wgs84 

azure-pipelines.yml

@@ -0,0 +1,45 @@
+# Python package
+# Create and test a Python package on multiple Python versions.
+# Add steps that analyze code, save the dist with the build record, publish to a PyPI-compatible index, and more:
+# https://docs.microsoft.com/azure/devops/pipelines/languages/python
+
+trigger:
+  - develop
+  - main
+
+pool:
+  vmImage: ubuntu-latest
+
+steps:
+  - task: UsePythonVersion@0
+    inputs:
+      versionSpec: "3.9"
+    displayName: "Use Python 3.9"
+
+  - script: |
+      python -m pip install --upgrade pip
+      pip install poetry
+      pip install twine
+      poetry install
+    #     poetry install --no-dev
+    displayName: "Install dependencies"
+
+  - script: |
+      poetry run pytest tests/ --cov ngi_kof_parser --cov-report html
+    displayName: "pytest"
+
+  - script: poetry version $(poetry version -s)-dev.$(Build.BuildId)
+    displayName: "Add pre-release version"
+    condition: and(succeeded(), eq(variables['Build.SourceBranch'], 'refs/heads/develop'))
+
+  - script: |
+      poetry build
+    displayName: "Build package"
+
+  - task: TwineAuthenticate@1
+    inputs:
+      artifactFeed: "NGI Digital/fieldmanager"
+
+  - script: |
+      twine upload -r fieldmanager --config-file $(PYPIRC_PATH) dist/*.whl
+    displayName: Upload package to Azure Artifact