Metadata-Version: 2.1
Name: mapillary
Version: 0.0.19
Summary: A Python 3 library built on the Mapillary API v4 to facilitate retrieving and working with Mapillary data
Home-page: https://github.com/mapillary/mapillary-python-sdk
Author: Christopher Beddow
Author-email: support@mapillary.zendesk.com
License: MIT
Project-URL: Download, https://pypi.org/project/mapillary/#files
Project-URL: Release Notes, https://github.com/mapillary/mapillary-python-sdk/releases
Project-URL: Bug Tracker, https://github.com/mapillary/mapillary-python-sdk/issues
Project-URL: Source, https://github.com/mapillary/mapillary-python-sdk
Project-URL: Twitter, https://twitter.com/mapillary
Project-URL: Developer Resources, https://www.mapillary.com/developer
Project-URL: Community Forum, https://forum.mapillary.com/
Project-URL: Blog, https://blog.mapillary.com/
Project-URL: Facebook, https://www.facebook.com/mapillary/
Project-URL: Website, https://www.mapillary.com/
Platform: POSIX
Platform: MacOS X
Platform: Linux
Platform: Windows
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: Topic :: Scientific/Engineering :: GIS
Classifier: Topic :: Scientific/Engineering :: Information Analysis
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: Microsoft
Classifier: Operating System :: MacOS
Classifier: Operating System :: POSIX
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Requires-Python: >=3.0
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: attrs (==21.2.0)
Requires-Dist: bleach (==3.3.0)
Requires-Dist: build (==0.6.0.post1)
Requires-Dist: certifi (==2021.5.30)
Requires-Dist: chardet (==4.0.0)
Requires-Dist: click (==8.0.1)
Requires-Dist: click-plugins (==1.1.1)
Requires-Dist: cligj (==0.7.2)
Requires-Dist: coverage (==5.5)
Requires-Dist: docutils (==0.17.1)
Requires-Dist: future (==0.18.2)
Requires-Dist: geojson (==2.5.0)
Requires-Dist: haversine (==2.3.1)
Requires-Dist: hypothesis (==6.14.0)
Requires-Dist: idna (==2.10)
Requires-Dist: iniconfig (==1.1.1)
Requires-Dist: mapbox-vector-tile (==1.2.1)
Requires-Dist: mercantile (==1.2.1)
Requires-Dist: munch (==2.5.0)
Requires-Dist: numpy (==1.21.0)
Requires-Dist: packaging (==21.0)
Requires-Dist: pep517 (==0.11.0)
Requires-Dist: pkginfo (==1.7.0)
Requires-Dist: pluggy (==0.13.1)
Requires-Dist: protobuf (==3.17.3)
Requires-Dist: psutil (==5.8.0)
Requires-Dist: py (==1.10.0)
Requires-Dist: pyclipper (==1.2.1)
Requires-Dist: pygments (==2.9.0)
Requires-Dist: pyparsing (==2.4.7)
Requires-Dist: pytest (==6.2.4)
Requires-Dist: pytest-arraydiff (==0.3)
Requires-Dist: pytest-astropy (==0.8.0)
Requires-Dist: pytest-astropy-header (==0.1.2)
Requires-Dist: pytest-cov (==2.12.1)
Requires-Dist: pytest-doctestplus (==0.9.0)
Requires-Dist: pytest-filter-subpackage (==0.1.1)
Requires-Dist: pytest-openfiles (==0.5.0)
Requires-Dist: pytest-remotedata (==0.3.2)
Requires-Dist: python-dotenv (==0.19.0)
Requires-Dist: readme-renderer (==29.0)
Requires-Dist: requests (==2.25.1)
Requires-Dist: requests-toolbelt (==0.9.1)
Requires-Dist: scipy (==1.7.1)
Requires-Dist: shapely (==1.7.1)
Requires-Dist: six (==1.16.0)
Requires-Dist: sortedcontainers (==2.4.0)
Requires-Dist: toml (==0.10.2)
Requires-Dist: tomli (==1.2.1)
Requires-Dist: tqdm (==4.61.1)
Requires-Dist: turfpy (==0.0.7)
Requires-Dist: twine (==1.13.0)
Requires-Dist: urllib3 (==1.26.5)
Requires-Dist: vt2geojson (==0.2.1)
Requires-Dist: webencodings (==0.5.1)


# mapillary-python-sdk - Internal Resources

## Relevant Links

- [Python naming conventions](https://pythonguides.com/python-naming-conventions/)
- [Building a Python Open Source Project](https://towardsdatascience.com/build-your-first-open-source-python-project-53471c9942a7)
- [Example geospatial Python library, which we can reference for inspiration](https://github.com/gboeing/osmnx)
- [Mapillary blog on API v4 examples](https://blog.mapillary.com/update/2021/06/23/getting-started-with-the-new-mapillary-api-v4.html)
- [Facebook Open Source Legal Terms](https://opensource.fb.com/legal/terms/)
- [Facebook Open Source Privacy Policy](https://opensource.fb.com/legal/privacy/)

## mapillary-python-sdk -External Documentation

In this section, we keep a draft of the documentation.

> here we should give a paragraph describing the library and what its capabilities are

## Getting Started
  
How do I install the Mapillary Python SDK? See the installation instructions ***link to readthedocs.io***.

How do I use the Mapillary Python SDK? See the usage examples and tutorials in the examples repo ***link to examples possibly***.

How does this function work? Check out the documentation.

### Basic Start

For installing `pipenv`, please see [here](https://pypi.org/project/pipenv/).

To install packages from `Pipfile`,

```bash
pipenv install
```

To install a package under `packages`,

```bash
pipenv install [package_name]
```

To install a package under `dev-packages`,

```bash
pipenv install --dev [package_name]
```

To run `python` with `pipenv`,

```bash
pipenv run python
```

To enter the virtual environment, run,

```bash
pipenv shell
```

### Formatting/Linting

To run the formatter `black`, and the linter `flake8`, run,

```bash
flake8 mapillary & black mapillary
```

Or, if you are on Linux, you can simply run,

```bash
make style
```

This runs the `style` policy from the `Makefile`.

### Building package

To build the package, run `python3 setup.py sdist bdist_wheel`. To test out a local installation, run `pip install -e .`.

## Contributing

We welcome contributions! See [CONTRIBUTING](CONTRIBUTING.md) for details on how to get started, and our [code of conduct](CODE_OF_CONDUCT.md).

## License

Mapillary-Python-SDK is MIT licensed, as found in the [LICENSE](LICENSE) file.


