5 Commits

Author SHA1 Message Date
msramalho
9f02a008f8 Bump version to v1.2.0 for release 2023-03-12 13:31:29 +00:00
msramalho
a58827dd29 fixes #11 bad path naming 2023-03-12 13:31:15 +00:00
msramalho
1216f70cfe readme cleanup 2023-02-13 16:17:09 +00:00
msramalho
ead88ae200 Bump version to v1.1.1 for release 2023-02-13 16:13:43 +00:00
msramalho
0aa179346a Bump version to v1.1.0 for release 2023-02-13 15:54:50 +00:00
4 changed files with 11 additions and 23 deletions

View File

@@ -1,11 +0,0 @@
# syntax=docker/dockerfile:1
FROM python:latest
WORKDIR /app
COPY . .
RUN pip install --upgrade pip && pip install build && python -m build && pip install dist/*.whl
ENTRYPOINT ["instagram_locations"]

View File

@@ -1,20 +1,18 @@
# Instagram Location Search
[![PyPI version](https://badge.fury.io/py/instagram-location-search.svg)](https://badge.fury.io/py/instagram-location-search)
## Installation
This Python application can be installed from PyPI using pip, and can also be built into a Docker image
### Install with Pip
This Python application can be installed from [PyPI](https://pypi.org/project/instagram-location-search/) using pip:
`pip install instagram-location-search`
or the latest from the repo:
`pip install git+https://github.com/bellingcat/instagram-location-search`
### Build Docker image
`docker build instagram-location-search .`
## Example usage
The following command will search for Instagram locations nearby the coordinates 32.22 N, 110.97 W (downtown Tucson, Arizona.) The list of locations is saved as a CSV file at "locs.csv".
```instagram_locations --cookie "<instagram-cookies>" --lat 32.22 --lng -110.97 --csv locs.csv```
```instagram-location-search --cookie "<instagram-cookies>" --lat 32.22 --lng -110.97 --csv locs.csv```
Note that this requires Instagram cookies in order to work! See below for how to obtain one from your account.
@@ -32,7 +30,7 @@ Using the `--map <output-location>` command line argument, a simple Leaflet map
Multiple types of output can be generated. For example, the following command will search for Instagram locations, save the JSON list, a CSV file, and a map for viewing the locations visually.
```instagram_locations --cookie "<instagram-cookie>" --lat 32.22 --lng -110.97 --json locs.json --csv locs.csv --map map.html```
```instagram-location-search --cookie "<instagram-cookie>" --lat 32.22 --lng -110.97 --json locs.json --csv locs.csv --map map.html```
## Sample Usage with `instagram-scraper`
The ID list generated with the `--ids` flag can be passed into `instagram-scraper` to pull down image metadata.
@@ -42,7 +40,7 @@ The ID list generated with the `--ids` flag can be passed into `instagram-scrape
First, get the proximal location IDs of your target location:
```sh
instagram_locations --cookies "<instagram-cookie>" --lat <lat> --lng <lng> --ids location_ids.txt
instagram-location-search --cookies "<instagram-cookie>" --lat <lat> --lng <lng> --ids location_ids.txt
```
Be sure to install `instagram-scraper`:

View File

@@ -1,9 +1,9 @@
_MAJOR = "1"
_MINOR = "0"
_MINOR = "2"
# On main and in a nightly release the patch should be one ahead of the last
# released build.
_PATCH = "1"
_PATCH = "0"
# This is mainly for nightly builds which have the suffix ".dev$DATE". See
# https://semver.org/#is-v123-a-semantic-version for the semantics.
_SUFFIX = ""

View File

@@ -1,11 +1,12 @@
import setuptools
from instagram_locations.version import __version__
with open("README.md", "r", encoding="utf-8") as file:
long_description = file.read()
setuptools.setup(
name="instagram-location-search",
version="1.0.0",
version=__version__,
author="Bellingcat",
author_email="tech@bellingcat.com",
packages=["instagram_locations"],
@@ -24,7 +25,7 @@ setuptools.setup(
],
entry_points={
"console_scripts": [
"instagram_locations=instagram_locations.instagram_locations:main",
"instagram-location-search=instagram_locations.instagram_locations:main",
]
},
)