Skip to content
This repository was archived by the owner on Jan 18, 2023. It is now read-only.

Commit 0b75e41

Browse files
committed
Clean up readme with better links
1 parent 3f9c79d commit 0b75e41

3 files changed

Lines changed: 42 additions & 34 deletions

File tree

README.md

Lines changed: 27 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ The First Street Foundation API Access (Python) is a wrapper used to bulk extrac
66

77

88
### Current Release:
9-
Current release: 0.1
9+
Current release: 0.1.1
1010

1111
**Notice:** This API wrapper is subject to change.
1212

@@ -37,17 +37,17 @@ Current release: 0.1
3737
**NOTE**: This project requires [Python](https://www.python.org/downloads/) 3.6+ to run.
3838
1. Go to the Python page (https://www.python.org/downloads/) and download then install Python version 3. **Make sure that the checkbox is checked for Python to be added to the PATH**
3939

40-
![Screenshot](doc/images/1.1.1.png)
40+
![Screenshot](https://raw.githubusercontent.com/FirstStreet/fsf_api_access_python/master/doc/images//1.1.1.png)
4141

42-
![Screenshot](doc/images/1.1.2.png)
42+
![Screenshot](https://raw.githubusercontent.com/FirstStreet/fsf_api_access_python/master/doc/images//1.1.2.png)
4343

44-
![Screenshot](doc/images/1.1.3.png)
44+
![Screenshot](https://raw.githubusercontent.com/FirstStreet/fsf_api_access_python/master/doc/images//1.1.3.png)
4545

46-
![Screenshot](doc/images/1.1.4.png)
46+
![Screenshot](https://raw.githubusercontent.com/FirstStreet/fsf_api_access_python/master/doc/images//1.1.4.png)
4747

4848
2. Install the source code manager [Git]
4949

50-
![Screenshot](doc/images/1.2.3.png)
50+
![Screenshot](https://raw.githubusercontent.com/FirstStreet/fsf_api_access_python/master/doc/images//1.2.3.png)
5151

5252
3. Open `git bash` or a `bash terminal` (if on a MacOS or Linux) and create then navigate to a new project directory
5353

@@ -57,9 +57,9 @@ Current release: 0.1
5757
cd fsf_api
5858
```
5959

60-
![Screenshot](doc/images/1.2.1.png)
60+
![Screenshot](https://raw.githubusercontent.com/FirstStreet/fsf_api_access_python/master/doc/images//1.2.1.png)
6161

62-
![Screenshot](doc/images/1.2.2.png)
62+
![Screenshot](https://raw.githubusercontent.com/FirstStreet/fsf_api_access_python/master/doc/images//1.2.2.png)
6363

6464
4. Clone the project repository (https://github.com/FirstStreet/fsf_api_access_python.git) to the new directory
6565
```sh
@@ -73,7 +73,7 @@ Current release: 0.1
7373
git clone https://github.com/FirstStreet/fsf_api_access_python.git
7474
```
7575

76-
![Screenshot](doc/images/1.3.1.png)
76+
![Screenshot](https://raw.githubusercontent.com/FirstStreet/fsf_api_access_python/master/doc/images//1.3.1.png)
7777

7878
5. [Optional] Open a new `powershell console` / `bash terminal` or close and re-open a console and create and activate a new virtual environment in the project directory:
7979
```sh
@@ -84,9 +84,9 @@ Current release: 0.1
8484
.\venv\Scripts\activate
8585
```
8686

87-
![Screenshot](doc/images/1.4.1.png)
87+
![Screenshot](https://raw.githubusercontent.com/FirstStreet/fsf_api_access_python/master/doc/images//1.4.1.png)
8888

89-
![Screenshot](doc/images/1.4.2.png)
89+
![Screenshot](https://raw.githubusercontent.com/FirstStreet/fsf_api_access_python/master/doc/images//1.4.2.png)
9090

9191
6. Run the setup script to install the project requirements
9292
```sh
@@ -95,9 +95,9 @@ Current release: 0.1
9595
pip install .\fsf_api_access_python\.
9696
```
9797

98-
![Screenshot](doc/images/1.5.2.png)
98+
![Screenshot](https://raw.githubusercontent.com/FirstStreet/fsf_api_access_python/master/doc/images//1.5.2.png)
9999

100-
![Screenshot](doc/images/1.5.1.png)
100+
![Screenshot](https://raw.githubusercontent.com/FirstStreet/fsf_api_access_python/master/doc/images//1.5.1.png)
101101

102102
7. The project is now setup and can be ran through one of the two methods below. See `Products` for additional details on how to extract flood data products from the API.
103103
```sh
@@ -123,19 +123,19 @@ Current release: 0.1
123123
## **Windows**
124124
[Required] Set an Environmental Variable with the `variable_name` as `FSF_API_KEY` and the `variable_value` with the `API_KEY`.
125125

126-
![Screenshot](doc/images/3.1.1.png)
126+
![Screenshot](https://raw.githubusercontent.com/FirstStreet/fsf_api_access_python/master/doc/images//3.1.1.png)
127127

128-
![Screenshot](doc/images/3.1.2.png)
128+
![Screenshot](https://raw.githubusercontent.com/FirstStreet/fsf_api_access_python/master/doc/images//3.1.2.png)
129129

130-
![Screenshot](doc/images/3.1.3.png)
130+
![Screenshot](https://raw.githubusercontent.com/FirstStreet/fsf_api_access_python/master/doc/images//3.1.3.png)
131131

132132
2. Open/Re-open a `powershell console` / `bash terminal` and navigate to the project directory. Next, call one of the methods described below in the `Products` section through the command line. See the `Examples` section for more examples.
133133
```sh
134134
cd /path/to/project
135135
python -m firststreet -p <product>.<product_subtype> -i <fsids> -f <file_name> -l <lookup_type>
136136
```
137137

138-
![Screenshot](doc/images/3.2.1.png)
138+
![Screenshot](https://raw.githubusercontent.com/FirstStreet/fsf_api_access_python/master/doc/images//3.2.1.png)
139139

140140
<a name="commandline"></a>
141141
### [Command Line Argument Details:](#toc)
@@ -182,9 +182,9 @@ Current release: 0.1
182182
540651172
183183
```
184184

185-
![Screenshot](doc/images/4.4.1.png)
185+
![Screenshot](https://raw.githubusercontent.com/FirstStreet/fsf_api_access_python/master/doc/images//4.4.1.png)
186186

187-
![Screenshot](doc/images/4.4.2.png)
187+
![Screenshot](https://raw.githubusercontent.com/FirstStreet/fsf_api_access_python/master/doc/images//4.4.2.png)
188188

189189
<a name="method2"></a>
190190
## [Running the Project - Method 2: Through the Client](#toc)
@@ -216,17 +216,17 @@ Current release: 0.1
216216
fs.<product>.<product_subtype>(<fsids: list>, <lookup_type: string>, <csv: boolean>)
217217
```
218218

219-
![Screenshot](doc/images/2.2.1.png)
219+
![Screenshot](https://raw.githubusercontent.com/FirstStreet/fsf_api_access_python/master/doc/images//2.2.1.png)
220220

221221
OR
222222

223-
![Screenshot](doc/images/2.2.2.png)
223+
![Screenshot](https://raw.githubusercontent.com/FirstStreet/fsf_api_access_python/master/doc/images//2.2.2.png)
224224

225-
![Screenshot](doc/images/2.2.3.png)
225+
![Screenshot](https://raw.githubusercontent.com/FirstStreet/fsf_api_access_python/master/doc/images//2.2.3.png)
226226

227227
3. Run the python script.
228228

229-
![Screenshot](doc/images/2.3.1.png)
229+
![Screenshot](https://raw.githubusercontent.com/FirstStreet/fsf_api_access_python/master/doc/images//2.3.1.png)
230230

231231
<a name="products"></a>
232232
# [Products](#toc)
@@ -437,9 +437,9 @@ fsid,year,returnPeriod,bin,low,mid,high
437437
7935,2020,20,100,<NA>,1,<NA>
438438
...
439439
```
440-
![Screenshot](doc/images/5.2.1.png)
440+
![Screenshot](https://raw.githubusercontent.com/FirstStreet/fsf_api_access_python/master/doc/images//5.2.1.png)
441441

442-
![Screenshot](doc/images/5.2.2.png)
442+
![Screenshot](https://raw.githubusercontent.com/FirstStreet/fsf_api_access_python/master/doc/images//5.2.2.png)
443443

444444
<a name="updating"></a>
445445
# [Updating the Project to the Newest Version:](#toc)
@@ -457,7 +457,7 @@ If an update is made to this project, you will need to pull the changes from git
457457

458458
If the response is `Already up to date.`, then you have the latest version of the project already.
459459

460-
![Screenshot](doc/images/6.1.1.png)
460+
![Screenshot](https://raw.githubusercontent.com/FirstStreet/fsf_api_access_python/master/doc/images//6.1.1.png)
461461

462462
2. Open a new `powershell console` / `bash terminal`, navigate to the project, and re-run the setup script to re-install the project:
463463

@@ -469,7 +469,7 @@ If an update is made to this project, you will need to pull the changes from git
469469
pip install .\fsf_api_access_python\.
470470
```
471471

472-
![Screenshot](doc/images/6.1.2.png)
472+
![Screenshot](https://raw.githubusercontent.com/FirstStreet/fsf_api_access_python/master/doc/images//6.1.2.png)
473473

474474
3. The project should now be updated to the newest version
475475

requirements.txt

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
aiohttp >= 3.6.2
1+
aiohttp
22
shapely >= 1.7.0
3-
pandas >= 1.0.5
4-
tqdm >= 4.46.1
3+
pandas >= 1.0.0
4+
tqdm

setup.py

Lines changed: 12 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -10,19 +10,27 @@
1010
extra = {'testing': [x.strip() for x in f.readlines()]}
1111

1212
setup(
13-
name='firststreet-api_access-python',
14-
version='0.1',
15-
description='A Python API Client for the First Street Foundation API',
13+
name='fsf-api-access_python',
14+
version='0.1.1',
15+
description='A Python API Access Client for the First Street Foundation API',
1616
url='https://github.com/FirstStreet/fsf_api_access_python',
1717
project_urls={
1818
'First Street Foundation Website': 'https://firststreet.org/'
1919
},
2020
long_description=readme,
21+
long_description_content_type="text/markdown",
22+
author="Kelvin",
23+
author_email="kelvin@firststreet.org",
24+
license="MIT",
25+
classifiers=[
26+
"Programming Language :: Python :: 3",
27+
"Programming Language :: Python :: 3.6",
28+
],
2129

2230
# Package info
2331
packages=find_packages(exclude=['contrib', 'docs', 'tests*']),
2432
py_modules=[],
2533
install_requires=requirements,
2634
python_requires='>=3.6',
27-
extras_require=extra,
35+
extras_require=extra
2836
)

0 commit comments

Comments
 (0)