Skip to content

Commit 88e01e4

Browse files
Renaming
1 parent 01df4f4 commit 88e01e4

25 files changed

+522
-442
lines changed

README.md

Lines changed: 18 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,16 @@
1-
# py-ipfs-api
1+
# py-ipfs-http-client
22

33
[![](https://img.shields.io/badge/project-IPFS-blue.svg?style=flat-square)](https://ipfs.io/)
44
[![](https://img.shields.io/badge/freenode-%23ipfs-blue.svg?style=flat-square)](https://webchat.freenode.net/?channels=%23ipfs)
55
[![standard-readme compliant](https://img.shields.io/badge/standard--readme-OK-green.svg?style=flat-square)](https://github.com/RichardLitt/standard-readme)
6-
[![](https://img.shields.io/pypi/v/ipfsapi.svg?style=flat-square)](https://pypi.python.org/pypi/ipfsapi)
7-
[![Build Status](https://travis-ci.org/ipfs/py-ipfs-api.svg?branch=master)](https://travis-ci.org/ipfs/py-ipfs-api)
6+
[![](https://img.shields.io/pypi/v/ipfshttpclient.svg?style=flat-square)](https://pypi.python.org/pypi/ipfshttpclient)
7+
[![Build Status](https://travis-ci.org/ipfs/py-ipfs-http-client.svg?branch=master)](https://travis-ci.org/ipfs/py-ipfs-http-client)
88

99
![Python IPFS HTTP Client Library](https://ipfs.io/ipfs/QmQJ68PFMDdAsgCZvA1UVzzn18asVcf7HVvCDgpjiSCAse)
1010

11-
Check out [the client API reference](https://ipfs.io/ipns/QmZ86ow1byeyhNRJEatWxGPJKcnQKG7s51MtbHdxxUddTH/Software/Python/ipfsapi/) for the full command reference.
11+
Check out [the HTTP Client reference](https://ipfs.io/ipns/QmZ86ow1byeyhNRJEatWxGPJKcnQKG7s51MtbHdxxUddTH/Software/Python/ipfshttpclient/) for the full command reference.
1212

13-
**Important:** The `py-ipfs-api` PIP package and Python module have both been renamed to `ipfsapi` (no dash, lower-case `a`).
13+
**Important:** The `ipfsapi` PIP package and Python module have both been renamed to `ipfshttpclient`
1414
The legacy `ipfs-api`/`ipfsApi` package/module will only work for IPFS 0.3.x and Python 2 and is deprecated. [Please upgrade](#important-changes-from-ipfsapi-02x)!
1515

1616
**Note:** This library constantly has to change to stay compatible with the IPFS HTTP API.
@@ -35,27 +35,27 @@ You may experience compatibility issues when attempting to use it with other ver
3535
Install with pip:
3636

3737
```sh
38-
pip install ipfsapi
38+
pip install ipfshttpclient
3939
```
4040

4141
## Usage
4242

4343
Basic use-case (requires a running instance of IPFS daemon):
4444

4545
```py
46-
>>> import ipfsapi
47-
>>> api = ipfsapi.connect('127.0.0.1', 5001)
48-
>>> res = api.add('test.txt')
46+
>>> import ipfshttpclient
47+
>>> http_client = ipfshttpclient.connect('127.0.0.1', 5001)
48+
>>> res = http_client.add('test.txt')
4949
>>> res
5050
{'Hash': 'QmWxS5aNTFEc9XbMX1ASvLET1zrqEaTssqt33rVZQCQb22', 'Name': 'test.txt'}
51-
>>> api.cat(res['Hash'])
51+
>>> http_client.cat(res['Hash'])
5252
'fdsafkljdskafjaksdjf\n'
5353
```
5454

5555
Administrative functions:
5656

5757
```py
58-
>>> api.id()
58+
>>> http_client.id()
5959
{'Addresses': ['/ip4/127.0.0.1/tcp/4001/ipfs/QmS2C4MjZsv2iP1UDMMLCYqJ4WeJw8n3vXx1VKxW1UbqHS',
6060
'/ip6/::1/tcp/4001/ipfs/QmS2C4MjZsv2iP1UDMMLCYqJ4WeJw8n3vXx1VKxW1UbqHS'],
6161
'AgentVersion': 'go-ipfs/0.4.10',
@@ -67,7 +67,7 @@ Administrative functions:
6767
Pass in API options:
6868

6969
```py
70-
>>> api.pin_ls(type='all')
70+
>>> http_client.pin_ls(type='all')
7171
{'Keys': {'QmNMELyizsfFdNZW3yKTi1SE2pErifwDTXx6vvQBfwcJbU': {'Count': 1,
7272
'Type': 'indirect'},
7373
'QmNQ1h6o1xJARvYzwmySPsuv9L5XfzS4WTvJSTAWwYRSd8': {'Count': 1,
@@ -78,7 +78,7 @@ Pass in API options:
7878
Add a directory and match against a filename pattern:
7979

8080
```py
81-
>>> api.add('photos', match='*.jpg')
81+
>>> http_client.add('photos', match='*.jpg')
8282
[{'Hash': 'QmcqBstfu5AWpXUqbucwimmWdJbu89qqYmE3WXVktvaXhX',
8383
'Name': 'photos/photo1.jpg'},
8484
{'Hash': 'QmSbmgg7kYwkSNzGLvWELnw1KthvTAMszN5TNg3XQ799Fu',
@@ -90,7 +90,7 @@ Add a directory and match against a filename pattern:
9090
Or add a directory recursively:
9191

9292
```py
93-
>>> api.add('fake_dir', recursive=True)
93+
>>> http_client.add('fake_dir', recursive=True)
9494
[{'Hash': 'QmQcCtMgLVwvMQGu6mvsRYLjwqrZJcYtH4mboM9urWW9vX',
9595
'Name': 'fake_dir/fsdfgh'},
9696
{'Hash': 'QmNuvmuFeeWWpxjCQwLkHshr8iqhGLWXFzSGzafBeawTTZ',
@@ -105,9 +105,9 @@ This module also contains some helper functions for adding strings and JSON to I
105105

106106
```py
107107
>>> lst = [1, 77, 'lol']
108-
>>> client.add_json(lst)
108+
>>> http_client.add_json(lst)
109109
'QmQ4R5cCUYBWiJpNL7mFe4LDrwD6qBr5Re17BoRAY9VNpd'
110-
>>> client.get_json(_)
110+
>>> http_client.get_json(_)
111111
[1, 77, 'lol']
112112
```
113113

@@ -137,7 +137,7 @@ The `ipfs` [command-line Client documentation](https://ipfs.io/docs/commands/) m
137137

138138
## Featured Projects
139139

140-
Projects that currently use py-ipfs-api. If your project isn't here, feel free to submit a PR to add it!
140+
Projects that currently use py-ipfs-http-client. If your project isn't here, feel free to submit a PR to add it!
141141

142142
- [git-remote-ipfs](https://github.com/larsks/git-remote-ipfs) allows users to push and pull git repositories from the IPFS network.
143143
- [InterPlanetary Wayback](https://github.com/oduwsdl/ipwb) interfaces web archive ([WARC](https://www.iso.org/standard/44717.html)) files for distributed indexing and replay using IPFS.
@@ -151,7 +151,7 @@ or if you just want to discuss IPFS and python.
151151

152152
### Bug reports
153153

154-
You can submit bug reports using the [GitHub issue tracker](https://github.com/ipfs/python-ipfs-api/issues).
154+
You can submit bug reports using the [GitHub issue tracker](https://github.com/ipfs/py-ipfs-http-client/issues).
155155

156156
### Pull requests
157157

docs/Makefile

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -91,9 +91,9 @@ qthelp:
9191
@echo
9292
@echo "Build finished; now you can run "qcollectiongenerator" with the" \
9393
".qhcp project file in $(BUILDDIR)/qthelp, like this:"
94-
@echo "# qcollectiongenerator $(BUILDDIR)/qthelp/PythonIPFSAPI.qhcp"
94+
@echo "# qcollectiongenerator $(BUILDDIR)/qthelp/PythonIPFSHTTPClient.qhcp"
9595
@echo "To view the help file:"
96-
@echo "# assistant -collectionFile $(BUILDDIR)/qthelp/PythonIPFSAPI.qhc"
96+
@echo "# assistant -collectionFile $(BUILDDIR)/qthelp/PythonIPFSHTTPClient.qhc"
9797

9898
.PHONY: applehelp
9999
applehelp:
@@ -110,8 +110,8 @@ devhelp:
110110
@echo
111111
@echo "Build finished."
112112
@echo "To view the help file:"
113-
@echo "# mkdir -p $$HOME/.local/share/devhelp/PythonIPFSAPI"
114-
@echo "# ln -s $(BUILDDIR)/devhelp $$HOME/.local/share/devhelp/PythonIPFSAPI"
113+
@echo "# mkdir -p $$HOME/.local/share/devhelp/PythonIPFSHTTPClient"
114+
@echo "# ln -s $(BUILDDIR)/devhelp $$HOME/.local/share/devhelp/PythonIPFSHTTPClient"
115115
@echo "# devhelp"
116116

117117
.PHONY: epub

docs/api_ref.md

Lines changed: 0 additions & 31 deletions
This file was deleted.

0 commit comments

Comments
 (0)