Skip to content

Commit c8ee0e3

Browse files
GawaboumgaGawaboumga
committed
First commit
1 parent e0b73fc commit c8ee0e3

11 files changed

+4185
-2
lines changed

‎.gitignore

+2
Original file line numberDiff line numberDiff line change
@@ -102,3 +102,5 @@ venv.bak/
102102

103103
# mypy
104104
.mypy_cache/
105+
# VS Code
106+
.vscode/

‎.travis.yml

+8
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
language: python
2+
python:
3+
- "3.4"
4+
install:
5+
- python setup.py bdist_wheel
6+
- pip install dist/iso_20275-*.whl
7+
script:
8+
- python -m unittest tests

‎Difference.txt

+184
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,184 @@
1+
266
2+
3+
Abbreviations Local language
4+
(i) the district name of the registry district in which the property is located;(ii) the words Condominium Corporation; and (iii) the abbreviation No. ###
5+
6+
Converted to:
7+
Condominium Corporation;No.
8+
9+
269
10+
11+
Entity Legal Form name Local name
12+
A company formed under the Companies Act may seek designation as a Private Investment Holding Company
13+
14+
Convert to:
15+
Private Investment Holding Company
16+
17+
Entity Legal Form name Transliterated name (per ISO 01.140.10)
18+
A company formed under the Companies Act may seek designation as a Private Investment Holding Company
19+
20+
Convert to:
21+
Private Investment Holding Company
22+
23+
270
24+
25+
Abbreviations Local language
26+
limited company and limited by guarantee = Limited, Limit�e, Ltd., Lt�e, Incorporated, Inc.
27+
28+
Converted to:
29+
limited company;Limited by guarantee;Limited;Limit�e;Ltd.;Lt�e;Incorporated;Inc.
30+
31+
271
32+
33+
Abbreviations Local language
34+
Society, Association, some other term suggesting plurality of persons - not limited, incorporated, or company
35+
36+
Converted to:
37+
Society;Association
38+
39+
273
40+
41+
Entity Legal Form name Local name
42+
A company formed under the Companies Act may seek designation as a Community Interest Company (a hybrid structure having characteristics of both for profit and non-profit entities)
43+
44+
Convert to:
45+
Community Interest Company
46+
47+
Entity Legal Form name Transliterated name (per ISO 01.140.10)
48+
A company formed under the Companies Act may seek designation as a Community Interest Company (a hybrid structure having characteristics of both for profit and non-profit entities)
49+
50+
Convert to:
51+
Community Interest Company
52+
53+
274
54+
55+
Abbreviations Local language
56+
Unlimited company = Company, Co., Corporation, Corp., U.L.C., ULC
57+
58+
Converted to:
59+
Company;Co.;Corporation;Corp.;U.L.C.;ULC
60+
61+
275
62+
63+
Abbreviations Local language
64+
limited liability partnership, LLP for limited liability partnership
65+
66+
Converted to:
67+
LLP;L.L.P.;LLP.
68+
69+
276
70+
71+
Abbreviations Local language
72+
no legal element for most
73+
74+
Converted to:
75+
76+
77+
277
78+
79+
Abbreviations Local language
80+
limited company and limited by guarantee = Limited, Limit�e, Ltd., Lt�e, Incorporated, Inc.
81+
82+
Converted to:
83+
limited company;Limited by guarantee;Limited;Limit�e;Ltd.;Lt�e;Incorporated;Inc.
84+
85+
278
86+
87+
Abbreviations Local language
88+
no legal element for most
89+
90+
Converted to:
91+
92+
307
93+
94+
Abbreviations Local language
95+
No legal element but must use the name format: Trustees of (giving distinguishing name and adding immediately thereafter the following words), a religious society, in the (city, town, village, or rural municipality) of (name of municipality), in the Provinceof Manitoba OR � Fiduciaires de (inscrire un nom distinctif), communaut� religieuse, en la (le) (cit�, ville, village oumunicipalit� rurale) de (nom de la municipalit�),province du Manitoba �.
96+
97+
Converted to:
98+
Trustees;Fiduciaires;Manitoba
99+
100+
310
101+
102+
Abbreviations Local language
103+
Limited Liability Partnership or LLP; or in french �Soci�t� � Responabilit� Limit�e� or �s.r.l.�
104+
105+
Converted to:
106+
Limited Liability Partnership;LLP;Soci�t� � Responabilit� Limit�e;s.r.l.;srl
107+
108+
311
109+
110+
Abbreviations Local language
111+
Include the word Cooperative, Co-operative, Coop�rative, or Pool, Co-op; plus Limited, limit�e, incorporated, incorpor�e, Ltd., lt�e, or Inc..
112+
113+
Converted to:
114+
Cooperative;Co-operative;Coop�rative;Pool;Co-op;Limited;limit�e;incorporated;incorpor�e;Ltd.;lt�e;Inc;Inc.
115+
116+
312
117+
118+
Abbreviations Local language
119+
No legal element but must use the name format: The Ukrainian Catholic Parish of (giving the distinguishing name of the parish). or � La Paroisse catholique ukrainienne de (inscrire le nom distinctif de la paroisse).
120+
121+
Converted to:
122+
Ukrainian Catholic Parish;Paroisse catholique ukrainienne
123+
124+
313
125+
126+
Abbreviations Local language
127+
Must include: the name of the land titles district, the words Condominium Corporation, and No. together with the next available consecutive number for a condminium corp. registered in that land titles district
128+
129+
Converted to:
130+
Condominium Corporation;No.
131+
132+
315
133+
134+
Abbreviations Local language
135+
Limited Partnership or LP, OR SOCIETE EN COMMANDITE, if desired (not mandatory)
136+
137+
Converted to:
138+
Limited Partnership;LP;SOCIETE EN COMMANDITE
139+
140+
318
141+
142+
Abbreviations Local language
143+
Must include the word credit union or caisse populaire; plus Limited, or Ltd. (credit union); limit�e or lt�e (caisse populaire)
144+
145+
Converted to:
146+
Cr�dit union;credit union;caisse populaire;Limited;Ltd.;limit�e;lt�e.;lt�e
147+
148+
322
149+
150+
Abbreviations Local language
151+
Must include the words credit union or the words caisse populaire in its name and the word Limited or Limitee or the abbreviation Ltd. or Ltee as the last word of that credit union's name.
152+
153+
Converted to:
154+
Cr�dit union;credit union;caisse populaire;Limited;Ltd.;limit�e;lt�e.;lt�e
155+
156+
324
157+
158+
Abbreviations Local language
159+
Name must end with Condominium Corporation
160+
161+
Converted to:
162+
Condominium Corporation
163+
164+
1133
165+
166+
Entity Legal Form name Local name
167+
Forening/lag/innretning (eller bare forening?)
168+
169+
Convert to:
170+
Forening/lag/innretning (eller bare forening?)
171+
172+
Entity Legal Form name Transliterated name (per ISO 01.140.10)
173+
Forening/lag/innretning (eller bare forening?)
174+
175+
Convert to:
176+
Forening/lag/innretning (eller bare forening?)
177+
178+
1743
179+
180+
Abbreviations Local language
181+
Depends on the company type when formed under other legislation
182+
183+
Converted to:
184+

‎README.md

+90-2
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,90 @@
1-
# iso-20275-python
2-
ISO 20275
1+
# ISO 20275
2+
3+
4+
ISO standard 20275 ‘Financial Services – Entity Legal Forms (ELF)’, Python wrapper.
5+
6+
Its aim is to enable legal forms within jurisdictions to be codified and thus facilitate the classification of legal entities according to their legal form and is codified through: [iso 20275:2017](https://www.iso.org/obp/ui/#iso:std:iso:20275:ed-1:v1:en)
7+
8+
9+
## Column description
10+
11+
Everything is stored in UTF-8 format.
12+
13+
- ELF Code: 4 alphanumerical characters (*[A-Z0-9]{4}*) representing the identifier of the legal entity type. One should pay attention that this code is not unique among the dataset. Indeed, a same legal entity can have different entries based on the language used.
14+
- Country of formation: Common name of the country corresponding to the: "English short name (using Title case)" of ISO 3166-1.
15+
- Country Code: Alpha-2 code of ISO 3166-1.
16+
- Jurisdiction of formation: `Optional` Common name of the subdivision within the country corresponding to the: "English short name (using Title case)" of ISO 3166-2.
17+
- Country sub-division code (ISO 3166-2): `Optional` (extended) Alpha-2 code of ISO 3166-2.
18+
- Entity Legal Form name Local name: Official name used within the country. If the country has different official languages, one may find several entries corresponding to the different languages.
19+
- Language: Common name of the language used to express the local name corresponding to the: "Name" (using Title case) of ISO 639-1.
20+
- Language Code (ISO 639-1): Alpha-2 code of ISO 639-1.
21+
- Entity Legal Form name Transliterated name (per ISO 01.140.10): Transliteration to *latinized* alphabet (more than ASCII) of local name according to ISO 01.140.10.
22+
- Abbreviations Local language: `Optional` Abbreviations of the legal entity type local name.
23+
- Abbreviations transliterated: `Optional` Transliterated abbreviation of the legal entity type local name in *latinized* alphabet (more than ASCII).
24+
- Date created YYYY-MM-DD (ISO 8601): Date of creation according to ISO 8601, per se, 2017-11-30 for the moment.
25+
- ELF Status ACTV/INAC: Either Active or Inactive.
26+
- Modification: `Optional` Explanation of the modification.
27+
- Modification date YYYY-MM-DD (ISO 8601): `Optional` Date of the modification according to ISO 8601.
28+
- Reason: `Optional` Explanation on the legal entity type.
29+
30+
31+
## Code examples
32+
33+
/!\\ Beware /!\\
34+
Two datasets are available within this package. The `Elf` and the `OriginalElf`, the original one (`OriginalElf`) is a mapping of the file without some normalization in the data. This is the pure form. Whereas `Elf` got some modifications to clean up some inputs. See [Differences section](#markdown-header-differences) for more details.
35+
36+
There exists 220 elements sharing a same ELF code. You need to specify which version you would like to use explicitly.
37+
38+
```python
39+
len(Elf['254M']) # 2 entries for this specific entity.
40+
Elf['254M'][0].local_name # Private company limited by shares for the English entry.
41+
Elf['254M'][1].local_name # '私人股份有限公司' for the Chinese entry.
42+
43+
len(Elf['CDOV']) # 1 entry for this specific entity.
44+
Elf['CDOV'][0].local_name # International Business Corporation.
45+
46+
# You can iterate over all the ELF code.
47+
for elf_code, values in Elf.items():
48+
pass
49+
50+
# You can access to both version of the dataset, a normalized one and the original.
51+
Elf['358I'][0].local_abbreviations # "corp.;inc.;co.;ltd. Incorporated;company;limited;corporation"
52+
OriginalElf['358I'][0].local_abbreviations # "corp., inc., co., ltd. Incorporated, company, limited, corporation, or no abbreviation"
53+
```
54+
55+
## Differences
56+
57+
Here, we will review which changes were made on the data or remarks were observed.
58+
59+
### Original file (OriginalElf)
60+
61+
Differences in comparison to the original file.
62+
63+
#### Modification:
64+
65+
- `n/a`, `N/A`, `""` were converted to NA.
66+
67+
#### Remark:
68+
69+
- (Opening) parenthesis are sometimes preceeded (or followed) by a space, sometimes not. Same with the closing ones.
70+
- Not trimmed data.
71+
- Some entries have symbol: `“` or `”`.
72+
- Some entries have: `&`.
73+
74+
### Modified file (Elf)
75+
76+
Differences in comparison to the original file.
77+
78+
#### Modification:
79+
80+
- `n/a`, `N/A`, `""`, `no abbreviation` were converted to NA.
81+
- Parenthesis have been normalized, one space before opening parenthesis and one after the closing one.
82+
- Data haves been trimmed.
83+
- Symbols `“` or `”` have been removed.
84+
- `&` were replaced by `&`.
85+
- ` and ` and ` or ` were replaced by `;` in abbreviations.
86+
- Commas `,` have been replaced by `;` in abbreviations.
87+
88+
Rows: 266, 269, 270, 271, 273, 274, 275, 276, 277, 278, 307, 310, 311, 312, 313, 315, 318, 322, 324, 1133 and 1743 have been modified to avoid comments within abbreviations columns. See [Difference.txt](Difference.txt) for further information.
89+
90+
Written by [`Youri Hubaut`](https://github.com/Gawaboumga). Distributed under MIT license.

0 commit comments

Comments
 (0)